Superpowers:让 AI 编程助手真正懂你意图的 Agentic Skills 框架

Superpowers:让 AI 编程助手真正懂你意图的 Agentic Skills 框架

你有没有过这种体验——给 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 吧。

如果内容对您有帮助,欢迎打赏

您的支持是我继续创作的动力

前往打赏页面

评论区

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注