简介
systematic-debugging 技能强制执行一种纪律严明、基于证据的软件问题修复方法。它解决了开发者(和 AI 代理)靠猜测解决问题、随意打补丁,最终掩盖了真正潜在问题或制造出新漏洞的普遍痛点。
核心理念
“在未调查根本原因前严禁修复”。通过强制执行四阶段诊断流程,该技能确保每一次修复都是针对真正的故障原因,而不是简单地处理表面症状。
安装与调用指南
https://github.com/obra/superpowers
工作流程解析 (SOP)
- 仔细阅读错误信息:要求 AI 完整阅读堆栈跟踪、文件路径和错误代码,而不是直接跳过它们。
- 持续复现问题:指示 AI 验证问题是否可靠发生;如果不确定,则应收集更多数据,而不是盲目猜测。
- 检查近期变更:强制回顾 Git 差异、新依赖项和配置更改,以找出触发失败的具体原因。
- 在多组件系统中收集证据:在提出任何修复建议之前,AI 必须添加诊断插桩(例如记录进出组件的数据),以精确隔离系统崩溃的位置。
技能设计评价
- 人类经验 SOP 化的亮点:确立了“在未调查根本原因前严禁提出修复建议”的铁律。强制执行结构化的四阶段诊断方法,特别强调在多组件系统中添加诊断插桩来收集证据。
- 潜在的局限性:绝对拒绝尝试快速修补的做法,可能会让那些面对明显拼写错误或简单语法问题(根本原因已显而易见)的用户感到死板。
- 优质技能的评判标准:通过将系统化、基于证据的排查方法固化为流程,直接击中了调试过程中的心理陷阱(如在时间压力下盲目猜测),确立了长期稳定性高于短期修复的原则。