openmatrix 0.1.55 → 0.1.57

package/README.md

@@ -386,6 +386,27 @@ Accept 阶段由 Reviewer Agent 执行:
 }
 ```
 
+## 状态存储
+
+任务状态持久化在 `.openmatrix/` 目录:
+
+```
+.openmatrix/
+├── state.json              # 全局状态 (runId, status, config, statistics)
+├── plan.md                 # AI 生成的执行计划
+├── tasks-input.json        # 任务输入 (goals, constraints, deliverables)
+├── tasks/
+│   └── TASK-001/
+│       ├── task.json       # 任务定义 + 状态 + 阶段信息
+│       ├── context.md      # Agent 上下文 (供后续 Agent 读取)
+│       ├── develop.json    # 开发阶段结果
+│       ├── verify.json     # 验证阶段结果 (质量门禁)
+│       ├── accept.json     # 验收阶段结果
+│       └── artifacts/      # 产出文件 (result.md, quality-report.json 等)
+├── approvals/              # 审批记录
+└── meetings/               # Meeting 记录
+```
+
 ---
 
 ## 多语言支持
@@ -465,6 +486,9 @@ cd openmatrix && npm install && npm run build && npm test
 - [x] `/om:brainstorm` 头脑风暴模式
 - [x] 多语言支持 (Python/Go/Java/TypeScript 等)
 - [x] E2E 测试支持 (Web/Mobile/GUI)
+- [x] Agent 上下文共享 (Agent Memory)
+- [x] Task 子目录结构 + Phase 结果持久化
+- [x] 执行循环持久化 (`openmatrix step`/`complete` 防上下文压缩丢失)
 - [ ] VSCode 扩展
 - [ ] CI/CD 集成
 

package/dist/agents/impl/researcher-agent.d.ts

@@ -7,11 +7,20 @@ import type { Task, AgentType, AgentResult } from '../../types/index.js';
  * - 分析技术方案
  * - 总结最佳实践
  * - 提供决策建议
+ *
+ * 支持动态领域感知，根据任务描述自动适配研究方向
  */
 export declare class ResearcherAgent {
     readonly type: AgentType;
     readonly capabilities: string[];
     execute(task: Task): Promise<AgentResult>;
-    private buildResearchPrompt;
+    /**
+     * 构建动态领域感知的研究 Prompt
+     */
+    private buildDynamicResearchPrompt;
+    /**
+     * 从任务描述中提取研究上下文
+     */
+    private extractResearchContext;
     private generateRunId;
 }

package/dist/agents/impl/researcher-agent.js

@@ -9,6 +9,8 @@ exports.ResearcherAgent = void 0;
  * - 分析技术方案
  * - 总结最佳实践
  * - 提供决策建议
+ *
+ * 支持动态领域感知，根据任务描述自动适配研究方向
  */
 class ResearcherAgent {
     type = 'researcher';
@@ -16,7 +18,7 @@ class ResearcherAgent {
     async execute(task) {
         const startTime = Date.now();
         try {
-            const prompt = this.buildResearchPrompt(task);
+            const prompt = this.buildDynamicResearchPrompt(task);
             return {
                 runId: this.generateRunId(),
                 taskId: task.id,
@@ -44,88 +46,208 @@ class ResearcherAgent {
             };
         }
     }
-    buildResearchPrompt(task) {
+    /**
+     * 构建动态领域感知的研究 Prompt
+     */
+    buildDynamicResearchPrompt(task) {
+        // 从任务描述中提取领域和角色信息
+        const { domain, role, focus } = this.extractResearchContext(task.description);
         return `
 # 调研任务
 
-## 调研问题
+## 研究领域
+${domain}
+
+## 角色定位
+${role}
+
+## 研究方向
+${focus}
 
+## 原始任务描述
 ${task.description}
 
 ## 调研步骤
 
 1. **搜索资料**
