openmatrix 0.2.9 → 0.2.11

package/dist/orchestrator/phase-executor.js

@@ -251,11 +251,21 @@ ${task.acceptanceCriteria?.map((c, i) => `${i + 1}. ${c}`).join('\n') || '根据
 ## 验证
 运行 \`npm test\` 确认测试失败 (这是正确的!)
 
-## ⚠️ Git 提交规范
-
-**禁止执行 \`git commit\`**
-
-所有代码提交必须通过 \`openmatrix complete\` 命令统一执行。测试文件创建完成后，只需返回结果摘要，**不要执行 git commit**。
+## ⚠️ Git 操作禁止
+
+**禁止执行以下 Git 命令**：
+- ❌ \`git commit\` — 所有提交统一通过 \`openmatrix complete\` 执行
+- ❌ \`git checkout\` — 不要切换分支
+- ❌ \`git merge\` — 不要合并其他分支
+- ❌ \`git pull\` — 不要拉取远程更新
+- ❌ \`git push\` — 不要推送代码
+- ❌ \`git rebase\` — 不要变基
+- ❌ \`git branch\` — 不要创建/删除分支
+
+**允许的 Git 命令**：
+- ✅ \`git status\` — 查看状态
+- ✅ \`git diff\` — 查看差异
+- ✅ \`git log\` — 查看历史
 
 ## 输出格式
 \`\`\`
@@ -386,16 +396,23 @@ ${task.acceptanceCriteria.map((c, i) => `${i + 1}. [ ] ${c}`).join('\n')}`);
 - [ ] 验收标准全部满足
 ${isTDDMode ? '- [ ] 所有测试通过 (GREEN)' : ''}
 
-## ⚠️ Git 提交规范
+## ⚠️ Git 操作禁止
 
-**禁止执行 \`git commit\`**
+**禁止执行以下 Git 命令**：
+- ❌ \`git commit\` — 所有提交统一通过 \`openmatrix complete\` 执行
+- ❌ \`git checkout\` — 不要切换分支
+- ❌ \`git merge\` — 不要合并其他分支
+- ❌ \`git pull\` — 不要拉取远程更新
+- ❌ \`git push\` — 不要推送代码
+- ❌ \`git rebase\` — 不要变基
+- ❌ \`git branch\` — 不要创建/删除分支
 
-所有代码提交必须通过 \`openmatrix complete\` 命令统一执行，该命令会：
-1. 使用正确的任务标题 (当前任务: ${task.title})
-2. 自动生成规范的提交信息
-3. 避免产生重复或无意义的提交
+**允许的 Git 命令**：
+- ✅ \`git status\` — 查看状态
+- ✅ \`git diff\` — 查看差异
+- ✅ \`git log\` — 查看历史
 
-如果代码变更已完成，只需返回结果摘要，**不要执行 git commit**。
+如果代码变更已完成，只需返回结果摘要。
 `);
         return parts.join('\n');
     }
@@ -676,7 +693,21 @@ Fix Required:
 - **不要伪造通过结果**
 - 如果项目没有某个脚本，标记为 "⏭️ Skipped" 而非 "❌ Failed"
 - 所有检查结果必须基于实际命令输出
