用途:用于遇到任何技术问题时进行系统化调试,包括测试失败、生产环境缺陷、异常行为、性能问题、构建失败和集成问题,尤其在时间紧迫、想快速打补丁或已多次尝试修复失败时使用。
主要能力:强调铁律“未完成根因调查前不得提出修复”。分四个必须依次完成的阶段:一是根因调查,仔细阅读报错与堆栈、稳定复现、检查近期改动,在多组件系统中于各组件边界加诊断日志收集证据,并沿调用栈追溯数据来源;二是模式分析,寻找可用的相似实现、完整阅读参考实现、列出差异并理解依赖;三是假设与测试,一次只提出一个明确假设,做最小改动验证,不成立就重新假设,不叠加补丁;四是修复实现,先编写失败测试用例(可用 tdd 技能),只做一个针对根因的修改,再验证修复且不破坏其他测试。若三次以上修复均失败,应停止并质疑架构,与人类伙伴讨论。
使用方式:按阶段顺序执行,可用同目录下的 root-cause-tracing.md、defense-in-depth.md、condition-based-waiting.md 辅助;相关技能有 tdd 和 verify。识别并避免“先快速修一下”“一次改多处”“跳过测试手动验证”等借口式思维;当人类伙伴说“别猜了”“深入思考一下”等信号时,回到第一阶段。
适用场景:任何技术故障排查,尤其是复杂多组件系统和反复修复无效时。限制:资料未提供具体平台、安装命令、费用或效果数据,仅描述方法论;若系统化调查后确认为环境、时序或外部因素,则记录调查并做相应处理。