-   - 官方文档
-   - 技术博客
-   - GitHub 仓库
-   - Stack Overflow
+   - 使用 WebSearch 搜索领域核心概念
+   - 搜索行业标准、最佳实践
+   - 搜索主流技术方案和开源项目
+   - 搜索常见挑战和解决方案
 
-2. **分析方案**
+2. **分析整理**
    - 功能对比
-   - 性能对比
-   - 社区支持
+   - 性能特点
+   - 社区生态
    - 学习曲线
+   - 适用场景
 
 3. **总结发现**
-   - 关键信息
-   - 优缺点
-   - 适用场景
+   - 关键信息提炼
+   - 优缺点分析
+   - 决策建议
 
 ## 输出格式
 
 \`\`\`markdown
-# 调研报告
+# ${domain} 调研报告
 
-## 问题
-[调研的核心问题]
+## 核心发现
 
-## 调研方法
-- 搜索关键词: ...
-- 参考来源: ...
+[3-5 个关键发现，每个用一句话概括]
 
-## 发现
+1. ...
+2. ...
+3. ...
 
-### 方案 A: [名称]
-- 描述: ...
-- 优点:
-  - ...
-- 缺点:
-  - ...
-- 适用场景: ...
+## 详细分析
 
-### 方案 B: [名称]
-- 描述: ...
-- 优点:
+### 发现 1: [标题]
+- **描述**: ...
+- **关键点**:
   - ...
-- 缺点:
-  - ...
-- 适用场景: ...
+- **注意事项**: ...
+
+### 发现 2: [标题]
+...
 
-## 方案对比
+## 行业最佳实践
 
-| 维度 | 方案 A | 方案 B |
-|-----|--------|--------|
-| 性能 | ⭐⭐⭐ | ⭐⭐ |
-| 易用性 | ⭐⭐ | ⭐⭐⭐ |
-| 社区 | ⭐⭐⭐ | ⭐ |
+1. ...
+2. ...
+3. ...
+
+## 关键决策点
+
+[用户需要做出的关键决策]
+
+1. **决策 1**: [决策描述]
+   - 选项 A: ... (适用场景)
+   - 选项 B: ... (适用场景)
+   - 建议: ...
+
+2. **决策 2**: ...
 
-## 建议
+## 推荐方案
 
-**推荐方案**: [方案 X]
+**首选方案**: ...
 
 **理由**:
 1. ...
 2. ...
 
+**备选方案**: ...
+
 ## 参考资料
+
 1. [标题](链接)
+2. [标题](链接)
 \`\`\`
 
 ## 开始调研
 
 请使用 WebSearch 和 WebFetch 工具搜索相关信息。
+至少搜索 5 个相关关键词，覆盖官方文档、社区讨论、技术博客等维度。
 `;
     }
