7.4 Bug 修复与重构路径

Bug 修复和重构是检验 Agent 使用水平的最好场景。

Bug 修复路径

输入材料

准备：

• 错误现象。
• 复现步骤。
• 日志或 stack trace。
• 最近相关改动。
• 期望行为。

Agent 流程

1. 先复现或解释如何复现。
2. 提出 2-3 个可能根因。
3. 用代码和日志验证假设。
4. 做最小修复。
5. 补回归测试。
6. 跑验证。
7. 写复盘。

禁止

• 不复现直接改。
• 猜一个原因就改。
• 修完不补测试。
• 改大范围无关代码。

重构路径

重构前先问：

• 外部行为是否保持不变？
• 现有测试是否足够？
• 是否需要 characterization test？
• 重构范围是否清楚？
• 是否有回滚点？

Agent 流程

1. 分析当前结构。
2. 找重复、复杂度、边界问题。
3. 写重构计划。
4. 人审计划。
5. 小步改动。
6. 每步跑测试。
7. 最后做 diff review。

验证标准

Bug 修复：

• 原 bug 可复现。
• 修复后不再复现。
• 有回归测试。

重构：

• 外部行为不变。
• 测试通过。
• diff 中没有无关功能变化。

复盘写回

任务结束后，让 Agent 回答：

这个 bug 为什么会出现？
哪些测试原本应该发现它？
AGENTS.md / CLAUDE.md 需要新增什么规则？
是否应该做成 bug-fix skill？