技能说明
适用于 Bug、测试失败、构建失败、性能问题和生产异常。强制完成根因调查、模式分析、假设验证和实施复核，避免凭症状反复打补丁；日志与环境信息需自行脱敏。
关于此技能
来自 obra/superpowers 的根因调试流程，要求先读错误、稳定复现、对比变更并追踪数据流，再提出单一假设和最小验证，避免靠猜测反复打补丁。
核心能力
四阶段根因流程
依次完成根因调查、模式分析、假设验证和单点实施，未完成前一阶段不得跳步。
证据驱动排查
要求完整阅读错误信息、稳定复现、检查近期变化，并在多组件系统中沿边界收集输入输出和配置证据。
失败后的止损机制
每次只验证一个假设；连续多次修复失败时停止继续试错，转而讨论架构问题。
适用场景
Bug 与测试失败
处理单元测试失败、生产故障、构建失败和集成错误，先确认真实原因再动手修改。
性能和异常行为
面对慢请求、偶发故障或结果不符合预期时，按证据、复现和数据流逐层缩小范围。
多组件系统排查
适用于 CI、构建、签名、API、服务和数据库等跨边界问题，避免只改最表面的报错位置。
使用步骤
- 01
先收集事实
完整读取报错和堆栈，记录复现步骤、发生频率、近期改动、环境差异和关键数据流。
- 02
找可比样本
查找同一项目中正常工作的相似代码或参考实现，逐项列出差异和依赖。
- 03
提出并验证假设
一次只提出一个具体假设，用最小改动验证；验证失败就回到证据阶段，不把多个补丁叠在一起。
- 04
修根因并确认
先创建能复现问题的测试，再实施一个根因修复，最后跑相关测试并确认没有引入新问题。
常见问题
问题看起来很简单，也要完整走流程吗？+
要。技能明确要求即使简单问题也不要跳过调查，因为简单症状同样可能有隐藏根因。
三次修复都没成功怎么办？+
停止继续尝试第四个补丁，检查是否存在架构、共享状态或耦合问题，并先和负责人讨论基础方案。
它会自动修改代码吗？+
它是排查流程，不保证自动修复；具体修改仍需根据证据、测试和项目规则决定。涉及日志和环境信息时还应先脱敏。
安装前检查
把兼容性、来源和安装入口先看清楚，再放进自己的工作流。
Codex · Claude Code · Cursor
已提供来源链接
命令可直接复制
2026/09/07
安装提醒：即使有清晰的来源和安装方式，也建议先阅读 SKILL.md，确认它会访问哪些文件和服务。
npx skills add https://github.com/obra/superpowers --skill systematic-debugging