openmatrix 0.2.14 → 0.2.16

package/skills/auto.md

@@ -154,7 +154,7 @@ openmatrix complete TASK-XXX --success       # 标记完成 + 更新统计（含
 # 提交验证（防止 commit 静默失败）:
 git status --porcelain                        # 检查是否有未提交的文件
 # 如果有未提交文件 → 必须手动提交:
-git add -A && git commit -m "feat(TASK-XXX): 任务标题"
+git add . && git commit -m "feat(TASK-XXX): 任务标题"
 
 openmatrix step --json                       # 获取下一个任务 + 检查是否全部完成
 ```
@@ -167,7 +167,68 @@ openmatrix step --json                       # 获取下一个任务 + 检查是
 4. 如果返回 `status: "blocked"` → 有阻塞任务需要处理
 </LOOP-ENFORCEMENT>
 
-对 `subagentTasks` 列表中的每个任务，**必须使用 Agent 工具**（禁止用 gsd-executor 或其他技能替代）:
+#### 6.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>
+```
+
+**5 种歧义类型说明：**
+
+| 类型 | 说明 | 示例 |
+|------|------|------|
+| `missing_info` | 缺失关键信息 | "未指定数据库类型" |
+| `conflicting_req` | 需求冲突 | "既要高性能又要低成本" |
+| `unclear_scope` | 范围不清晰 | "是否包含历史数据处理？" |
+| `tech_choice` | 技术选型歧义 | "用 REST 还是 GraphQL？" |
+| `edge_case` | 边界情况未定义 | "超过限制时如何处理？" |
+
+#### 6.2 歧义处理策略（全自动模式）
+
+**在 `/om:auto` 全自动模式下，所有歧义都写入 Meeting 继续执行，不中断流程：**
+
+| 严重程度 | 处理方式 |
+|---------|---------|
+| **Critical** | Meeting + 继续执行其他任务 |
+| **High** | Meeting + 继续执行其他任务 |
+| **Medium** | Meeting + 继续执行其他任务 |
+| **Low** | Meeting + 继续执行其他任务 |
+
+**全自动模式特点：**
+- ❌ **不使用 AskUserQuestion** — 全自动执行，零人工干预
+- ✅ **所有歧义写入 Meeting** — 执行完成后统一展示
+- ✅ **继续执行其他任务** — 最大化并行度，无阻塞等待
+
+**Meeting 处理流程：**
+```bash
+# 检测到歧义时，写入 Meeting 记录并继续执行
+openmatrix meeting --create --task TASK-XXX --reason "歧义: ${description}" --severity ${overallSeverity}
+
+# 继续执行下一个任务
+openmatrix step --json
+```
+
+**执行完成后提示用户：**
+```
+⚠️ 检测到 N 个歧义记录，请使用 `/om:meeting` 统一处理
+```
+
+#### 6.3 执行 Agent 任务
 
 ```typescript
 Agent({
@@ -246,7 +307,7 @@ openmatrix step --json
 Agent-1 完成 → 写入 context.md → Agent-2 读取 Agent-1 的上下文 → 写入 context.md → ...
 ```
 ```bash
-git add -A && git commit -m "$(cat <<'EOF'
+git add . && git commit -m "$(cat <<'EOF'
 feat: 任务标题
 
 改动点1

package/skills/debug.md

@@ -440,7 +440,7 @@ ${lessons}
 ```bash
 git status --porcelain
 # 如果有未提交文件：
-git add -A && git commit -m "$(cat <<'EOF'
+git add . && git commit -m "$(cat <<'EOF'
 fix: 修复 bug - 问题描述
 
 根因: ...

package/skills/feature.md

@@ -20,16 +20,18 @@ priority: high
 ## 执行顺序 - 必须严格按此顺序，不得跳过
 
 ```
+Step 0:  Git 前置检查与持久化初始化（必须执行）
 Step 1:  接收任务输入（参数、文件、或询问用户）
 Step 2:  AI 自动判断任务边界（不符合条件才询问切换）
-Step 3:  AI 拆分为 2-5 个小任务块
-Step 4:  用 TodoWrite 管理任务状态
-Step 5:  问答确认（质量等级、E2E测试、执行计划）
-Step 6:  逐个执行小任务
-Step 7:  验证（按质量等级）
-Step 8:  分步 Git 提交
-Step 9:  全部任务完成后整体验证
-Step 10: 输出执行摘要并清理
+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: 输出执行摘要并清理
 ```
 
 **铁律：不验证不得提交，验证失败必须停止**
