SuperAPI AI 工具集

systematic-debugging

编程与开发

查看项目

更新于 11-03 16:18

技能介绍

系统化调试(Systematic Debugging)是一套针对缺陷和故障的根因调查方法论,用于测试失败、意外行为或研究、实现过程中出现错误等场景。

用途

该技能的核心主张是:调试缺少方法会浪费时间并引入新缺陷,随意修复只能处理症状而非原因。因此它要求开发者先完成系统化调查、找到根因,再考虑修复。其“铁律”是:在任何修复尝试之前,始终先找到根本原因。

主要能力(四阶段流程)

第一阶段:根因调查。要求在推测原因之前先弄清发生了什么,包括完整阅读错误信息与堆栈跟踪、记录错误码或类型;稳定复现故障并记录确切步骤;检查自上次正常以来发生的改动,如 git log、新依赖或配置;在关键点添加日志、检查系统状态与输入数据;从错误处反向追踪调用栈,定位正确行为开始偏离的位置。

第二阶段:模式分析。通过对比正常工作代码来寻找差异:参考类似功能的实现、文档示例与框架约定,找出失败案例的独特之处和被违反的假设,并检查所依赖的组件或版本是否发生变化。

第三阶段:假设与测试。采用科学方法:一次只提出一个具体、可验证的假设(如“错误因 X 而发生”),设计能证明或证伪该假设的实验,只做一处最小且可回退的改动,观察结果是否与预测一致,然后决定继续或重新提出假设。

第四阶段:实施。仅在理解根因后修复:先编写能捕获该缺陷的失败测试,再针对根因做最小修复,最后验证原测试与其他测试均通过,并检查类似问题是否存在于别处。

使用方式

技能以方法论清单形式指导调试过程,包括修复前检查项:错误信息是否完整阅读、故障能否稳定复现、最近改动是否检查、诊断证据是否收集、根因是否已识别、假设是否已形成并测试、修复是否针对根因、失败测试是否在修复前编写。它还提供证据收集技巧:临时日志(函数出入口、关键变量、时间戳、请求/响应负载)、git bisect 与二分查找定位破坏提交、移除无关代码做最小复现、对比正常与异常环境或输入。同时列出反模式:散弹式调试、修复后祈祷、删除法调试、盲目复制粘贴网络修复、跳过前三个阶段直接实施。

与 RPI 工作流的集成

在研究阶段调查问题时使用该技能理解问题,并在研究结论中记录根因,根因将指导实现计划;在实现阶段某步骤未通过验证时,应停止该步骤、套用此调试方法,修复验证通过后再恢复实现。若已尝试三次或更多修复而问题依旧,应停止修复并质疑架构:设计是否存在根本缺陷、是否在与框架对抗、是否需要重新实现,并通过 AskUserQuestion 讨论架构问题后再继续。

适用场景与限制

适用于软件缺陷排查、测试失败定位、意外行为分析以及研究与实现阶段的问题调查。该技能是方法论指南,本身不提供代码、安装命令、自动化工具或平台支持;实际执行依赖开发者所在项目环境与工具链。收费、价格等信息暂未提供。