-- **禁止执行 \`git commit\`** — 所有提交统一通过 \`openmatrix complete\` 执行
+## ⚠️ Git 操作禁止
+
+**禁止执行以下 Git 命令**：
+- ❌ \`git commit\` — 所有提交统一通过 \`openmatrix complete\` 执行
+- ❌ \`git checkout\` — 不要切换分支
+- ❌ \`git merge\` — 不要合并其他分支
+- ❌ \`git pull\` — 不要拉取远程更新
+- ❌ \`git push\` — 不要推送代码
+- ❌ \`git rebase\` — 不要变基
+- ❌ \`git branch\` — 不要创建/删除分支
+
+**允许的 Git 命令**：
+- ✅ \`git status\` — 查看状态
+- ✅ \`git diff\` — 查看差异
+- ✅ \`git log\` — 查看历史
 
 ## 🔧 配置检查 (可选但推荐)
 检查以下常见配置问题:
@@ -811,8 +842,21 @@ ACCEPT_FAILED
 1. [原因]
 \`\`\`
 
-## ⚠️ Git 提交规范
-**禁止执行 \`git commit\`** — 所有提交统一通过 \`openmatrix complete\` 执行，确保使用正确的任务标题。
+## ⚠️ Git 操作禁止
+
+**禁止执行以下 Git 命令**：
+- ❌ \`git commit\` — 所有提交统一通过 \`openmatrix complete\` 执行
+- ❌ \`git checkout\` — 不要切换分支
+- ❌ \`git merge\` — 不要合并其他分支
+- ❌ \`git pull\` — 不要拉取远程更新
+- ❌ \`git push\` — 不要推送代码
+- ❌ \`git rebase\` — 不要变基
+- ❌ \`git branch\` — 不要创建/删除分支
+
+**允许的 Git 命令**：
+- ✅ \`git status\` — 查看状态
+- ✅ \`git diff\` — 查看差异
+- ✅ \`git log\` — 查看历史
 `);
         return parts.join('\n');
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openmatrix",
-  "version": "0.2.9",
+  "version": "0.2.11",
   "description": "AI Agent task orchestration system with Claude Code Skills integration",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/skills/auto.md

@@ -173,7 +173,7 @@ openmatrix step --json                       # 获取下一个任务 + 检查是
 Agent({
   subagent_type: task.subagent_type,
   description: task.description,
-  prompt: task.prompt + "\n\n⚠️ 完成后请输出简短摘要（不超过3行）：\n1. 关键决策\n2. 创建/修改的文件\n3. 对后续任务的建议\n\n🚫 **禁止执行 git commit** — 所有提交统一通过 openmatrix complete 执行，确保使用正确的任务标题。",
+  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
 })