@@ -44,6 +46,39 @@ Step 10: 输出执行摘要并清理
 
 <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`:**
@@ -82,7 +117,7 @@ AskUserQuestion: `header: "任务描述"`, `multiSelect: false`
 
 | 结果 | 处理 |
 |------|------|
-| ✅ 全部满足 | 继续执行 Step 3 |
+| ✅ 全部满足 | 继续执行 Step 3 收集上下文 |
 | ❌ 不满足 | 输出建议并询问是否切换到 `/om:start` |
 
 **如果需要切换，询问：**
@@ -95,7 +130,35 @@ AskUserQuestion: `header: "任务复杂度"`, `multiSelect: false`
 | 切换到 /om:start | 使用完整流程 |
 | 继续用 /om:feature | 强制使用轻量流程（可能无法完整追踪） |
 
-## Step 3: AI 拆分为 2-5 个小任务块
+## 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 进行任务拆分：**
 
@@ -108,11 +171,14 @@ Agent({
 ## 用户需求
 ${taskDescription}
 
+${projectContext}
+
 ## 拆分原则
 1. 拆分粒度：每个小块 ≤ 30 分钟工作量
 2. 拆分方向：数据层 → API层 → UI层 / 核心逻辑 → 边界处理
 3. 依赖关系：确保后续任务可依赖前面的成果
-4. 文件预估：每个任务预估涉及的文件
+4. 文件预估：基于项目目录结构，预估每个任务涉及的文件路径
+5. 技术栈对齐：使用项目已有的框架和库，不引入新依赖
 
 ## 输出格式
 请按以下格式输出：
@@ -125,7 +191,7 @@ ${taskDescription}
 拆分为 N 个小任务：
 1. [任务名称]
    描述：[简要描述]
-   预估文件：[文件列表]
+   预估文件：[基于项目结构的文件路径列表]
    预估时间：[分钟]
 
 2. [任务名称]
@@ -137,12 +203,13 @@ ${taskDescription}
 
 ## 注意事项
 - 如果任务过于复杂无法拆分，明确说明并建议使用完整流程
-- 保持任务块独立性，便于验证和提交`,
+- 保持任务块独立性，便于验证和提交
+- 文件路径必须基于实际项目结构`,
   run_in_background: false
 })
 ```
 
-## Step 4: 用 TodoWrite 管理任务状态
+## Step 5: 用 TodoWrite 管理任务状态
 
 **将拆分的任务写入 TodoWrite：**
 
@@ -156,13 +223,13 @@ TodoWrite({
 })
 ```
 
-状态仅在当前会话有效，不产生持久化文件。
+状态同时在会话和 `.openmatrix/feature-session.json` 中管理。
 
-## Step 5: 问答确认
+## Step 6: 问答确认
 
 **⛔ 执行前必须确认所有配置**
 
-**5.1 质量等级（必选）**
+**6.1 质量等级（必选）**
 
 AskUserQuestion: `header: "质量等级"`, `multiSelect: false`
 
@@ -174,7 +241,7 @@ AskUserQuestion: `header: "质量等级"`, `multiSelect: false`
 | `balanced (推荐)` | >60%覆盖率 + Lint + 安全扫描 — 日常开发 |
 | `fast` | 无质量门禁 — 快速原型/验证 |
 
-**5.2 E2E 测试（仅 strict/balanced）**
+**6.2 E2E 测试（仅 strict/balanced）**
 
 AskUserQuestion: `header: "E2E 测试"`, `multiSelect: false`
 
@@ -186,7 +253,7 @@ AskUserQuestion: `header: "E2E 测试"`, `multiSelect: false`
 | `视觉验证` | 需要浏览器可视化验证 UI 样式 |
 | `不需要 (推荐)` | 仅单元测试和集成测试 |
 
-**5.3 确认拆分计划**
+**6.3 确认拆分计划**
 
 AskUserQuestion: `header: "确认计划"`, `multiSelect: false`
 
@@ -197,16 +264,65 @@ AskUserQuestion: `header: "确认计划"`, `multiSelect: false`
 | `开始执行 (推荐)` | 按计划逐个执行 |
 | `调整计划` | 重新拆分任务 |
 
-## Step 6: 逐个执行小任务
+## Step 7: 逐个执行小任务
 
 **对 TodoWrite 中的每个任务（按顺序）：**
 
-**6.1 更新状态为 in_progress**
+**7.1 更新状态为 in_progress**
 ```typescript
 TodoWrite({ todos: [...] }) // 当前任务标记 in_progress
 ```
 
-**6.2 调用 Agent 执行**
+**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({
@@ -214,7 +330,16 @@ Agent({
   description: task.content,
   prompt: `你是实现专家。执行以下任务块。
 
