openmatrix 0.1.55 → 0.1.57

package/skills/start.md

@@ -39,15 +39,24 @@ Step 10: 逐个执行 subagentTasks（调用 Agent 工具）    ← 只有这步
 
 ## === 准备阶段（此阶段不得写任何业务代码）===
 
-### Step 1: 初始化
+### Step 1: 智能检测状态
 
-检查 `.openmatrix/` 目录是否存在，不存在则初始化:
+检查 `.openmatrix/` 目录和 `state.json` 的状态:
+
+| 状态 | 处理方式 |
+|------|---------|
+| `.openmatrix/` 不存在 | 全新初始化: `openmatrix start --init-only` |
+| `status: initialized` | 正常继续（首次使用） |
+| `status: completed` | 提示用户：开始新任务会清理旧数据，确认后继续 |
+| `status: running` | 提示用户先完成或暂停当前任务，然后退出 |
+| `status: paused` | 询问用户：继续上次任务（→`/om:resume`）还是开始新任务 |
+| `status: failed` | 询问用户：重试失败任务（→`/om:retry`）还是开始新任务 |
+
+**如果是全新初始化:**
 ```bash
 openmatrix start --init-only
 ```
 
-读取 `.openmatrix/state.json`，如果 `status === 'running'`，提示用户先完成或暂停。
-
 检查 Git 仓库:
 - 无 `.git` → 询问用户是否初始化
 - 无远程仓库 → 提示用户添加
@@ -87,6 +96,15 @@ AskUserQuestion({
         { label: "fast", description: "无质量门禁" }
       ],
       multiSelect: false
+    },
+    {
+      question: "是否启用 E2E 测试? (Web/Mobile/GUI 项目推荐)",
+      header: "E2E",
+      options: [
+        { label: "跳过 (推荐)", description: "E2E 测试耗时较长，大多数项目不需要" },
+        { label: "启用", description: "适合 Web 应用 (Playwright/Cypress)、Mobile (Appium/Detox)" }
+      ],
+      multiSelect: false
     }
   ]
 })
@@ -113,16 +131,16 @@ AskUserQuestion({
     question: "请选择执行模式:",
     header: "执行模式",
     options: [
-      { label: "每阶段确认", description: "每个阶段完成后暂停" },
-      { label: "关键节点确认", description: "plan/merge/deploy 时暂停" },
-      { label: "全自动执行", description: "无需确认，自动完成" }
+      { label: "全自动执行 (推荐)", description: "无需确认，自动完成" },
+      { label: "关键节点确认", description: "plan/merge 时暂停确认" },
+      { label: "每阶段确认", description: "每个阶段完成后暂停" }
     ],
     multiSelect: false
-  }]
+  ]
 })
 ```
 
-**如果用户选择"全自动执行"，进入 BYPASS 模式（所有操作自动批准）。**
+**默认进入 BYPASS 模式（全自动执行），用户可选其他模式。**
 
 ### Step 6: AI 提取 goals + 生成 plan
 
@@ -150,6 +168,12 @@ AskUserQuestion({
 }
 ```
 
+**E2E 测试:** 如果用户在 Step 4 选择了"启用 E2E"，在 quality 后面加上:
+```
+"e2eTests": true
+```
+这会让 CLI 的 TaskPlanner 在任务拆分时生成额外的 E2E 测试任务。
+
 ### Step 8: 调用 CLI 创建任务 ⚠️ 不可跳过
 
 **必须执行此命令，禁止跳过：**
@@ -174,18 +198,15 @@ CLI 返回 JSON 中 `subagentTasks` 数组包含待执行任务。
 ❌ **禁止在还有未完成任务时停止** — 即使 Agent 返回了大段输出，也必须继续下一个
 ❌ **禁止询问"是否继续"** — 直接执行下一个任务
 ❌ **禁止输出"让我知道是否..."后停止** — 继续执行
-❌ **禁止因为上下文压缩而忘记剩余任务** — 每完成一个任务后，重新读取 state.json 确认剩余任务
+❌ **禁止因为上下文压缩而忘记剩余任务** — 通过 `openmatrix step --json` 重新获取状态
 
-**执行循环伪代码:**
-```
-remaining = subagentTasks 中 status !== 'completed' 的任务
-while (remaining.length > 0) {
-  task = remaining[0]
-  result = Agent(task)           // 执行
-  更新任务状态为 completed
-  remaining = 从 state.json 重新读取未完成任务
-}
+**文件持久化循环（防止上下文压缩丢失状态）:**
+```bash
+# 每个 Agent 完成后执行:
+openmatrix complete TASK-XXX --success       # 标记完成 + 更新统计
+openmatrix step --json                       # 获取下一个任务 + 检查是否全部完成
 ```
+`openmatrix step` 会从磁盘读取真实状态，不依赖上下文记忆。
 </LOOP-ENFORCEMENT>
 
 对每个任务调用 Agent 工具:
@@ -200,7 +221,11 @@ Agent({
 ```
 
 每个 Agent 完成后:
-1. **保存 Agent 上下文** — 将执行结果摘要写入 `.openmatrix/tasks/TASK-XXX/context.md`，格式如下:
+1. **标记完成并更新统计（必须执行）:**
+```bash
+openmatrix complete TASK-XXX --success
+```
+2. **保存 Agent 上下文** — 将执行结果摘要写入 `.openmatrix/tasks/TASK-XXX/context.md`，格式如下:
 
 ```markdown
 ## 任务: TASK-XXX 任务标题
@@ -219,9 +244,14 @@ Agent({
 - [下一个 Agent 应该注意什么]
 ```
 
-2. 更新任务状态: `openmatrix complete <taskId>` 或更新 state
 3. Git 自动提交（必须使用下方统一提交格式）
-4. **立即检查是否还有未完成任务** — 读取 `.openmatrix/state.json` 中的 statistics，如果 completed < totalTasks，继续执行下一个
+4. **获取下一个任务（防止上下文压缩丢失）:**
+```bash
+openmatrix step --json
+```
+如果返回 `status: "next"` → 继续执行返回的 task
+如果返回 `status: "done"` → 所有任务完成，进入最终提交
+如果返回 `status: "blocked"` → 有阻塞任务，处理 Meeting
 5. 检查审批点（auto 模式自动批准，其他模式按配置暂停）
 
 **Agent 上下文共享机制 (Agent Memory):**