openmatrix 0.2.31 → 0.2.34

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,7 +291,7 @@ AskUserQuestion: `header: "E2E 测试"`, `multiSelect: false`
 | `视觉验证` | 需要浏览器可视化验证，可检查页面样式和布局 |
 | `不需要` | 仅进行单元测试和集成测试，节省时间 |
 
-#### 5.3 Agent 执行模式（所有任务类型都需要选择）
+#### 5.3 Agent 执行模式（所有任务类型）
 
 **Agent 执行模式决定任务如何分配和执行，是影响效率的关键决策。**
 
@@ -350,16 +355,22 @@ AskUserQuestion: `header: "Agent 模式"`, `multiSelect: false`
 | 从零搭建系统 | 单 Agent | 架构决策需要一致性 |
 | 添加多个测试文件 | 多 Agent | 测试文件独立，并行快 |
 
-#### 执行模式自动推断
+#### 审批模式自动推断
 
-**执行模式不再通过问答选择，而是根据质量等级自动推断：**
+**审批模式不再通过问答选择，而是根据质量等级自动推断：**
 
-- **严格模式** → 全自动执行 + TDD 流程
-- **平衡模式** → 全自动执行 + 先开发后测试
-- **快速模式** → 全自动执行 + 直接开发
+| 质量等级 | 审批模式 | 执行流程 |
+|---------|---------|---------|
+| 严格模式 | 全自动执行 | TDD（先测试后开发） |
+| 平衡模式 | 全自动执行 | 先开发后测试 |
+| 快速模式 | 全自动执行 | 直接开发 |
 
 **非开发任务**（testing/documentation/other）默认使用「全自动执行」。
 
+**注意**：审批模式（approval mode）和 Agent 模式（agent mode）是两个独立的配置：
+- **审批模式**：决定是否需要用户确认（自动推断，无需问答）
+- **Agent 模式**：决定任务执行方式（并行 vs 串行，Step 5.3 问答选择）
+
 #### 常见借口
 
 | 借口 | 真相 |
@@ -447,7 +458,7 @@ openmatrix start --tasks-json @tasks-input.json --mode auto --parallel --json
 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` 列表。
 
@@ -716,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 模式）:** 记录并跳过，执行完成后统一展示。
 
@@ -818,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. 展示格式化状态概览
 
 ## 输出格式