-## 任务信息
+## 项目上下文（请读取文件）
+请先读取 .openmatrix/feature-context.md 了解项目上下文。
+
+## 前序任务结果（请读取文件）
+请读取 .openmatrix/feature-progress.md 了解前序 Agent 的决策和发现。
+
+## 整体任务
+${taskDescription}
+
+## 当前任务
 - 任务名称：${task.content}
 - 预估文件：${task.files}
 - 质量等级：${quality}
@@ -236,16 +361,17 @@ ${quality === 'strict' ? `
 `}
 
 ## 实施原则
-1. 只修改当前任务相关的文件
-2. 不做"顺便"的重构或优化
-3. 确保代码风格与项目一致
-4. 完成后运行相关测试验证
+1. 先阅读预估文件中的现有代码，理解上下文后再动手
+2. 只修改当前任务相关的文件
+3. 不做"顺便"的重构或优化
+4. 确保代码风格与项目现有代码一致
+5. 完成后运行相关测试验证
 
 ## 完成后输出
 请按以下格式输出（不超过3行）：
-1. 关键决策
+1. 关键决策：[做了什么决策及原因]
 2. 创建/修改的文件列表
-3. 对后续任务的建议
+3. 对后续任务的建议或注意事项
 
 ## 禁止行为
 ❌ 执行 git commit（由主流程处理）
