SuperAPI AI 工具集

systematic-debugging

测试与质量

查看项目

更新于 10-15 23:42

技能介绍

用途:面向任何技术问题的调试流程,包括测试失败、生产缺陷、异常行为、性能问题、构建失败与集成问题。核心原则是先找到根因再修复,症状式修补视为失败。

主要能力:定义四阶段流程。阶段一根因调查:仔细读错误与堆栈、稳定复现、检查近期变更、在多组件系统中于各边界加诊断日志收集证据、沿调用栈回溯数据流。阶段二模式分析:找可用的相似实现、完整阅读参考实现、列出工作与故障版本的全部差异、理解依赖与假设。阶段三假设与验证:提出单一明确假设并写下,做最小改动单变量测试,验证后再继续。阶段四实现:先写失败测试用例,再实施单一修复,最后验证测试通过且未破坏其他测试。

使用方式:遇到问题时按阶段顺序执行,未完成阶段一不得提出修复。若修复失败,少于三次回到阶段一重新分析;三次及以上应停止并质疑架构,与人类伙伴讨论后再继续。配套技术包括 root-cause-tracing.md、defense-in-depth.md、condition-based-waiting.md,相关技能为 superpowers:test-driven-development 与 superpowers:verification-before-completion。

适用场景:时间压力大、看似只需一处快速修复、已尝试多次修复、前次修复无效或尚未完全理解问题时尤其适用。

限制:资料未提供安装命令、平台支持、收费与价格信息;若系统化调查后确认问题确属环境、时序或外部因素,应记录调查过程并实现重试、超时或错误提示等处理,但资料指出约 95% 的“无根因”情况实为调查不完整。