一句话概括
Superpowers 不是给 AI 加能力的插件，是给 AI 加纪律的纯文本约束。14 个 Markdown 文件，强制 Claude 按流程干活、不跳步骤。
Superpowers 是啥？
你以为它是个工具？不是。它就是一堆 Markdown 文件，每个文件定义一种工作场景的"标准流程"。
Claude 其实啥都会——会写测试、会查根因、会做设计。但你一催它"快帮我改一下"，它就全跳过了，直接猜着改。
Superpowers 做的事就是：不管你怎么催，该走的流程它都不让你绕过去。
14 个 skill，分三类：
| 类型 | 包含 |
|---|---|
| 测试 | TDD |
| 调试 | 系统调试、完成前验证 |
| 工作流 | 头脑风暴、写计划、执行计划、subagent、并行/串行、code review、git worktree、收尾、写 skill |
核心 Skill 拆解
1. brainstorming — 不批准设计，一行代码都不许写
大多数人的用法：问几个问题 → 直接让它写。相当于 9 步流程只走了前 3 步。
完整流程：
- 探索项目现状
- 提供可视化伴侣（如果有 UI 问题）
- 逐条问澄清问题
- 给 2-3 个方案 + 推荐理由
- 按章节展示设计，每段确认
- 把设计写成 spec 文档并 commit（大多数人跳过的就是这步）
- 自检 spec，扫 TBD/TODO
- 让你审阅 spec
- 移交 writing-plans
有一道 <HARD-GATE>：设计没批准，代码一行都不许写。
反直觉的设计："觉得项目太简单不需要设计？那更要走流程。简单项目里的隐含假设，是返工的最大来源。"
2. systematic-debugging — 没找到根因，别动手
普通调试：报错 → 贴给 Claude → "可能是 X" → 试了 → 没好 → "那可能是 Y" → 反复横跳。
这个 skill 的铁律：NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST
四个阶段，必须按顺序：
| 阶段 | 做什么 |
|---|---|
| Phase 1 根因调查 | 完整读错误、稳定复现、查 git 变更、打诊断日志 |
| Phase 2 模式分析 | 找类似能跑的代码，逐项对比差异 |
| Phase 3 单假设验证 | 写一个具体假设 → 最小变更验证 → 不对就换假设，不叠加改动 |
| Phase 4 实现修复 | 先写复现测试 → 只改一处 → 三次失败就停下来讨论架构 |
那个"三次失败规则"很精髓：大多数人第三次失败后会更焦虑地试第四次，但每多猜一次，都在给代码引入新的不确定性。
3. writing-plans — 每步 2-5 分钟，不许写 TBD
把 spec 拆成"人类或 AI 都能一步步执行"的任务清单。
关键： "写测试"和"跑测试确认失败"是两个独立步骤，每一步都有明确的完成判定。
零占位符规则 — 以下写法直接判定计划失败：
- "TBD"、"TODO"、"后续实现"
- "添加适当的错误处理"（不说怎么处理）
- "类似 Task N"（不许引用，必须写全）
4. subagent vs executing-plans — 怎么选
| 场景 | 选哪个 |
|---|---|
| 支持 subagent 的平台 | subagent-driven-development |
| 不支持 subagent | executing-plans |
| 任务多、上下文容易漂移 | subagent |
| 简单小任务 | executing-plans |
subagent 的优势：每个任务用全新的上下文，不会被前面的错误带偏。作者实测做 8 个任务时，executing-plans 跑到第 5 个就开始把通过的测试改坏了，换 subagent 后这种"上下文串扰"基本消失。
5. finishing-a-development-branch — 收尾别留烂摊子
四个选项：本地 merge / 推远程创建 PR / 保留分支 / 丢弃。
丢弃选项需要手动输入 "discard" 才能执行，防止误操作。
完整工作流
brainstorming → using-git-worktrees → writing-plans → subagent/executing-plans（穿插 TDD） → requesting-code-review → finishing-a-development-branch
中途遇 bug 插入 systematic-debugging，验证有疑插入 verification-before-completion。
两个常见坑
坑 1：上下文漂移 — 聊久了 Claude 忘了自己有 skill，开始按默认模式跳步骤。解法：显式喊 /using-superpowers 重置。
坑 2：把 brainstorming 当问答机 — 只问问题不产出 spec 文档，后面执行阶段 Claude 没有设计依据，质量大打折扣。
一句话总结
AI 编程工具最大的问题不是智力，是纪律。Superpowers 证明了：纪律可以用纯文本分发。前两次跑完整流程确实觉得慢，但从第三次开始返工率断崖式下降，总时间反而更短。
