openmatrix 0.2.30 → 0.2.33

package/skills/feature.md

@@ -1,687 +1,714 @@
----
-name: om:feature
-description: "Use for small feature requests needing quick iteration without full task file management. Triggers on MINOR-CHANGE intent: user wants small, quick changes with clear scope - single component, few files, straightforward implementation. DO NOT trigger on: complex multi-module tasks, unclear requirements, or investigation tasks. Intent signals: user explicitly says 'small/quick/simple', describes a focused change, or task is clearly localized."
-priority: high
----
-
-<INTENT-JUDGMENT>
-## 意图判断指南
-
-**AI 应根据用户语义判断意图：**
-
-### 触发信号（小需求意图）
-
-- 用户表达"小改动"、"快速"、"简单"
-- 任务范围明确且单一
-- 改动点集中在少数文件
-- 实现路径显而易见
-
-### 不触发信号
-
-| 用户意图 | 应调用 |
-|---------|--------|
-| 多模块复杂任务 | /om:start 或 /om:brainstorm |
-| 需求不明确 | /om:brainstorm |
-| 状态检查 | /om:status |
-
-### 示例判断
-
-| 用户消息 | 判断 | 结果 |
-|---------|------|------|
-| "给列表加搜索按钮" | 小改动意图 | 触发 ✓ |
-| "调整按钮颜色" | 简单修改意图 | 触发 ✓ |
-| "加个字段到表单" | 小需求意图 | 触发 ✓ |
-| "重构认证模块" | 复杂任务 | /om:start |
-| "从零搭建系统" | 需要设计 | /om:brainstorm |
-</INTENT-JUDGMENT>
-
-<NO-OTHER-SKILLS>
-本 skill 与其他任务编排技能功能重叠，请勿同时使用。
-
-本 skill 是轻量版，不调用 /om:start 或 /om:auto 完整流程。
-
-**任务执行阶段使用 Agent 工具。**
-
-**相关技能**: `/om` (主入口) | `/om:start` (标准任务) | `/om:brainstorm` (复杂任务)
-</NO-OTHER-SKILLS>
-
-<MANDATORY-EXECUTION-ORDER>
-## 执行顺序 - 必须严格按此顺序，不得跳过
-
-```
-Step 0:  Git 前置检查与持久化初始化（必须执行）
-Step 1:  接收任务输入（参数、文件、或询问用户）
-Step 2:  AI 自动判断任务边界（不符合条件才询问切换）
-Step 3:  收集项目上下文（技术栈、目录结构、CLAUDE.md）
-Step 4:  AI 拆分为 2-5 个小任务块
-Step 5:  用 TodoWrite 管理任务状态
-Step 6:  问答确认（质量等级、E2E测试、执行计划）
-Step 7:  逐个执行小任务（含跨 Agent 上下文传递）
-Step 8:  验证（按质量等级）
-Step 9:  分步 Git 提交
-Step 10: 全部任务完成后整体验证
-Step 11: 输出执行摘要并清理
-```
-
-**铁律：不验证不得提交，验证失败必须停止**
-**铁律：每次只改一个任务块，不得并行修改多个文件**
-**铁律：验证通过后立即提交，不得积累多个任务块再提交**
-</MANDATORY-EXECUTION-ORDER>
-
-<objective>
-轻量级小需求开发流程：拆分为 2-5 个小任务块，内存状态管理，保留质量门禁验证，支持分步 Git 提交。
-不产生 `.openmatrix/tasks/` 文件。
-</objective>
-
-<process>
-
-## Step 0: Git 前置检查与持久化初始化（必须执行）
-
-**检查 Git 仓库:**
-
-```bash
-ls -la .git 2>/dev/null || echo "NOT_INITIALIZED"
-git status --porcelain
-```
-
-| 检查结果 | 处理 |
-|---------|------|
-| `NOT_INITIALIZED` | AskUserQuestion 是否初始化 git |
-| 有未提交文件 | AskUserQuestion 处理方式（暂存/忽略/取消） |
-| 干净 | 继续执行 |
-
-**初始化持久化状态:**
-
-```bash
-mkdir -p .openmatrix
-cat > .openmatrix/feature-session.json << 'EOF'
-{
-  "sessionId": "FEATURE-$(date +%Y%m%d%H%M%S)",
-  "status": "running",
-  "tasks": [],
-  "currentTaskIndex": 0,
-  "quality": null,
-  "failureCount": {}
-}
-EOF
-echo '' > .openmatrix/feature-context.md
-echo '' > .openmatrix/feature-progress.md
-```
-
-## Step 1: 接收任务输入
-
-**检查 `$ARGUMENTS`:**
-
-| 参数 | 处理方式 |
-|------|---------|
-| `<任务描述>` | 直接使用描述 |
-| `<文件路径>` | Read 工具读取内容 |
-| 空 | AskUserQuestion 询问 |
-
-**如果是空参数，询问：**
-
-AskUserQuestion: `header: "任务描述"`, `multiSelect: false`
-**question:** 请描述你的小需求
-
-| label | description |
-|-------|-------------|
-| 描述需求 | 输入自由文本描述 |
-| 从文件读取 | 指定任务文件路径 |
-| 取消 | 退出 |
-
-## Step 2: AI 判断任务边界
-
-**AI 自动判断任务是否适合本 skill：**
-
-检查以下条件（全部满足才继续，否则建议切换）：
-
-| 条件 | 检查方式 |
-|------|---------|
-| 描述长度 ≤ 100 字 | 字数统计 |
-| 单一功能点 | 无"和"、"同时"、"另外"等连接词 |
-| 无架构设计 | 无"架构"、"设计"、"从零"、"重构"关键词 |
-| 无多子系统 | 无多个独立模块描述 |
-
-**判断结果处理：**
-
-| 结果 | 处理 |
-|------|------|
-| ✅ 全部满足 | 继续执行 Step 3 收集上下文 |
-| ❌ 不满足 | 输出建议并询问是否切换到 `/om:start` |
-
-**如果需要切换，询问：**
-
-AskUserQuestion: `header: "任务复杂度"`, `multiSelect: false`
-**question:** 任务可能需要完整追踪，建议使用 `/om:start`。是否切换？
-
-| label | description |
-|-------|-------------|
-| 切换到 /om:start | 使用完整流程 |
-| 继续用 /om:feature | 强制使用轻量流程（可能无法完整追踪） |
-
-## Step 3: 收集项目上下文并写入文件
-
-**收集并写入上下文文件:**
-
-```bash
-mkdir -p .openmatrix
-
-# 写入上下文文件头
-echo "# 项目上下文" > .openmatrix/feature-context.md
-echo "" >> .openmatrix/feature-context.md
-
-# 收集技术栈并写入文件
-echo "## 技术栈" >> .openmatrix/feature-context.md
-cat package.json 2>/dev/null | grep -E '"(react|vue|angular|next|express|fastify|koa|typeorm|prisma|sequelize|mongoose|jest|vitest|playwright|cypress)"' >> .openmatrix/feature-context.md || echo "未检测到常见框架" >> .openmatrix/feature-context.md
-echo "" >> .openmatrix/feature-context.md
-
-# 收集目录结构并写入文件
-echo "## 目录结构" >> .openmatrix/feature-context.md
-find . -maxdepth 2 -type d -not -path '*/node_modules/*' -not -path '*/.git/*' -not -path '*/dist/*' -not -path '*/.openmatrix/*' 2>/dev/null | head -30 >> .openmatrix/feature-context.md
-echo "" >> .openmatrix/feature-context.md
-
-# 读取 CLAUDE.md 并写入文件
-echo "## 项目规范（来自 CLAUDE.md）" >> .openmatrix/feature-context.md
-cat CLAUDE.md 2>/dev/null | head -50 >> .openmatrix/feature-context.md || echo "无 CLAUDE.md" >> .openmatrix/feature-context.md
-```
-
-上下文已写入 `.openmatrix/feature-context.md`，后续 Agent 会读取此文件。
-
-## Step 4: AI 拆分为 2-5 个小任务块
-
-**调用 Agent 进行任务拆分：**
-
-```typescript
-Agent({
-  subagent_type: "general-purpose",
-  description: "任务拆分分析",
-  prompt: `你是任务拆分专家。将用户需求拆分为 2-5 个小任务块。
-
-## 用户需求
-${taskDescription}
-
-${projectContext}
-
-## 拆分原则
-1. 拆分粒度：每个小块 ≤ 30 分钟工作量
-2. 拆分方向：数据层 → API层 → UI层 / 核心逻辑 → 边界处理
-3. 依赖关系：确保后续任务可依赖前面的成果
-4. 文件预估：基于项目目录结构，预估每个任务涉及的文件路径
-5. 技术栈对齐：使用项目已有的框架和库，不引入新依赖
-
-## 输出格式
-请按以下格式输出：
-
-\`\`\`
-📋 任务拆分计划
-
-原始需求：${taskDescription}
-
-拆分为 N 个小任务：
-1. [任务名称]
-   描述：[简要描述]
-   预估文件：[基于项目结构的文件路径列表]
-   预估时间：[分钟]
-
-2. [任务名称]
-   ...
-
-📋 依赖关系图
-任务1 → 任务2 → 任务3
-\`\`\`
-
-## 注意事项
-- 如果任务过于复杂无法拆分，明确说明并建议使用完整流程
-- 保持任务块独立性，便于验证和提交
-- 文件路径必须基于实际项目结构`,
-  run_in_background: false
-})
-```
-
-## Step 5: 用 TodoWrite 管理任务状态
-
-**将拆分的任务写入 TodoWrite：**
-
-```typescript
-TodoWrite({
-  todos: [
-    { activeForm: "正在实现数据层", content: "数据层：添加搜索参数", status: "pending" },
-    { activeForm: "正在实现 API 层", content: "API 层：实现搜索端点", status: "pending" },
-    { activeForm: "正在实现 UI 层", content: "UI 层：添加搜索框", status: "pending" }
-  ]
-})
-```
-
-状态同时在会话和 `.openmatrix/feature-session.json` 中管理。
-
-## Step 6: 问答确认
-
-**⛔ 执行前必须确认所有配置**
-
-**6.1 质量等级（必选）**
-
-根据任务描述，Claude 直接推断推荐的质量等级，并在问题中标注推荐项：
-
-- Bug 修复 / 重构 → 推荐 `balanced`
-- 原型 / demo / 快速验证 → 推荐 `fast`
-- 新功能 / 生产代码 / 涉及测试 → 推荐 `strict`
-- 文档 / skill 文件 → 推荐 `fast`
-
-AskUserQuestion: `header: "质量等级"`, `multiSelect: false`
-
-**question:** 选择质量等级（Claude 推荐：${inferredQuality}，原因：${inferReason}）
-
-| label | description |
-|-------|-------------|
-| `strict` | TDD + >80%覆盖率 + 严格Lint + 安全扫描 — 生产级代码 |
-| `balanced` | >60%覆盖率 + Lint + 安全扫描 — 日常开发 |
-| `fast` | 无质量门禁 — 快速原型/验证 |
-
-**6.2 E2E 测试（仅 strict/balanced）**
-
-根据任务描述推断：若任务涉及前端页面/UI/Web，询问；否则默认跳过（不需要）。
-
-如需询问：
-
-AskUserQuestion: `header: "E2E 测试"`, `multiSelect: false`
-
-**question:** 是否需要端到端 (E2E) 测试？（适用于 Web/Mobile/GUI 项目）
-
-| label | description |
-|-------|-------------|
-| `功能测试` | 验证业务流程正确性，速度快 |
-| `视觉验证` | 需要浏览器可视化验证 UI 样式 |
-| `不需要 (推荐)` | 仅单元测试和集成测试 |
-
-**6.3 确认拆分计划**
-
-AskUserQuestion: `header: "确认计划"`, `multiSelect: false`
-
-**question:** 任务拆分计划已展示，确认开始执行？
-
-| label | description |
-|-------|-------------|
-| `开始执行 (推荐)` | 按计划逐个执行 |
-| `调整计划` | 重新拆分任务 |
-
-## Step 7: 逐个执行小任务
-
-**对 TodoWrite 中的每个任务（按顺序）：**
-
-**7.1 更新状态为 in_progress**
-```typescript
-TodoWrite({ todos: [...] }) // 当前任务标记 in_progress
-```
-
-**7.2 歧义检测与处理**
-
-Agent 输出中可能包含歧义报告：
-
-当 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>
-```
-
-**5 种歧义类型说明：**
-
-| 类型 | 说明 | 示例 |
-|------|------|------|
-| `missing_info` | 缺失关键信息 | "未指定数据库类型" |
-| `conflicting_req` | 需求冲突 | "既要高性能又要低成本" |
-| `unclear_scope` | 范围不清晰 | "是否包含历史数据处理？" |
-| `tech_choice` | 技术选型歧义 | "用 REST 还是 GraphQL？" |
-| `edge_case` | 边界情况未定义 | "超过限制时如何处理？" |
-
-**歧义处理策略（轻量模式）：**
-
-| 严重程度 | 处理方式 |
-|---------|---------|
-| **Critical/High** | AskUserQuestion 立即确认 |
-| **Medium/Low** | 写入进度文件，继续执行 |
-
-**AskUserQuestion 处理（仅 Critical/High）：**
-
-AskUserQuestion: `header: "歧义确认"`, `multiSelect: false`
-**question:** 检测到 ${severity} 级歧义：${description}。请确认处理方式
-
-| label | description |
-|-------|-------------|
-| 提供信息 | 回答歧义相关问题，继续执行 |
-| 跳过任务块 | 标记当前任务块为可选，继续执行下一个 |
-| 修改方案 | 根据歧义调整方案后继续 |
-
-**7.3 调用 Agent 执行**
-
-```typescript
-Agent({
-  subagent_type: "general-purpose",
-  description: task.content,
-  prompt: `你是实现专家。执行以下任务块。
-
-## 项目上下文（请读取文件）
-请先读取 .openmatrix/feature-context.md 了解项目上下文。
-
-## 前序任务结果（请读取文件）
-请读取 .openmatrix/feature-progress.md 了解前序 Agent 的决策和发现。
-
-## 整体任务
-${taskDescription}
-
-## 当前任务
-- 任务名称：${task.content}
-- 预估文件：${task.files}
-- 质量等级：${quality}
-- 前置任务完成状态：${previousTasksStatus}
-
-## 质量要求
-${quality === 'strict' ? `
-- 必须使用 TDD：先写测试，再写实现
-- 测试覆盖率要求：>80%
-- 必须通过严格 Lint
-- 必须通过安全扫描
-` : quality === 'balanced' ? `
-- 测试覆盖率要求：>60%
-- 必须通过 Lint
-- 必须通过安全扫描
-` : `
-- 无质量门禁要求
-- 快速实现功能
-`}
-
-## 实施原则
-1. 先阅读预估文件中的现有代码，理解上下文后再动手
-2. 只修改当前任务相关的文件
-3. 不做"顺便"的重构或优化
-4. 确保代码风格与项目现有代码一致
-5. 完成后运行相关测试验证
-
-## 完成后输出
-请按以下格式输出（不超过3行）：
-1. 关键决策：[做了什么决策及原因]
-2. 创建/修改的文件列表
-3. 对后续任务的建议或注意事项
-
-## 禁止行为
-❌ 执行 git commit（由主流程处理）
-❌ 执行 git checkout — 不要切换分支
-❌ 执行 git merge — 不要合并其他分支
-❌ 执行 git pull — 不要拉取远程更新
-❌ 执行 git push — 不要推送代码
-❌ 执行 git rebase — 不要变基
-❌ 执行 git branch — 不要创建/删除分支
-❌ 修改与当前任务无关的文件
-❌ 进行额外的重构
-
-✅ 允许：git status, git diff, git log`,
-  run_in_background: true
-})
-```
-
-**7.3 等待 Agent 完成，写入进度文件**
-
-Agent 完成后，将输出中的关键决策和建议写入 `.openmatrix/feature-progress.md` 文件：
-
-```bash
-# Agent 完成后，追加写入进度文件
-echo "" >> .openmatrix/feature-progress.md
-echo "## 任务 N: ${task.content}" >> .openmatrix/feature-progress.md
-echo "${agentOutput}" >> .openmatrix/feature-progress.md
-echo "" >> .openmatrix/feature-progress.md
-```
-
-这样后续 Agent 能通过读取文件获取前序 Agent 的决策和发现。
-
-## Step 8: 验证（按质量等级）
-
-**⛔ 验证不通过不得提交，必须停止等待修复**
-
-每个任务完成后，根据质量等级执行验证：
-
-**8.1 执行验证命令**
-
-| 质量等级 | 验证命令 |
-|---------|---------|
-| `strict` | `npm test -- --run && npm run lint && npm run test:coverage && npm audit --audit-level=moderate` |
-| `balanced` | `npm test -- --run && npm run lint && npm audit --audit-level=moderate` |
-| `fast` | 跳过验证 |
-
-**覆盖率阈值检查说明：**
-- strict 模式要求 >80% 覆盖率，`npm run test:coverage` 命令应输出覆盖率报告
-- balanced 模式要求 >60% 覆盖率，建议定期检查覆盖率报告
-
-**8.2 E2E 验证（如果用户选择）**
-- 功能测试：`npm run test:e2e`
-- 视觉验证：启动 Playwright 截图对比
-
-**8.3 验证结果自动判断**
-
-验证命令执行后，根据退出码自动判断结果：
-
-```bash
-# 执行验证命令并捕获结果
-if npm test -- --run && npm run lint; then
-  # 验证成功
-  echo "✅ 验证通过"
-else
-  # 验证失败
-  echo "❌ 验证失败"
-  npm test -- --run 2>&1 | tail -30  # 展示失败详情
-  exit 1
-fi
-```
-
-**验证失败处理：**
-- 自动展示验证失败详情（最后 30 行输出）
-- 停止执行流程
-- 提示用户修复后使用 `/om:resume` 继续
-
-**验证成功处理：**
-- 继续执行 Step 9 Git 提交
-
-## Step 9: 分步 Git 提交
-
-**⛔ 验证通过后必须立即提交，不得积累多个任务块**
-
-**只提交本次任务修改的文件（而非 `git add -A`）：**
-
-```bash
-# 获取本次任务修改的文件列表（从 Agent 输出中提取）
-git status --porcelain
-
-# 只提交任务涉及的文件
-git add ${modifiedFiles}
-git commit -m "$(cat <<'EOF'
-feat(feature): ${originalTask} - ${currentChunk}
-
-改动详情：
-- ${changesSummary}
-
-Co-Authored-By: OpenMatrix https://github.com/bigfish1913/openmatrix
-EOF
-)"
-```
-
-提交成功后：
-1. **更新 TodoWrite 状态为 completed**
-2. **继续下一个任务**
-
-## Step 10: 全部任务完成后
-
-**检查 TodoWrite 所有任务状态为 `completed`：**
-
-**10.1 运行最终整体验证**
-```bash
-npm test -- --run
-```
-
-**10.2 收集所有任务的执行摘要**
-
-## Step 11: 输出执行摘要并清理
-
-**展示执行摘要：**
-
-```
-✅ 任务完成：${originalTask}
-
-📊 执行统计：
-- 任务块数：${chunkCount}
-- 质量等级：${quality}
-- 总耗时：约 ${totalTime} 分钟
-- Git 提交：${commitCount} 次
-
-📝 创建/修改的文件：
-${fileList}
-
-🔧 关键决策：
-${decisions}
-
-📈 测试覆盖率：${coverageResult}
-
-✨ 所有任务已完成，会话状态已清理
-```
-
-**清理操作：**
-- TodoWrite 所有任务保持 completed 状态
-- 持久化文件可选择保留或手动清理
-- 任务完成后状态标记为 `completed`
-
-</process>
-
-<arguments>
-$ARGUMENTS
-</arguments>
-
-<examples>
-/om:feature 给用户列表页添加搜索功能
-/om:feature 添加一个导出按钮
-/om:feature docs/small-task.md
-</examples>
-
-<notes>
-## 铁律
-
-**不验证不得提交，验证失败必须停止**
-**每次只改一个任务块，不得并行修改多个文件**
-**验证通过后立即提交，不得积累多个任务块再提交**
-
-## 红线
-
-- 验证失败不得继续执行，必须停止等待修复
-- 不得跳过质量等级确认
-- 不得跳过任务边界确认
-- 不得在 Agent 内部执行任何 Git 操作（commit/checkout/merge/pull/push/rebase/branch）
-
-<RED-FLAGS>
-## 红旗警告 - 停止并回归流程
-
-这些想法意味着你在找借口：
-
-| 想法 | 真相 |
-|-----|------|
-| "验证麻烦，先提交再说" | 未验证的提交会污染仓库 |
-| "任务块小，一次改两个吧" | 无法隔离哪个改动有问题 |
-| "顺便重构下这个代码" | "顺便"是 bug 的温床 |
-| "跳过质量确认，直接开始" | 3秒选择防止后续数小时排查 |
-| "测试失败没关系，手动验证就行" | 手动验证不可重复 |
-| "这个小改动不会影响其他" | 小改动也有根因 |
-| "我知道该怎么做" | 知道概念 ≠ 正确执行 |
-
-</RED-FLAGS>
-
-## 常见借口 vs 真实情况
-
-| 借口 | 真实情况 |
-|------|---------|
-| "验证太慢，先提交" | 未验证的提交会污染仓库，回头排查更慢。 |
-| "一次改两个任务块效率高" | 无法隔离哪个改动有问题。引入新 bug。 |
-| "顺便重构没问题" | "顺便"是 bug 的温床。任务聚焦。 |
-| "质量确认麻烦" | 3 秒的选择防止后续数小时排查。 |
-| "手动验证就行" | 手动验证不可重复。自动化测试才可靠。 |
-| "小改动不会出错" | 小改动也有根因。系统性验证。 |
-
-## 与其他指令的区别
-
-| 指令 | 适用场景 | 任务文件 | 问答 | 验证 | 持久化 |
-|-----|---------|:-------:|:----:|:----:|:-----:|
-| `/om:feature` | 小需求（≤100字，单一功能） | ❌ | 质量+E2E | 按等级 | 必须 |
-| `/om:start` | 标准任务 | ✅ | 质量+E2E+模式 | 按等级 | 必须 |
-| `/om:brainstorm` | 复杂任务 | ✅ | 设计问答 | 按等级 | 必须 |
-| `/om:auto` | 全自动执行 | ✅ | 无 | 按等级 | 必须 |
-
-## 路由触发条件
-
-从 `/om` 主入口自动路由到此 skill 的条件：
-- 任务描述 ≤ 100 字
-- 单一功能点（无多个独立子系统）
-- 不涉及架构设计/技术选型
-- 关键词匹配：小需求、小功能、小改动、minor、quick、快速、添加按钮
-
-## 错误处理流程
-
-```
-验证失败 → 停止执行 → 展示错误详情 → 提示用户修复 → 使用 /om:resume 恢复
-```
-
-| 错误 | 处理 |
-|-----|-----|
-| 测试失败 | 停止，提示用户修复 |
-| Lint 错误 | 停止，提示用户修复 |
-| 安全扫描失败 | 停止，提示用户修复 |
-| Agent 超时 | 询问重试或跳过 |
-| Git 失败 | 提示手动处理 |
-
-## 3+ 次验证失败：质疑任务拆分
-
-**如果同一任务块验证失败 3 次以上：**
-
-**指示拆分问题的模式：**
-- 每次修复产生新的测试失败
-- 任务块范围模糊，边界不清
-- 修改影响多个不相关文件
-
-**停止并质疑拆分方案：**
-- 任务块是否过于复杂？
-- 是否需要重新拆分？
-- 是否应该切换到 `/om:start` 使用完整流程？
-
-**在继续执行之前与用户讨论拆分方案。**
-
-这不是执行失败 — 这是拆分策略问题。
-
-## Git 提交格式
-
-```
-<type>(feature): <任务描述> - <任务块名称>
-
-改动详情
-
-Co-Authored-By: OpenMatrix
-```
-
-type: feat/fix/test/refactor/docs
-
-## 恢复执行
-
-如果验证失败需要修复：
-
-使用 `/om:resume` 继续执行（自动检测 `.openmatrix/feature-session.json` 或 `state.json`）
-
-## 挡久化文件说明
-
-执行过程中产生以下文件：
-- `.openmatrix/feature-session.json` - 会话状态（任务列表、当前索引、质量等级）
-- `.openmatrix/feature-context.md` - 项目上下文
-- `.openmatrix/feature-progress.md` - Agent 执行进度
+---
+name: om:feature
+description: "Use for small feature requests needing quick iteration without full task file management. Triggers on MINOR-CHANGE intent: user wants small, quick changes with clear scope - single component, few files, straightforward implementation. DO NOT trigger on: complex multi-module tasks, unclear requirements, or investigation tasks. Intent signals: user explicitly says 'small/quick/simple', describes a focused change, or task is clearly localized."
+priority: high
+---
+
+<INTENT-JUDGMENT>
+## 意图判断指南
+
+**AI 应根据用户语义判断意图：**
+
+### 触发信号（小需求意图）
+
+- 用户表达"小改动"、"快速"、"简单"
+- 任务范围明确且单一
+- 改动点集中在少数文件
+- 实现路径显而易见
+
+### 不触发信号
+
+| 用户意图 | 应调用 |
+|---------|--------|
+| 多模块复杂任务 | /om:start 或 /om:brainstorm |
+| 需求不明确 | /om:brainstorm |
+| 状态检查 | /om:status |
+
+### 示例判断
+
+| 用户消息 | 判断 | 结果 |
+|---------|------|------|
+| "给列表加搜索按钮" | 小改动意图 | 触发 ✓ |
+| "调整按钮颜色" | 简单修改意图 | 触发 ✓ |
+| "加个字段到表单" | 小需求意图 | 触发 ✓ |
+| "重构认证模块" | 复杂任务 | /om:start |
+| "从零搭建系统" | 需要设计 | /om:brainstorm |
+</INTENT-JUDGMENT>
+
+<NO-OTHER-SKILLS>
+本 skill 与其他任务编排技能功能重叠，请勿同时使用。
+
+本 skill 是轻量版，不调用 /om:start 或 /om:auto 完整流程。
+
+**任务执行阶段使用 Agent 工具。**
+
+**相关技能**: `/om` (主入口) | `/om:start` (标准任务) | `/om:brainstorm` (复杂任务)
+</NO-OTHER-SKILLS>
+
+<MANDATORY-EXECUTION-ORDER>
+## 执行顺序 - 必须严格按此顺序，不得跳过
+
+```
+Step 0:  Git 前置检查与持久化初始化（必须执行）
+Step 1:  接收任务输入（参数、文件、或询问用户）
+Step 2:  AI 自动判断任务边界（不符合条件才询问切换）
+Step 3:  收集项目上下文（技术栈、目录结构、CLAUDE.md）
+Step 4:  AI 拆分为 2-5 个小任务块
+Step 5:  用 TodoWrite 管理任务状态
+Step 6:  问答确认（质量等级、E2E测试、执行计划）
+Step 7:  逐个执行小任务（含跨 Agent 上下文传递）
+Step 8:  验证（按质量等级）
+Step 9:  分步 Git 提交
+Step 10: 全部任务完成后整体验证
+Step 11: 输出执行摘要并清理
+```
+
+**铁律：不验证不得提交，验证失败必须停止**
+**铁律：每次只改一个任务块，不得并行修改多个文件**
+**铁律：验证通过后立即提交，不得积累多个任务块再提交**
+</MANDATORY-EXECUTION-ORDER>
+
+<objective>
+轻量级小需求开发流程：拆分为 2-5 个小任务块，内存状态管理，保留质量门禁验证，支持分步 Git 提交。
+不产生 `.openmatrix/tasks/` 文件。
+</objective>
+
+<process>
+
+## Step 0: Git 前置检查与持久化初始化（必须执行）
+
+**检查 Git 仓库:**
+
+```bash
+ls -la .git 2>/dev/null || echo "NOT_INITIALIZED"
+git status --porcelain
+```
+
+| 检查结果 | 处理 |
+|---------|------|
+| `NOT_INITIALIZED` | AskUserQuestion 是否初始化 git |
+| 有未提交文件 | AskUserQuestion 处理方式（暂存/忽略/取消） |
+| 干净 | 继续执行 |
+
+**初始化持久化状态:**
+
+```bash
+mkdir -p .openmatrix
+cat > .openmatrix/feature-session.json << EOF
+{
+  "sessionId": "FEATURE-$(date +%Y%m%d%H%M%S)",
+  "status": "running",
+  "tasks": [],
+  "currentTaskIndex": 0,
+  "quality": null,
+  "failureCount": {}
+}
+EOF
+echo '' > .openmatrix/feature-context.md
+echo '' > .openmatrix/feature-progress.md
+```
+
+## Step 1: 接收任务输入
+
+**检查 `$ARGUMENTS`:**
+
+| 参数 | 处理方式 |
+|------|---------|
+| `<任务描述>` | 直接使用描述 |
+| `<文件路径>` | Read 工具读取内容 |
+| 空 | AskUserQuestion 询问 |
+
+**如果是空参数，询问：**
+
+AskUserQuestion: `header: "任务描述"`, `multiSelect: false`
+**question:** 请描述你的小需求
+
+| label | description |
+|-------|-------------|
+| 描述需求 | 输入自由文本描述 |
+| 从文件读取 | 指定任务文件路径 |
+| 取消 | 退出 |
+
+## Step 2: AI 判断任务边界
+
+**AI 自动判断任务是否适合本 skill：**
+
+检查以下条件（全部满足才继续，否则建议切换）：
+
+| 条件 | 检查方式 |
+|------|---------|
+| 描述长度 ≤ 100 字 | 字数统计 |
+| 单一功能点 | 无"和"、"同时"、"另外"等连接词 |
+| 无架构设计 | 无"架构"、"设计"、"从零"、"重构"关键词 |
+| 无多子系统 | 无多个独立模块描述 |
+
+**判断结果处理：**
+
+| 结果 | 处理 |
+|------|------|
+| ✅ 全部满足 | 继续执行 Step 3 收集上下文 |
+| ❌ 不满足 | 输出建议并询问是否切换到 `/om:start` |
+
+**如果需要切换，询问：**
+
+AskUserQuestion: `header: "任务复杂度"`, `multiSelect: false`
+**question:** 任务可能需要完整追踪，建议使用 `/om:start`。是否切换？
+
+| label | description |
+|-------|-------------|
+| 切换到 /om:start | 使用完整流程 |
+| 继续用 /om:feature | 强制使用轻量流程（可能无法完整追踪） |
+
+## Step 3: 收集项目上下文并写入文件
+
+**收集并写入上下文文件:**
+
+```bash
+mkdir -p .openmatrix
+
+# 写入上下文文件头
+echo "# 项目上下文" > .openmatrix/feature-context.md
+echo "" >> .openmatrix/feature-context.md
+
+# 收集技术栈并写入文件
+echo "## 技术栈" >> .openmatrix/feature-context.md
+cat package.json 2>/dev/null | grep -E '"(react|vue|angular|next|express|fastify|koa|typeorm|prisma|sequelize|mongoose|jest|vitest|playwright|cypress)"' >> .openmatrix/feature-context.md || echo "未检测到常见框架" >> .openmatrix/feature-context.md
+echo "" >> .openmatrix/feature-context.md
+
+# 收集目录结构并写入文件
+echo "## 目录结构" >> .openmatrix/feature-context.md
+find . -maxdepth 2 -type d -not -path '*/node_modules/*' -not -path '*/.git/*' -not -path '*/dist/*' -not -path '*/.openmatrix/*' 2>/dev/null | head -30 >> .openmatrix/feature-context.md
+echo "" >> .openmatrix/feature-context.md
+
+# 读取 CLAUDE.md 并写入文件
+echo "## 项目规范（来自 CLAUDE.md）" >> .openmatrix/feature-context.md
+cat CLAUDE.md 2>/dev/null | head -50 >> .openmatrix/feature-context.md || echo "无 CLAUDE.md" >> .openmatrix/feature-context.md
+```
+
+上下文已写入 `.openmatrix/feature-context.md`，后续 Agent 会读取此文件。
+
+## Step 4: AI 拆分为 2-5 个小任务块
+
+**调用 Agent 进行任务拆分：**
+
+```typescript
+Agent({
+  subagent_type: "general-purpose",
+  description: "任务拆分分析",
+  prompt: `你是任务拆分专家。将用户需求拆分为 2-5 个小任务块。
+
+## 用户需求
+${taskDescription}
+
+${projectContext}
+
+## 拆分原则
+1. 拆分粒度：每个小块 ≤ 30 分钟工作量
+2. 拆分方向：数据层 → API层 → UI层 / 核心逻辑 → 边界处理
+3. 依赖关系：确保后续任务可依赖前面的成果
+4. 文件预估：基于项目目录结构，预估每个任务涉及的文件路径
+5. 技术栈对齐：使用项目已有的框架和库，不引入新依赖
+
+## 输出格式
+请按以下格式输出：
+
+\`\`\`
+📋 任务拆分计划
+
+原始需求：${taskDescription}
+
+拆分为 N 个小任务：
+1. [任务名称]
+   描述：[简要描述]
+   预估文件：[基于项目结构的文件路径列表]
+   预估时间：[分钟]
+
+2. [任务名称]
+   ...
+
+📋 依赖关系图
+任务1 → 任务2 → 任务3
+\`\`\`
+
+## 注意事项
+- 如果任务过于复杂无法拆分，明确说明并建议使用完整流程
+- 保持任务块独立性，便于验证和提交
+- 文件路径必须基于实际项目结构`,
+  run_in_background: false
+})
+```
+
+## Step 5: 用 TodoWrite 管理任务状态
+
+**将拆分的任务写入 TodoWrite：**
+
+```typescript
+TodoWrite({
+  todos: [
+    { activeForm: "正在实现数据层", content: "数据层：添加搜索参数", status: "pending" },
+    { activeForm: "正在实现 API 层", content: "API 层：实现搜索端点", status: "pending" },
+    { activeForm: "正在实现 UI 层", content: "UI 层：添加搜索框", status: "pending" }
+  ]
+})
+```
+
+**同时更新 feature-session.json（AI 将 tasks 写入文件）：**
+
+```bash
+# 使用 AI 写入 JSON（而非 bash heredoc，因为 tasks 是 JS 数组）
+# AI 执行：Write 文件 .openmatrix/feature-session.json
+# 内容：{ sessionId, status, tasks: [...从 Step 4 获取的数组], currentTaskIndex: 0, quality: null, failureCount: {} }
+```
+
+状态同时在会话和 `.openmatrix/feature-session.json` 中管理。
+
+## Step 6: 问答确认
+
+**⛔ 执行前必须确认所有配置**
+
+**6.1 质量等级（必选）**
+
+根据任务描述，Claude 直接推断推荐的质量等级，并在问题中标注推荐项：
+
+- Bug 修复 / 重构 → 推荐 `balanced`
+- 原型 / demo / 快速验证 → 推荐 `fast`
+- 新功能 / 生产代码 / 涉及测试 → 推荐 `strict`
+- 文档 / skill 文件 → 推荐 `fast`
+
+AskUserQuestion: `header: "质量等级"`, `multiSelect: false`
+
+**question:** 选择质量等级（Claude 推荐：${inferredQuality}，原因：${inferReason}）
+
+| label | description |
+|-------|-------------|
+| `strict` | TDD + >80%覆盖率 + 严格Lint + 安全扫描 — 生产级代码 |
+| `balanced` | >60%覆盖率 + Lint + 安全扫描 — 日常开发 |
+| `fast` | 无质量门禁 — 快速原型/验证 |
+
+**6.2 E2E 测试（仅 strict/balanced）**
+
+根据任务描述推断：若任务涉及前端页面/UI/Web，询问；否则默认跳过（不需要）。
+
+如需询问：
+
+AskUserQuestion: `header: "E2E 测试"`, `multiSelect: false`
+
+**question:** 是否需要端到端 (E2E) 测试？（适用于 Web/Mobile/GUI 项目）
+
+| label | description |
+|-------|-------------|
+| `功能测试` | 验证业务流程正确性，速度快 |
+| `视觉验证` | 需要浏览器可视化验证 UI 样式 |
+| `不需要 (推荐)` | 仅单元测试和集成测试 |
+
+**6.3 确认拆分计划**
+
+AskUserQuestion: `header: "确认计划"`, `multiSelect: false`
+
+**question:** 任务拆分计划已展示，确认开始执行？
+
+| label | description |
+|-------|-------------|
+| `开始执行 (推荐)` | 按计划逐个执行 |
+| `调整计划` | 重新拆分任务 |
+
+**6.4 更新 quality 到 feature-session.json**
+
+问答完成后，更新会话状态：
+
+```bash
+# AI 使用 Write 工具更新 .openmatrix/feature-session.json
+# 内容：{ ...原有内容, quality: "${用户选择的质量等级}", e2eTests: ${e2eChoice} }
+```
+
+## Step 7: 逐个执行小任务
+
+**对 TodoWrite 中的每个任务（按顺序）：**
+
+**7.1 更新状态为 in_progress**
+```typescript
+TodoWrite({ todos: [...] }) // 当前任务标记 in_progress
+```
+
+**7.2 歧义检测与处理**
+
+Agent 输出中可能包含歧义报告：
+
+当 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>
+```
+
+**5 种歧义类型说明：**
+
+| 类型 | 说明 | 示例 |
+|------|------|------|
+| `missing_info` | 缺失关键信息 | "未指定数据库类型" |
+| `conflicting_req` | 需求冲突 | "既要高性能又要低成本" |
+| `unclear_scope` | 范围不清晰 | "是否包含历史数据处理？" |
+| `tech_choice` | 技术选型歧义 | "用 REST 还是 GraphQL？" |
+| `edge_case` | 边界情况未定义 | "超过限制时如何处理？" |
+
+**歧义处理策略（轻量模式）：**
+
+| 严重程度 | 处理方式 |
+|---------|---------|
+| **Critical/High** | AskUserQuestion 立即确认 |
+| **Medium/Low** | 写入进度文件，继续执行 |
+
+**AskUserQuestion 处理（仅 Critical/High）：**
+
+AskUserQuestion: `header: "歧义确认"`, `multiSelect: false`
+**question:** 检测到 ${severity} 级歧义：${description}。请确认处理方式
+
+| label | description |
+|-------|-------------|
+| 提供信息 | 回答歧义相关问题，继续执行 |
+| 跳过任务块 | 标记当前任务块为可选，继续执行下一个 |
+| 修改方案 | 根据歧义调整方案后继续 |
+
+**7.3 调用 Agent 执行**
+
+```typescript
+Agent({
+  subagent_type: "general-purpose",
+  description: task.content,
+  prompt: `你是实现专家。执行以下任务块。
+
+## 项目上下文（请读取文件）
+请先读取 .openmatrix/feature-context.md 了解项目上下文。
+
+## 前序任务结果（请读取文件）
+请读取 .openmatrix/feature-progress.md 了解前序 Agent 的决策和发现。
+
+## 整体任务
+${taskDescription}
+
+## 当前任务
+- 任务名称：${task.content}
+- 预估文件：${task.files}
+- 质量等级：${quality}
+- 前置任务完成状态：${previousTasksStatus}
+
+## 质量要求
+${quality === 'strict' ? `
+- 必须使用 TDD：先写测试，再写实现
+- 测试覆盖率要求：>80%
+- 必须通过严格 Lint
+- 必须通过安全扫描
+` : quality === 'balanced' ? `
+- 测试覆盖率要求：>60%
+- 必须通过 Lint
+- 必须通过安全扫描
+` : `
+- 无质量门禁要求
+- 快速实现功能
+`}
+
+## 实施原则
+1. 先阅读预估文件中的现有代码，理解上下文后再动手
+2. 只修改当前任务相关的文件
+3. 不做"顺便"的重构或优化
+4. 确保代码风格与项目现有代码一致
+5. 完成后运行相关测试验证
+
+## 完成后输出
+请按以下格式输出（不超过3行）：
+1. 关键决策：[做了什么决策及原因]
+2. 创建/修改的文件列表
+3. 对后续任务的建议或注意事项
+
+## 禁止行为
+❌ 执行 git commit（由主流程处理）
+❌ 执行 git checkout — 不要切换分支
+❌ 执行 git merge — 不要合并其他分支
+❌ 执行 git pull — 不要拉取远程更新
+❌ 执行 git push — 不要推送代码
+❌ 执行 git rebase — 不要变基
+❌ 执行 git branch — 不要创建/删除分支
+❌ 修改与当前任务无关的文件
+❌ 进行额外的重构
+
+✅ 允许：git status, git diff, git log`,
+  run_in_background: true
+})
+```
+
+**7.4 等待 Agent 完成，写入进度文件**
+
+Agent 完成后，将输出中的关键决策和建议写入 `.openmatrix/feature-progress.md` 文件：
+
+**注意：以下命令中的变量需要在执行前由 AI 替换为实际值。**
+
+```bash
+# Agent 完成后，追加写入进度文件
+echo "" >> .openmatrix/feature-progress.md
+echo "## 任务 N: ${taskContent}" >> .openmatrix/feature-progress.md
+echo "${agentOutput}" >> .openmatrix/feature-progress.md
+echo "" >> .openmatrix/feature-progress.md
+```
+
+这样后续 Agent 能通过读取文件获取前序 Agent 的决策和发现。
+
+## Step 8: 验证（按质量等级）
+
+**⛔ 验证不通过不得提交，必须停止等待修复**
+
+每个任务完成后，根据质量等级执行验证：
+
+**8.1 执行验证命令**
+
+| 质量等级 | 验证命令 |
+|---------|---------|
+| `strict` | `npm test -- --run && npm run lint && npm run test:coverage && npm audit --audit-level=moderate` |
+| `balanced` | `npm test -- --run && npm run lint && npm audit --audit-level=moderate` |
+| `fast` | 跳过验证 |
+
+**覆盖率阈值检查说明：**
+- strict 模式要求 >80% 覆盖率，`npm run test:coverage` 命令应输出覆盖率报告
+- balanced 模式要求 >60% 覆盖率，建议定期检查覆盖率报告
+
+**8.2 E2E 验证（如果用户选择）**
+- 功能测试：`npm run test:e2e`
+- 视觉验证：启动 Playwright 截图对比
+
+**8.3 验证结果自动判断**
+
+验证命令执行后，根据退出码自动判断结果：
+
+```bash
+# 执行验证命令并捕获结果
+if npm test -- --run && npm run lint; then
+  # 验证成功
+  echo "✅ 验证通过"
+else
+  # 验证失败
+  echo "❌ 验证失败"
+  npm test -- --run 2>&1 | tail -30  # 展示失败详情
+  exit 1
+fi
+```
+
+**验证失败处理：**
+- 自动展示验证失败详情（最后 30 行输出）
+- 停止执行流程
+- 提示用户修复后使用 `/om:resume` 继续
+
+**验证成功处理：**
+- 继续执行 Step 9 Git 提交
+
+## Step 9: 分步 Git 提交
+
+**⛔ 验证通过后必须立即提交，不得积累多个任务块**
+
+**只提交本次任务修改的文件（而非 `git add -A`）：**
+
+**注意：以下命令中的变量需要在执行前由 AI 替换为实际值。**
+
+```bash
+# 获取本次任务修改的文件列表（从 Agent 输出中提取）
+git status --porcelain
+
+# 只提交任务涉及的文件（AI 从 Agent 输出中提取文件列表）
+git add ${modifiedFiles}
+git commit -m "feat(feature): ${originalTask} - ${currentChunk}
+
+改动详情：
+- ${changesSummary}
+
+Co-Authored-By: OpenMatrix https://github.com/bigfish1913/openmatrix"
+```
+
+提交成功后：
+1. **更新 TodoWrite 状态为 completed**
+2. **更新 feature-session.json 的 currentTaskIndex**
+   ```bash
+   # AI 使用 Write 工具更新 .openmatrix/feature-session.json
+   # 内容：{ ...原有内容, currentTaskIndex: ${newIndex} }
+   ```
+3. **继续下一个任务**
+
+## Step 10: 全部任务完成后
+
+**检查 TodoWrite 所有任务状态为 `completed`：**
+
+**10.1 运行最终整体验证**
+```bash
+npm test -- --run
+```
+
+**10.2 收集所有任务的执行摘要**
+
+## Step 11: 输出执行摘要并清理
+
+**展示执行摘要：**
+
+```
+✅ 任务完成：${originalTask}
+
+📊 执行统计：
+- 任务块数：${chunkCount}
+- 质量等级：${quality}
+- 总耗时：约 ${totalTime} 分钟
+- Git 提交：${commitCount} 次
+
+📝 创建/修改的文件：
+${fileList}
+
+🔧 关键决策：
+${decisions}
+
+📈 测试覆盖率：${coverageResult}
+
+✨ 所有任务已完成，会话状态已清理
+```
+
+**清理操作：**
+- TodoWrite 所有任务保持 completed 状态
+- 更新 feature-session.json status 为 `completed`
+  ```bash
+  # AI 使用 Write 工具更新 .openmatrix/feature-session.json
+  # 内容：{ ...原有内容, status: "completed" }
+  ```
+- 持久化文件可选择保留或手动清理
+
+</process>
+
+<arguments>
+$ARGUMENTS
+</arguments>
+
+<examples>
+/om:feature 给用户列表页添加搜索功能
+/om:feature 添加一个导出按钮
+/om:feature docs/small-task.md
+</examples>
+
+<notes>
+## 铁律
+
+**不验证不得提交，验证失败必须停止**
+**每次只改一个任务块，不得并行修改多个文件**
+**验证通过后立即提交，不得积累多个任务块再提交**
+
+## 红线
+
+- 验证失败不得继续执行，必须停止等待修复
+- 不得跳过质量等级确认
+- 不得跳过任务边界确认
+- 不得在 Agent 内部执行任何 Git 操作（commit/checkout/merge/pull/push/rebase/branch）
+
+<RED-FLAGS>
+## 红旗警告 - 停止并回归流程
+
+这些想法意味着你在找借口：
+
+| 想法 | 真相 |
+|-----|------|
+| "验证麻烦，先提交再说" | 未验证的提交会污染仓库 |
+| "任务块小，一次改两个吧" | 无法隔离哪个改动有问题 |
+| "顺便重构下这个代码" | "顺便"是 bug 的温床 |
+| "跳过质量确认，直接开始" | 3秒选择防止后续数小时排查 |
+| "测试失败没关系，手动验证就行" | 手动验证不可重复 |
+| "这个小改动不会影响其他" | 小改动也有根因 |
+| "我知道该怎么做" | 知道概念 ≠ 正确执行 |
+
+</RED-FLAGS>
+
+## 常见借口 vs 真实情况
+
+| 借口 | 真实情况 |
+|------|---------|
+| "验证太慢，先提交" | 未验证的提交会污染仓库，回头排查更慢。 |
+| "一次改两个任务块效率高" | 无法隔离哪个改动有问题。引入新 bug。 |
+| "顺便重构没问题" | "顺便"是 bug 的温床。任务聚焦。 |
+| "质量确认麻烦" | 3 秒的选择防止后续数小时排查。 |
+| "手动验证就行" | 手动验证不可重复。自动化测试才可靠。 |
+| "小改动不会出错" | 小改动也有根因。系统性验证。 |
+
+## 与其他指令的区别
+
+| 指令 | 适用场景 | 任务文件 | 问答 | 验证 | 持久化 |
+|-----|---------|:-------:|:----:|:----:|:-----:|
+| `/om:feature` | 小需求（≤100字，单一功能） | ❌ | 质量+E2E | 按等级 | 必须 |
+| `/om:start` | 标准任务 | ✅ | 质量+E2E+模式 | 按等级 | 必须 |
+| `/om:brainstorm` | 复杂任务 | ✅ | 设计问答 | 按等级 | 必须 |
+| `/om:auto` | 全自动执行 | ✅ | 无 | 按等级 | 必须 |
+
+## 路由触发条件
+
+从 `/om` 主入口自动路由到此 skill 的条件：
+- 任务描述 ≤ 100 字
+- 单一功能点（无多个独立子系统）
+- 不涉及架构设计/技术选型
+- 关键词匹配：小需求、小功能、小改动、minor、quick、快速、添加按钮
+
+## 错误处理流程
+
+```
+验证失败 → 停止执行 → 展示错误详情 → 提示用户修复 → 使用 /om:resume 恢复
+```
+
+| 错误 | 处理 |
+|-----|-----|
+| 测试失败 | 停止，提示用户修复 |
+| Lint 错误 | 停止，提示用户修复 |
+| 安全扫描失败 | 停止，提示用户修复 |
+| Agent 超时 | 询问重试或跳过 |
+| Git 失败 | 提示手动处理 |
+
+## 3+ 次验证失败：质疑任务拆分
+
+**如果同一任务块验证失败 3 次以上：**
+
+**指示拆分问题的模式：**
+- 每次修复产生新的测试失败
+- 任务块范围模糊，边界不清
+- 修改影响多个不相关文件
+
+**停止并质疑拆分方案：**
+- 任务块是否过于复杂？
+- 是否需要重新拆分？
+- 是否应该切换到 `/om:start` 使用完整流程？
+
+**在继续执行之前与用户讨论拆分方案。**
+
+这不是执行失败 — 这是拆分策略问题。
+
+## Git 提交格式
+
+```
+<type>(feature): <任务描述> - <任务块名称>
+
+改动详情
+
+Co-Authored-By: OpenMatrix
+```
+
+type: feat/fix/test/refactor/docs
+
+## 恢复执行
+
+如果验证失败需要修复：
+
+使用 `/om:resume` 继续执行（自动检测 `.openmatrix/feature-session.json` 或 `state.json`）
+
+## 持久化文件说明
+
+执行过程中产生以下文件：
+- `.openmatrix/feature-session.json` - 会话状态（任务列表、当前索引、质量等级）
+- `.openmatrix/feature-context.md` - 项目上下文
+- `.openmatrix/feature-progress.md` - Agent 执行进度
 </notes>