SuperAPI AI 工具集

interrogation-debugging

测试与质量

查看项目

更新于 10-16 06:22

技能介绍

该技能名为“审讯式调试”(The Interrogation: Systematic Debugging),核心原则是:任何修复之前必须先完成根因调查,症状式修复无效。铁律为“没有根因调查就不修复”。

用途:适用于任何技术问题,包括测试失败、生产环境缺陷、意外行为、性能问题、构建失败与集成问题;尤其适用于时间压力大、看似只需“快速一修”、已多次尝试修复、上一次修复无效、或尚未完全理解问题时。

主要能力:将调试分为四个必须依次完成的阶段。第一阶段“简报”(The Brief):阅读错误与堆栈完整信息,记录行号、文件路径与错误码;稳定复现问题;检查近期变更(git diff、提交、依赖、配置、环境差异);在系统存在多个组件边界时加入诊断埋点,记录每个边界的输入输出与环境配置传递,先定位失败组件再深入。第二阶段“交叉审问”(Cross-Examination):在同一代码库中寻找可用的相似实现,完整阅读参考实现,列出工作版本与故障版本之间的每一项差异,梳理依赖、配置与假设。第三阶段“推理”(The Theory):形成单一具体假设并以最小改动验证,一次只改一个变量,验证后再继续。第四阶段“命中”(The Hit):先创建失败测试用例,再进行单一根因修复,最后验证修复且不破坏其他测试。

使用方式:按四阶段推进;修复失败不足三次则回到简报阶段重新分析;达到三次及以上失败应停止并升级,考虑架构问题而非继续叠加修复。测试编写可配合 gangsta:drill-tdd,修复验证可配合 gangsta:sweep-verification。

限制与提醒:手动验证不算证据;禁止“顺便”捆绑重构;不要一次改多处;“可能”“大概”意味着尚未调查。若系统性调查后确认问题确属环境、时序或外部因素,则记录调查内容并实现重试、超时、错误提示与监控日志;但资料指出约 95% 的“无根因”情况仍属调查不完整。资料未提供安装命令、价格、平台或量化效果信息。