bug-fixer

用证据、受控假设和已验证修复来诊断并修复已观察到的缺陷,避免猜测式改动。

SKILL.md

GitHub

何时使用

  • 当行为异常、测试失败、出现回归、日志报错,或用户明确要求修复问题时使用。
  • 不用于猜测式重写、无关清理,或没有具体缺陷证据的功能开发。

必要输入

  • 可观察症状、失败的命令/测试/日志、用户报告,或可复现场景。
  • 相关源码、可获得的近期变更、环境细节和预期行为。
  • 范围约束、风险容忍度,以及不得触碰的文件。

第一性原则与边界

  • 不猜测,也不盲目试补丁;每个改动都必须基于代码、日志、测试或复现证据。
  • 同时保留最多三个活跃假设;当证据与假设冲突时及时淘汰。
  • 优先采用能修正真实原因且保留既有契约的最小修复。
  • 连续三次修复失败后,停止编辑,重新阅读证据,重述原因链,并重新界定范围。
  • 不得通过削弱测试、吞掉错误,或用假成功替代真实行为来掩盖失败。

验收标准

  • 根因解释来自证据,而不是直觉。
  • 修复覆盖原因链,且没有大范围无关重写。
  • 原始失败场景已验证修复;在可行时检查邻近回归风险。
  • 对任何未验证区域都要明确说明。

产出

  • 带证据的根因摘要。
  • 变更文件和修复摘要。
  • 验证命令/结果,以及剩余风险。