你有没有过这种体验——给 AI 编程助手下达一个需求,它二话不说就开始写代码,结果写出来的功能和你的预期完全不符?
这不是 AI 不够聪明,而是大多数 AI 编程工具从一开始就缺少了一个关键环节:理解真正的意图。
今天要介绍的 Superpowers,正是为了解决这个问题而生的——它是一套完整的 AI 编程方法论 + 可组合的技能框架,让 Claude Code、Codex、Cursor 这样的编程 Agent 能够真正站在工程视角做事,而不是盲目堆代码。
一、为什么你需要 Superpowers
市面上的 AI 编程工具已经很强大了,Claude Code 可以自主完成代码审查、git 工作流;Codex 能解释代码库、执行复杂任务。但问题在于,当你丢给它们一个需求时,它们往往会:立刻动手写。
这在简单任务上没问题,但一旦项目复杂度上升,这种「先写再说」的思路就会导致:
– 代码写完了才发现架构设计有问题,推倒重来
– 实现了 A 功能但忽略了 B 依赖
– 单元测试写成了「表面文章」,根本没覆盖边界情况
Superpowers 解决的是「AI 在动手之前先思考」的问题。它不是替代你的 AI 编程工具,而是在它上面加了一层方法论护栏,确保每个工程任务都经过:意图澄清 → 设计确认 → 计划制定 → 执行review 的完整闭环。
二、核心理念:从「写代码」到「做工程」
Superpowers 的核心可以概括为三个阶段:
阶段一:Spec First——先说清楚要做什么
当你向 Superpowers 加持的 Agent 描述你的需求时,它不会直接跳到代码。它会退后一步,通过一系列问题来澄清你真正的目标。
这不是简单的问答,而是结构化的需求挖掘过程:
– 你想解决的核心问题是什么?
– 有没有现有的实现方式可以参考?
– 成功的标准是什么,如何验证?
澄清完成后,它会把设计方案分段展示给你,每段都足够短,让你能够真正消化和确认。这解决了 AI 一次性输出大量内容、你根本看不过来的问题。
阶段二:TDD + YAGNI——让 AI 也遵循工程纪律
设计确认后,Agent 会制定一份实施计划,这份计划清晰到可以让一个「热情但缺乏判断力的初级工程师」直接执行。
Superpowers 特别强调三点工程原则:
– 红/绿 TDD:先写失败的测试,再写让测试通过的实现代码
– YAGNI(You Aren’t Gonna Need It):不做过度设计,只实现当前需求明确的功能
– DRY(Don’t Repeat Yourself):避免重复逻辑
这意味着 AI 不再是「能跑就行」的代码工厂,而是一个有工程纪律的协作伙伴。
阶段三:Subagent 驱动的任务执行
在执行阶段,Superpowers 会启动子 Agent 驱动开发流程。父级 Agent 将任务分解后,分配给专门的子 Agent 处理各个工程任务。每个子 Agent 完成工作后,主 Agent 会进行审查和检验,确认无误后才继续推进。
实际使用中,Claude 在 Superpowers 框架下可以自主连续工作数小时,不会偏离最初商定的计划。
三、Superpowers 的 Skills 体系
Superpowers 之所以强大,在于它把开发流程拆解成了一系列可组合的技能(Skills),每个 Skill 负责一个特定环节,自动触发:
| Skill 名称 | 触发时机 | 功能说明 |
| `brainstorming` | 写代码之前 | 澄清需求,探索备选方案,分段展示设计供确认 |
| `using-git-worktrees` | 设计确认后 | 创建隔离工作空间,基于新分支运行,自动清理 |
| `writing-code` | 代码实现 | 遵循 YAGNI 和 DRY 原则,写出简洁可维护代码 |
| `writing-tests` | 代码实现后 | 真正的 TDD,先写失败测试再写实现 |
| `inspecting` | 任何时候 | 代码审查,发现潜在 bug 和改进点 |
这些 Skills 不是手动调用的,而是自动触发的。你只需要正常和 AI 对话,它会自动识别当前所处阶段并激活相应技能。这让 Superpowers 对用户完全透明——你不需要学习任何新命令。
四、安装与实战
Superpowers 支持主流 AI 编程工具,安装方式因工具而异:
Claude Code(推荐)
# 安装 Superpowers 插件
/plugin install superpowers@claude-plugins-official
# 注册插件市场
/plugin marketplace add obra/superpowers-marketplace
# 从市场安装
/plugin install superpowers@superpowers-marketplace
Codex CLI
在 Codex 中搜索 “superpowers” 即可从官方插件市场安装。
Cursor Agent
/add-plugin superpowers
或直接在 Cursor 的插件市场中搜索 “superpowers”。
OpenCode
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md
Gemini CLI
gemini extensions install https://github.com/obra/superpowers
gemini extensions update superpowers # 后续更新
安装完成后,每次启动编码任务时 Superpowers 会自动介入,引导你完成「澄清 → 设计 → 计划 → 执行」的完整流程。
五、真实案例:Superpowers 如何改变开发体验
让我们看一个具体场景:
你:帮我给这个 REST API 加一个用户认证模块。
普通 AI:好,我来写 JWT 中间件、User 模型、登录接口……(30秒后)写好了!
Superpowers Agent:在开始之前,我想先确认几件事:
1. 你希望用 JWT 还是 Session-based 认证?
2. 需要支持哪些登录方式(账号密码 / OAuth / 手机号)?
3. Token 过期策略是什么?
4. 现有数据库结构里有 User 表吗,还是需要新建?
你:用 JWT,支持账号密码,Token 7 天过期,有 User 表。
Superpowers Agent:[将设计方案分两段展示](确认后)这是我的实施计划……
这才是真正的工程协作方式。Superpowers 把 AI 从「代码生成器」升级为「工程伙伴」。
总结
Superpowers 解决的不是 AI 编程工具「能力不足」的问题,而是「方向不对」的问题。它通过一套完整的开发方法论——Spec First、TDD、Subagent 驱动——让 AI 编程助手真正按工程规律做事。
如果你经常使用 Claude Code、Codex、Cursor 等编程 Agent,Superpowers 是目前最值得安装的框架之一。它不改变你使用工具的方式,却能显著提升 AI 输出的质量和可靠性。
18 万 stars 的背后,是大量开发者的真实认可。这个夏天,给你的 AI 助手装上 Superpowers 吧。
评论区