Diagnose and fix batch

Skill 0xkangl/skills/skills/diagnose-and-fix-batch

一组可独立装载的 Agent / Claude Code Skills：编码行为准则、横切规范、多仓脚手架与多 agent 代码审计

Install

npx -y skills add 0xkangl/skills --skill diagnose-and-fix-batch

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

手动触发的「问题列表批量修复」编排器。接收问题列表文件（.md/.json/.yaml/.txt）和可选编号，把未修复问题排成队列，逐个派发独立 subagent——每个 subagent 在隔离上下文里调用 diagnose-and-fix skill 完成单问题的「诊断 → 选方案 → 修复 → 测试 → 修复后验证 → 提交代码 → 标记列表」全流程，再回收结构化结果。 **强依赖 diagnose-and-fix skill**（按 skill 名调用，单问题流程与终态均由其定义）。问题列表只标记 resolved、不提交（提交时机由用户掌控）。支持不填编号（自动检测未修复）、单个或多个编号。

SKILL.md

7.4 KB, as published. Nobody here has run it

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 填 `—`），继续队列，并在摘要提示该 `#<编号>` 需手动复核