用途:在遇到缺陷、测试或 CI 失败、异常行为或性能问题时,用系统化的根因调试加完成前验证来定位并修复问题。尤其适合时间紧迫时的“快速改一下”场景,以及在声称“已修复/通过/完成”之前使用。不适用于没有失败现象的全新功能开发。
核心原则:证据先于修复,证据先于“已修复”的声明。铁律:未先调查根因不做修复;没有本轮新鲜验证证据不声称已修复/通过/完成。
工作流分阶段进行。第一阶段调查:完整阅读错误、堆栈与日志,稳定复现,检查近期改动(git diff、提交、配置、环境),多组件系统在边界处插桩定位断点,沿坏值回溯到源头并计划在源头修复,期间建立待办,未确认根因前不改生产逻辑。第二阶段找模式:在仓库内找到可用的相似路径,对比可用与损坏的差异,记录依赖与假设。第三阶段假设:提出单一假设“X 是根因,因为 Y”,设计最小证伪测试;假设错误则换新假设。第四阶段用 TDD 修复:先写锁定缺陷的失败回归测试并观察 RED,再最小修复到 GREEN。第五阶段验证:声称修复前必须明确证明命令、重新完整运行、阅读退出码与失败,然后带证据声明;回归需呈现红绿证明。
交付前设过渡关卡,需询问用户选择:推荐继续进入评审(再提交推送)、先运行评审再回到关卡、回到调试处理未锁定边界、或其他。限制:资料未提供具体命令、安装方式、价格或平台信息。