SuperAPI AI 工具集

systematic-debugging

编程与开发

查看项目

更新于 10-28 17:10

技能介绍

Systematic Debugging 是一套用于软件调试的系统化流程技能,强调随机修复只会浪费时间并引入新缺陷,因此必须始终先找到根因再尝试修复。

核心原则(铁律):没有根因调查不进行修复;没有记忆检索不进行调查。

五个阶段:

阶段0:记忆检索(必须首先执行)。从错误中提取关键词(错误类型、组件、项目),查询记忆数据库中相关的过往经验并审视结果:找到相关经验则直接应用并跳到阶段4;部分匹配则作为起点;无匹配则进入阶段1,并记得之后记录解决方案。

阶段1:根因调查。仔细完整阅读错误信息;确认能否按相同步骤稳定复现;检查近期变更(git diff、新增依赖、配置改动);在多组件系统中于各组件边界记录日志,运行一次以定位断点位置;追溯数据流,从异常值反向追踪到源头。

阶段2:模式分析。在同一代码库中寻找可正常工作的示例;完整阅读参考实现而非略读;找出正常与故障版本之间的每一处差异;理解设置、配置、环境与假设等依赖关系。

阶段3:假设与验证。形成单一假设,例如“我认为 X 是根因,因为 Y”;做最小化测试,一次只改变一个变量;验证后再继续,成功则进入阶段4,失败则提出新假设。

阶段4:实施。创建失败测试用例(尽可能自动化且为最简复现);实施单一修复,不做“顺便改进”;验证修复后测试通过且未破坏其他测试;若已有 3 次以上修复失败,应停止、质疑架构并在继续尝试前进行讨论。

危险信号与停止条件:出现“先快速修复,之后再调查”“先改改 X 试试”、在追溯数据流之前就提出方案、在已尝试 2 次以上后仍说“再试一次”等情况时,都意味着应停止并回到阶段1。

快速参考中,各阶段的成功标准分别为:阶段0输出检索摘要;阶段1理解问题的 WHAT 与 WHY;阶段2识别差异;阶段3确认假设或提出新假设;阶段4缺陷解决且测试通过。