调试 · 跨 Agent
systematic-debugging
系统化排查缺陷：假设、取证、验证，避免盲目改代码。
完整介绍
与 brainstorming 同属 Superpowers 工程协作套件。定位是假设驱动的调试环：观察 → 提出假设 → 设计检验 → 验证，而不是凭直觉连续打补丁。skills.sh 相关推荐也将其描述为 hypothesis-driven debugging loop。适合反复「猜补丁」无效、需要可复现步骤与证据链时启用。
obra/superpowers 的 systematic-debugging：把调试流程固化为 Agent 可执行步骤。
适合场景
- 线上/本地疑难 bug
- 回归失败定位
- 需要可复现步骤的排障
- 避免无证据的连环改动
不适合 / 注意
- 已知一行笔误且已定位的简单修复（直接修即可）。
- 需求未澄清的功能开发（应先 brainstorming）。
逐步安装
- 安装 systematic-debugging。
- 遇到疑难 bug 时显式启用，先复现与收集证据。
- 写下假设与可证伪实验，再改代码。
- 每次只验证一个假设；失败则更新假设而非堆叠补丁。
打开下载 / 源码地址open_in_new
安装命令（公开生态常用）
npx skills add obra/superpowers/systematic-debugging兼容软件
- Cursor
- Claude Code
- Codex
- GitHub Copilot
- Windsurf
- Gemini CLI
- 其他兼容 skills CLI 的 Agent
以 skills.sh「Available for these agents」所示生态为准；具体宿主是否已接入以各客户端文档为准。
作者来源
作者 obra ↗ · skills.sh obra/superpowers/systematic-debugging ↗
上游要点（README / SKILL.md）
- Hypothesis-driven：observe → hypothesize → test → verify（skills.sh 相关描述）。
- 同仓库姊妹：brainstorming、writing-plans 等。