openmatrix 0.2.29 → 0.2.31

package/dist/cli/commands/install-skills.js

@@ -146,6 +146,25 @@ exports.installSkillsCommand = new commander_1.Command('install-skills')
                 }
             }
         }
+        // Install SKILL.md for MatrixCode (skill package manifest)
+        if (target.name === 'MatrixCode') {
+            const skillManifestSrc = path.join(skillsDir, 'SKILL.md');
+            const skillManifestDest = path.join(target.dir, 'SKILL.md');
+            if (fs.existsSync(skillManifestSrc)) {
+                try {
+                    if (fs.existsSync(skillManifestDest) && !options.force) {
+                        skipped++;
+                    }
+                    else {
+                        fs.copyFileSync(skillManifestSrc, skillManifestDest);
+                        installed++;
+                    }
+                }
+                catch (err) {
+                    failed++;
+                }
+            }
+        }
         console.log(`   ✅ Installed: ${installed}`);
         console.log(`   ⏭️  Skipped: ${skipped}`);
         if (failed > 0) {

package/dist/cli/commands/start.js

@@ -61,6 +61,8 @@ exports.startCommand = new commander_1.Command('start')
     .option('--e2e-tests', '启用 E2E 测试')
     .option('--e2e-type <type>', 'E2E 测试类型 (web|visual)')
     .option('--research-context <path>', '研究上下文 JSON 路径 (来自 /om:research 的 context.json)')
+    .option('--parallel', '多 Agent 并行执行 (推荐，速度快)')
+    .option('--single-agent', '单 Agent 串行执行 (上下文连贯)')
     .action(async (input, options) => {
     const basePath = process.cwd();
     const omPath = path.join(basePath, '.openmatrix');
@@ -326,13 +328,19 @@ async function handleTasksJson(options, stateManager, state, omPath, basePath) {
     // 解析执行模式
     const executionMode = tasksInput.mode || options.mode || 'confirm-key';
     const approvalPoints = resolveApprovalPoints(executionMode);
+    // 解析 Agent 执行模式
+    const agentMode = options.singleAgent ? 'single' : 'parallel';
+    // 更新 maxConcurrentAgents（单 Agent = 1，多 Agent = 3）
+    const maxConcurrent = agentMode === 'single' ? 1 : 3;
     await stateManager.updateState({
         status: 'running',
         currentPhase: 'execution',
         config: {
             ...state.config,
             approvalPoints: approvalPoints,
-            quality: qualityConfig
+            quality: qualityConfig,
+            agentMode,
+            maxConcurrentAgents: maxConcurrent
         }
     });
     // 创建审批请求（如果有审批点）
@@ -394,7 +402,9 @@ async function handleTasksJson(options, stateManager, state, omPath, basePath) {
                 title: resolvedInput.title,
                 description: resolvedInput.description,
                 quality: qualityLevel,
-                domain: researchContext?.domain
+                domain: researchContext?.domain,
+                agentMode,
+                maxConcurrent
             }
         }));
     }
@@ -402,6 +412,7 @@ async function handleTasksJson(options, stateManager, state, omPath, basePath) {
         console.log(`\n📋 ${resolvedInput.title} - ${subTasks.length} 个子任务已创建`);
         console.log(`🎯 执行模式：${executionMode}`);
         console.log(`   质量级别：${qualityLevel}`);
+        console.log(`   Agent 模式：${agentMode === 'parallel' ? '多 Agent 并行' : '单 Agent 串行'}`);
         console.log('\n🚀 等待 Skill 执行任务...');
         console.log('   使用 /om:status 查看进度');
     }

package/dist/orchestrator/executor.js

@@ -39,14 +39,7 @@ class OrchestratorExecutor {
             ...config
         };
         this._configReady = this.loadConfigFromState(stateManager);
-        this.scheduler = new scheduler_js_1.Scheduler(stateManager, {
-            maxConcurrentTasks: this.config.maxConcurrent,
-            taskTimeout: this.config.taskTimeout
-        });
-        this.agentRunner = new agent_runner_js_1.AgentRunner(stateManager, approvalManager, {
-            maxConcurrent: this.config.maxConcurrent,
-            taskTimeout: this.config.taskTimeout
-        });
+        // scheduler 和 agentRunner 在 loadConfigFromState 中根据 state.config 初始化
         this.stateMachine = new state_machine_js_1.StateMachine();
         this.phaseExecutor = new phase_executor_js_1.PhaseExecutor(stateManager, approvalManager);
         this.retryManager = new retry_manager_js_1.RetryManager();
