Skip to content

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
SuperpowersTDD + Spec-driven + 子任务编排174k
GSD (Get Stuff Done)快速完成任务,灵活
GSTACK完整 stack 自动化(前后端 +DB)
Pulumi ClaudeIaC 专用

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-first1 周
习惯 TDD2-4 周
写自定义 skill1 个月

前两周会觉得慢、烦,但坚持过来回不去了。

类似生态产品

项目链接
obra/superpowersgithub.com/obra/superpowers
pulumi/claude-orchestrationpulumi.com/blog/claude-code-orchestration-frameworks
Vibe Sparking 教程vibesparking.com

真实评测

  • "Superpowers 让 Claude 从代码生成器变成纪律性开发伙伴"
  • "前 2 周想骂作者,第 3 周开始上瘾"
  • "Bug 数量减少 60%,但开发速度慢 30%(整体净收益正)"

资源

内容采用 CC BY-NC-ND 4.0 协议 · 禁止商业使用 / 禁止改编 / 禁止训练 AI 模型