+    /**
+     * 从任务描述中提取研究上下文
+     */
+    extractResearchContext(description) {
+        const lower = description.toLowerCase();
+        // 领域关键词映射
+        const domainMap = [
+            {
+                keywords: ['游戏', 'game', 'gamedev', 'unity', 'unreal'],
+                domain: '游戏开发',
+                aspects: ['游戏类型', '目标平台', '技术架构', '美术风格', '盈利模式']
+            },
+            {
+                keywords: ['网站', 'website', 'web app', '门户'],
+                domain: 'Web 网站开发',
+                aspects: ['功能需求', '用户体验', '技术栈', 'SEO', '性能优化']
+            },
+            {
+                keywords: ['app', '移动应用', 'ios', 'android', 'flutter'],
+                domain: '移动应用开发',
+                aspects: ['平台选择', '用户界面', '性能优化', '发布流程', '用户增长']
+            },
+            {
+                keywords: ['支付', 'payment', 'stripe', '支付宝'],
+                domain: '支付系统',
+                aspects: ['支付方式', '安全合规', '风控策略', '对账结算', '国际化']
+            },
+            {
+                keywords: ['电商', 'ecommerce', 'shop', '商城'],
+                domain: '电商系统',
+                aspects: ['商品管理', '购物流程', '库存物流', '营销工具', '数据分析']
+            },
+            {
+                keywords: ['社交', 'social', 'community', '论坛'],
+                domain: '社交平台',
+                aspects: ['用户关系', '内容互动', '实时通讯', '内容审核', '推荐算法']
+            },
+            {
+                keywords: ['安全', 'security', 'auth', '认证', '加密'],
+                domain: '安全领域',
+                aspects: ['威胁模型', '认证授权', '数据保护', '审计监控', '合规要求']
+            },
+            {
+                keywords: ['后台', 'admin', 'dashboard', 'cms', '管理'],
+                domain: '后台管理系统',
+                aspects: ['权限模型', '数据看板', '工作流程', 'API 设计', '多租户']
+            },
+            {
+                keywords: ['ai', '人工智能', 'ml', '机器学习', '大模型', 'llm'],
+                domain: 'AI/机器学习',
+                aspects: ['模型选择', '数据处理', '训练部署', '性能优化', '伦理合规']
+            },
+            {
+                keywords: ['区块链', 'blockchain', 'web3', 'defi', 'nft'],
+                domain: '区块链',
+                aspects: ['链选择', '智能合约', '安全审计', '性能扩展', '合规监管']
+            },
+            {
+                keywords: ['音视频', 'streaming', '直播', 'rtc', 'webrtc'],
+                domain: '音视频',
+                aspects: ['编解码', '传输协议', '延迟优化', '存储分发', '实时互动']
+            }
+        ];
+        // 查找匹配的领域
+        for (const { keywords, domain, aspects } of domainMap) {
+            if (keywords.some(kw => lower.includes(kw))) {
+                return {
+                    domain,
+                    role: `${domain}专家`,
+                    focus: `请重点调研以下方面: ${aspects.join('、')}`
+                };
+            }
+        }
+        // 通用领域：尝试从"做X"模式提取
+        const actionPatterns = [
+            /做(一个|个)(.+?)(的|app|网站|系统|平台|工具|应用|$)/,
+            /开发(一个|个)?(.+?)(系统|应用|平台|工具|$)/,
+            /构建(一个|个)?(.+?)(系统|应用|平台|工具|$)/,
+            /build (a |an )?(.+?)(app|website|system|tool|platform|$)/i,
+        ];
+        for (const pattern of actionPatterns) {
+            const match = description.match(pattern);
+            if (match && match[2]) {
+                const extracted = match[2].trim();
+                return {
+                    domain: extracted,
+                    role: `${extracted}领域专家`,
+                    focus: `请调研 ${extracted} 的核心概念、技术方案、最佳实践、常见挑战`
+                };
+            }
+        }
+        // 默认：使用原始描述
+        return {
+            domain: '项目开发',
+            role: '技术顾问',
+            focus: '请调研相关技术方案、最佳实践、实现路径'
+        };
+    }
     generateRunId() {
         return `researcher-${Date.now().toString(36)}`;
     }

package/dist/cli/commands/brainstorm.js

@@ -177,6 +177,8 @@ exports.brainstormCommand = new commander_1.Command('brainstorm')
     }
     // 生成头脑风暴问题
     const questions = generateBrainstormQuestions(taskContent, taskTitle);
