Diagnose and fix batch

Diagnose and Fix (Batch) Skill

@diagnose-and-fix-batch <问题列表文件>              # 自动检测所有未修复问题
@diagnose-and-fix-batch <问题列表文件> 3            # 修复单个问题
@diagnose-and-fix-batch <问题列表文件> 3 7 BUG-012  # 修复多个问题（按序处理）

支持 .md / .json / .yaml / .txt，编号可为数字或字符串。

定位

批量循环编排器：主 agent 把问题列表拆成队列，逐个在独立 subagent 里修复（避免污染主会话），回收结构化结果。 单问题的「先诊断、用户选方案、再动手、修完验证、提交代码、标记列表」全流程不在本 skill 内重复定义——每个 subagent 调用 diagnose-and-fix skill 执行，本 skill 只负责排队、派发、回收、汇总。 问题列表只标记 resolved、不提交（由 diagnose-and-fix 在子流程内完成标记）——提交时机由用户统一掌控，本 skill 全程不碰列表文件的提交。

依赖：本 skill 强依赖 diagnose-and-fix skill。主 agent 在 Step 0 先做存在性检查，缺失则直接提示用户、不进入任何 subagent。

---

主流程（Main Agent）

Step 0 — 依赖检查（前置闸门）

派发任何 subagent 前，先确认 diagnose-and-fix skill 已装载（在可用 skill 列表中）。未装载则立即停止，不解析队列、不进入 subagent：

❌ 本 skill 依赖 diagnose-and-fix skill，但未检测到它已装载。
请先装载 diagnose-and-fix（见 README「使用」）后重试。

确认存在后再进入 Step 1。

Step 1 — 解析问题队列

未提供编号： 扫描文件，按格式排除已修复条目：

• JSON/YAML：status 字段值为 resolved/fixed/done/closed（忽略大小写）
• Markdown/纯文本：含 status: resolved、[resolved、✅ 修复记录，或 fixed/done/closed 紧跟编号后

未命中者视为未修复，输出清单后停止，等待用户选择：

🔍 发现 N 个未修复问题：

| # | 编号 | 标题 | 严重程度 | 分类 |
|---|------|------|----------|------|
| 1 | #<编号> | <标题> | <如有> | <如有> |

处理方式： a) 按序逐个修复  b) 指定编号（空格分隔）  c) 取消
请选择：

（无 severity/type 字段时省略对应列）

• a → 全部按序入队
• b → 停止，等待用户输入编号列表后入队
• c → 停止

提供编号： 验证各编号存在，无效的跳过并提示，其余按输入顺序入队。

队列确定后输出确认表格，并询问处理模式（所有路径都问一次）：

📌 待处理队列（共 N 个）：

| 顺序 | 编号 | 标题 |
|------|------|------|
| 1 | #<编号> | <标题> |

处理模式： 1) 连续处理（subagent 之间不停）  2) 逐个确认（每个 subagent 结束后停下）
请选择（默认 1）：

默认连续：用户在每个 subagent 内部已全程参与（选方案、测试失败、提交确认），subagent 之间再加 y/n 是重复摩擦。需中途审视节奏时才选「逐个确认」。

Step 2 — 循环派发 Subagent

按序串行启动 Subagent，注入以下 prompt：

你是问题修复 agent，拥有完整工具权限，可与用户交互。

调用 diagnose-and-fix skill 处理下面这个问题，参数为：<问题列表文件> <编号>
该 skill 会完成单问题全流程：诊断 → 用户选方案 → 修复 → 测试 → 修复后验证 →
提交代码 → 在问题列表内标记 resolved（只标记、不提交列表）。全程交互由该 skill 主导，
你不要另起一套修复流程，也不要重复标记列表。

问题列表文件：<路径>
当前问题编号：<编号>
队列进度：[M/N]
问题内容：
<条目原文>

diagnose-and-fix 收束后，读取它给出的【终态】，按下表映射并返回 RESULT：

| diagnose-and-fix 终态 | status            | 说明 |
|----------------------|-------------------|------|
| completed            | completed         | 已修复并提交代码、列表已标记 resolved |
| skipped_inconsistent | skipped_inconsistent | 描述与代码对不上，用户确认跳过 |
| skipped_noop         | skipped_noop      | 问题已缓解/无需修复，列表标记 no-op |
| user_declined        | user_declined     | 用户选「仅报告，暂不修复」 |
| skipped_test_failed  | skipped_test_failed  | 测试/验证重试超 3 次 |

RESULT 格式（严格按此返回，供主 agent 解析）：

RESULT #<编号>
status: <见上表>
solution: <方案名> | no-op: <原因> | —
code_commit: <hash7> | none | —
list_marked: resolved | no-op | not-marked

Subagent 返回 RESULT 后，追加进度行（首条先输出表头）：

| 状态 | 编号 | 标题 | 方案 | code commit |
|------|------|------|------|-------------|
| ✅/⚠️/❌/⏭️/🔵 | #<编号> | <标题> | <方案名/—> | <hash7/none/—> |

• 连续处理 → 直接启动下一个。
• 逐个确认 → 队列还有下一个时停止，等待用户输入 继续处理下一个 #<编号>：<标题>？(y/n)；y 启动下一个，n 进入 Step 3。

队列处理完进入 Step 3。

Step 3 — 收尾摘要

不提交问题列表，直接输出最终摘要：

🏁 本次共处理 N 个问题（问题列表已标记 resolved、未提交）：

| 状态 | 编号 | 标题 | 方案 | code commit |
|------|------|------|------|-------------|
| ✅ 已完成       | ... | ... | <方案名>    | <hash7> |
| 🔵 无需修复     | ... | ... | <no-op原因> | none    |
| ⚠️ 存疑跳过     | ... | ... | —           | —       |
| ❌ 测试/验证失败 | ... | ... | <方案名>    | —       |
| ⏭️ 用户跳过     | ... | ... | —           | —       |

---

错误处理

本表只列编排器级异常；单问题流程内的失败（测试/验证超限、git 未初始化、格式化工具缺失、列表只读、工作区有无关改动等）由 diagnose-and-fix skill 自行处理并反映在终态里。

情况	处理
文件不存在	Main Agent 报错停止
编号未找到	跳过，继续队列，列出可用编号
无未修复问题	提示「所有问题已修复」后停止
diagnose-and-fix skill 未装载	Step 0 前置拦截：提示用户装载该依赖后停止，不进入 subagent
subagent 返回非 completed 终态	按终态记入进度表/摘要（skipped_*/user_declined），继续队列
subagent 崩溃 / 未返回 RESULT / RESULT 缺失字段或无法解析	记为 ❌ 失败（status 留空、方案与 commit 填 —），继续队列，并在摘要提示该 #<编号> 需手动复核