openmatrix 0.2.26 → 0.2.28

package/skills/start.md

@@ -1,621 +1,758 @@
----
-name: om:start
-description: "Use when starting a new development task cycle with interactive questions. Triggers on TASK-EXECUTION intent: user wants to start implementing a clearly-defined task with full workflow support. Expects plan.md + tasks-input.json to already exist (generated by /om:plan). DO NOT trigger on: vague ideas (use brainstorm), status checks, debugging, or pure questions. Intent signals: user describes a concrete task to build/fix/refactor, has clear goal, or wants to start execution workflow."
----
-
-<INTENT-JUDGMENT>
-## 意图判断指南
-
-**AI 应根据用户语义判断意图：**
-
-### 触发信号（任务执行意图）
-
-- 用户想开始明确的开发任务
-- 任务描述清晰可执行
-- 有具体的功能目标
-- 修复已知 bug（知道要改什么）
-
-### 不触发信号
-
-| 用户意图 | 应调用 |
-|---------|--------|
-| 需求不明确 | /om:brainstorm |
-| 需要生成技术方案 | /om:plan |
-| 调查问题原因 | /om:debug |
-| 查看进度 | /om:status |
-
-### 示例判断
-
-| 用户消息 | 判断 | 结果 |
-|---------|------|------|
-| "开始实现登录功能" | 任务执行意图 | 触发 |
-| "修复这个 bug"（明确位置）| 执行意图明确 | 触发 |
-| "重构 API 模块" | 任务意图 | 触发 |
-| "登录怎么设计" | 设计意图 | /om:brainstorm |
-| "生成技术方案" | 方案生成 | /om:plan |
-| "为什么出错了" | 调查意图 | /om:debug |
-</INTENT-JUDGMENT>
-
-<NO-OTHER-SKILLS>
-**绝对禁止**调用以下任何技能或工具：
-- gsd-executor、gsd:* 等 GSD 相关技能
-- superpowers:* 等 superpowers 相关技能
-- 任何其他任务编排相关的 Agent 或工具
-
-**Step 9 只能使用 Agent 工具** — 直接调用 Agent，不通过任何中间层。
-
-违规调用将导致执行失败。
-
-**相关技能**: `/om:brainstorm` (需求探索) | `/om:plan` (方案生成) | `/om:auto` (全自动) | `/om:meeting` (阻塞处理) | `/om:status` (状态查看) | `/om:report` (报告)
-</NO-OTHER-SKILLS>
-
-<MANDATORY-EXECUTION-ORDER>
-## 执行顺序 - 必须严格按此顺序，不得跳过任何步骤
-
-```
-Step 1:  初始化 .openmatrix 目录
-Step 2:  验证前置条件（plan.md + tasks-input.json 必须已存在）
-Step 3:  智能分析任务类型（开发/非开发）
-Step 4:  提交文档（git add docs/ + 所有 .md 文件, commit）
-Step 5:  必选问题（开发任务:质量等级; 严格模式可选E2E; 非开发:跳过）<- 不可跳过
-Step 6:  可选问题（仅复杂开发任务）+ 展示执行计划
-Step 7:  调用 openmatrix start --tasks-json                <- 必须完成，不可跳过
-Step 8:  从 CLI 返回结果中读取 subagentTasks 列表           <- 必须完成
-Step 9:  逐个执行 subagentTasks（调用 Agent 工具）          <- 只有这步才能写代码
-```
-
-**违反以下任一规则将导致任务执行失败：**
-
-- **禁止在 Step 9 之前写任何业务代码** — 所有代码必须在 Step 9 通过 Agent 执行
-- **禁止跳过 Step 5 必选问题** — 开发任务必须选质量等级，非开发任务无需问答
-- **禁止跳过 Step 7** — 必须调用 CLI，不能用其他方式代替
-- **禁止自行规划 Phase** — 任务由 CLI 的 TaskPlanner 拆分，AI 只提取 goals
-- **禁止用 Bash/npm/write 直接写业务代码** — 业务代码只能通过 Step 9 的 Agent 执行
-- **禁止调用 gsd-executor 或其他编排技能** — 必须用原生 Agent 工具
-- **禁止在 start 中生成 plan** — plan 由 /om:plan 生成，start 只负责执行
-</MANDATORY-EXECUTION-ORDER>
-
-<objective>
-读取已有的 plan.md + tasks-input.json，通过必选问答确定执行配置（开发任务还需确定质量等级、E2E测试），确认后通过 CLI 拆分任务并执行。
-
-本 Skill 只做执行，不做方案生成。如果 plan.md 或 tasks-input.json 不存在，引导用户先执行 /om:plan。
-
-**Step 5 必选问题（开发任务）：**
-1. 质量等级（严格模式/平衡模式/快速模式）
-2. E2E 测试（仅严格模式可选，其他模式自动跳过）
-3. 执行模式根据质量等级自动推断（无需问答）
-
-**非开发任务**（文档、配置等）无需问答，直接使用全自动执行。
-</objective>
-
-<process>
-
-## === 准备阶段（此阶段不得写任何业务代码）===
-
-### Step 1: 智能检测状态
-
-检查 `.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
-```
-
-**检查 Git 仓库（必须执行，不可跳过）：**
-
-```bash
-# 检查是否有 .git 目录（必须执行此命令）
-ls -la .git 2>/dev/null || echo "NOT_INITIALIZED"
-```
-
-**根据检查结果处理：**
-
-| 检查结果 | 必须执行的操作 |
-|---------|--------------|
-| 目录不存在 | 使用 AskUserQuestion 询问用户是否初始化 git |
-| 目录存在 | 继续检查远程仓库 |
-
-**如果用户同意初始化，立即执行：**
-```bash
-git init
-```
-
-### Step 2: 验证前置条件
-
-**检查 plan.md 和 tasks-input.json 是否已存在：**
-
-```bash
-cat .openmatrix/tasks-input.json 2>/dev/null || echo "NOT_FOUND"
-cat .openmatrix/plan.md 2>/dev/null || echo "NOT_FOUND"
-```
-
-| 情况 | 处理方式 |
-|------|---------|
-| 两个都存在 | 读取内容，继续 Step 3 |
-| 只有 tasks-input.json | 继续执行（plan.md 可选） |
-| 只有 plan.md | 提示：需要 tasks-input.json，引导执行 `/om:plan` |
-| 都不存在，有 `$ARGUMENTS` | 自动调用 `/om:plan` 生成方案（传入参数） |
-| 都不存在，无参数 | 引导执行 `/om:plan` |
-
-**如果都存在，读取 tasks-input.json：**
-
-```bash
-cat .openmatrix/tasks-input.json
-```
-
-提取关键字段：`title`、`goals`、`goalTypes`、`goalComplexity`。
-
-**检测研究上下文：**
-
-```bash
-cat .openmatrix/research/context.json 2>/dev/null || echo "NO_RESEARCH"
-```
-
-如果检测到研究上下文，告知用户并将 `--research-context` 参数传递给 CLI。
-
-### Step 3: 智能分析任务类型
-
-根据 `goalTypes` 字段判断是开发任务还是非开发任务，这决定 Step 5 需要问哪些问题。
-
-| 任务类型 | 定义 | Step 5 问题 |
-|---------|------|------------|
-| **开发任务** | goalTypes 包含 `development` | 质量等级 + E2E + 执行模式 |
-| **非开发任务** | goalTypes 仅有 `testing`/`documentation`/`other` | 仅执行模式 |
-
----
-
-### Step 4: 提交文档（必须执行，不可跳过）
-
-在开始任何新任务之前，先提交所有已变更的文档文件，确保文档和代码同步提交。
-
-```bash
-git status --porcelain
-```
-
-检查是否有文档变更（包括 `docs/` 目录、所有 `.md` 文件）：
-
-```bash
-git diff --name-only | grep -E '\.md$|^docs/' 2>/dev/null
-git ls-files --others --exclude-standard | grep -E '\.md$|^docs/' 2>/dev/null
-```
-
-如果有文档变更（未追踪或未提交），执行提交：
-
-```bash
-git add docs/ .openmatrix/*.md CLAUDE.md README.md README_EN.md
-git commit -m "$(cat <<'EOF'
-docs: 更新项目文档
-
-更新内容: ...
-
-Co-Authored-By: OpenMatrix https://github.com/bigfish1913/openmatrix
-EOF
-)"
-```
-
-**如果没有文档变更，跳过此步骤继续。**
-
----
-
-### Step 5: 必选问题（不可跳过，不可使用默认值，必须通过 AskUserQuestion 让用户选择）
-
-根据 `goalTypes` 字段判断需要询问哪些问题：
-
-| goalTypes | 需要询问 |
-|-----------|---------|
-| `development` | 5.1 质量等级 -> 5.2 E2E（仅严格模式可选） |
-| `testing` | 无需问答，直接进入 Step 7 |
-| `documentation` / `other` | 无需问答，直接进入 Step 7 |
-
-#### 5.1 质量等级（仅 `goalTypes: development`）
-
-AskUserQuestion: `header: "质量等级"`, `multiSelect: false`
-
-**question:** 选择质量等级（决定测试覆盖、Lint、安全扫描等要求）
-
-| label | description |
-|-------|-------------|
-| `严格模式` | TDD + >80%覆盖率 + 严格Lint + 安全扫描 — 生产级代码 |
-| `平衡模式 (推荐)` | >60%覆盖率 + Lint + 安全扫描 — 日常开发 |
-| `快速模式` | 无质量门禁 — 快速原型/验证 |
-
-**质量等级选择后的自动推断规则：**
-
-| 模式 | E2E | AI 验收 | 执行方式 |
-|-----|-----|---------|---------|
-| 严格模式 | 可选问一句（Step 5.2） | 必须 | TDD（先测试后开发） |
-| 平衡模式 | 不需要（自动跳过） | 必须 | 先开发后测试 |
-| 快速模式 | 不需要（自动跳过） | 不需要 | 直接开发 |
-
-#### 5.2 E2E 测试（仅 `严格模式` 可选，其他模式自动跳过）
-
-**只有选择「严格模式」时才询问此问题，平衡模式和快速模式自动推断为「不需要」。**
-
-AskUserQuestion: `header: "E2E 测试"`, `multiSelect: false`
-
-**question:** 是否需要端到端 (E2E) 测试？（适用于 Web/Mobile/GUI 项目，耗时较长）
-
-| label | description |
-|-------|-------------|
-| `功能测试 (推荐)` | 验证业务流程正确性，无需浏览器可视化，速度快 |
-| `视觉验证` | 需要浏览器可视化验证，可检查页面样式和布局 |
-| `不需要` | 仅进行单元测试和集成测试，节省时间 |
-
-#### 执行模式自动推断
-
-**执行模式不再通过问答选择，而是根据质量等级自动推断：**
-
-- **严格模式** → 全自动执行 + TDD 流程
-- **平衡模式** → 全自动执行 + 先开发后测试
-- **快速模式** → 全自动执行 + 直接开发
-
-**非开发任务**（testing/documentation/other）默认使用「全自动执行」。
-
-### Step 6: 可选问题（仅复杂任务）
-
-根据任务类型，可能需要额外询问:
-
-- 技术栈偏好
-- 文档级别
-- 风险评估
-- 验收标准
-
-展示执行计划:
-
-```
-执行计划
-
-Goals:
-  1. [development/high] 目标1
-  2. [development/medium] 目标2
-  3. [testing/medium] 目标3
-
-统计
-  Goals: N 个（将生成 N个开发 + N个测试 + 审查）
-  质量级别: xxx
-  E2E 测试: 功能测试 / 视觉验证 / 不启用
-  技术方案: .openmatrix/plan.md
-```
-
-### Step 7: 调用 CLI 创建任务（不可跳过）
-
-**根据质量等级自动设置执行参数：**
-
-| 质量等级 | CLI 参数 | 执行方式 |
-|---------|---------|---------|
-| 严格模式 | `--quality strict --mode auto` | TDD 流程 |
-| 平衡模式 | `--quality balanced --mode auto` | 先开发后测试 |
-| 快速模式 | `--quality fast --mode auto` | 直接开发 |
-
-**开发任务**（有质量等级选择）：
-```bash
-openmatrix start --tasks-json @.openmatrix/tasks-input.json --quality <质量等级> --mode auto --json
-```
-
-如果存在 `.openmatrix/research/context.json`，增加 `--research-context` 参数：
-```bash
-openmatrix start --tasks-json @.openmatrix/tasks-input.json --research-context @.openmatrix/research/context.json --quality <质量等级> --mode auto --json
-```
-
-如果启用了 E2E 测试（功能测试），加上 `--e2e-tests`：
-```bash
-openmatrix start --tasks-json @.openmatrix/tasks-input.json --quality strict --mode auto --e2e-tests --json
-```
-
-如果选择了视觉验证，加上 `--e2e-tests --e2e-type visual`：
-```bash
-openmatrix start --tasks-json @.openmatrix/tasks-input.json --quality strict --mode auto --e2e-tests --e2e-type visual --json
-```
-
-**非开发任务**（无质量等级，默认全自动执行）：
-```bash
-openmatrix start --tasks-json @.openmatrix/tasks-input.json --mode auto --json
-```
-
-此命令返回 JSON 包含 `subagentTasks` 列表。
-
-### Step 8: 读取 subagentTasks
-
-CLI 返回 JSON 中 `subagentTasks` 数组包含待执行任务。
-
-## === 执行阶段（只有此阶段才能写业务代码）===
-
-### Step 9: 逐个执行 subagentTasks（禁止中断）
-
-<LOOP-ENFORCEMENT>
-**此步骤是执行循环，必须执行完所有任务后才能停止。**
-
-- **禁止在还有未完成任务时停止** — 即使 Agent 返回了大段输出，也必须继续下一个
-- **禁止询问"是否继续"** — 直接执行下一个任务
-- **禁止输出"让我知道是否..."后停止** — 继续执行
-- **禁止因为上下文压缩而忘记剩余任务** — 通过 `openmatrix step --json` 重新获取状态
-
-**文件持久化循环（防止上下文压缩丢失状态）:**
-```bash
-# 每个 Agent 完成后执行:
-# --summary 传入执行摘要，自动追加到全局 context.md
-openmatrix complete TASK-XXX --success --summary "决策: xxx; 文件: xxx"
-
-# 提交验证（防止 commit 静默失败）:
-git status --porcelain                        # 检查是否有未提交的文件
-# 如果有未提交文件 -> 必须手动提交:
-git add . && git commit -m "feat(TASK-XXX): 任务标题"
-
-openmatrix step --json                       # 获取下一个任务 + 检查是否全部完成
-```
-`openmatrix step` 会从磁盘读取真实状态，不依赖上下文记忆。
-</LOOP-ENFORCEMENT>
-
-#### 9.1 歧义检测机制
-
-**Agent 输出中可能包含歧义报告（JSON 格式）:**
-
-当 Agent 输出包含以下标记时，表示检测到歧义：
-```
-<AMBIGUITY_REPORT>
-{
-  "ambiguities": [
-    {
-      "type": "missing_info" | "conflicting_req" | "unclear_scope" | "tech_choice" | "edge_case",
-      "severity": "critical" | "high" | "medium" | "low",
-      "description": "歧义描述",
-      "suggestions": ["建议1", "建议2"]
-    }
-  ],
-  "overallSeverity": "critical" | "high" | "medium" | "low"
-}
-</AMBIGUITY_REPORT>
-```
-
-#### 9.2 歧义处理策略
-
-根据 `overallSeverity` 和执行模式选择处理方式：
-
-| 执行模式 | Critical/High | Medium/Low |
-|---------|--------------|------------|
-| **全自动执行** | Meeting + 继续执行 | Meeting + 继续执行 |
-| **关键节点确认** | AskUserQuestion | Meeting + 继续执行 |
-| **每阶段确认** | AskUserQuestion | Meeting + 继续执行 |
-
-**Meeting 处理（写入阻塞记录）:**
-```bash
-openmatrix meeting --create --task TASK-XXX --reason "歧义: ${description}" --severity ${severity}
-```
-
-**AskUserQuestion 处理（交互确认）:**
-
-AskUserQuestion: `header: "歧义确认"`, `multiSelect: false`
-**question:** 检测到 ${severity} 级歧义：${description}。请确认处理方式
-
-| label | description |
-|-------|-------------|
-| 提供信息 | 回答歧义相关问题，继续执行 |
-| 跳过任务 | 标记当前任务为可选，继续执行其他任务 |
-| 修改方案 | 根据歧义调整任务方案后继续 |
-
-#### 9.3 执行 Agent 任务
-
-**Skill 感知执行：**
-
-执行每个任务前，AI 应根据任务内容判断是否需要调用相关 skill 来增强执行质量。
-
-可用 skill 列表（AI 自行判断是否适用）：
-- `om:test` — 测试生成与验证循环
-- `frontend-design` — 前端/UI 设计与实现
-- `om:research` — 领域研究
-- 其他已安装的 skill
-
-**判断流程：**
-1. 读取任务的 `agentType`、`title`、`description`
-2. AI 自行判断该任务是否匹配某个 skill 的触发条件
-3. 如果匹配，在 Agent prompt 中注入该 skill 的核心指令或先调用对应 CLI 获取上下文数据
-4. 如果不匹配任何 skill，直接执行
-
-**tester 任务验证循环（om:test 逻辑）：**
-
-当 AI 判断任务需要 om:test 流程时：
-
-1. 先调用 CLI 获取项目测试配置：
-```bash
-openmatrix test --json
-```
-
-2. 调用 Agent 生成测试（prompt 中已包含原始扫描数据）：
-```typescript
-Agent({
-  subagent_type: task.subagent_type,
-  description: task.description,
-  prompt: task.prompt + "\n\n⚠️ 完成后请输出简短摘要（不超过3行）：\n1. 关键决策\n2. 创建/修改的文件\n3. 对后续任务的建议\n\n🚫 **禁止执行以下 Git 命令**：\n- ❌ git commit\n- ❌ git checkout/merge/pull/push/rebase/branch\n\n✅ 允许：git status, git diff, git log",
-  run_in_background: true
-})
-```
-
-3. Agent 完成后，自动验证测试：
-```bash
-npm test -- --run 2>&1
-```
-
-4. 验证失败时自动重试（最多 3 次）：
-   - 将失败输出传给新 Agent 修复测试
-   - 重新验证
-   - 3 次失败后标记为 blocked，创建 Meeting
-
-**默认执行方式（无特殊 skill 匹配时）：**
-
-```typescript
-Agent({
-  subagent_type: task.subagent_type,
-  description: task.description,
-  prompt: task.prompt + "\n\n⚠️ 完成后请输出简短摘要（不超过3行）：\n1. 关键决策\n2. 创建/修改的文件\n3. 对后续任务的建议\n\n🚫 **禁止执行以下 Git 命令**：\n- ❌ git commit — 所有提交统一通过 openmatrix complete 执行\n- ❌ git checkout — 不要切换分支\n- ❌ git merge — 不要合并其他分支\n- ❌ git pull — 不要拉取远程更新\n- ❌ git push — 不要推送代码\n- ❌ git rebase — 不要变基\n- ❌ git branch — 不要创建/删除分支\n\n✅ 允许：git status, git diff, git log",
-  isolation: task.isolation,
-  run_in_background: true
-})
-```
-
-每个 Agent 完成后（收到后台完成通知时）:
-1. **标记完成并更新统计（必须执行）:**
-```bash
-openmatrix complete TASK-XXX --success --summary "关键决策: xxx; 创建文件: xxx"
-```
-
-2. **全局上下文文件** — 所有任务的上下文累积在 `.openmatrix/context.md`:
-   - 每次任务完成后，通过 `--summary` 参数追加写入
-   - 后续 Agent 可读取此文件了解前序任务的决策和发现
-
-3. Git 自动提交（必须使用下方统一提交格式）
-
-4. **获取下一个任务（必须执行，防止上下文压缩丢失）:**
-```bash
-openmatrix step --json
-```
-
-**返回值解析：**
-
-| status | 含义 | 后续操作 |
-|--------|------|---------|
-| `next` | 有下一个任务 | 继续执行返回的 `subagent` 配置 |
-| `done` | 所有任务完成 | 进入最终提交 |
-| `blocked` | 无可执行任务 | 检查是否有 Meeting，用 `/om:meeting` 处理 |
-
-5. **审批点处理（根据执行模式）:**
-
-| 执行模式 | 审批点 | 处理方式 |
-|---------|--------|---------|
-| 全自动执行 | 无 | 自动批准所有操作 |
-| 关键节点确认 | plan, merge, deploy | 到达审批点时暂停，交互式确认 |
-| 每阶段确认 | develop, verify, accept | 每个阶段完成后暂停，交互式确认 |
-
-**Agent 上下文共享机制 (Agent Memory):**
-
-每个 Agent 执行时会自动接收前序 Agent 的上下文信息（通过 `context.md` 文件）。
-
-```
-Agent-1 完成 -> 写入 context.md -> Agent-2 读取 Agent-1 的上下文 -> 写入 context.md -> ...
-```
-
-**中断恢复:** 如果会话中断，再次执行 `/om:start` 时:
-1. 读取 `.openmatrix/state.json`
-2. 如果 `status === 'running'`，读取所有任务，找到 status 不是 completed 的任务
-3. 从中断的任务继续执行，不需要重新开始
-
-**Meeting 处理（auto 模式）:** 记录并跳过，执行完成后统一展示。
-
-**执行完成后:**
-
-### Meeting 机制
-
-在「全自动执行」模式下:
-- 遇到阻塞任务时，创建 Meeting 记录并跳过该任务
-- 继续执行其他独立任务，最大化并行度
-- 所有非阻塞任务完成后，提示用户使用 `/om:meeting` 统一处理阻塞问题
-
-```bash
-openmatrix meeting --list
-```
-
-如有 pending Meeting，交互式处理。
-
-所有任务完成后，执行最终 Git 提交（**必须使用 HEREDOC 格式**）:
-```bash
-git add . && git commit -m "$(cat <<'EOF'
-feat: 完成所有任务 - 任务总标题
-
-改动点1
-改动点2
-
-影响范围: 全部模块
-文件改动: src/xxx.ts, src/yyy.ts
-
-Co-Authored-By: OpenMatrix https://github.com/bigfish1913/openmatrix
-EOF
-)"
-```
-
-**Git 提交格式规范（所有提交必须遵守）:**
-
-```
-<type>(TASK-XXX): 简短描述
-
-改动点1
-改动点2
-
-影响范围: 模块名
-文件改动: 文件1, 文件2
-
-Co-Authored-By: OpenMatrix https://github.com/bigfish1913/openmatrix
-```
-
-**type 映射:** feat(新功能) / fix(修复) / test(测试) / refactor(重构) / docs(文档)
-**禁止使用 emoji**，使用纯文本格式
-
-</process>
-
-<arguments>
-$ARGUMENTS
-</arguments>
-
-<examples>
-/om:start
-/om:start "实现用户登录功能"
-</examples>
-
-<notes>
-## 流程定位
-
-```
-需求 -> brainstorm (澄清需求) -> plan (生成方案) -> start (执行) -> end
-需求 -> brainstorm (澄清需求) -> plan (生成方案) -> auto (全自动执行) -> end
-```
-
-start 和 auto 在同一位置，区别在于 start 有交互审批，auto 零交互。前置条件：
-- `.openmatrix/plan.md` — 技术方案（由 /om:plan 生成）
-- `.openmatrix/tasks-input.json` — 结构化元数据（由 /om:plan 生成）
-
-如果前置条件不满足，引导用户执行 `/om:plan`。
-
-## 质量级别
-
-| 级别 | TDD | 覆盖率 | Lint | 安全 | 执行方式 |
-|------|:---:|:------:|:----:|:----:|:--------:|
-| 严格模式 | Y | >80% | Y | Y | TDD |
-| 平衡模式 | N | >60% | Y | Y | 先开发后测试 |
-| 快速模式 | N | 无 | N | N | 直接开发 |
-
-## 执行流程
-
-```
-Step 1-2: 初始化 + 验证前置条件 -> Step 3-4: 分析类型 + 提交文档 -> Step 5-6: 问答 + 确认
--> Step 7: openmatrix start --tasks-json (必须) -> Step 8: 读取 subagentTasks
--> Step 9: Agent 逐个执行 (只有这里写代码)
-```
-
-## 自动推断规则
-
-| 质量等级 | E2E 问题 | AI 验收 | 执行模式 |
-|---------|---------|---------|---------|
-| 严格模式 | 可选问一句 | 必须 | 全自动 + TDD |
-| 平衡模式 | 不需要 | 必须 | 全自动 + 先开发后测试 |
-| 快速模式 | 不需要 | 不需要 | 全自动 + 直接开发 |
-
-## Git 提交格式
-
-```
-<type>(TASK-XXX): 简短描述
-
-改动点1 / 改动点2
-影响范围: 模块名
-文件改动: 文件1, 文件2
-Co-Authored-By: OpenMatrix https://github.com/bigfish1913/openmatrix
-```
-
-type: feat/fix/test/refactor/docs。禁止 emoji。
-</notes>
+---
+name: om:start
+description: "Use when starting a new development task cycle with interactive questions. Triggers on TASK-EXECUTION intent: user wants to start implementing a clearly-defined task with full workflow support. Expects plan.md + tasks-input.json to already exist (generated by /om:plan). DO NOT trigger on: vague ideas (use brainstorm), status checks, debugging, or pure questions. Intent signals: user describes a concrete task to build/fix/refactor, has clear goal, or wants to start execution workflow."
+---
+
+<INTENT-JUDGMENT>
+## 意图判断指南
+
+**AI 应根据用户语义判断意图：**
+
+### 触发信号（任务执行意图）
+
+- 用户想开始明确的开发任务
+- 任务描述清晰可执行
+- 有具体的功能目标
+- 修复已知 bug（知道要改什么）
+
+### 不触发信号
+
+| 用户意图 | 应调用 |
+|---------|--------|
+| 需求不明确 | /om:brainstorm |
+| 需要生成技术方案 | /om:plan |
+| 调查问题原因 | /om:debug |
+| 查看进度 | /om:status |
+
+### 示例判断
+
+| 用户消息 | 判断 | 结果 |
+|---------|------|------|
+| "开始实现登录功能" | 任务执行意图 | 触发 |
+| "修复这个 bug"（明确位置）| 执行意图明确 | 触发 |
+| "重构 API 模块" | 任务意图 | 触发 |
+| "登录怎么设计" | 设计意图 | /om:brainstorm |
+| "生成技术方案" | 方案生成 | /om:plan |
+| "为什么出错了" | 调查意图 | /om:debug |
+</INTENT-JUDGMENT>
+
+<NO-OTHER-SKILLS>
+本 skill 与其他任务编排技能功能重叠，请勿同时使用。
+
+**Step 9 使用 Agent 工具执行子任务。**
+
+**相关技能**: `/om:brainstorm` (需求探索) | `/om:plan` (方案生成) | `/om:auto` (全自动) | `/om:meeting` (阻塞处理) | `/om:status` (状态查看) | `/om:report` (报告)
+</NO-OTHER-SKILLS>
+
+<MANDATORY-EXECUTION-ORDER>
+## 执行顺序 - 必须严格按此顺序，不得跳过任何步骤
+
+```
+Step 1:  初始化 .openmatrix 目录
+Step 2:  验证前置条件（plan.md + tasks-input.json 必须已存在）
+Step 3:  智能分析任务类型（开发/非开发）
+Step 4:  提交文档（git add docs/ + 所有 .md 文件, commit）
+Step 5:  必选问题（开发任务:质量等级; 严格模式可选E2E; 非开发:跳过）<- 不可跳过
+Step 6:  可选问题（仅复杂开发任务）+ 展示执行计划
+Step 7:  调用 openmatrix start --tasks-json                <- 必须完成，不可跳过
+Step 8:  从 CLI 返回结果中读取 subagentTasks 列表           <- 必须完成
+Step 9:  逐个执行 subagentTasks（调用 Agent 工具）          <- 只有这步才能写代码
+```
+
+**违反以下任一规则将导致任务执行失败：**
+
+- **禁止在 Step 9 之前写任何业务代码** — 所有代码必须在 Step 9 通过 Agent 执行
+- **禁止跳过 Step 5 必选问题** — 开发任务必须选质量等级，非开发任务无需问答
+- **禁止跳过 Step 7** — 必须调用 CLI，不能用其他方式代替
+- **禁止自行规划 Phase** — 任务由 CLI 的 TaskPlanner 拆分，AI 只提取 goals
+- **禁止用 Bash/npm/write 直接写业务代码** — 业务代码只能通过 Step 9 的 Agent 执行
+- **禁止在 start 中生成 plan** — plan 由 /om:plan 生成，start 只负责执行
+- **使用 Agent 工具执行子任务** — 不通过其他编排系统
+</MANDATORY-EXECUTION-ORDER>
+
+<IRON-LAW>
+
+**NO PRODUCTION CODE WITHOUT QUALITY GATES FIRST**
+
+跳过了必选问题？停止。重新开始。
+写了代码但没跑测试？删除。重新开始。
+这不是建议。这是铁律。
+
+</IRON-LAW>
+
+<RED-FLAGS>
+
+这些想法意味着停止：
+
+| 想法 | 真相 |
+|-----|------|
+| "先写代码，测试稍后" | 跳过铁律 = 质量无保证 |
+| "这个任务很简单" | 简单任务也要质量门禁 |
+| "手动验证就够了" | 手动验证不可重复 |
+| "质量级别不重要" | 质量级别决定代码可信度 |
+| "跳过问答更快" | 跳过问答 = 跳过铁律 |
+| "我知道该选什么" | 必选问题不可跳过 |
+| "执行模式无所谓" | 执行模式决定审批节点 |
+
+</RED-FLAGS>
+
+<objective>
+读取已有的 plan.md + tasks-input.json，通过必选问答确定执行配置（开发任务还需确定质量等级、E2E测试），确认后通过 CLI 拆分任务并执行。
+
+本 Skill 只做执行，不做方案生成。如果 plan.md 或 tasks-input.json 不存在，引导用户先执行 /om:plan。
+
+**Step 5 必选问题（开发任务）：**
+1. 质量等级（严格模式/平衡模式/快速模式）
+2. E2E 测试（仅严格模式可选，其他模式自动跳过）
+3. 执行模式根据质量等级自动推断（无需问答）
+
+**非开发任务**（文档、配置等）无需问答，直接使用全自动执行。
+</objective>
+
+<process>
+
+## === 准备阶段（此阶段不得写任何业务代码）===
+
+### Step 1: 智能检测状态
+
+检查 `.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
+```
+
+**检查 Git 仓库（必须执行，不可跳过）：**
+
+```bash
+# 检查是否有 .git 目录（必须执行此命令）
+ls -la .git 2>/dev/null || echo "NOT_INITIALIZED"
+```
+
+**根据检查结果处理：**
+
+| 检查结果 | 必须执行的操作 |
+|---------|--------------|
+| 目录不存在 | 使用 AskUserQuestion 询问用户是否初始化 git |
+| 目录存在 | 继续检查远程仓库 |
+
+**如果用户同意初始化，立即执行：**
+```bash
+git init
+```
+
+### Step 2: 验证前置条件
+
+**先获取当前 runId：**
+```bash
+cat .openmatrix/current.json 2>/dev/null || echo '{"runId":"run-default"}'
+```
+
+从返回结果提取 `runId`，后续文件检测和读取都使用 `.openmatrix/{runId}/` 目录。
+
+**检查 plan.md 和 tasks-input.json 是否已存在（使用 runId）：**
+
+```bash
+cat .openmatrix/${runId}/tasks-input.json 2>/dev/null || echo "NOT_FOUND"
+cat .openmatrix/${runId}/plan.md 2>/dev/null || echo "NOT_FOUND"
+```
+
+**或通过 CLI 检查（推荐）：**
+```bash
+openmatrix status --json | jq '.files'
+```
+
+返回 `{hasPlan: true, hasTasksInput: true, hasResearchContext: false}` 等。
+
+| 情况 | 处理方式 |
+|------|---------|
+| 两个都存在 | 读取内容，继续 Step 3 |
+| 只有 tasks-input.json | 继续执行（plan.md 可选） |
+| 只有 plan.md | 提示：需要 tasks-input.json，引导执行 `/om:plan` |
+| 都不存在，有 `$ARGUMENTS` | 自动调用 `/om:plan` 生成方案（传入参数） |
+| 都不存在，无参数 | 引导执行 `/om:plan` |
+
+**如果都存在，读取 tasks-input.json：**
+
+```bash
+cat .openmatrix/${runId}/tasks-input.json
+```
+
+提取关键字段：`title`、`goals`、`goalTypes`、`goalComplexity`。
+
+**检测研究上下文：**
+
+```bash
+cat .openmatrix/${runId}/research/context.json 2>/dev/null || echo "NO_RESEARCH"
+```
+
+如果检测到研究上下文，告知用户并将 `--research-context` 参数传递给 CLI。
+
+### Step 3: 智能分析任务类型
+
+根据 `goalTypes` 字段判断是开发任务还是非开发任务，这决定 Step 5 需要问哪些问题。
+
+| 任务类型 | 定义 | Step 5 问题 |
+|---------|------|------------|
+| **开发任务** | goalTypes 包含 `development` | 质量等级 + E2E + 执行模式 |
+| **非开发任务** | goalTypes 仅有 `testing`/`documentation`/`other` | 仅执行模式 |
+
+---
+
+### Step 4: 提交文档（必须执行，不可跳过）
+
+在开始任何新任务之前，先提交所有已变更的文档文件，确保文档和代码同步提交。
+
+```bash
+git status --porcelain
+```
+
+检查是否有文档变更（包括 `docs/` 目录、所有 `.md` 文件）：
+
+```bash
+git diff --name-only | grep -E '\.md$|^docs/' 2>/dev/null
+git ls-files --others --exclude-standard | grep -E '\.md$|^docs/' 2>/dev/null
+```
+
+如果有文档变更（未追踪或未提交），执行提交：
+
+```bash
+git add docs/ CLAUDE.md README.md README_EN.md
+# 注意：plan.md 和 tasks-input.json 在 .openmatrix/{runId}/ 目录，被 gitignore，不提交
+git commit -m "$(cat <<'EOF'
+docs: 更新项目文档
+
+更新内容: ...
+
+Co-Authored-By: OpenMatrix https://github.com/bigfish1913/openmatrix
+EOF
+)"
+```
+
+**如果没有文档变更，跳过此步骤继续。**
+
+---
+
+### Step 5: 必选问题（不可跳过，不可使用默认值，必须通过 AskUserQuestion 让用户选择）
+
+根据 `goalTypes` 字段判断需要询问哪些问题：
+
+| goalTypes | 需要询问 |
+|-----------|---------|
+| `development` | 5.1 质量等级 -> 5.2 E2E（仅严格模式可选） |
+| `testing` | 无需问答，直接进入 Step 7 |
+| `documentation` / `other` | 无需问答，直接进入 Step 7 |
+
+#### 5.1 质量等级（仅 `goalTypes: development`）
+
+AskUserQuestion: `header: "质量等级"`, `multiSelect: false`
+
+**question:** 选择质量等级（决定测试覆盖、Lint、安全扫描等要求）
+
+| label | description |
+|-------|-------------|
+| `严格模式` | TDD + >80%覆盖率 + 严格Lint + 安全扫描 — 生产级代码 |
+| `平衡模式 (推荐)` | >60%覆盖率 + Lint + 安全扫描 — 日常开发 |
+| `快速模式` | 无质量门禁 — 快速原型/验证 |
+
+**质量等级选择后的自动推断规则：**
+
+| 模式 | E2E | AI 验收 | 执行方式 |
+|-----|-----|---------|---------|
+| 严格模式 | 可选问一句（Step 5.2） | 必须 | TDD（先测试后开发） |
+| 平衡模式 | 不需要（自动跳过） | 必须 | 先开发后测试 |
+| 快速模式 | 不需要（自动跳过） | 不需要 | 直接开发 |
+
+#### 5.2 E2E 测试（仅 `严格模式` 可选，其他模式自动跳过）
+
+**只有选择「严格模式」时才询问此问题，平衡模式和快速模式自动推断为「不需要」。**
+
+AskUserQuestion: `header: "E2E 测试"`, `multiSelect: false`
+
+**question:** 是否需要端到端 (E2E) 测试？（适用于 Web/Mobile/GUI 项目，耗时较长）
+
+| label | description |
+|-------|-------------|
+| `功能测试 (推荐)` | 验证业务流程正确性，无需浏览器可视化，速度快 |
+| `视觉验证` | 需要浏览器可视化验证，可检查页面样式和布局 |
+| `不需要` | 仅进行单元测试和集成测试，节省时间 |
+
+#### 执行模式自动推断
+
+**执行模式不再通过问答选择，而是根据质量等级自动推断：**
+
+- **严格模式** → 全自动执行 + TDD 流程
+- **平衡模式** → 全自动执行 + 先开发后测试
+- **快速模式** → 全自动执行 + 直接开发
+
+**非开发任务**（testing/documentation/other）默认使用「全自动执行」。
+
+#### 常见借口
+
+| 借口 | 真相 |
+|-----|------|
+| "只是个小功能，不用问这么多" | 小功能也要质量门禁 |
+| "我知道该选什么级别" | 必选问题不可跳过 |
+| "E2E测试浪费时间" | E2E测试由你决定，不是默认跳过 |
+| "我会手动检查代码" | AI验收比手动检查更系统 |
+| "这太复杂了，简化流程" | 流程设计有目的，简化=降低质量 |
+
+### Step 6: 可选问题（仅复杂任务）
+
+根据任务类型，可能需要额外询问:
+
+- 技术栈偏好
+- 文档级别
+- 风险评估
+- 验收标准
+
+展示执行计划:
+
+```
+执行计划
+
+Goals:
+  1. [development/high] 目标1
+  2. [development/medium] 目标2
+  3. [testing/medium] 目标3
+
+统计
+  Goals: N 个（将生成 N个开发 + N个测试 + 审查）
+  质量级别: xxx
+  E2E 测试: 功能测试 / 视觉验证 / 不启用
+  技术方案: .openmatrix/{runId}/plan.md
+```
+
+### Step 7: 调用 CLI 创建任务（不可跳过）
+
+**CLI 自动从当前 runId 目录读取 tasks-input.json 和 plan.md。**
+
+**根据质量等级自动设置执行参数：**
+
+| 质量等级 | CLI 参数 | 执行方式 |
+|---------|---------|---------|
+| 严格模式 | `--quality strict --mode auto` | TDD 流程 |
+| 平衡模式 | `--quality balanced --mode auto` | 先开发后测试 |
+| 快速模式 | `--quality fast --mode auto` | 直接开发 |
+
+**开发任务**（有质量等级选择）：
+```bash
+openmatrix start --tasks-json @tasks-input.json --quality <质量等级> --mode auto --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
+```
+
+如果启用了 E2E 测试（功能测试），加上 `--e2e-tests`：
+```bash
+openmatrix start --tasks-json @tasks-input.json --quality strict --mode auto --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
+```
+
+**非开发任务**（无质量等级，默认全自动执行）：
+```bash
+openmatrix start --tasks-json @tasks-input.json --mode auto --json
+```
+
+**注意**: `@tasks-input.json` 表示 CLI 自动从当前 runId 目录读取。CLI 会自动检测 `current.json` 定位 runId。
+
+此命令返回 JSON 包含 `subagentTasks` 列表。
+
+### Step 8: 读取 subagentTasks
+
+CLI 返回 JSON 中 `subagentTasks` 数组包含待执行任务：
+
+```json
+{
+  "status": "tasks_ready",
+  "subagentTasks": [
+    {
+      "taskId": "TASK-001",
+      "agentType": "coder",
+      "title": "实现登录功能",
+      "description": "...",
+      "prompt": "完整任务提示词...",
+      "timeout": 300000
+    }
+  ]
+}
+```
+
+提取每个任务的 `taskId`、`agentType`、`title`、`prompt`，供 Step 9 执行。
+
+## === 执行阶段（只有此阶段才能写业务代码）===
+
+### Step 9: 逐个执行 subagentTasks（禁止中断）
+
+<LOOP-ENFORCEMENT>
+**此步骤是执行循环，必须执行完所有任务后才能停止。**
+
+- **禁止在还有未完成任务时停止** — 即使 Agent 返回了大段输出，也必须继续下一个
+- **禁止询问"是否继续"** — 直接执行下一个任务
+- **禁止输出"让我知道是否..."后停止** — 继续执行
+- **禁止因为上下文压缩而忘记剩余任务** — 通过 `openmatrix step --json` 重新获取状态
+
+**文件持久化循环（防止上下文压缩丢失状态）:**
+```bash
+# 每个 Agent 完成后执行:
+# --summary 传入执行摘要，自动追加到全局 context.md
+openmatrix complete TASK-XXX --success --summary "决策: xxx; 文件: xxx"
+
+# 提交验证（防止 commit 静默失败）:
+git status --porcelain                        # 检查是否有未提交的文件
+# 如果有未提交文件 -> 必须手动提交:
+git add . && git commit -m "feat(TASK-XXX): 任务标题"
+
+openmatrix step --json                       # 获取下一个任务 + 检查是否全部完成
+```
+`openmatrix step` 会从磁盘读取真实状态，不依赖上下文记忆。
+</LOOP-ENFORCEMENT>
+
+#### 9.1 歧义检测机制
+
+**Agent 输出中可能包含歧义报告（JSON 格式）:**
+
+当 Agent 输出包含以下标记时，表示检测到歧义：
+```
+<AMBIGUITY_REPORT>
+{
+  "ambiguities": [
+    {
+      "type": "missing_info" | "conflicting_req" | "unclear_scope" | "tech_choice" | "edge_case",
+      "severity": "critical" | "high" | "medium" | "low",
+      "description": "歧义描述",
+      "suggestions": ["建议1", "建议2"]
+    }
+  ],
+  "overallSeverity": "critical" | "high" | "medium" | "low"
+}
+</AMBIGUITY_REPORT>
+```
+
+#### 9.2 歧义处理策略
+
+根据 `overallSeverity` 和执行模式选择处理方式：
+
+| 执行模式 | Critical/High | Medium/Low |
+|---------|--------------|------------|
+| **全自动执行** | Meeting + 继续执行 | Meeting + 继续执行 |
+| **关键节点确认** | AskUserQuestion | Meeting + 继续执行 |
+| **每阶段确认** | AskUserQuestion | Meeting + 继续执行 |
+
+**Meeting 处理（写入阻塞记录）:**
+```bash
+openmatrix meeting --create --task TASK-XXX --reason "歧义: ${description}" --severity ${severity}
+```
+
+**AskUserQuestion 处理（交互确认）:**
+
+AskUserQuestion: `header: "歧义确认"`, `multiSelect: false`
+**question:** 检测到 ${severity} 级歧义：${description}。请确认处理方式
+
+| label | description |
+|-------|-------------|
+| 提供信息 | 回答歧义相关问题，继续执行 |
+| 跳过任务 | 标记当前任务为可选，继续执行其他任务 |
+| 修改方案 | 根据歧义调整任务方案后继续 |
+
+#### 9.3 执行 Agent 任务
+
+**Skill 感知执行：**
+
+执行每个任务前，AI 应根据任务内容判断是否需要调用相关 skill 来增强执行质量。
+
+可用 skill 列表（AI 自行判断是否适用）：
+- `om:test` — 测试生成与验证循环
+- `frontend-design` — 前端/UI 设计与实现
+- `om:research` — 领域研究
+- 其他已安装的 skill
+
+**判断流程：**
+1. 读取任务的 `agentType`、`title`、`description`
+2. AI 自行判断该任务是否匹配某个 skill 的触发条件
+3. 如果匹配，在 Agent prompt 中注入该 skill 的核心指令或先调用对应 CLI 获取上下文数据
+4. 如果不匹配任何 skill，直接执行
+
+**tester 任务验证循环（om:test 逻辑）：**
+
+当 AI 判断任务需要 om:test 流程时：
+
+1. 先调用 CLI 获取项目测试配置：
+```bash
+openmatrix test --json
+```
+
+2. 调用 Agent 生成测试（prompt 中已包含原始扫描数据）：
+```typescript
+Agent({
+  subagent_type: task.subagent_type,
+  description: task.description,
+  prompt: task.prompt + "\n\n⚠️ 完成后请输出简短摘要（不超过3行）：\n1. 关键决策\n2. 创建/修改的文件\n3. 对后续任务的建议\n\n🚫 **禁止执行以下 Git 命令**：\n- ❌ git commit\n- ❌ git checkout/merge/pull/push/rebase/branch\n\n✅ 允许：git status, git diff, git log",
+  run_in_background: true
+})
+```
+
+3. Agent 完成后，自动验证测试：
+```bash
+npm test -- --run 2>&1
+```
+
+4. 验证失败时自动重试（最多 3 次）：
+   - 将失败输出传给新 Agent 修复测试
+   - 重新验证
+   - 3 次失败后标记为 blocked，创建 Meeting
+
+**默认执行方式（无特殊 skill 匹配时）：**
+
+```typescript
+Agent({
+  subagent_type: task.subagent_type,
+  description: task.description,
+  prompt: task.prompt + "\n\n⚠️ 完成后请输出简短摘要（不超过3行）：\n1. 关键决策\n2. 创建/修改的文件\n3. 对后续任务的建议\n\n🚫 **禁止执行以下 Git 命令**：\n- ❌ git commit — 所有提交统一通过 openmatrix complete 执行\n- ❌ git checkout — 不要切换分支\n- ❌ git merge — 不要合并其他分支\n- ❌ git pull — 不要拉取远程更新\n- ❌ git push — 不要推送代码\n- ❌ git rebase — 不要变基\n- ❌ git branch — 不要创建/删除分支\n\n✅ 允许：git status, git diff, git log",
+  isolation: task.isolation,
+  run_in_background: true
+})
+```
+
+每个 Agent 完成后（收到后台完成通知时）:
+
+<VERIFICATION-BEFORE-COMPLETION>
+## ⛔ 铁律：证据优先于声明
+
+**NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE**
+
+在调用 `openmatrix complete` 之前，必须：
+1. **运行验证命令** — 测试、构建、lint 等
+2. **读取完整输出** — 检查退出码、错误信息
+3. **确认验证通过** — 只有通过才能标记完成
+
+**验证命令（根据任务类型选择）：**
+
+| 任务类型 | 验证命令 |
+|---------|---------|
+| coder 任务 | `npm run build 2>&1 && npm test -- --run 2>&1` |
+| tester 任务 | `npm test -- --run 2>&1` |
+| reviewer 任务 | 无需验证（审查本身即是验证） |
+| 文档任务 | `npm run build 2>&1`（验证无破坏） |
+
+**验证流程：**
+```bash
+# 1. 运行验证（自动判断退出码）
+VERIFY_EXIT=0
+npm test -- --run > /tmp/verify-output.txt 2>&1 || VERIFY_EXIT=1
+
+# 2. 检查结果
+if [ $VERIFY_EXIT -eq 0 ]; then
+  echo "✅ 验证通过"
+else
+  echo "❌ 验证失败"
+  cat /tmp/verify-output.txt | tail -30
+  # 不调用 openmatrix complete，而是让 Agent 修复后重新验证
+fi
+
+# 3. 只有通过才标记完成
+if [ $VERIFY_EXIT -eq 0 ]; then
+  openmatrix complete TASK-XXX --success --summary "关键决策: xxx; 创建文件: xxx"
+fi
+```
+
+**红旗警告 — 停止并验证：**
+
+| 借口 | 真相 |
+|-----|------|
+| "应该能工作" | 运行验证，不要猜测 |
+| "测试看起来没问题" | 运行测试命令，读取输出 |
+| "Agent 说成功了" | Agent 的报告不是证据，运行验证 |
+| "只是简单改动" | 简单改动也要验证 |
+| "我会手动检查" | 手动检查不可重复 |
+| "跳过验证更快" | 跳过验证 = 虚假完成 |
+
+**常见失败处理：**
+
+验证失败时，不要调用 `openmatrix complete`，而是：
+1. 分析失败原因
+2. 让修复 Agent 处理（最多 3 次循环）
+3. 重新验证
+4. 3 次失败后创建 Meeting 记录阻塞问题
+
+</VERIFICATION-BEFORE-COMPLETION>
+
+**验证通过后，标记完成：**
+```bash
+openmatrix complete TASK-XXX --success --summary "关键决策: xxx; 创建文件: xxx"
+```
+
+**注意**: `openmatrix complete` 会自动执行以下操作：
+1. 🔄 **同步 Worktree 改动** - 如果 Agent 在 worktree 中工作，自动将改动同步到主工作树
+2. 📝 **更新上下文** - 将执行摘要写入 context.md
+3. ✅ **标记完成** - 更新任务状态为下一阶段
+
+2. **全局上下文文件** — 所有任务的上下文累积在 `.openmatrix/{runId}/context.md`:
+   - 每次任务完成后，通过 `--summary` 参数追加写入
+   - 后续 Agent 可读取此文件了解前序任务的决策和发现
+
+3. Git 自动提交（必须使用下方统一提交格式）
+
+4. **获取下一个任务（必须执行，防止上下文压缩丢失）:**
+```bash
+openmatrix step --json
+```
+
+**返回值解析：**
+
+| status | 含义 | 后续操作 |
+|--------|------|---------|
+| `next` | 有下一个任务 | 继续执行返回的 `subagent` 配置 |
+| `done` | 所有任务完成 | 进入最终提交 |
+| `blocked` | 无可执行任务 | 检查是否有 Meeting，用 `/om:meeting` 处理 |
+
+5. **审批点处理（根据执行模式）:**
+
+| 执行模式 | 审批点 | 处理方式 |
+|---------|--------|---------|
+| 全自动执行 | 无 | 自动批准所有操作 |
+| 关键节点确认 | plan, merge, deploy | 到达审批点时暂停，交互式确认 |
+| 每阶段确认 | develop, verify, accept | 每个阶段完成后暂停，交互式确认 |
+
+**Agent 上下文共享机制 (Agent Memory):**
+
+每个 Agent 执行时会自动接收前序 Agent 的上下文信息（通过 `context.md` 文件）。
+
+```
+Agent-1 完成 -> 写入 context.md -> Agent-2 读取 Agent-1 的上下文 -> 写入 context.md -> ...
+```
+
+**中断恢复:** 如果会话中断，再次执行 `/om:start` 时:
+1. 读取 `.openmatrix/state.json`
+2. 如果 `status === 'running'`，读取所有任务，找到 status 不是 completed 的任务
+3. 从中断的任务继续执行，不需要重新开始
+
+**Meeting 处理（auto 模式）:** 记录并跳过，执行完成后统一展示。
+
+**执行完成后:**
+
+### Meeting 机制
+
+在「全自动执行」模式下:
+- 遇到阻塞任务时，创建 Meeting 记录并跳过该任务
+- 继续执行其他独立任务，最大化并行度
+- 所有非阻塞任务完成后，提示用户使用 `/om:meeting` 统一处理阻塞问题
+
+```bash
+openmatrix meeting --list
+```
+
+如有 pending Meeting，交互式处理。
+
+所有任务完成后，执行最终 Git 提交（**必须使用 HEREDOC 格式**）:
+```bash
+git add . && git commit -m "$(cat <<'EOF'
+feat: 完成所有任务 - 任务总标题
+
+改动点1
+改动点2
+
+影响范围: 全部模块
+文件改动: src/xxx.ts, src/yyy.ts
+
+Co-Authored-By: OpenMatrix https://github.com/bigfish1913/openmatrix
+EOF
+)"
+```
+
+**Git 提交格式规范（所有提交必须遵守）:**
+
+```
+<type>(TASK-XXX): 简短描述
+
+改动点1
+改动点2
+
+影响范围: 模块名
+文件改动: 文件1, 文件2
+
+Co-Authored-By: OpenMatrix https://github.com/bigfish1913/openmatrix
+```
+
+**type 映射:** feat(新功能) / fix(修复) / test(测试) / refactor(重构) / docs(文档)
+**禁止使用 emoji**，使用纯文本格式
+
+</process>
+
+<arguments>
+$ARGUMENTS
+</arguments>
+
+<examples>
+/om:start
+/om:start "实现用户登录功能"
+</examples>
+
+<notes>
+## 流程定位
+
+```
+需求 -> brainstorm (澄清需求) -> plan (生成方案) -> start (执行) -> end
+需求 -> brainstorm (澄清需求) -> plan (生成方案) -> auto (全自动执行) -> end
+```
+
+start 和 auto 在同一位置，区别在于 start 有交互审批，auto 零交互。前置条件：
+- `.openmatrix/{runId}/plan.md` — 技术方案（由 /om:plan 生成）
+- `.openmatrix/{runId}/tasks-input.json` — 结构化元数据（由 /om:plan 生成）
+
+CLI 自动通过 `current.json` 定位当前 runId。
+
+如果前置条件不满足，引导用户执行 `/om:plan`。
+
+## 质量级别
+
+| 级别 | TDD | 覆盖率 | Lint | 安全 | 执行方式 |
+|------|:---:|:------:|:----:|:----:|:--------:|
+| 严格模式 | Y | >80% | Y | Y | TDD |
+| 平衡模式 | N | >60% | Y | Y | 先开发后测试 |
+| 快速模式 | N | 无 | N | N | 直接开发 |
+
+## 执行流程
+
+```
+Step 1-2: 初始化 + 验证前置条件 -> Step 3-4: 分析类型 + 提交文档 -> Step 5-6: 问答 + 确认
+-> Step 7: openmatrix start --tasks-json (必须) -> Step 8: 读取 subagentTasks
+-> Step 9: Agent 逐个执行 (只有这里写代码)
+```
+
+## 自动推断规则
+
+| 质量等级 | E2E 问题 | AI 验收 | 执行模式 |
+|---------|---------|---------|---------|
+| 严格模式 | 可选问一句 | 必须 | 全自动 + TDD |
+| 平衡模式 | 不需要 | 必须 | 全自动 + 先开发后测试 |
+| 快速模式 | 不需要 | 不需要 | 全自动 + 直接开发 |
+
+## Git 提交格式
+
+```
+<type>(TASK-XXX): 简短描述
+
+改动点1 / 改动点2
+影响范围: 模块名
+文件改动: 文件1, 文件2
+Co-Authored-By: OpenMatrix https://github.com/bigfish1913/openmatrix
+```
+
+type: feat/fix/test/refactor/docs。禁止 emoji。
+</notes>