@@ -263,47 +389,79 @@ ${quality === 'strict' ? `
 })
 ```
 
-**6.3 等待 Agent 完成，接收通知**
+**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
+```
 
-## Step 7: 验证（按质量等级）
+这样后续 Agent 能通过读取文件获取前序 Agent 的决策和发现。
+
+## Step 8: 验证（按质量等级）
 
 **⛔ 验证不通过不得提交，必须停止等待修复**
 
 每个任务完成后，根据质量等级执行验证：
 
-**7.1 执行验证命令**
+**8.1 执行验证命令**
 
 | 质量等级 | 验证命令 |
 |---------|---------|
-| `strict` | `npm test -- --run && npm run lint && npm run test:coverage` |
-| `balanced` | `npm test -- --run && npm run lint` |
+| `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` | 跳过验证 |
 
-**7.2 E2E 验证（如果用户选择）**
+**覆盖率阈值检查说明：**
+- strict 模式要求 >80% 覆盖率，`npm run test:coverage` 命令应输出覆盖率报告
+- balanced 模式要求 >60% 覆盖率，建议定期检查覆盖率报告
+
+**8.2 E2E 验证（如果用户选择）**
 - 功能测试：`npm run test:e2e`
 - 视觉验证：启动 Playwright 截图对比
 
-**7.3 验证结果判断**
+**8.3 验证结果自动判断**
 
-AskUserQuestion: `header: "验证结果"`, `multiSelect: false`
-**question:** 任务验证通过了吗？
+验证命令执行后，根据退出码自动判断结果：
 
-| label | description |
-|-------|-------------|
-| 通过 | 验证成功，继续提交 |
-| 未通过 | 验证失败，停止执行 |
+```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` 继续
+- 提示用户修复后使用 `/om:resume-feature` 继续
+
+**验证成功处理：**
+- 继续执行 Step 9 Git 提交
 
-## Step 8: 分步 Git 提交
+## Step 9: 分步 Git 提交
 
 **⛔ 验证通过后必须立即提交，不得积累多个任务块**
 
+**只提交本次任务修改的文件（而非 `git add -A`）：**
+
 ```bash
-git add -A
+# 获取本次任务修改的文件列表（从 Agent 输出中提取）
+git status --porcelain
+
+# 只提交任务涉及的文件
+git add ${modifiedFiles}
 git commit -m "$(cat <<'EOF'
 feat(feature): ${originalTask} - ${currentChunk}
 
@@ -319,18 +477,18 @@ EOF
 1. **更新 TodoWrite 状态为 completed**
 2. **继续下一个任务**
 
-## Step 9: 全部任务完成后
+## Step 10: 全部任务完成后
 
 **检查 TodoWrite 所有任务状态为 `completed`：**
 
-**9.1 运行最终整体验证**
+**10.1 运行最终整体验证**
 ```bash
 npm test -- --run
 ```
 
-**9.2 收集所有任务的执行摘要**
+**10.2 收集所有任务的执行摘要**
 
-## Step 10: 输出执行摘要并清理
+## Step 11: 输出执行摘要并清理
 
 **展示执行摘要：**
 
@@ -356,8 +514,8 @@ ${decisions}
 
 **清理操作：**
 - TodoWrite 所有任务保持 completed 状态
-- 不产生任何 `.openmatrix/` 持久化文件
-- 会话结束后状态自动消失
+- 持久化文件可选择保留或手动清理
+- 任务完成后状态标记为 `completed`
 
 </process>
 
@@ -410,12 +568,12 @@ $ARGUMENTS
 
 ## 与其他指令的区别
 
-| 指令 | 适用场景 | 任务文件 | 问答 | 验证 |
-|-----|---------|:-------:|:----:|:----:|
-| `/om:feature` | 小需求（≤100字，单一功能） | ❌ | 质量+E2E | 按等级 |
-| `/om:start` | 标准任务 | ✅ | 质量+E2E+模式 | 按等级 |
-| `/om:brainstorm` | 复杂任务 | ✅ | 设计问答 | 按等级 |
-| `/om:auto` | 全自动执行 | ✅ | 无 | 按等级 |
+| 指令 | 适用场景 | 任务文件 | 问答 | 验证 | 持久化 |
+|-----|---------|:-------:|:----:|:----:|:-----:|
+| `/om:feature` | 小需求（≤100字，单一功能） | ❌ | 质量+E2E | 按等级 | 必须 |
+| `/om:start` | 标准任务 | ✅ | 质量+E2E+模式 | 按等级 | 必须 |
+| `/om:brainstorm` | 复杂任务 | ✅ | 设计问答 | 按等级 | 必须 |
+| `/om:auto` | 全自动执行 | ✅ | 无 | 按等级 | 必须 |
 
 ## 路由触发条件
 
@@ -428,13 +586,14 @@ $ARGUMENTS
 ## 错误处理流程
 
 ```
-验证失败 → 停止执行 → 展示错误详情 → 提示用户修复 → 建议使用 /om:resume 继续
+验证失败 → 停止执行 → 展示错误详情 → 提示用户修复 → 使用 /om:resume-feature 恢复
 ```
 
 | 错误 | 处理 |
 |-----|-----|
 | 测试失败 | 停止，提示用户修复 |
 | Lint 错误 | 停止，提示用户修复 |
+| 安全扫描失败 | 停止，提示用户修复 |
 | Agent 超时 | 询问重试或跳过 |
 | Git 失败 | 提示手动处理 |
 
@@ -470,8 +629,14 @@ type: feat/fix/test/refactor/docs
 
 ## 恢复执行
 
-如果验证失败需要修复，使用 `/om:resume` 继续执行：
-```bash
-/om:resume
-```
+如果验证失败需要修复：
+
+使用 `/om:resume-feature` 继续执行（读取 `.openmatrix/feature-session.json`）
+
+## 挡久化文件说明
+
+执行过程中产生以下文件：
+- `.openmatrix/feature-session.json` - 会话状态（任务列表、当前索引、质量等级）
+- `.openmatrix/feature-context.md` - 项目上下文
+- `.openmatrix/feature-progress.md` - Agent 执行进度
 </notes>