openmatrix 0.1.24 → 0.1.26

package/skills/start.md

@@ -1,743 +1,324 @@
----
-name: om:start
-description: 启动新的任务执行周期
----
-
-<NO-OTHER-SKILLS>
-执行此技能时，不得调用 superpowers、gsd 或其他任务编排相关的技能。OpenMatrix 独立运行，不依赖外部任务编排系统。
-</NO-OTHER-SKILLS>
-
-<objective>
-解析任务文档，通过智能分析自动推断配置，仅对不确定的问题进行交互式问答，确认后启动执行。
-</objective>
-
-<process>
-1. **检查并初始化 .openmatrix 目录**
-   - 检查 `.openmatrix/` 目录是否存在
-   - 如果不存在，调用 CLI 初始化:
-     ```bash
-     openmatrix start --init-only
-     ```
-   - 这会创建 `.openmatrix/`、`.openmatrix/tasks/`、`.openmatrix/approvals/` 目录
-   - 同时自动将 `.openmatrix/` 添加到 `.gitignore`
-
-2. **检查当前状态**
-   - 读取 `.openmatrix/state.json`
-   - 如果 `status === 'running'`，提示用户先完成或暂停
-
-3. **检查 Git 仓库**
-   - 检查当前目录是否存在 `.git` 文件夹
-   - 如果没有：
-     - 询问用户是否初始化 Git 仓库 (使用 AskUserQuestion)
-     - 如果用户确认，执行 `git init`
-     - 创建初始 commit: `git add -A && git commit -m "Initial commit"`
-   - 检查是否有远程仓库配置:
-     - 如果没有远程仓库，提示用户添加: `git remote add origin <url>`
-
-4. **智能检测 .gitignore**
-
-   检查 `.gitignore` 文件是否存在并完善:
-   ```bash
-   openmatrix check-gitignore --json
-   ```
-
-   返回结果:
-   ```json
-   {
-     "exists": true,
-     "missingEntries": ["node_modules", "dist", ".env"],
-     "suggestedContent": "# Node.js\nnode_modules/\ndist/\n\n# Environment\n.env\n.env.local"
-   }
-   ```
-
-   **如果缺少常见忽略项**:
-   - 自动补充缺失的条目到 `.gitignore`
-   - 不询问用户，静默完成
-
-   **常见忽略项清单** (按项目类型):
-
-   | 类型 | 忽略项 |
-   |------|--------|
-   | Node.js | `node_modules/`, `dist/`, `build/`, `.npm/`, `*.log` |
-   | TypeScript | `*.tsbuildinfo`, `.tsbuildinfo` |
-   | Python | `__pycache__/`, `*.pyc`, `.venv/`, `venv/`, `.pytest_cache/` |
-   | Java | `target/`, `.gradle/`, `build/`, `*.class` |
-   | Go | `vendor/`, `bin/`, `*.exe` |
-   | Rust | `target/`, `Cargo.lock` (库项目) |
-   | 通用 | `.env`, `.env.local`, `.DS_Store`, `Thumbs.db`, `*.swp` |
-   | IDE | `.idea/`, `.vscode/`, `*.iml` |
-
-5. **解析任务输入**
-   - 如果 `$ARGUMENTS` 提供文件路径 → 读取文件内容
-   - 如果 `$ARGUMENTS` 是任务描述 → 直接使用
-   - 如果无参数 → **使用 AskUserQuestion 询问用户要执行的任务**
-
-6. **🔍 询问是否启用智能分析**
-
-   **首先询问用户是否启用智能推测:**
-   ```typescript
-   AskUserQuestion({
-     questions: [{
-       question: "是否启用智能推测配置？",
-       header: "智能模式",
-       options: [
-         {
-           label: "🧠 智能推测 (推荐)",
-           description: "自动推断质量级别、技术栈、文档级别，确认后执行"
-         },
-         {
-           label: "✏️ 手动配置",
-           description: "手动选择每个配置项"
-         }
-       ],
-       multiSelect: false
-     }]
-   })
-   ```
-
-7. **智能分析流程** (用户选择"智能推测")
-
-   **调用 CLI 进行智能分析:**
-   ```bash
-   openmatrix analyze --json
-   ```
-
-   这会返回分析结果:
-   ```json
-   {
-     "inferences": [
-       { "questionId": "quality_level", "inferredAnswer": "strict", "confidence": "high", "reason": "任务涉及新功能开发" },
-       { "questionId": "tech_stack", "inferredAnswer": ["typescript", "react"], "confidence": "high", "reason": "检测到技术栈: TypeScript, React" },
-       { "questionId": "doc_level", "inferredAnswer": "basic", "confidence": "medium", "reason": "新功能开发需要基础文档" }
-     ],
-     "questionsToAsk": ["e2e_test"],
-     "skippedQuestions": ["quality_level", "tech_stack", "doc_level"],
-     "projectContext": { "projectType": "typescript", "frameworks": ["React"], "hasFrontend": true }
-   }
-   ```
-
-   **展示推断结果并确认:**
-   ```typescript
-   AskUserQuestion({
-     questions: [{
-       question: `检测到配置，确认使用？\n\n📊 推断结果:\n  • 质量级别: ${inferredAnswer.quality_level}\n  • 技术栈: ${inferredAnswer.tech_stack}\n  • 文档级别: ${inferredAnswer.doc_level}`,
-       header: "确认配置",
-       options: [
-         {
-           label: "✅ 确认执行",
-           description: "使用以上配置开始执行任务"
-         },
-         {
-           label: "🚀 strict 模式",
-           description: "TDD + >80%覆盖率 + 严格Lint + 安全扫描"
-         },
-         {
-           label: "⚖️ balanced 模式",
-           description: ">60%覆盖率 + Lint + 安全扫描"
-         },
-         {
-           label: "⚡ fast 模式",
-           description: "无质量门禁，最快速度"
-         }
-       ],
-       multiSelect: false
-     }]
-   })
-   ```
-
-   **如果用户选择"确认执行"**: 使用推断配置，继续执行
-
-   **如果用户选择其他选项**: 更新对应配置，继续执行
-
-8. **手动配置流程** (用户选择"手动配置")
-
-   按顺序询问所有配置项:
-
-   **问题 0: 质量级别**
-   ```typescript
-   AskUserQuestion({
-     questions: [{
-       question: "选择质量级别 (决定 TDD、覆盖率、安全扫描等):",
-       header: "质量级别",
-       options: [
-         {
-           label: "🚀 strict (推荐生产代码)",
-           description: "TDD + >80%覆盖率 + 严格Lint + 安全扫描 + AI验收 (E2E可选)"
-         },
-         {
-           label: "⚖️ balanced (日常开发)",
-           description: ">60%覆盖率 + Lint + 安全扫描 + AI验收 (E2E可选)"
-         },
-         {
-           label: "⚡ fast (快速原型)",
-           description: "无质量门禁，最快速度"
-         }
-       ],
-       multiSelect: false
-     }]
-   })
-   ```
-
-   **⚠️ 如果用户选择 "strict" 或 "balanced"，追问 E2E 测试:**
-   ```typescript
-   AskUserQuestion({
-     questions: [{
-       question: "是否需要端到端(E2E)测试？(适用于 Web、移动端、GUI 桌面应用等需要完整用户流程测试的场景，较耗时)",
-       header: "E2E测试",
-       options: [
-         {
-           label: "✅ 启用 E2E 测试",
-           description: "添加端到端测试，验证完整用户流程（Playwright/Cypress/Appium等）"
-         },
-         {
-           label: "❌ 不需要",
-           description: "仅运行单元测试和集成测试"
-         }
-       ],
-       multiSelect: false
-     }]
-   })
-   ```
-
-   **⚠️ 如果用户启用 E2E 测试，追问应用类型:**
-   ```typescript
-   AskUserQuestion({
-     questions: [{
-       question: "选择应用类型以确定 E2E 测试方案:",
-       header: "应用类型",
-       options: [
-         {
-           label: "🌐 Web 应用",
-           description: "浏览器应用 - Playwright/Cypress/Selenium"
-         },
-         {
-           label: "📱 移动应用",
-           description: "iOS/Android - Appium/Detox/XCUITest/Espresso"
-         },
-         {
-           label: "🖥️ GUI 桌面应用",
-           description: "Electron/原生桌面 - Playwright/Spectron/Robot Framework"
-         }
-       ],
-       multiSelect: false
-     }]
-   })
-   ```
-
-   **问题 1: 任务目标** (仅当 questionsToAsk 包含 "objective" 时询问)
-   ```typescript
-   AskUserQuestion({
-     questions: [{
-       question: "这个任务的主要目标是什么？",
-       header: "目标",
-       options: [
-         { label: "实现新功能", description: "添加新的功能特性" },
-         { label: "修复 Bug", description: "修复已知问题" },
-         { label: "重构优化", description: "改进代码结构或性能" },
-         { label: "其他", description: "其他类型任务" }
-       ],
-       multiSelect: false
-     }]
-   })
-   ```
-
-   **问题 2: 技术栈** (仅当 questionsToAsk 包含 "tech_stack" 时询问，否则使用项目检测值)
-   ```typescript
-   AskUserQuestion({
-     questions: [{
-       question: "使用什么技术栈？",
-       header: "技术栈",
-       options: [
-         { label: "TypeScript", description: "类型安全的 JavaScript" },
-         { label: "Python", description: "Python 语言" },
-         { label: "Go", description: "Go 语言" },
-         { label: "其他", description: "其他技术栈" }
-       ],
-       multiSelect: true
-     }]
-   })
-   ```
-
-   **问题 3: 文档要求** (仅当 questionsToAsk 包含 "doc_level" 时询问)
-   ```typescript
-   AskUserQuestion({
-     questions: [{
-       question: "需要什么级别的文档？",
-       header: "文档",
-       options: [
-         { label: "完整文档", description: "API + 使用指南 + 架构" },
-         { label: "基础文档", description: "README + API" },
-         { label: "最小文档", description: "仅 README" },
-         { label: "无需文档", description: "不生成文档" }
-       ],
-       multiSelect: false
-     }]
-   })
-   ```
-
-   **多轮追问**: 如果用户选择"其他"，必须追问详情：
-   ```typescript
-   if (answer.includes("其他")) {
-     AskUserQuestion({
-       questions: [{
-         question: "请详细描述:",
-         header: "详情",
-         options: [] // 允许自由输入
-       }]
-     })
-   }
-   ```
-
-9. **任务拆解**
-   - 根据用户回答拆解任务
-   - 生成子任务列表和依赖图
-
-10. **展示执行计划**
-
-```
-📋 执行计划
-
-## Phase 1: 设计阶段
-  └─ TASK-001: 架构设计 (15min)
-
-## Phase 2: 开发阶段
-  ├─ TASK-002: 数据模型 (20min)
-  ├─ TASK-003: API 接口 (30min)
-  └─ TASK-004: 前端页面 (40min)
-
-## Phase 3: 测试阶段
-  ├─ TASK-005: 单元测试 (20min)
-  └─ TASK-006: 集成测试 (15min)
-
-## Phase 4: 收尾阶段
-  ├─ TASK-007: 文档编写 (15min)
-  └─ TASK-008: 代码审查 (10min)
-
-📊 统计
-  总任务: 8
-  预计耗时: ~2.5小时
-  审批点: plan, merge
-```
-
-11. **执行模式确认** (使用 AskUserQuestion)
-
-```typescript
-AskUserQuestion({
-  questions: [{
-    question: "请选择执行模式:",
-    header: "执行模式",
-    options: [
-      {
-        label: "每阶段确认 (推荐)",
-        description: "每个阶段完成后暂停，等待确认，适合重要任务"
-      },
-      {
-        label: "关键节点确认",
-        description: "仅在 plan/merge/deploy 时暂停，平衡速度和控制"
-      },
-      {
-        label: "全自动执行",
-        description: "无需确认，自动完成所有任务，适合简单低风险任务"
-      }
-    ],
-    multiSelect: false
-  }]
-})
-```
-
-**⚠️ 如果用户选择"全自动执行":**
-- 进入 **BYPASS 模式**，所有操作自动批准
-- 不要请求用户确认任何 Bash 命令或文件操作
-- 自动批准所有审批点 (plan/merge/deploy)
-
-12. **开始执行** (⚠️ 严格模式)
-
-**重要**: 从此步骤开始，除非遇到 meeting 审批或失败，否则**不得暂停询问用户**。
-
-用户选择执行模式后：
-
-a) 调用 CLI 初始化状态:
-```bash
-openmatrix start --mode <mode>
-```
-
-b) CLI 返回 SubagentTask 列表
-
-c) **执行循环** (由 Skill 驱动):
-
-```
-while (有待执行任务) {
-  1. 读取状态文件获取 SubagentTask
-  2. 调用 Agent 工具执行 Subagent
-  3. Subagent 完成后，更新状态文件:
-     ```bash
-     openmatrix complete <taskId> --success/--failed
-     ```
-  4. **Git 自动提交** (每个子任务完成后):
-     ```bash
-     git add -A
-     git commit -m "feat(task-id): 任务标题
-
-     - 修改内容1
-     - 修改内容2
-
-     任务ID: TASK-XXX
-     RunID: run-XXX"
-     ```
-  5. Phase 验收测试 (verify phase)
-  6. **检查是否需要审批**:
-     - 如果配置了 auto 模式 (`approvalPoints` 为空):
-       - **plan/merge/deploy 审批**: 自动批准 ✓
-       - **meeting 审批**: 不自动批准，只记录并跳过阻塞任务，供最后统一处理
-     - 如果配置了非 auto 模式: 在配置的审批点暂停等待确认
-     - 其他情况: 暂停等待人工确认
-
-**Meeting 处理** (auto 模式):
-```
-执行任务中...
-├── 任务A 完成 ✓
-├── 任务B 阻塞 → 创建Meeting → **跳过任务，继续执行** ↷
-├── 任务C 完成 ✓
-└── 任务D 阻塞 → 创建Meeting → **跳过任务，继续执行** ↷
-
-所有任务执行完成!
-```
-
-d) **执行完成后自动处理 Meeting**:
-
-```bash
-# 检查是否有 pending 的 Meeting
-openmatrix meeting --list --pending
-```
-
-**如果有 pending 的 Meeting，立即进入交互式处理**:
-
-```
-📋 检测到待处理的 Meeting (2个)
-
-┌─────────────────────────────────────────┐
-│ [1] 🔴 TASK-001 - 数据库连接失败          │
-│     阻塞原因: 无法连接到远程数据库         │
-│                                         │
-│ [2] 🤔 TASK-003 - API设计决策             │
-│     问题: 选择 REST 还是 GraphQL         │
-└─────────────────────────────────────────┘
-```
-
-**使用 AskUserQuestion 逐个处理**:
-
-```typescript
-// 1. 先选择要处理的 Meeting
-AskUserQuestion({
-  questions: [{
-    question: "请选择要处理的 Meeting:",
-    header: "Meeting",
-    options: [
-      { label: "[1] TASK-001 - 数据库连接失败", description: "阻塞 - 需要信息" },
-      { label: "[2] TASK-003 - API设计决策", description: "决策 - 技术选型" },
-      { label: "全部跳过", description: "标记所有 Meeting 为跳过" }
-    ],
-    multiSelect: false
-  }]
-})
-
-// 2. 根据类型展示处理选项
-// 阻塞型:
-AskUserQuestion({
-  questions: [{
-    question: "如何处理此阻塞?",
-    header: "处理方式",
-    options: [
-      { label: "💡 提供信息", description: "提供解决问题所需的信息后重试" },
-      { label: "⏭️ 跳过任务", description: "标记为可选，继续执行" },
-      { label: "🔄 重试", description: "直接重试此任务" }
-    ],
-    multiSelect: false
-  }]
-})
-
-// 决策型:
-AskUserQuestion({
-  questions: [{
-    question: "请做出决策:",
-    header: "决策",
-    options: [
-      { label: "方案 A", description: "方案A描述" },
-      { label: "方案 B", description: "方案B描述" }
-    ],
-    multiSelect: false
-  }]
-})
-```
-
-**处理完成后，如果用户提供了信息或选择重试，重新执行阻塞任务**:
-```bash
-openmatrix meeting APPR-001 --action provide-info --info "..."
-# 或
-openmatrix meeting APPR-001 --action retry
-
-# 然后重新执行阻塞的任务
-openmatrix resume TASK-001
-```
-
-**⚠️ 重要**: Meeting 处理是执行流程的一部分，必须在任务结束前完成。不要让用户手动调用 /om:meeting。
-
-  7. 继续下一个任务
-}
-```
-
-**⚠️ 重要**: 在 **auto 模式** 下，Skill **不得**询问用户任何确认问题：
-- 不得询问"是否继续执行"
-- 不得询问"是否执行下一 Phase"
-- 不得询问"是否处理 Meeting"
-- **plan/merge/deploy 自动批准，meeting 记录但不批准，最后统一展示**
-
-d) 执行 Agent 工具示例:
-
-```typescript
-// 使用 Agent 工具执行 Subagent
-Agent({
-  subagent_type: task.subagent_type,
-  description: task.description,
-  prompt: task.prompt,
-  isolation: task.isolation
-})
-```
-
-**⚠️ 执行约束 - 必须遵守**
-
-当执行 Agent 工具时，**禁止**向用户询问以下问题：
-- "是否继续执行？"
-- "是否执行下一阶段？"
-- "是否继续 Phase X？"
-- "任务量较大，是否需要分批次？"
-
-**正确的行为**:
-- 如果当前是 auto 模式 (`approvalPoints` 为空数组)，Agent 执行完毕后**直接继续**，无任何确认
-- 只有遇到 **meeting** 类型的审批时才暂停
-- 其他情况下，让 Agent 完整执行任务并在完成后自动返回结果
-
-13. **执行完成 - 最终 Git 提交**
-
-所有任务完成后，执行最终提交:
-```bash
-git add -A
-git commit -m "feat: 完成所有任务
-
-RunID: run-XXX
-任务数: N
-完成时间: YYYY-MM-DD HH:mm:ss"
-```
-
-</process>
-
-<arguments>
-$ARGUMENTS
-</arguments>
-
-<examples>
-/om:start                      # 交互式输入任务
-/om:start docs/task.md         # 从文件读取任务
-/om:start "实现用户登录功能"    # 直接描述任务
-</examples>
-
-<notes>
-## 质量级别详解
-
-| 级别 | TDD | 覆盖率 | Lint | 安全扫描 | E2E测试 | AI验收 | 适用场景 |
-|------|:---:|:------:|:----:|:--------:|:-------:|:------:|---------|
-| **strict** | ✅ | >80% | ✅ 严格 | ✅ | ❓ 可选 | ✅ | 生产代码、核心功能 |
-| **balanced** | ❌ | >60% | ✅ | ✅ | ❓ 可选 | ✅ | 日常开发 (默认) |
-| **fast** | ❌ | >20% | ❌ | ❌ | ❌ | ❌ | 快速原型、POC |
-
-> E2E 测试耗时较长，即使在严格模式下也建议根据项目需要选择。strict 可配置为 100%。80% 覆盖核心业务逻辑，100% 成本高收益低。
-
-### strict 模式 (推荐生产代码)
-```
-🧪 TDD 阶段:   先写测试 (RED) → 测试必须失败
-✨ 开发阶段:   再写代码 (GREEN) → 测试必须通过
-✅ 验证阶段:   7道质量门禁
-   ├── Gate 1: 编译检查 (必须通过)
-   ├── Gate 2: 测试运行 (必须通过)
-   ├── Gate 3: 覆盖率 >= 80% (必须达标)
-   ├── Gate 4: Lint 无 error (必须通过)
-   ├── Gate 5: 安全扫描无高危 (必须通过)
-   ├── Gate 6: E2E 测试通过 (必须通过，Web项目)
-   └── Gate 7: 验收标准全部满足
-🎉 验收阶段:   AI Reviewer 最终确认
-```
-
-### balanced 模式 (日常开发)
-```
-✨ 开发阶段:   编写代码
-✅ 验证阶段:   4-5道质量门禁
-   ├── Gate 1: 编译检查
-   ├── Gate 2: 测试运行
-   ├── Gate 3: 覆盖率 >= 60%
-   ├── Gate 4: E2E 测试 (可选，Web项目)
-   └── Gate 5: 验收标准
-🎉 验收阶段:   AI Reviewer 确认
-```
-
-### fast 模式 (快速原型)
-```
-✨ 开发阶段:   编写代码
-✅ 验证阶段:   仅编译检查
-🎉 完成
-```
-
-## 交互式问答流程图
-
-```
-┌─────────────────┐
-│   开始任务解析   │
-└────────┬────────┘
-         │
-         ▼
-┌─────────────────┐
-│ 问题0: 质量级别  │ ◀── 最重要，第一个问
-│ strict/balanced │
-│    /fast        │
-└────────┬────────┘
-         │
-         ▼
-┌─────────────────┐
-│ 问题1: 任务目标  │
-└────────┬────────┘
-         │
-         ▼
-┌─────────────────┐
-│ 问题2: 技术栈    │
-└────────┬────────┘
-         │
-         ▼
-┌─────────────────┐
-│ 问题3: 文档要求  │
-└────────┬────────┘
-         │
-         ▼
-┌─────────────────┐
-│   展示执行计划   │
-│  (含质量配置)    │
-└────────┬────────┘
-         │
-         ▼
-┌─────────────────┐
-│  确认执行模式    │
-└────────┬────────┘
-         │
-         ▼
-┌─────────────────┐
-│    开始执行     │
-│  (应用质量配置)  │
-└────────┬────────┘
-         │
-         ▼
-┌─────────────────┐
-│  所有任务完成?   │
-└────────┬────────┘
-         │
-    ┌────┴────┐
-    │         │
-   否        是
-    │         │
-    ▼         ▼
-┌───────┐ ┌─────────────────┐
-│继续执行│ │有 pending       │
-└───────┘ │Meeting?         │
-          └────────┬────────┘
-                   │
-              ┌────┴────┐
-              │         │
-             否        是
-              │         │
-              ▼         ▼
-          ┌───────┐ ┌─────────────┐
-          │  完成  │ │ 交互式处理  │
-          └───────┘ │ Meeting     │
-                    └──────┬──────┘
-                           │
-                           ▼
-                    ┌─────────────┐
-                    │ 重新执行    │
-                    │ 阻塞任务    │
-                    └─────────────┘
-```
-
-## 执行模式对比
-
-| 模式 | 审批点 | Phase间确认 | 适用场景 |
-|------|--------|-------------|---------|
-| 每阶段确认 | 每阶段结束 | ✅ 是 | 重要任务 |
-| 关键节点确认 | plan/merge/deploy | ❌ 否 | 常规任务 |
-| 全自动执行 | 无 | ❌ 否 | 简单任务 |
-
-## CLI 和 Skill 协作
-
-```
-┌─────────────┐     ┌─────────────┐     ┌─────────────┐
-│   Skill     │────▶│    CLI      │────▶│   状态文件   │
-│  (用户交互)  │     │ (状态管理)   │     │  (.openmat) │
-└─────────────┘     └─────────────┘     └─────────────┘
-       │                                        │
-       │         读取 SubagentTask              │
-       │◀───────────────────────────────────────┘
-       │
-       │         调用 Agent 工具
-       ▼
-┌─────────────┐
-│   Subagent  │
-│  (任务执行)  │
-└─────────────┘
-```
-
-## SubagentTask 格式
-
-```typescript
-{
-  subagent_type: 'general-purpose' | 'Explore' | 'Plan',
-  description: string,      // 简短描述 (3-5词)
-  prompt: string,           // 完整执行提示词
-  isolation?: 'worktree',   // 是否隔离
-  taskId: string,
-  agentType: AgentType,
-  timeout: number,
-  needsApproval: boolean
-}
-```
-
-## Git 自动提交
-
-当配置了自动提交时，每个子任务完成后自动执行:
-
-```bash
-git add -A
-git commit -m "feat(task-id): 任务标题
-
-- 修改内容1
-- 修改内容2
-
-影响范围: [模块名]
-任务ID: TASK-XXX
-RunID: run-XXX"
-```
-
-## Phase 验收流程
-
-每个 Phase 完成后:
-
-1. **Verify Phase**
-   - 运行测试: `npm test`
-   - 构建检查: `npm run build`
-   - 代码检查: `npm run lint` (如有)
-
-2. **AI Reviewer**
-   - 代码质量审查
-   - 安全性检查
-   - 性能评估
-
-3. **结果输出**
-   - ✅ 通过 → 进入下一 Phase
-   - ⚠️ 警告 → 记录但继续
-   - ❌ 失败 → 暂停等待处理
-</notes>
+---
+name: om:start
+description: 启动新的任务执行周期
+---
+
+<NO-OTHER-SKILLS>
+执行此技能时，不得调用 superpowers、gsd 或其他任务编排相关的技能。OpenMatrix 独立运行，不依赖外部任务编排系统。
+</NO-OTHER-SKILLS>
+
+<objective>
+解析任务，展示理解，确认后启动执行。核心原则：理解优先于配置。
+</objective>
+
+<process>
+## 前置检查
+
+1. **检查并初始化 .openmatrix 目录**
+   - 检查 `.openmatrix/` 目录是否存在
+   - 如果不存在，调用 CLI 初始化:
+     ```bash
+     openmatrix start --init-only
+     ```
+   - 这会创建 `.openmatrix/`、`.openmatrix/tasks/`、`.openmatrix/approvals/` 目录
+   - 同时自动将 `.openmatrix/` 添加到 `.gitignore`
+
+2. **检查当前状态**
+   - 读取 `.openmatrix/state.json`
+   - 如果 `status === 'running'`，提示用户先完成或暂停
+
+3. **检查 Git 仓库**
+   - 检查当前目录是否存在 `.git` 文件夹
+   - 如果没有：
+     - 询问用户是否初始化 Git 仓库 (使用 AskUserQuestion)
+     - 如果用户确认，执行 `git init`
+     - 创建初始 commit: `git add -A && git commit -m "Initial commit"`
+
+4. **智能检测 .gitignore**
+   ```bash
+   openmatrix check-gitignore --json
+   ```
+   如果缺少常见忽略项，自动补充，不询问用户。
+
+5. **解析任务输入**
+   - 如果 `$ARGUMENTS` 提供文件路径 → 读取文件内容
+   - 如果 `$ARGUMENTS` 是任务描述 → 直接使用
+   - 如果无参数 → 使用 AskUserQuestion 询问用户要执行的任务
+
+---
+
+## Step 1: 展示理解 + 推荐
+
+**调用 CLI 分析任务:**
+```bash
+openmatrix analyze --json
+```
+
+**展示 AI 的理解和推荐:**
+```
+🔍 我理解的任务:
+
+📋 类型: Bug 修复
+📁 范围: 前端样式
+⚡ 复杂度: 简单 (预计 1 个 commit)
+
+💡 推荐配置:
+   • 质量级别: fast (Bug 修复无需 TDD)
+   • 文档: 无需生成
+   • 测试: 单元测试覆盖
+
+🎯 预计产出:
+   • 修改 1-2 个文件
+   • 1 个 commit
+```
+
+**用户确认:**
+```typescript
+AskUserQuestion({
+  questions: [{
+    question: "以上理解正确吗？",
+    header: "确认",
+    options: [
+      { label: "✅ 确认执行", description: "使用推荐配置开始执行" },
+      { label: "📝 补充说明", description: "提供更多任务细节" },
+      { label: "⚙️ 调整配置", description: "修改质量级别、文档等配置" }
+    ],
+    multiSelect: false
+  }]
+})
+```
+
+**根据选择:**
+- **"确认执行"** → 跳到 Step 3，直接开始执行
+- **"补充说明"** → 询问详情后重新分析
+- **"调整配置"** → 进入 Step 2
+
+---
+
+## Step 2: 配置 (仅用户选择调整时)
+
+**展示配置选项:**
+```typescript
+AskUserQuestion({
+  questions: [
+    {
+      question: "选择质量级别:",
+      header: "质量",
+      options: [
+        { label: "🚀 fast", description: "快速执行，无 TDD，>20% 覆盖率" },
+        { label: "⚖️ balanced", description: "平衡模式，>60% 覆盖率" },
+        { label: "🎯 strict", description: "严格模式，TDD + >80% 覆盖率" }
+      ],
+      multiSelect: false
+    },
+    {
+      question: "是否需要生成文档?",
+      header: "文档",
+      options: [
+        { label: "❌ 无需文档", description: "不生成文档" },
+        { label: "📄 基础文档", description: "生成 README 或 API 文档" },
+        { label: "📚 完整文档", description: "生成详细文档和示例" }
+      ],
+      multiSelect: false
+    }
+  ]
+})
+```
+
+---
+
+## Step 3: 展示执行计划 + 执行模式
+
+**调用 CLI 拆解任务:**
+```bash
+openmatrix plan --json
+```
+
+**展示执行计划:**
+```
+📋 执行计划
+
+## Phase 1: 开发
+  ├─ TASK-001: 分析样式问题 (5min)
+  └─ TASK-002: 修复 CSS 问题 (10min)
+
+## Phase 2: 验证
+  └─ TASK-003: 验证修复效果 (5min)
+
+📊 统计
+  总任务: 3
+  预计耗时: ~20分钟
+  预计修改: 1-2 个文件
+```
+
+**选择执行模式:**
+```typescript
+AskUserQuestion({
+  questions: [{
+    question: "选择执行模式:",
+    header: "模式",
+    options: [
+      { label: "🚀 自动执行 (推荐)", description: "自动完成所有任务，仅风险操作需确认" },
+      { label: "⏸️ 关键节点确认", description: "在 plan/merge 时暂停确认" },
+      { label: "📋 每步确认", description: "每个任务完成后暂停确认" }
+    ],
+    multiSelect: false
+  }]
+})
+```
+
+---
+
+## Step 4: 执行
+
+**重要**: 从此步骤开始，除非遇到风险操作、meeting 或失败，否则**不得暂停询问用户**。
+
+### 执行循环
+
+```
+while (有待执行任务) {
+  1. 读取状态文件获取 SubagentTask
+  2. 调用 Agent 工具执行 Subagent
+  3. Subagent 完成后，更新状态文件:
+     ```bash
+     openmatrix complete <taskId> --success/--failed
+     ```
+  4. **Git 自动提交** (每个子任务完成后):
+     ```bash
+     git add -A
+     git commit -m "feat(TASK-XXX): 任务标题
+
+     - 改动点1
+     - 改动点2
+
+     影响范围: 模块/功能
+     文件改动: 文件1, 文件2
+
+     Co-Authored-By: OpenMatrix <https://github.com/bigfish1913/openmatrix>"
+     ```
+  5. **检查是否需要审批**:
+     - 自动模式: plan/merge 自动批准
+     - 非自动模式: 在配置的审批点暂停确认
+
+  6. **风险操作确认** (任何模式都需要):
+     - 修改配置文件 (.env, config.*)
+     - 删除文件
+     - git push
+     - 修改数据库 schema
+     - 调用外部服务
+}
+```
+
+### 失败处理
+
+```
+执行任务中...
+├── TASK-001 ✓ 完成
+├── TASK-002 ✗ 失败 → 记录 → 跳过 ↷
+└── TASK-003 ✓ 完成
+
+所有任务执行完成!
+
+📋 失败任务 (1个)
+┌─────────────────────────────────┐
+│ TASK-002 - 数据库连接失败        │
+│ 错误: 无法连接到远程数据库       │
+└─────────────────────────────────┘
+
+处理选项:
+  • 🔄 重试
+  • ⏭️ 跳过
+```
+
+### Meeting 处理
+
+```
+📋 待处理的阻塞 (2个)
+
+┌─────────────────────────────────────────┐
+│ [1] 🔴 TASK-001 - 数据库连接失败         │
+│     阻塞原因: 无法连接到远程数据库        │
+│                                         │
+│ [2] 🤔 TASK-003 - API设计决策            │
+│     问题: 选择 REST 还是 GraphQL         │
+└─────────────────────────────────────────┘
+
+使用 AskUserQuestion 逐个处理:
+  • 💡 提供信息 → 重试
+  • ⏭️ 跳过任务
+  • 🔄 重试
+```
+
+### 执行完成
+
+```
+✅ 任务完成!
+
+📝 改动: 3 个文件
+🔗 Commits: 2 个
+
+[查看 Diff] [回滚上一步] [回滚全部]
+```
+
+---
+
+## 风险操作清单
+
+以下操作在任何执行模式下都需要用户确认:
+
+| 类型 | 操作 | 确认方式 |
+|------|------|---------|
+| 配置 | 修改 `.env`, `config.*`, `*.config.*` | AskUserQuestion |
+| 删除 | 删除文件或目录 | AskUserQuestion |
+| 远程 | `git push`, `git push --force` | AskUserQuestion |
+| 数据库 | 修改 schema, 执行 migration | AskUserQuestion |
+| 外部 | 发送消息, 调用外部 API | AskUserQuestion |
+
+</process>
+
+<arguments>
+$ARGUMENTS
+</arguments>
+
+<examples>
+/om:start                      # 交互式输入任务
+/om:start docs/task.md         # 从文件读取任务
+/om:start "实现用户登录功能"    # 直接描述任务
+</examples>
+
+<notes>
+## 质量级别详解
+
+| 级别 | TDD | 覆盖率 | Lint | 安全扫描 | E2E测试 | AI验收 | 适用场景 |
+|------|:---:|:------:|:----:|:--------:|:-------:|:------:|---------|
+| **strict** | ✅ | >80% | ✅ 严格 | ✅ | ❓ 可选 | ✅ | 生产代码、核心功能 |
+| **balanced** | ❌ | >60% | ✅ | ✅ | ❓ 可选 | ✅ | 日常开发 (默认) |
+| **fast** | ❌ | >20% | ❌ | ❌ | ❌ | ❌ | 快速原型、POC |
+
+## 执行模式对比
+
+| 模式 | 审批点 | 风险操作确认 | 适用场景 |
+|------|--------|-------------|---------|
+| 自动执行 | 自动批准 | ✅ 需要 | 简单任务、信任 AI |
+| 关键节点确认 | plan/merge 暂停 | ✅ 需要 | 常规任务 |
+| 每步确认 | 每任务暂停 | ✅ 需要 | 重要任务 |
+
+## Git 提交格式
+
+```
+<type>: (TASK-XXX) 简短描述
+
+- 改动点1
+- 改动点2
+
+影响范围: 模块/功能
+文件改动: 文件1, 文件2
+
+Co-Authored-By: OpenMatrix <https://github.com/bigfish1913/openmatrix>
+```
+
+类型映射:
+- develop phase → `feat`
+- verify phase → `test`
+- accept phase → `feat`
+</notes>