@@ -64,10 +57,28 @@ class OrchestratorExecutor {
             if (state.config?.taskTimeout) {
                 this.config.taskTimeout = state.config.taskTimeout;
             }
+            // 只有在 state.config 中有明确的 agentMode 时才更新并发数
+            // 否则使用传入的 config.maxConcurrent
+            if (state.config?.agentMode === 'single') {
+                this.config.maxConcurrent = 1;
+            }
+            else if (state.config?.maxConcurrentAgents && state.config?.maxConcurrentAgents !== 3) {
+                // 只有当 maxConcurrentAgents 不是默认值 3 时才更新
+                this.config.maxConcurrent = state.config.maxConcurrentAgents;
+            }
         }
         catch {
             // use default config
         }
+        // 初始化 scheduler 和 agentRunner（使用最终配置）
+        this.scheduler = new scheduler_js_1.Scheduler(this.stateManager, {
+            maxConcurrentTasks: this.config.maxConcurrent,
+            taskTimeout: this.config.taskTimeout
+        });
+        this.agentRunner = new agent_runner_js_1.AgentRunner(this.stateManager, this.approvalManager, {
+            maxConcurrent: this.config.maxConcurrent,
+            taskTimeout: this.config.taskTimeout
+        });
     }
     /**
      * 执行一步 - 返回待执行的 Subagent 任务

package/dist/types/index.d.ts

@@ -104,6 +104,8 @@ export interface AppConfig {
     model: string;
     /** 质量配置 */
     quality?: QualityConfig;
