文档大纲

让Claude Code从实习生变资深工程师：把superpowers装进工作流

用 Claude Code 大半年，最头疼的就是：让它写代码，它立刻闷头开干；写完也不测试；出问题就乱试；改完不评审。本质上是个"实习生"——你推一下动一下，不推就原地发呆。

[obra/superpowers]这个项目（4k+ stars），作者是前 GitHub 工程师 Jesse Vincent，现任 Prime Radiant CEO，Anthropic 官方 marketplace 也上架了。README 第一段——"Mandatory workflows, not suggestions."（强制流程，不是建议）。本文把这套方案完整拆给你看。

一、它是什么：一套强制工作流 + 14 个 skill

如果只用一句话说清楚——

obra/superpowers 把"先聊需求 → 拆任务 → TDD → 评审 → 完成验收"这套资深工程师的工作习惯，做成 14 个 skill 装进 Claude Code，每次开新会话自动注入，强制 agent 遵守。

核心 6 步硬流程

1. brainstorming             → 先问清楚需求
2. using-git-worktrees       → 在隔离分支里开发
3. writing-plans             → 拆成 2-5 分钟小任务
4. executing-plans           → 串行/并行执行
5. test-driven-development   → 强制 RED-GREEN-REFACTOR
6. requesting-code-review    → 任务间强评审
7. finishing-a-development-branch → 完成时决定 merge/PR/废弃

最关键的设计：agent 每次响应前必须先用 Skill 工具检查相关 skill。这是硬约束，不是软建议。

14 个 skill 全景

类别Skill啥时候触发
测试test-driven-development写任何实现代码前
测试verification-before-completion声称完成/修复前
调试systematic-debugging任何 bug/test 失败时
协作brainstorming任何编码任务开始
协作writing-plans拿 spec 后、写代码前
协作executing-plans串行执行计划
协作dispatching-parallel-agents并行任务分发
协作requesting-code-review任务间评审
协作receiving-code-review收到评审反馈时
协作using-git-worktrees隔离开发分支
协作finishing-a-development-branch分支完成时
协作subagent-driven-development高速迭代（双评审）
Metawriting-skills创建/优化新 skill
Metausing-superpowers每次会话开始（bootstrap）

二、它解决了哪些痛点

我自己对照了一下，AI 编程助手最常见的 7 个"翻车现场"，obra/superpowers 都给了对应解法：

翻车现场Superpowers 解法
一上来就闷头写代码brainstorming 强制先问需求
写完不知道对不对test-driven-development 红绿循环
出了 bug 直接乱试systematic-debugging 4 阶段根因分析
大需求无从下手writing-plans 拆成 2-5 分钟任务
多个特性并行冲突dispatching-parallel-agents + worktree 隔离
改完没 reviewrequesting-code-review 任务间强评审
完工时混乱（merge/扔/留）finishing-a-development-branch 给明确选项

如果你是一个人单打独斗，这些功能看起来"杀鸡用牛刀"。但如果是团队用——所有成员走同一套流程，输出风格一致，知识沉淀在 skill 里不随人走——这才是真正值钱的地方。

与裸 prompt 工程的对比

维度裸 promptSuperpowers
工作流自由发挥，每次不同强制 6 步流程
上下文效率长 prompt 占 tokenskill 按需加载（渐进披露）
可复用性复制粘贴Git 版本化
跨 agent各自适配一次编写，10+ agent 通用
协作单人team-wide 同步

三、支持哪些 AI 编程助手

