用途:用于任何技术问题的排查,包括测试失败、生产环境 bug、异常行为、性能问题、构建失败和集成问题。核心原则是在尝试修复之前先找到根本原因,只修症状视为失败。
主要能力:提供四阶段流程。第一阶段根因调查:完整阅读错误信息与堆栈跟踪、稳定复现、检查近期变更(git diff、提交、依赖与配置变更),在多组件系统中于各组件边界添加诊断埋点收集证据,并沿调用栈反向追踪数据流。第二阶段模式分析:找到可正常工作的示例、与参考实现逐行对比、列出所有差异、理解依赖与隐含假设。第三阶段假设与验证:提出单一具体假设,做最小改动验证,每次只改一个变量。第四阶段实施:先创建失败测试用例,实施单一修复,验证测试通过且未破坏其他测试。
使用方式:按阶段顺序执行,完成一个阶段才能进入下一个。若修复无效,少于 3 次回到第一阶段重新分析;3 次或以上失败则停下来质疑架构,与搭档讨论后再继续。辅助技术包括 root-cause-tracing.md、defense-in-depth.md、condition-based-waiting.md。
适用场景:时间紧迫、觉得只需小修改、已尝试多种修复、上次修复未生效或未完全理解问题时尤其适用。
限制:资料未提供安装命令、平台支持、收费与价格信息。若系统化排查后确认问题属环境、时序或外部因素,需记录排查过程并实施重试、超时、错误提示等处理,同时添加监控日志;资料指出 95% 的“找不到根因”实为排查不充分。