主题
Superpowers 工作流框架
obra/superpowers 是 Claude Code 上最火的工作流框架(174k+ stars,7 个月内累计)。把 Claude Code 从"随便写代码的工具"变成"有纪律的 TDD 工程师"。
一句话
Superpowers = 强制 TDD + Spec-driven + 必须读 Spec 才能写代码。 解决 "vibe coding" 没设计就乱写 + 没测试就提交的乱象。
安装
bash
# 在 Claude Code 里加 Superpowers 插件市场
/plugin marketplace add obra/superpowers
# 安装
/plugin install superpowers或手动:
bash
cd ~/.claude
git clone https://github.com/obra/superpowers
# 重启 claude它强迫你做什么
1. 拒绝直接写代码
你:"帮我加个用户注册"
↓
Superpowers 接管:
↓
"先告诉我你想解决什么问题?谁会用?输入输出长什么样?"
↓
(你描述)
↓
"我已经写好 spec 了,请你审一下:
<详细需求文档,分块短到能消化>
你 sign-off 后我再写实现计划。"不让你跳过设计阶段。
2. 强制 RED-GREEN-REFACTOR
spec 通过 → Superpowers 进入 TDD 模式
RED: 先写测试,确认测试失败
GREEN: 写最少代码让测试通过
REFACTOR: 重构改进
如果你跳过 RED 直接写代码 → Superpowers 删掉重来听起来很死板,但实战质量真的高。
3. 子任务自动委派 + 自审
任务 → 拆成 N 个子步骤
├─ 子任务 A: subagent 实现
│ └─ 完成后自动调用另一个 subagent 审 code
├─ 子任务 B: ...
└─ 子任务 C: ...
错了?回 RED 阶段。对了?合主线。核心 Skills 列表
Superpowers 装好后会注入 ~30 个 skills:
| Skill | 作用 |
|---|---|
brainstorming | 跟你头脑风暴出需求 |
spec-writing | 把对话凝练成 spec 文档 |
tdd-cycle | 强制 RED-GREEN-REFACTOR |
subagent-dev | 委派给 subagent + 自动 code review |
debugging | 系统化调试(不是瞎试) |
skill-authoring | 教 Claude 写新 skill |
commit-discipline | 规范 commit 消息 + atomic commits |
documentation-driven | 写文档驱动开发 |
所有 skill 都是 Markdown 文件,可看可改。
何时该用
✅ 适合
- 正式项目(不是 demo / hello world)
- 团队多人协作
- 长期维护的代码
- 怕 vibe coding 出 bug 的场景
- 想培养 TDD 习惯的开发者
❌ 不适合
- 一次性脚本
- 学习/实验代码
- 急迫的 quick fix(流程长)
- 单纯 brainstorm 不想写代码时
- 你已经有清晰想法只想快速实现
跟其他框架对比
| 框架 | 焦点 | Stars |
|---|---|---|
| Superpowers | TDD + Spec-driven + 子任务编排 | 174k |
| GSD (Get Stuff Done) | 快速完成任务,灵活 | 中 |
| GSTACK | 完整 stack 自动化(前后端 +DB) | 中 |
| Pulumi Claude | IaC 专用 | 小 |
Superpowers 是最严格、最适合生产的那个。GSD 比它更灵活适合个人。
第一次使用怎么样
你:/skill brainstorming
Superpowers:(进入 brainstorming 模式)
"你想做什么?"
你:"实现购物车功能"
Superpowers:"好。我需要弄清几件事:
1. 单用户 or 多用户?
2. 持久化到哪里?数据库/localStorage/Redis?
3. 是否要支持促销码?
4. 跨设备同步吗?
5. 离线场景考虑吗?
回答这些,我会写出 spec。"
你:(回答)
Superpowers:(生成 spec 文档分块给你审)
你:(sign-off)
Superpowers:/skill tdd-cycle
(进入 RED-GREEN-REFACTOR)
"RED: 我现在写测试。"
(写 cart.test.ts,运行,失败)
"失败确认,进入 GREEN..."比直接 "帮我写购物车" 慢 3 倍开始,但质量高 10 倍。
跟 CLAUDE.md 的配合
Superpowers + CLAUDE.md 是最强组合:
markdown
# CLAUDE.md
## 工作流
本项目使用 Superpowers 框架:
- 重大功能必须先 /skill spec-writing
- 必须遵循 TDD(RED-GREEN-REFACTOR)
- 提交前必须 /skill commit-discipline
- 不允许跳过 spec 直接写代码CLAUDE.md 告诉 Claude "必须" 用 Superpowers,Superpowers 强制执行流程。双保险。
关掉 Superpowers
/plugin uninstall superpowers或临时跳过:
你:"不要走 Superpowers 流程,直接写个简单脚本"Claude 会暂时绕开。但如果 CLAUDE.md 强制要求了,可能会问"确定?这违反项目约定"。
上手成本
| 阶段 | 时长 |
|---|---|
| 第一次跑通 | 30 分钟 |
| 习惯 spec-first | 1 周 |
| 习惯 TDD | 2-4 周 |
| 写自定义 skill | 1 个月 |
前两周会觉得慢、烦,但坚持过来回不去了。
类似生态产品
| 项目 | 链接 |
|---|---|
| obra/superpowers | github.com/obra/superpowers |
| pulumi/claude-orchestration | pulumi.com/blog/claude-code-orchestration-frameworks |
| Vibe Sparking 教程 | vibesparking.com |
真实评测
- "Superpowers 让 Claude 从代码生成器变成纪律性开发伙伴"
- "前 2 周想骂作者,第 3 周开始上瘾"
- "Bug 数量减少 60%,但开发速度慢 30%(整体净收益正)"