[obra/superpowers 官方 README](https://github.com/obra/superpowers) 列了 10+ agents，按成熟度排：

  • Claude Code ⭐ —— 主力支持，Anthropic 官方 marketplace 上架
  • Antigravity —— 启动 hook 自动激活
  • Codex App / Codex CLI —— OpenAI 官方 marketplace
  • Cursor —— /add-plugin superpowers 或插件市场搜索（需 Cursor Agent chat）
  • Factory Droid —— droid plugin marketplace add ... + droid plugin install
  • GitHub Copilot CLI —— copilot plugin marketplace add obra/superpowers-marketplace
  • Kimi Code —— /plugins 面板，详细文档见 docs/README.kimi.md
  • OpenCode —— 让 agent fetch https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md，详见 docs/README.opencode.md
  • Pi —— pi install git:github.com/obra/superpowers，Pi 原生 skill，无需兼容层

选择建议

  • 如果只用 Claude Code：✅ 直接装（本文第四节有实操记录）
  • 跨 agent 协作团队：✅ 一次编写到处跑，是最大卖点
  • 想自己定制 skill：✅ 用 writing-skills skill 写，但需遵守仓库 PR 规则（94% 拒收率）

不适合的场景

  • 你只想让 AI 快速回答一次性问题（杀鸡用牛刀）
  • 你不接受「AI 助手先问问题再写代码」的延迟
  • 项目已强制走自家流程（如公司级 Cursor rules）
  • 项目是领域特定（金融/医疗）的合规编码——可能需要更严格的 skill

四、怎么装：3 种方式

方式 1：官方 marketplace（最省事）

Claude Code 输入框直接执行：

# 1) 注册 marketplace（一次性）
/plugin marketplace add obra/superpowers-marketplace

# 2) 安装 superpowers 插件
/plugin install superpowers@superpowers-marketplace

或者走 Anthropic 官方 marketplace：

/plugin install superpowers@claude-plugins-official

方式 2：手动 git clone（国内网络推荐）

我的实操环境网络受限（拉 GitHub release 失败），所以走手动 clone 到 Claude Code 插件目录：

# 1) 克隆到 Claude Code 插件目录
cd ~/.claude/plugins
git clone --depth 1 https://github.com/obra/superpowers.git

# 2) 配置本地 marketplace（可选，便于 /plugin install 本地版）
mkdir -p ~/.claude/plugins/marketplaces/superpowers-dev
cat > ~/.claude/plugins/marketplaces/superpowers-dev/marketplace.json <<'EOF'
{
 "name": "superpowers-dev",
 "owner": {"name": "Jesse Vincent", "email": "[email protected]"},
 "plugins": [{
   "name": "superpowers",
   "version": "6.1.1",
   "source": "./superpowers",
   "description": "Core skills library for Claude Code: TDD, debugging, collaboration patterns"
 }]
}
EOF

部署结果：

~/.claude/plugins/
├── superpowers/                  ← 主插件目录（v6.1.1，14 skills）
│   ├── .claude-plugin/plugin.json ← Claude 插件元数据
│   ├── hooks/hooks.json          ← SessionStart hook 配置
│   ├── hooks/session-start       ← Bash 脚本，注入 using-superpowers
│   ├── skills/                   ← 14 个 skill 的内容
│   ├── docs/                     ← 多平台适配文档
│   └── ...
└── marketplaces/superpowers-dev/ ← 本地 marketplace 注册
    └── marketplace.json

方式 3：升级方式

# 手动 clone 方式
cd ~/.claude/plugins/superpowers && git pull

# marketplace 方式（在 Claude Code 输入框）
/plugin update superpowers

三种部署方式对比

方式优点缺点
官方 marketplace /plugin install自动更新 + Anthropic 签名验证依赖 GitHub 网络
手动 clone无网络依赖 + 可改源码需手动 git pull 升级
Pi/OpenCode 各自命令原生体验最佳仅限对应 agent

五、怎么用：装完就开干

部署完不需要任何手动激活。 下次开 Claude Code 会话：

  1. SessionStart hook 自动触发
  2. skills/using-superpowers/SKILL.md 自动注入到上下文
  3. agent 每次响应前自动检查并调用相关 skill

场景 1：从零开始新项目

你：我想做一个 React Todo List

（agent 自动触发 brainstorming skill）
agent：在写代码前，我想先理清几个问题：
 1. 这个 Todo List 是个人用还是团队协作？
 2. 需要后端持久化吗？还是 localStorage 就够？
 3. 视觉风格有偏好吗（极简/可爱/深色模式优先）？

（多轮问答后自动触发 writing-plans）
agent：基于你的回答，我写了 plan，分 8 个任务，每个 2-5 分钟。要我开始吗？

（你说 go，自动触发 executing-plans + test-driven-development）
agent：[任务1：写失败测试 → 看着失败 → 写最小实现 → 看着通过 → commit]
       [任务1 完成，请求评审]
       要我继续任务 2 吗？

场景 2：调试现有代码

你：我的 login 函数有时候会失败，帮我修

（自动触发 systematic-debugging）
agent：在我提议任何修复前，让我先按 4 阶段流程排查：
 Phase 1: 根因 - 你能描述"失败"的精确表现吗？
           错误信息？发生的频率？最近改了什么？
 Phase 2: 理解系统 - login 函数的代码路径是什么？
           涉及哪些外部依赖（DB/cache/auth provider）？
 ...

场景 3：完成时

agent：所有任务完成，测试全绿。
（自动触发 finishing-a-development-branch + verification-before-completion）
agent：分支完成。你想：
 A) merge 到 main
 B) 推 PR
 C) 保留 worktree 继续迭代
 D) 废弃这个分支

