bugfix-farming

30 秒简介

用于"把一个 Bug 从问题描述推进到修复"。

它聚焦 7 个步骤：

1. 建立可执行 Bug 卡
2. 先做最小复现（先红，可跳过）
3. 假设驱动定位根因
4. 实施修复（用户决定范围）
5. 同上下文补测试（可跳过）
6. 接入 CodeReview 流程（可跳过）
7. 生成修复报告

快速上手

如何触发

在对话中直接描述你要修的 Bug，AI 会自动加载本技能。无需输入任何斜杠命令。

可以这样说：

• "帮我修个 bug：用户登录后页面白屏"
• "定位一下这个回归：订单接口突然返回 500"
• "线上缺陷修复：支付回调没触发"

前置准备

在启动前，请尽量准备好以下信息（缺了也能开始，但信息越全 AI 定位越快）：

流程概览

你描述 Bug → AI 建 Bug 卡 → [复现确认] → AI 定位根因 → [方案确认] → AI 实施修复 → [测试确认] → [CodeReview] → 完成报告

其中 [ ] 为强制检查点，AI 不会跳过你的确认直接动手改代码。

你只需要做两件事

1. 描述问题：用自然语言告诉 AI "什么坏了"
2. 按快捷键确认：每个关键节点 AI 会停下来等你，输入 y 继续，r 提修改意见

适用场景

• 用户提到"修bug""定位回归""线上缺陷修复""排查问题"
• CI 失败怀疑是代码问题而非偶发波动
• 希望把修复过程沉淀成可复用步骤
• 不确定 Bug 根因，需要 AI 辅助分析

不适合的场景

• 👎 "帮我写一个新功能"
• 👎 "这段代码写得怎么样"
• 👎 "帮我理解这个模块"

人机协作原则（最高优先级）

AI 负责「分析 + 提案」，人类负责「确认 + 决策」。AI 不得在未经人工确认的情况下直接修改代码。

每次执行必须遵守以下强制检查点，任一检查点未通过则禁止进入下一步：

CP3 特别规则：若人工对 AI 修复方案不满意，AI 必须提供至少 2 个备选方案供选择，其中至少 1 个必须是思路完全不同的替代路径（非同一路径的微调），不得强行实施原方案。用户可输入 p 启动 party-mode 多角色讨论方案；输入 e 要求 AI 扩大修复范围（可连带重构相关模块），重新出方案。讨论/扩展完毕后 AI 重新提交修订方案。

快捷确认指令

每个检查点 AI 提交交付物后，必须附上确认提示，用户可用数字快速响应：

检查点（CP）确认格式（s 不出现在 CP 中，跳过在步骤执行前处理）：
🔴 [CPx] 请确认以上内容。输入 y=确认通过，r=需修改（可附带修改意见）[，p=Party讨论][，e=扩为大改]。

可跳过步骤的预执行格式（执行步骤前询问，非检查点）：
🔵 [步骤x] 是否执行[步骤名]？输入 y=执行，s=跳过[步骤名]。

输出格式（固定）

1. ## Bug 修复报告
2. ### Bug 卡（现象 / 期望 / 影响范围 / 验收句）
3. ### 复现与根因（复现证据 / 候选根因 / 最终根因）
4. ### 修复与测试（改动文件 / 新增或更新测试 / 本地结果）
5. ### 门禁与收口（code-review 结论）
6. ### 结论（已修复可收口 / 需继续修复 / 阻塞）

工作流架构

本技能使用 step-file 架构 实现按需加载，避免一次性加载全部内容造成的上下文膨胀：

• 微文件设计：每个步骤自包含，精确按需执行
• 即时加载：仅加载当前步骤文件，不预加载后续步骤
• 顺序执行：严格按步骤顺序完成，强制检查点不可跳过
• 人机确认：每个检查点暂停等待人工确认

步骤处理规则

1. 完整阅读：执行前完整阅读当前步骤文件
2. 严格遵循：按步骤文件中的指令顺序执行
3. 检查点暂停：到达 🔴 CP 时暂停，等待人工确认
4. 加载下一步：当前步骤完成后，按 NEXT 指令加载下一步文件

关键规则（不可违反）

• 绝不同时加载多个步骤文件
• 始终在执行前完整阅读步骤文件
• 绝不跳过强制检查点（CP1、CP2、CP3、CP4）
• 始终在检查点等待人工确认后再继续

护栏

• 禁止"未经人工确认直接改代码"——CP2、CP3 为强制闸门，不可跳过。步骤 2（复现）、步骤 5（补测试）和步骤 6（CodeReview）可在执行前跳过。
• 禁止"未复现先改代码"。
• 禁止把"CI 重跑成功"当作根因修复。
• 禁止 AI 在 CP3 被否决后强行实施原方案——必须提供备选，且至少 1 个是思路完全不同的替代路径。
• 禁止"同一模块连续打补丁不审视"——步骤 3 全局审视为强制项，不可跳过。
• 默认原子提交，不混入无关重构。
• 发现高风险回归时，优先回滚（revert PR）再补回归测试。
• 若用户在任一检查点长时间未响应，AI 应主动询问而非自行决策推进。

参考文档

第三层参考材料，按需查阅：

• 完整对话示例 — 典型 Bug 修复全流程走查
• 常见问题 FAQ — 7 个高频疑问的详细解答

第一步

完整阅读并遵循 ./step-01-triage.md 开始工作流。