+    /** Agent 执行模式：parallel（多 Agent 并行）或 single（单 Agent 串行） */
+    agentMode?: 'parallel' | 'single';
 }
 /**
  * 质量配置 - 控制自动化质量门禁

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openmatrix",
-  "version": "0.2.29",
+  "version": "0.2.31",
   "description": "AI Agent task orchestration system with Claude Code Skills integration",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/scripts/install-skills.js

@@ -16,10 +16,12 @@ const targets = [
   {
     name: 'Claude Code',
     dir: path.join(os.homedir(), '.claude', 'commands', 'om'),
+    isClaudeCode: true,
   },
   {
     name: 'OpenCode',
     dir: path.join(os.homedir(), '.config', 'opencode', 'commands', 'om'),
+    isClaudeCode: false,
   },
 ];
 
@@ -33,6 +35,7 @@ if (fs.existsSync(matrixDir)) {
   targets.push({
     name: 'MatrixCode',
     dir: matrixSkillsDir,
+    isMatrixCode: true,
   });
 }
 
@@ -62,6 +65,31 @@ for (const target of targets) {
       }
     }
 
+    // For Claude Code: install om.md and openmatrix.md to parent directory
+    if (target.isClaudeCode) {
+      const claudeCommandsDir = path.join(os.homedir(), '.claude', 'commands');
+      const omSrc = path.join(skillsDir, 'om.md');
+      const omDest = path.join(claudeCommandsDir, 'om.md');
+      if (fs.existsSync(omSrc)) {
+        try {
+          fs.copyFileSync(omSrc, omDest);
+          installed++;
+        } catch (copyErr) {
+          console.log(`  ⚠️  Skipped: om.md (${copyErr.message})`);
+        }
+      }
+      const autoSrc = path.join(skillsDir, 'openmatrix.md');
+      const autoDest = path.join(claudeCommandsDir, 'openmatrix.md');
+      if (fs.existsSync(autoSrc)) {
+        try {
+          fs.copyFileSync(autoSrc, autoDest);
+          installed++;
+        } catch (copyErr) {
+          console.log(`  ⚠️  Skipped: openmatrix.md (${copyErr.message})`);
+        }
+      }
+    }
+
     console.log(`✅ ${target.name}: ${installed} skills installed to ${target.dir}`);
   } catch (err) {
     console.log(`⚠️  ${target.name}: skipped (${err.message})`);

package/skills/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: om
+description: "OpenMatrix - AI Agent 任务编排系统，自动化测试生成，覆盖率 >80%。提供 /om 命令族：/om:start、/om:feature、/om:brainstorm、/om:auto、/om:debug 等。"
+priority: critical
+always_load: true
+---
+
+# OpenMatrix Skills Package
+
+你的代码没测试？OpenMatrix 自动帮你补，覆盖率 >80%
+
+## 可用 Skills
+
+| Skill | 描述 | 用途 |
+|-------|------|------|
+| `/om` | 默认入口 | AI 推荐路由，用户确认后执行 |
+| `/om:start` | 标准流程 | 完整追踪，质量门禁，任务明确可直接执行 |
+| `/om:feature` | 小需求流程 | 2-5 个任务块，轻量追踪，适合单一改动点 |
+| `/om:brainstorm` | 澄清/设计 | 先澄清不明确点或设计方案，再执行 |
+| `/om:auto` | 全自动执行 | 零交互，无审批，适合批量任务 |
+| `/om:debug` | 系统化调试 | 问题诊断，根因分析 |
+| `/om:status` | 查看状态 | 任务执行进度 |
+| `/om:meeting` | 处理阻塞 | 处理 blocked 任务 |
+| `/om:report` | 生成报告 | 执行报告生成 |
+| `/om:resume` | 恢复任务 | 恢复中断的任务 |
+| `/om:research` | 领域调研 | 技术方案调研 |
+
+## 快速开始
+
+```
+/om 实现用户登录功能
+
+# AI 分析任务 → 推荐路由 → 用户确认 → 执行
+```
+
+## 质量门禁
+
+| 模式 | TDD | 覆盖率 | Lint | 安全扫描 |
+|------|:---:|:------:|:----:|:--------:|
+| 严格模式 | Y | >80% | Y | Y |
+| 平衡模式 | N | >60% | Y | Y |
+| 快速模式 | N | 无 | N | N |
+
+## 安装
+
+```bash
+npm install -g openmatrix
+openmatrix install-skills
+```
+
+## 文档
+
+- GitHub: https://github.com/bigfish1913/openmatrix
+- NPM: https://www.npmjs.com/package/openmatrix

package/skills/start.md

@@ -286,6 +286,70 @@ AskUserQuestion: `header: "E2E 测试"`, `multiSelect: false`
 | `视觉验证` | 需要浏览器可视化验证，可检查页面样式和布局 |
 | `不需要` | 仅进行单元测试和集成测试，节省时间 |
 
+#### 5.3 Agent 执行模式（所有任务类型都需要选择）
+
+**Agent 执行模式决定任务如何分配和执行，是影响效率的关键决策。**
+
+AskUserQuestion: `header: "Agent 模式"`, `multiSelect: false`
+
+**question:** 选择 Agent 执行模式（决定任务如何分配和执行）
+
+| label | description |
+|-------|-------------|
+| `多 Agent 并行 (推荐)` | 多个 Agent 同时执行独立任务，速度快，适合任务边界清晰的项目 |
+| `单 Agent 串行` | 一个 Agent 顺序执行所有任务，上下文连贯，适合复杂依赖任务 |
+
+**两种模式的详细对比：**
+
+| 特性 | 多 Agent 并行 | 单 Agent 串行 |
+|-----|--------------|--------------|
+| **执行速度** | ⚡ 快（并行执行） | 🐢 慢（顺序执行） |
+| **上下文连贯性** | ⚠️ 可能不连贯 | ✅ 完全连贯 |
+| **决策一致性** | ⚠️ 各 Agent 可能不同 | ✅ 单一决策者 |
+| **任务独立性** | ✅ 失败不影响其他 | ❌ 一个失败可能阻塞后续 |
+| **内存占用** | ⚠️ 较高（多个进程） | ✅ 较低（单进程） |
+| **依赖处理** | ⚠️ 需要等待依赖完成 | ✅ 自动处理依赖 |
+| **调试难度** | ⚠️ 多 Agent 日志分散 | ✅ 单一日志流 |
+| **适用场景** | 任务边界清晰、无复杂依赖 | 任务间强依赖、需要全局视角 |
+
+**推荐选择指南：**
+
+```
+任务特点判断流程:
+
+┌─────────────────────────────────────┐
+│ 任务之间是否有强依赖关系？           │
+│ (例如: 任务B 需要 任务A 的产出)      │
+└──────────────┬──────────────────────┘
+               │
+        ┌──────┴──────┐
+        │             │
+       有依赖        无依赖
+        │             │
+        ▼             ▼
+   单 Agent       多 Agent
+   串行模式       并行模式
+        │             │
+        │             │
+   ┌────┴────┐   ┌────┴────┐
+   │         │   │         │
+   │ 上下文   │   │ 速度快   │
+   │ 连贯     │   │ 效率高   │
+   │ 决策一致 │   │ 独立性   │
+   └──────────┘   └──────────┘
+```
+
+**典型场景推荐：**
+
+| 场景 | 推荐 | 理由 |
+|-----|------|------|
+| 重构模块结构 | 单 Agent | 需要全局视角，任务间强关联 |
+| 添加多个独立 API | 多 Agent | 任务独立，并行效率高 |
+| 实现完整功能流程 | 单 Agent | 有上下文依赖，需要连贯决策 |
+| 批量修复多个 bug | 多 Agent | 各 bug 独立，可并行 |
+| 从零搭建系统 | 单 Agent | 架构决策需要一致性 |
+| 添加多个测试文件 | 多 Agent | 测试文件独立，并行快 |
+
 #### 执行模式自动推断
 
 **执行模式不再通过问答选择，而是根据质量等级自动推断：**
@@ -336,7 +400,7 @@ Goals:
 
 **CLI 自动从当前 runId 目录读取 tasks-input.json 和 plan.md。**
 
-**根据质量等级自动设置执行参数：**
+**根据质量等级和 Agent 模式自动设置执行参数：**
 
 | 质量等级 | CLI 参数 | 执行方式 |
 |---------|---------|---------|
@@ -344,29 +408,43 @@ Goals:
 | 平衡模式 | `--quality balanced --mode auto` | 先开发后测试 |
 | 快速模式 | `--quality fast --mode auto` | 直接开发 |
 
-**开发任务**（有质量等级选择）：
+| Agent 模式 | CLI 参数 | 执行方式 |
+|-----------|---------|---------|
+| 多 Agent 并行 | `--parallel` | 多个 Agent 同时执行 |
+| 单 Agent 串行 | `--single-agent` | 一个 Agent 顺序执行 |
+
+**开发任务**（有质量等级 + Agent 模式选择）：
+
 ```bash
-openmatrix start --tasks-json @tasks-input.json --quality <质量等级> --mode auto --json
+# 多 Agent 并行模式（默认推荐）
+openmatrix start --tasks-json @tasks-input.json --quality <质量等级> --mode auto --parallel --json
+
+# 单 Agent 串行模式
+openmatrix start --tasks-json @tasks-input.json --quality <质量等级> --mode auto --single-agent --json
 ```
 
 如果存在研究上下文（`.openmatrix/{runId}/research/context.json`），增加 `--research-context` 参数：
 ```bash
-openmatrix start --tasks-json @tasks-input.json --research-context @research/context.json --quality <质量等级> --mode auto --json
+openmatrix start --tasks-json @tasks-input.json --research-context @research/context.json --quality <质量等级> --mode auto --parallel --json
 ```
 
 如果启用了 E2E 测试（功能测试），加上 `--e2e-tests`：
 ```bash
-openmatrix start --tasks-json @tasks-input.json --quality strict --mode auto --e2e-tests --json
+openmatrix start --tasks-json @tasks-input.json --quality strict --mode auto --parallel --e2e-tests --json
 ```
 
 如果选择了视觉验证，加上 `--e2e-tests --e2e-type visual`：
 ```bash
-openmatrix start --tasks-json @tasks-input.json --quality strict --mode auto --e2e-tests --e2e-type visual --json
+openmatrix start --tasks-json @tasks-input.json --quality strict --mode auto --parallel --e2e-tests --e2e-type visual --json
 ```
 
-**非开发任务**（无质量等级，默认全自动执行）：
+**非开发任务**（无质量等级，但需要 Agent 模式选择）：
 ```bash
-openmatrix start --tasks-json @tasks-input.json --mode auto --json
+# 多 Agent 并行模式
+openmatrix start --tasks-json @tasks-input.json --mode auto --parallel --json
+
+# 单 Agent 串行模式
+openmatrix start --tasks-json @tasks-input.json --mode auto --single-agent --json
 ```
 
 **注意**: `@tasks-input.json` 表示 CLI 自动从当前 runId 目录读取。CLI 会自动检测 `current.json` 定位 runId。