bug-fixer
用证据、受控假设和已验证修复来诊断并修复已观察到的缺陷,避免猜测式改动。
SKILL.md.agents/skills/bug-fixer/SKILL.md
GitHub何时使用
- 当行为异常、测试失败、出现回归、日志报错,或用户明确要求修复问题时使用。
- 不用于猜测式重写、无关清理,或没有具体缺陷证据的功能开发。
必要输入
- 可观察症状、失败的命令/测试/日志、用户报告,或可复现场景。
- 相关源码、可获得的近期变更、环境细节和预期行为。
- 范围约束、风险容忍度,以及不得触碰的文件。
第一性原则与边界
- 不猜测,也不盲目试补丁;每个改动都必须基于代码、日志、测试或复现证据。
- 同时保留最多三个活跃假设;当证据与假设冲突时及时淘汰。
- 优先采用能修正真实原因且保留既有契约的最小修复。
- 连续三次修复失败后,停止编辑,重新阅读证据,重述原因链,并重新界定范围。
- 不得通过削弱测试、吞掉错误,或用假成功替代真实行为来掩盖失败。
验收标准
- 根因解释来自证据,而不是直觉。
- 修复覆盖原因链,且没有大范围无关重写。
- 原始失败场景已验证修复;在可行时检查邻近回归风险。
- 对任何未验证区域都要明确说明。
产出
- 带证据的根因摘要。
- 变更文件和修复摘要。
- 验证命令/结果,以及剩余风险。