SuperAPI AI 工具集

systematic-debugging

测试与质量

查看项目

更新于 10-16 03:43

技能介绍

用途:在开发中遇到 bug、意外行为、测试失败或错误时,用一套严格的四阶段流程替代随机试错,确保每次修复都建立在理解根因之上。

主要能力:流程分为四阶段。阶段一根因调查:完整阅读错误信息与堆栈、稳定复现、收集输入与预期/实际行为、检查近期变更(如 git log --oneline -20)。阶段二模式分析:寻找可工作的对照案例,比较工作与损坏场景的差异,验证依赖,缩小到最小可复现范围。阶段三假设与测试:一次只提出一个具体可测假设,用最小改动验证,优先加测试、日志或回滚而非改生产代码;记录假设日志。阶段四架构质疑:仅当至少 3 个假设被否定后触发,重新审视假设、设计与抽象,决定修补还是重构。

使用方式:技能开始时声明“I'm using the systematic-debugging skill to investigate this issue.”。每个阶段设有 HARD-GATE,未满足不得进入下一阶段。修复后必须写回归测试,并与 test-driven-development、verification-before-completion 等技能配合。

适用场景:调试开发中的缺陷、测试失败、环境差异(“在我机器上能跑”)、依赖版本问题、竞态条件等。

限制:该技能为 RIGID 类型,四阶段顺序强制;不得在未理解根因时改代码,不得用 try/catch 掩盖错误,不得无证据归咎框架,不得跳过回归测试,调试超过 45 分钟需暂停回看证据。具体安装命令与平台支持暂未提供。