@@ -183,7 +183,7 @@ Agent({
 >
 > **上下文节省**: 使用 `run_in_background: true` 后台执行，Agent 完成后仅返回简短摘要，大幅节省主会话上下文。
 >
-> 🚫 **Agent 内部禁止 git commit** — 所有提交必须通过 `openmatrix complete` 执行，否则会产生无意义提交。
+> 🚫 **Agent 内部禁止 Git 操作** — 禁止执行：git commit, git checkout, git merge, git pull, git push, git rebase, git branch。所有提交必须通过 `openmatrix complete` 执行。
 
 每个 Agent 完成后:
 1. **保存 Agent 上下文** — 将执行结果摘要写入 `.openmatrix/tasks/TASK-XXX/context.md`，格式如下:

package/skills/debug.md

@@ -114,12 +114,67 @@ Agent({
 - 问题描述: ${description}
 ${relatedTaskId ? `- 关联任务: ${relatedTaskId}` : ''}
 
-## 任务
-1. 仔细阅读所有错误信息（不要跳过任何警告或错误）
-2. 收集相关文件和日志
-3. 检查近期代码变更（git diff、最近提交）
-4. 如果有多个组件，追踪数据流，找到断裂点
-5. 定位问题根源
+## 调查步骤（必须按顺序执行）
+
+### 1. 仔细阅读错误信息
+- 不要跳过任何警告或错误
+- 错误信息往往包含解决方案
+- 完整阅读堆栈跟踪
+- 记录行号、文件路径、错误代码
+
+### 2. 稳定复现
+- 能否可靠触发？
+- 精确步骤是什么？
+- 每次都会发生吗？
+- 不能复现 → 收集更多数据，不要猜测
+
+### 3. 检查近期变更
+- git diff、最近提交
+- 新依赖、配置变更
+- 环境差异
+
+### 4. 多组件系统诊断（如有多个组件）
+**当系统有多个组件（CI → build → signing, API → service → database）：**
+
+**在提出修复之前，添加诊断日志：**
+\`\`\`
+对每个组件边界：
+  - 记录什么数据进入组件
+  - 记录什么数据退出组件
+  - 验证环境/配置传递
+  - 检查每层状态
+
+运行一次收集证据，显示哪里断裂
+然后分析证据识别失败组件
+然后深入调查该组件
+\`\`\`
+
+**示例（多层系统）：**
+\`\`\`bash
+# Layer 1: Workflow
+echo "=== Secrets in workflow: ==="
+echo "IDENTITY: ${IDENTITY:+SET}${IDENTITY:-UNSET}"
+
+# Layer 2: Build script
+echo "=== Env vars in build: ==="
+env | grep IDENTITY || echo "IDENTITY not in env"
+
+# Layer 3: Signing script
+echo "=== Keychain state: ==="
+security list-keychains
+
+# Layer 4: Actual signing
+codesign --sign "$IDENTITY" --verbose=4 "$APP"
+\`\`\`
+
+这揭示：哪层失败（secrets → workflow ✓, workflow → build ✗）
+
+### 5. 追踪数据流
+**当错误在调用栈深处：**
+- 错误值从哪里产生？
+- 谁传入的这个错误值？
+- 继续向上追踪直到源头
+- 在源头修复，不是症状处
 
 ## 输出格式
 请按以下格式输出：
@@ -136,6 +191,10 @@ ${relatedTaskId ? `- 关联任务: ${relatedTaskId}` : ''}
 - 提交1: 描述
 - 提交2: 描述
 
+### 多组件诊断结果（如适用）
+- Layer N 状态: ...
+- 断裂点: ...
+
 ### 根因分析
 [详细描述问题根源]
 
@@ -448,4 +507,69 @@ Step 10: 写入 Debug Report
 - 不修改未关联的文件
 - 单一修复原则
 - 修复前必须有验证方法
+
+## 红旗警告 - 停止并回归流程
+
+**如果发现自己在想：**
+- "先快速修复，之后再调查"
+- "试试改 X 看看能不能工作"
+- "一次改多处，跑测试"
+- "跳过测试，手动验证就行"
+- "大概是 X 问题，直接修吧"
+- "不太懂但这可能有用"
+- "模式说 X 但我要改动一下"
+- "这里列出主要问题：[未经调查直接列修复]"
+- 提出解决方案前没有追踪数据流
+- **"再试一次修复"（已经试过 2+ 次）**
+- 每次修复揭示新地方的问题
+
+**所有这些意味着：停止。回到 Step 3。**
+
+## 常见借口 vs 真实情况
+
+| 借口 | 真实情况 |
+|------|---------|
+| "问题简单，不需要流程" | 简单问题也有根因。流程处理简单 bug 很快。 |
+| "紧急情况，没时间走流程" | 系统化调试比瞎猜乱试更快。 |
+| "先试试这个，再调查" | 第一次修复定基调。从一开始就做对。 |
+| "确认修复有效后再写测试" | 没测试的修复不牢靠。先写测试证明它。 |
+| "一次改多处节省时间" | 无法隔离哪个有效。还会引入新 bug。 |
+| "参考文档太长，我按模式改改" | 一知半解必然有 bug。完整阅读。 |
+| "我看到问题了，直接修吧" | 看到症状 ≠ 理解根因。 |
+| "再试一次修复"（失败 2+ 次后） | 3+ 次失败 = 架构问题。质疑模式，不要继续修。 |
+
+## 3+ 次修复失败：质疑架构
+
+**指示架构问题的模式：**
+- 每次修复揭示新共享状态/耦合/其他地方的问题
+- 修复需要"大规模重构"才能实现
+- 每次修复在其他地方产生新症状
+
+**停止并质疑根本问题：**
+- 这个模式根本上是否合理？
+- 我们是否"靠惯性硬撑"？
+- 应该重构架构还是继续修补症状？
+
+**在尝试更多修复之前与用户讨论。**
+
+这不是假设失败 — 这是架构错误。
+
+## 无根因的情况
+
+如果系统化调查揭示问题确实是环境、时序依赖或外部因素：
+
+1. 你已完成流程
+2. 记录调查了什么
+3. 实现适当处理（重试、超时、错误消息）
+4. 添加监控/日志以便未来调查
+
+**但：** 95% 的"无根因"情况是调查不完整。
+
+## 实际影响
+
+来自调试实践：
+- 系统化方法：15-30 分钟修复
+- 随机修复方法：2-3 小时折腾
+- 首次修复率：95% vs 40%
+- 引入新 bug：接近零 vs 常见
 </notes>

package/skills/feature.md

@@ -249,8 +249,16 @@ ${quality === 'strict' ? `
 
 ## 禁止行为
 ❌ 执行 git commit（由主流程处理）
+❌ 执行 git checkout — 不要切换分支
+❌ 执行 git merge — 不要合并其他分支
+❌ 执行 git pull — 不要拉取远程更新
+❌ 执行 git push — 不要推送代码
+❌ 执行 git rebase — 不要变基
+❌ 执行 git branch — 不要创建/删除分支
 ❌ 修改与当前任务无关的文件
-❌ 进行额外的重构`,
+❌ 进行额外的重构
+
+✅ 允许：git status, git diff, git log`,
   run_in_background: true
 })
 ```
@@ -375,7 +383,30 @@ $ARGUMENTS
 - 验证失败不得继续执行，必须停止等待修复
 - 不得跳过质量等级确认
 - 不得跳过任务边界确认
-- 不得在 Agent 内部执行 git commit
+- 不得在 Agent 内部执行任何 Git 操作（commit/checkout/merge/pull/push/rebase/branch）
+
+## 红旗警告 - 停止并回归流程
+
+**如果发现自己在想：**
+- "验证麻烦，先提交再说"
+- "任务块小，一次改两个吧"
+- "顺便重构下这个代码"
+- "跳过质量确认，直接开始"
+- "测试失败没关系，手动验证就行"
+- "这个小改动不会影响其他"
+
+**所有这些意味着：停止。回到流程执行。**
+
+## 常见借口 vs 真实情况
+
+| 借口 | 真实情况 |
+|------|---------|
+| "验证太慢，先提交" | 未验证的提交会污染仓库，回头排查更慢。 |
+| "一次改两个任务块效率高" | 无法隔离哪个改动有问题。引入新 bug。 |
+| "顺便重构没问题" | "顺便"是 bug 的温床。任务聚焦。 |
+| "质量确认麻烦" | 3 秒的选择防止后续数小时排查。 |
+| "手动验证就行" | 手动验证不可重复。自动化测试才可靠。 |
+| "小改动不会出错" | 小改动也有根因。系统性验证。 |
 
 ## 与其他指令的区别
 
@@ -407,6 +438,24 @@ $ARGUMENTS
 | Agent 超时 | 询问重试或跳过 |
 | Git 失败 | 提示手动处理 |
 
+## 3+ 次验证失败：质疑任务拆分
+
+**如果同一任务块验证失败 3 次以上：**
+
+**指示拆分问题的模式：**
+- 每次修复产生新的测试失败
+- 任务块范围模糊，边界不清
+- 修改影响多个不相关文件
+
+**停止并质疑拆分方案：**
+- 任务块是否过于复杂？
+- 是否需要重新拆分？
+- 是否应该切换到 `/om:start` 使用完整流程？
+
+**在继续执行之前与用户讨论拆分方案。**
+
+这不是执行失败 — 这是拆分策略问题。
+
 ## Git 提交格式
 
 ```

package/skills/start.md

@@ -395,7 +395,7 @@ openmatrix step --json                       # 获取下一个任务 + 检查是
 Agent({
   subagent_type: task.subagent_type,
   description: task.description,
-  prompt: task.prompt + "\n\n⚠️ 完成后请输出简短摘要（不超过3行）：\n1. 关键决策\n2. 创建/修改的文件\n3. 对后续任务的建议\n\n🚫 **禁止执行 git commit** — 所有提交统一通过 openmatrix complete 执行，确保使用正确的任务标题。",
+  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
 })
@@ -405,7 +405,7 @@ Agent({
 >
 > **上下文节省**: 使用 `run_in_background: true` 后台执行，Agent 完成后仅返回简短摘要，不返回完整输出，大幅节省主会话上下文。
 >
-> 🚫 **Agent 内部禁止 git commit** — 所有提交必须通过 `openmatrix complete` 执行，否则会产生 "Test Task" 等无意义提交。
+> 🚫 **Agent 内部禁止 Git 操作** — 禁止执行：git commit, git checkout, git merge, git pull, git push, git rebase, git branch。所有提交必须通过 `openmatrix complete` 执行。
 
 每个 Agent 完成后（收到后台完成通知时）:
 1. **标记完成并更新统计（必须执行）:**