+    // 检测是否涉及垂直领域
+    const domainDetection = detectVerticalDomain(taskContent);
     // 创建会话
     const session = {
         status: 'brainstorming',
@@ -185,12 +187,13 @@ exports.brainstormCommand = new commander_1.Command('brainstorm')
         questions,
         answers: {},
         insights: [],
-        designNotes: []
+        designNotes: [],
+        suggestResearch: domainDetection.isVertical ? domainDetection.domain : undefined
     };
     await fs.writeFile(brainstormPath, JSON.stringify(session, null, 2));
     if (options.json) {
         // JSON 输出供 Skill 解析
-        console.log(JSON.stringify({
+        const output = {
             status: 'brainstorming',
             message: '开始头脑风暴',
             taskTitle,
@@ -202,11 +205,21 @@ exports.brainstormCommand = new commander_1.Command('brainstorm')
                 multiSelect: q.multiSelect
             })),
             hint: '请逐一回答问题，完成后再调用 --complete'
-        }));
+        };
+        // 如果检测到垂直领域，添加建议
+        if (domainDetection.isVertical) {
+            output.suggestResearch = domainDetection.domain;
+            output.researchHint = `检测到垂直领域「${domainDetection.domain}」，建议先进行领域调研`;
+        }
+        console.log(JSON.stringify(output));
     }
     else {
         console.log('\n🧠 开始头脑风暴...\n');
         console.log(`📋 任务: ${taskTitle}\n`);
+        if (domainDetection.isVertical) {
+            console.log(`🔍 检测到垂直领域: ${domainDetection.domain}`);
+            console.log('   建议使用 /om:research 进行领域调研\n');
+        }
         console.log('需要探索以下问题:');
         questions.forEach((q, i) => {
             console.log(`  ${i + 1}. ${q.question}`);
@@ -214,6 +227,37 @@ exports.brainstormCommand = new commander_1.Command('brainstorm')
         console.log('\n💡 使用 /om:brainstorm 技能进行交互式问答');
     }
 });
+/**
+ * 检测是否可能需要领域调研
+ * 不硬编码领域，只判断是否像垂直领域任务
+ */
+function detectVerticalDomain(taskContent) {
+    const lower = taskContent.toLowerCase();
+    // 检测"做X"模式 - 这是垂直领域任务的典型特征
+    const actionPatterns = [
+        /做(一个|个)(.+?)(的|app|网站|系统|平台|工具|应用|游戏|$)/,
+        /开发(一个|个)?(.+?)(系统|应用|平台|工具|游戏|$)/,
+        /构建(一个|个)?(.+?)(系统|应用|平台|工具|$)/,
+        /build (a |an )?(.+?)(app|website|system|tool|platform|game|$)/i,
+        /create (a |an )?(.+?)(app|website|system|tool|platform|game|$)/i,
+    ];
+    for (const pattern of actionPatterns) {
+        const match = taskContent.match(pattern);
+        if (match && match[2]) {
+            const extracted = match[2].trim();
+            // 如果提取的内容有意义，认为是垂直领域任务
+            if (extracted.length > 1) {
+                return { isVertical: true, domain: extracted };
+            }
+        }
+    }
+    // 检测是否包含"系统"、"平台"、"应用"等大词
+    const systemKeywords = ['系统', '平台', '应用', 'system', 'platform', 'app'];
+    if (systemKeywords.some(kw => lower.includes(kw))) {
+        return { isVertical: true, domain: '待分析' };
+    }
+    return { isVertical: false, domain: '' };
+}
 /**
  * 根据任务内容生成头脑风暴问题
  */

package/dist/cli/commands/complete.js

@@ -37,64 +37,71 @@ exports.completeCommand = void 0;
 // src/cli/commands/complete.ts
 const commander_1 = require("commander");
 const state_manager_js_1 = require("../../storage/state-manager.js");
-const approval_manager_js_1 = require("../../orchestrator/approval-manager.js");
-const executor_js_1 = require("../../orchestrator/executor.js");
 const path = __importStar(require("path"));
 exports.completeCommand = new commander_1.Command('complete')
-    .description('标记任务完成或失败')
-    .argument('<taskId>', '任务 ID')
-    .option('--success', '标记为成功')
+    .description('标记任务完成并更新全局统计')
+    .argument('<taskId>', '任务ID (如 TASK-001)')
+    .option('--success', '标记为成功完成 (默认)', true)
     .option('--failed', '标记为失败')