显式调用某个 skill

虽然会自动触发，你也可以直接说：

用 test-driven-development 帮我实现这个功能
按 systematic-debugging 排查这个 bug

关闭可视化伴侣（可选）

README 提到 brainstorming skill 有一个可选的可视化伴侣（Prime Radiant logo 加载自他们官网，含 Superpowers 版本号，用于粗略统计用户量）。不收集 prompt、项目、agent 信息。

如需禁用：

# 在 ~/.bashrc 或 PowerShell profile 中
export SUPERPOWERS_DISABLE_TELEMETRY=1

或者尊重 Claude Code 自带的开关：

export DISABLE_TELEMETRY=1
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

六、用了之后 AI 助手行为会有这些变化

⚠️ 这才是真正需要心理准备的地方：

行为变化你要做的预期调整
它会先问问题再写代码准备好回答苏格拉底式提问
它会强制 TDD即使你想直接写实现，它会坚持先写测试
它会分小任务长任务会被拆成 2-5 分钟任务
它会要求 code review每个任务完成后会自审或请你审
完成时它会问 merge/PR别嫌烦，这是流程设计

如果某项行为你不习惯，可以临时跳过。skill 会被自动触发但你可以坚持直接做某件事。obra/superpowers 是"辅导而非强制"。

七、资源链接

  • GitHub：https://github.com/obra/superpowers
  • 作者博客：https://blog.fsck.com/2025/10/09/superpowers/
  • 商业支持：https://primeradiant.com
  • Discord 社区：https://discord.gg/35wsABTejz
  • Eval 仓库：https://github.com/prime-radiant-inc/superpowers-evals/
  • awesome-claude-skills 推荐项：https://github.com/travisvn/awesome-claude-skills
  • 多平台适配文档：docs/README.kimi.md、docs/README.opencode.md、docs/porting-to-a-new-harness.md

八、部署核对清单

  • 通过 skill-vetter 协议审查
  • Git clone 到 ~/.claude/plugins/superpowers/
  • 验证 .claude-plugin/plugin.json 元数据完整
  • 验证 hooks/hooks.json SessionStart hook 配置
  • 验证 14 个 skills 完整下载
  • 设置本地 marketplace 描述文件
  • 用户下次打开 Claude Code 时首次响应会注入 using-superpowers bootstrap
  • 验证方式：发送"Let's make a react todo list"，应自动触发 brainstorming

阅读量： 325

网站备案号：沪ICP备2025137870号