SuperAPI AI 工具集

systematic-debugger

测试与质量

查看项目

更新于 10-16 00:03

技能介绍

用途:Systematic Debugger 用于处理任何技术问题,包括测试失败、生产环境缺陷、意外行为、性能问题、构建失败和集成问题。其核心原则是:在尝试修复前必须先找到根因,只修复症状视为失败。

主要能力:该技能定义四个必须依次完成的阶段。第一阶段根因调查:仔细阅读错误信息与堆栈、稳定复现问题、检查近期变更、在多组件系统中于各组件边界添加诊断日志以定位失败层,并沿调用栈反向追踪数据流找到坏值来源。第二阶段模式分析:寻找可工作的相似代码、完整阅读参考实现、列出工作与故障之间的所有差异、理解依赖与配置假设。第三阶段假设与测试:形成单一明确假设,做最小改动逐一验证,失败则提出新假设而非叠加修复。第四阶段实现:先创建可复现的失败测试,再实施单一根因修复,最后验证测试通过且未破坏其他测试。

使用方式:在 spec-superflow 执行期间,当实现任务遇到阻塞时,execution-governor 会路由到本技能;调试完成后通过 execution-governor 返回执行状态。本技能遵循 execution-governor 内嵌的 TDD 规则:写修复前先创建能复现缺陷的失败测试,修复以测试转绿为验证标准。

适用场景与限制:适用于时间压力大、看似只需快速修复、已尝试多次修复、前次修复无效或尚未完全理解问题的情形。若三次以上修复失败,应停止并质疑架构,与用户讨论后再继续。资料未提供安装命令、价格、平台支持或具体集成配置细节。