-    .option('--error <message>', '错误信息')
-    .option('--output <text>', '执行输出')
-    .option('--json', 'JSON 输出')
+    .option('--output <text>', '执行结果摘要')
+    .option('--error <text>', '错误信息 (失败时)')
     .action(async (taskId, options) => {
     const basePath = process.cwd();
     const omPath = path.join(basePath, '.openmatrix');
     const stateManager = new state_manager_js_1.StateManager(omPath);
     await stateManager.initialize();
-    const state = await stateManager.getState();
-    // 构建执行器
-    const approvalManager = new approval_manager_js_1.ApprovalManager(stateManager);
-    const executor = new executor_js_1.OrchestratorExecutor(stateManager, approvalManager, {
-        maxConcurrent: state.config.maxConcurrentAgents,
-        taskTimeout: state.config.timeout * 1000
-    });
-    const success = options.success || !options.failed;
-    // 标记任务完成
-    await executor.completeTask(taskId, {
-        success,
-        output: options.output,
-        error: options.error
-    });
-    if (options.json) {
-        // 获取下一批可执行任务
-        const nextResult = await executor.step();
-        const updatedTask = await stateManager.getTask(taskId);
-        console.log(JSON.stringify({
-            status: success ? 'completed' : 'failed',
-            taskId,
-            taskStatus: updatedTask?.status,
-            nextBatch: {
-                status: nextResult.status,
-                subagentTasks: nextResult.subagentTasks.map(t => ({
-                    subagent_type: t.subagent_type,
-                    description: t.description,
-                    prompt: t.prompt,
-                    isolation: t.isolation,
-                    taskId: t.taskId,
-                    agentType: t.agentType,
-                    timeout: t.timeout
-                })),
-                statistics: nextResult.statistics
+    // 1. 读取任务
+    const task = await stateManager.getTask(taskId);
+    if (!task) {
+        console.log(JSON.stringify({ error: `任务 ${taskId} 不存在` }));
+        process.exit(1);
+    }
+    const isSuccess = !options.failed;
+    const now = new Date().toISOString();
+    if (isSuccess) {
+        // 2a. 标记任务完成 - 更新所有阶段
+        await stateManager.updateTask(taskId, {
+            status: 'completed',
+            phases: {
+                develop: { status: 'completed', duration: 0, completedAt: now },
+                verify: { status: 'completed', duration: 0, completedAt: now },
+                accept: { status: 'completed', duration: 0, completedAt: now }
             }
-        }));
+        });
     }
     else {
-        const emoji = success ? '✅' : '❌';
-        console.log(`${emoji} 任务 ${taskId} ${success ? '完成' : '失败'}`);
-        if (!success && options.error) {
-            console.log(`   错误: ${options.error}`);
-        }
+        // 2b. 标记任务失败
+        await stateManager.updateTask(taskId, {
+            status: 'failed',
+            error: options.error || 'Task failed'
+        });
     }
+    // 3. 重新计算全局统计（从实际任务文件统计，避免累积误差）
+    const allTasks = await stateManager.listTasks();
+    const stats = {
+        totalTasks: allTasks.length,
+        completed: allTasks.filter(t => t.status === 'completed').length,
+        inProgress: allTasks.filter(t => t.status === 'in_progress').length,
+        failed: allTasks.filter(t => t.status === 'failed').length,
+        pending: allTasks.filter(t => t.status === 'pending' || t.status === 'scheduled').length
+    };
+    // 4. 更新全局状态
+    const allDone = stats.completed + stats.failed === stats.totalTasks;
+    await stateManager.updateState({
+        statistics: stats,
+        status: allDone ? 'completed' : 'running',
+        currentPhase: allDone ? 'completed' : 'execution',
+        ...(allDone ? { completedAt: now } : {})
+    });
+    // 5. 输出结果
+    const result = {
+        taskId,
+        status: isSuccess ? 'completed' : 'failed',
+        statistics: stats,
+        allDone,
+        message: isSuccess
+            ? `${taskId} 完成 (${stats.completed}/${stats.totalTasks})`
+            : `${taskId} 失败: ${options.error || 'Unknown error'}`
+    };
+    console.log(JSON.stringify(result, null, 2));
 });

package/dist/cli/commands/research.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const researchCommand: Command;