用途:面向任何技术问题的调试方法,用于测试失败、生产缺陷、异常行为、性能问题、构建失败与集成问题。尤其在时间紧迫、看似只需“一个小修改”、已多次尝试修复无效、或尚不完全理解问题时应使用;问题看起来简单时也不应跳过。
主要能力:以“铁律”约束流程——未完成第一阶段根因调查不得提出修复。流程分四阶段。第一阶段根因调查:仔细阅读错误与堆栈信息,稳定复现,检查近期改动,多组件系统在各边界记录输入输出与环境配置以定位失败层,并沿调用栈向上追溯数据来源(见同目录 root-cause-tracing.md)。第二阶段模式分析:寻找同类可用示例、完整对照参考实现、列出全部差异、理解依赖与假设。第三阶段假设与验证:写出单一明确假设,只做最小改动、一次只验一个变量,未通过则另立新假设而非叠加修复。第四阶段实现:先建立最小失败测试(可结合 superpowers:test-driven-development),再做单一根因修复,最后验证原问题解决且未破坏其他测试。
限制与补充:若修复失败少于3次,回到第一阶段并带上新信息;达到3次及以上应停止,转入架构质疑,与人类伙伴讨论,不再尝试第4次修复。若系统化调查确认问题属环境、时序或外部因素,应记录调查结论,采用重试、超时、错误信息等处理,并补充监控日志;但多数“无根因”实为调查不完整。附带技术还包括 defense-in-depth.md 与 condition-based-waiting.md。资料未提供安装命令、收费或平台信息。