openmatrix 0.2.30 → 0.2.33

package/skills/start.md

@@ -52,9 +52,9 @@ Step 1:  初始化 .openmatrix 目录
 Step 2:  验证前置条件（plan.md + tasks-input.json 必须已存在）
 Step 3:  智能分析任务类型（开发/非开发）
 Step 4:  提交文档（git add docs/ + 所有 .md 文件, commit）
-Step 5:  必选问题（开发任务:质量等级; 严格模式可选E2E; 非开发:跳过）<- 不可跳过
+Step 5:  必选问题（开发任务:质量等级+E2E+Agent模式; 非开发:仅Agent模式）<- 不可跳过
 Step 6:  可选问题（仅复杂开发任务）+ 展示执行计划
-Step 7:  调用 openmatrix start --tasks-json                <- 必须完成，不可跳过
+Step 7:  调用 openmatrix start --tasks-json --parallel/--single-agent    <- 必须完成，不可跳过
 Step 8:  从 CLI 返回结果中读取 subagentTasks 列表           <- 必须完成
 Step 9:  逐个执行 subagentTasks（调用 Agent 工具）          <- 只有这步才能写代码
 ```
@@ -62,12 +62,13 @@ Step 9:  逐个执行 subagentTasks（调用 Agent 工具）          <- 只有
 **违反以下任一规则将导致任务执行失败：**
 
 - **禁止在 Step 9 之前写任何业务代码** — 所有代码必须在 Step 9 通过 Agent 执行
-- **禁止跳过 Step 5 必选问题** — 开发任务必须选质量等级，非开发任务无需问答
+- **禁止跳过 Step 5 必选问题** — 开发任务必须选质量等级+Agent模式，非开发任务必须选Agent模式
 - **禁止跳过 Step 7** — 必须调用 CLI，不能用其他方式代替
 - **禁止自行规划 Phase** — 任务由 CLI 的 TaskPlanner 拆分，AI 只提取 goals
 - **禁止用 Bash/npm/write 直接写业务代码** — 业务代码只能通过 Step 9 的 Agent 执行
 - **禁止在 start 中生成 plan** — plan 由 /om:plan 生成，start 只负责执行
 - **使用 Agent 工具执行子任务** — 不通过其他编排系统
+- **禁止省略 Agent 模式参数** — CLI 命令必须包含 --parallel 或 --single-agent
 </MANDATORY-EXECUTION-ORDER>
 
 <IRON-LAW>
@@ -248,9 +249,11 @@ EOF
 
 | goalTypes | 需要询问 |
 |-----------|---------|
-| `development` | 5.1 质量等级 -> 5.2 E2E（仅严格模式可选） |
-| `testing` | 无需问答，直接进入 Step 7 |
-| `documentation` / `other` | 无需问答，直接进入 Step 7 |
+| `development` | 5.1 质量等级 -> 5.2 E2E（仅严格模式可选） -> 5.3 Agent 模式 |
+| `testing` | 仅 5.3 Agent 模式（其他跳过） |
+| `documentation` / `other` | 仅 5.3 Agent 模式（其他跳过） |
+
+**注意**：所有任务类型都需要选择 Agent 模式（Step 5.3），因为这影响执行效率。
 
 #### 5.1 质量等级（仅 `goalTypes: development`）
 
@@ -269,12 +272,14 @@ AskUserQuestion: `header: "质量等级"`, `multiSelect: false`
 | 模式 | E2E | AI 验收 | 执行方式 |
 |-----|-----|---------|---------|
 | 严格模式 | 可选问一句（Step 5.2） | 必须 | TDD（先测试后开发） |
-| 平衡模式 | 不需要（自动跳过） | 必须 | 先开发后测试 |
+| 平衡模式 | 可选问一句（Step 5.2） | 必须 | 先开发后测试 |
 | 快速模式 | 不需要（自动跳过） | 不需要 | 直接开发 |
 
-#### 5.2 E2E 测试（仅 `严格模式` 可选，其他模式自动跳过）
+#### 5.2 E2E 测试（仅 `严格模式/平衡模式` 可选，快速模式自动跳过）
+
+**只有选择「严格模式」或「平衡模式」时才询问此问题，快速模式自动推断为「不需要」。**
 
-**只有选择「严格模式」时才询问此问题，平衡模式和快速模式自动推断为「不需要」。**
+**注意：E2E 测试耗时较长，仅在涉及前端页面/UI/Web 的任务时询问，其他类型任务默认跳过。**
 
 AskUserQuestion: `header: "E2E 测试"`, `multiSelect: false`
 
@@ -286,16 +291,86 @@ AskUserQuestion: `header: "E2E 测试"`, `multiSelect: false`
 | `视觉验证` | 需要浏览器可视化验证，可检查页面样式和布局 |
 | `不需要` | 仅进行单元测试和集成测试，节省时间 |
 
-#### 执行模式自动推断
+#### 5.3 Agent 执行模式（所有任务类型）
+
+**Agent 执行模式决定任务如何分配和执行，是影响效率的关键决策。**
 
-**执行模式不再通过问答选择，而是根据质量等级自动推断：**
+AskUserQuestion: `header: "Agent 模式"`, `multiSelect: false`
 
-- **严格模式** → 全自动执行 + TDD 流程
-- **平衡模式** → 全自动执行 + 先开发后测试
-- **快速模式** → 全自动执行 + 直接开发
+**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 | 测试文件独立，并行快 |
+
+#### 审批模式自动推断
+
+**审批模式不再通过问答选择，而是根据质量等级自动推断：**
+
+| 质量等级 | 审批模式 | 执行流程 |
+|---------|---------|---------|
+| 严格模式 | 全自动执行 | TDD（先测试后开发） |
+| 平衡模式 | 全自动执行 | 先开发后测试 |
+| 快速模式 | 全自动执行 | 直接开发 |
 
 **非开发任务**（testing/documentation/other）默认使用「全自动执行」。
 
+**注意**：审批模式（approval mode）和 Agent 模式（agent mode）是两个独立的配置：
+- **审批模式**：决定是否需要用户确认（自动推断，无需问答）
+- **Agent 模式**：决定任务执行方式（并行 vs 串行，Step 5.3 问答选择）
+
 #### 常见借口
 
 | 借口 | 真相 |
@@ -336,7 +411,7 @@ Goals:
 
 **CLI 自动从当前 runId 目录读取 tasks-input.json 和 plan.md。**
 
-**根据质量等级自动设置执行参数：**
+**根据质量等级和 Agent 模式自动设置执行参数：**
 
 | 质量等级 | CLI 参数 | 执行方式 |
 |---------|---------|---------|
@@ -344,32 +419,46 @@ 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。
+**注意**: `@tasks-input.json` 表示 CLI 自动从当前 runId 目录读取文件。CLI 会检测 `.openmatrix/current.json` 获取 runId，然后读取 `.openmatrix/{runId}/tasks-input.json`。
 
 此命令返回 JSON 包含 `subagentTasks` 列表。
 
@@ -638,9 +727,10 @@ Agent-1 完成 -> 写入 context.md -> Agent-2 读取 Agent-1 的上下文 ->
 ```
 
 **中断恢复:** 如果会话中断，再次执行 `/om:start` 时:
-1. 读取 `.openmatrix/state.json`
-2. 如果 `status === 'running'`，读取所有任务，找到 status 不是 completed 的任务
-3. 从中断的任务继续执行，不需要重新开始
+1. 读取 `.openmatrix/current.json` 获取 runId
+2. 读取 `.openmatrix/${runId}/state.json`
+3. 如果 `status === 'running'`，读取所有任务，找到 status 不是 completed 的任务
+4. 从中断的任务继续执行，不需要重新开始
 
 **Meeting 处理（auto 模式）:** 记录并跳过，执行完成后统一展示。
 
@@ -740,7 +830,7 @@ Step 1-2: 初始化 + 验证前置条件 -> Step 3-4: 分析类型 + 提交文
 | 质量等级 | E2E 问题 | AI 验收 | 执行模式 |
 |---------|---------|---------|---------|
 | 严格模式 | 可选问一句 | 必须 | 全自动 + TDD |
-| 平衡模式 | 不需要 | 必须 | 全自动 + 先开发后测试 |
+| 平衡模式 | 可选问一句 | 必须 | 全自动 + 先开发后测试 |
 | 快速模式 | 不需要 | 不需要 | 全自动 + 直接开发 |
 
 ## Git 提交格式

package/skills/status.md

@@ -43,10 +43,11 @@ description: "Use when checking task execution progress, run status, completion
 </objective>
 
 <process>
-1. 读取 `.openmatrix/state.json` 获取全局状态
-2. 读取 `.openmatrix/tasks/` 下所有任务
-3. 读取 `.openmatrix/approvals/` 下待处理审批
-4. 展示格式化状态概览
+1. 读取 `.openmatrix/current.json` 获取当前 runId
+2. 读取 `.openmatrix/{runId}/state.json` 获取全局状态
+3. 读取 `.openmatrix/{runId}/tasks/` 下所有任务
+4. 读取 `.openmatrix/{runId}/approvals/` 下待处理审批
+5. 展示格式化状态概览
 
 ## 输出格式