Appearance
Superpowers 不是一个代码库,而是一套「给 AI 编程助手装上工作规范」的行为约束系统。安装之后,Claude Code 等 AI agent 会在编程过程中自动触发测试驱动开发、代码审查、Git 分支管理、子代理并发等专业工程流程——不需要你每次都手动提醒它「先写测试」或「帮我做个代码审查」。它把软件工程的最佳实践内置进了 AI 的行为模式里。
Superpowers 是什么?给 AI 编程助手安装「工作规范」
它解决的核心问题:AI 编程助手为什么总是「乱来」
你用过 Claude Code 或者类似的 AI 编程工具,大概都经历过这些情况:
- 说一句「帮我实现这个功能」,AI 直接开始写代码,没有确认需求,写完发现方向完全跑偏
- 写了一堆代码,却没有任何测试,或者测试是最后补上去的摆设
- 改了 A 文件,顺手动了 B 文件,结果出现意想不到的副作用
- 每次都要你提醒「先写测试」「做个 code review」,不然它就跳过
这些问题的根源是:AI 没有内置的工程纪律。它默认是个「急于动手」的工程师,能做事但不按流程做事。
Superpowers 要解决的正是这个问题。它给 AI 装上了一套强制触发的工作规范——不是建议,而是约束。
装上之后,你的 AI 会有哪些变化
1. 开始写代码前,它会先跟你对齐需求
没有 Superpowers 时,你说「帮我做个用户登录」,AI 直接开写。
装上之后,它会先进入 brainstorming 模式:用苏格拉底式提问挖清楚你真正想要什么,把设计方案分段展示给你确认,直到你说「OK,可以开始」才进入实现。这个环节会生成一份设计文档存下来,后续所有工作都以此为基准。
2. 有了方案之后,它会写出可执行的实现计划
设计确认后,AI 进入 writing-plans 模式。它不会说「我来实现这个功能」就开干,而是把工作拆分成每个 2~5 分钟可完成的小任务,每个任务都包含:精确的文件路径、完整的代码示例、验证步骤。
这个计划细到「一个积极的初级工程师不用动脑也能照着做」的程度——目的是让 AI 子代理在执行时不会因为理解偏差而偏轨。
3. 执行过程中严格遵守 TDD
这是 Superpowers 最硬的约束之一。整个实现过程强制执行 RED-GREEN-REFACTOR 循环:
- 先写一个会失败的测试(RED)
- 跑一下,确认它确实失败了
- 写最少的代码让测试通过(GREEN)
- 跑一下,确认通过了
- 重构,保持测试绿色
如果发现代码是在测试之前写的,Superpowers 会要求删掉那段代码重来。这不是建议,是规定。
4. 每个任务完成后自动做代码审查
每次子任务执行完毕,requesting-code-review skill 会自动介入,按严重程度(Critical / High / Medium / Low)上报问题。Critical 问题会阻断流程,必须修完才能继续下一个任务。
这意味着代码审查不再是你手动要求的可选步骤,而是流水线上的强制检查点。
5. 用 Git Worktree 隔离每次开发
AI 在接手任务时会自动创建一个独立的 Git worktree,在新分支上工作,运行项目的初始化脚本,验证测试基线是干净的。完成后,它会展示选项:合并到主分支、创建 PR、保留分支、还是放弃——而不是直接修改你的 main 分支。
6. 复杂任务派遣多个子代理并行处理
对于规模更大的任务,Superpowers 会启动 subagent-driven-development 模式:为每个工程任务派遣一个独立的子代理,每个子代理完成后经过两轮审查(先检查是否符合规格,再检查代码质量),再进入下一个任务。Claude 可以在你几乎不干预的情况下连续工作数小时而不偏轨。
Superpowers 的 Skills 体系
Superpowers 的本质是一个可组合的 skill 集合,每个 skill 是一段描述特定工程行为的规范文件。当你的 AI 检测到对应场景时,会自动加载并遵循相应 skill。
主要 skill 分三类:
测试与调试类
test-driven-development:RED-GREEN-REFACTOR 完整循环,附带常见反模式参考systematic-debugging:4 阶段根因分析流程(不是「试一试看看」,是系统化排查)verification-before-completion:声称修好之前先验证确实修好了
协作与流程类
brainstorming:苏格拉底式需求挖掘writing-plans:细粒度实现计划executing-plans:分批执行 + 人工检查点requesting-code-review/receiving-code-review:审查流程的发起和响应using-git-worktrees:并行分支隔离finishing-a-development-branch:分支收尾决策
元技能类
writing-skills:创建新 skill 的规范(Superpowers 自己用来扩展自己)using-superpowers:系统介绍
所有 skill 都是强制触发的,不是可选建议。
在 Claude Code 上安装
Superpowers 在不同平台的安装方式不同。Claude Code 是支持最完整的平台,也是作者的主要开发目标。
方式一:通过官方插件市场(推荐)
bash
/plugin install superpowers@claude-plugins-official方式二:通过社区插件市场
bash
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace安装完成后,开启一个新的 Claude Code 会话,说一句「帮我规划这个功能」,如果 AI 自动进入结构化的 brainstorming 流程而不是直接开写,说明安装成功。
后续更新:
bash
/plugin update superpowers其他平台(Cursor、GitHub Copilot CLI、Gemini CLI、OpenCode、Codex)也都支持,安装命令各有不同,参考官方仓库 obra/superpowers 的说明。
它改变的不是能力,而是行为模式
理解 Superpowers 有一个关键点:它不是给 AI 增加新能力,Claude Code 本来就能写测试、做审查、管 Git。
它改变的是 AI 的默认行为模式。
没有 Superpowers:AI 有能力做这些事,但除非你明确要求,它会跳过。 有了 Superpowers:这些事变成了强制流程,不经过就不能继续。
这个区别在长期协作中尤其明显。你不需要每次都扮演「流程监督者」,AI 自己知道什么时候该停下来确认需求、什么时候该先写测试、什么时候该做审查。
它的设计哲学是:系统化优于临时发挥,证据优于声明,简洁优于过度设计。这几条原则被硬编码进了每一个 skill 里。
FAQ
Q: Superpowers 是不是只适合大项目?小功能也能用吗?
A: 适合任何规模。对于小功能,brainstorming 阶段会很短,AI 很快就能进入实现;真正有价值的是 TDD 和代码审查约束,无论功能大小都能帮你避免草率实现。
Q: 装了 Superpowers 之后,我还能像以前一样直接让 AI 写代码吗?
A: 可以,你随时可以绕过某个流程。Superpowers 是约束系统而不是枷锁,如果你明确说「跳过需求确认,直接写」,AI 也会听。它的作用是在你没有明确指令时给出最佳默认行为。
Q: Skills 可以自定义吗?能新增自己团队的规范吗?
A: 完全可以。Superpowers 内置了 writing-skills 这个元技能,专门用来指导你按照标准格式创建新 skill。你可以把团队特有的代码规范、部署流程、review checklist 等写成 skill,让 AI 在对应场景自动遵守。
本系列文章
安装与配置
核心研发流程 Skills
- brainstorming skill:用对话驱动需求,而非直接跳进写代码
- writing-plans skill:给 AI 写一份「傻瓜也能执行」的实现计划
- subagent-driven-development:每个任务用独立子代理执行,双阶段审查
- executing-plans skill:批量执行计划,设置人工检查点
- finishing-a-development-branch:开发完成后怎么安全收尾
代码质量 Skills
- test-driven-development skill:先写失败的测试,再写最少的代码
- requesting-code-review:让独立子代理审查你的代码
- receiving-code-review:如何用技术判断力处理 AI 审查反馈
- verification-before-completion:完成声明前必须先有证据