Superpowers:让 AI 编程 Agent 自主工作数小时的技能框架
你有没有遇到过这种情况:让 AI 编程 Agent 帮你写一个功能,结果它要么写了一半就跑偏,要么代码质量参差不齐,甚至把你的测试搞坏了?问题不在 AI 的能力,而在于缺少一套结构化的工作方法。
这就是 Superpowers 要解决的事情。它是一个在 GitHub 上 Trending 的开源项目,由 Jesse(obra)创建,提供了一套完整的 AI 编程 Agent 软件开发方法论。它不是一个新工具,而是一组自动触发的技能,让你的 Claude Code、Codex CLI、Cursor、Gemini CLI 等 AI 编程工具像一个训练有素的高级工程师一样自主工作。
安装之后,你不需要手动调用任何技能——Agent 会根据当前任务自动触发合适的技能,从头脑风暴到代码审查,整个开发流程一气呵成。
Superpowers 是什么
Superpowers 本质上是一套给 AI 编程 Agent 看的软件开发方法论。它把人类工程师多年积累的工程实践——TDD(测试驱动开发)、代码审查、分支管理、任务拆解——转化成了 AI Agent 可以理解和执行的技能。
你可以把它理解为:给 AI 装上了一套"高级工程师的工作习惯"。不是那种"帮我写个函数"的简单指令,而是"先想清楚要做什么,拆成小任务,每个任务写测试,写完代码验证,最后做代码审查"的完整流程。
为什么它与众不同
市面上不缺 AI 编程工具,但 Superpowers 解决的是一个更根本的问题:如何让 AI Agent 高质量地自主工作数小时。
大多数 AI 编程工具的问题是:
- 上下文丢失:Agent 干着干着就忘了最初要做什么
- 质量不稳定:没有测试保障,写出来的代码时好时坏
- 缺乏结构:任务没有拆解,Agent 试图一口吃个胖子
- 没有验证:代码写完就完事了,没人检查
Superpowers 通过一套自动触发的技能链解决了这些问题。每个技能都是一个独立的模块,Agent 在合适的时机自动调用,确保整个开发过程有条不紊。
核心工作流:7 个自动触发技能
Superpowers 的核心是 7 个技能,它们组成了一条完整的开发流水线:
1. Brainstorming(头脑风暴)
在写任何代码之前,Agent 会先搞清楚你到底想做什么。它不会直接上手写代码,而是通过一系列问题来理解你的需求:
- 你真正想解决的问题是什么?
- 有没有已经存在的方案可以参考?
- 你期望的行为和边界条件是什么?
然后它会探索不同的实现方案,分章节展示设计思路,让你在写代码之前就对方案达成共识。这个步骤可以避免大量返工。
2. Using Git Worktrees(Git 工作树隔离)
当设计确定后,Agent 会自动创建一个隔离的工作空间:
- 在新分支上创建 Git worktree
- 运行项目的初始化设置(安装依赖等)
- 验证测试基线是干净的(所有测试通过)
这确保了开发工作不会污染你的主分支,也能在工作完成后干净地合并或丢弃。
3. Writing Plans(编写计划)
这是 Superpowers 最核心的技能之一。Agent 会把整个开发任务拆解成一个个 2-5 分钟的小任务,每个任务都包含:
- 要修改的确切文件路径
- 完整的代码变更内容
- 验证步骤(如何确认这个任务完成了)
这个计划不是给人看的概要——它是给 AI 执行的精确指令。每个步骤都足够小,小到不需要"理解"整体架构也能执行。
4. Subagent-Driven Development(子代理驱动开发)
这是 Superpowers 最创新的设计。每个小任务不是由主 Agent 直接执行,而是派发给一个全新的子 Agent。这样做的好处是:
- 每个子 Agent 都有干净的上下文,不会被之前的对话干扰
- 执行完后有两阶段审查:先检查是否符合规范,再检查代码质量
- 如果子 Agent 失败,可以重新派发,不影响整体进度
5. Test-Driven Development(测试驱动开发)
Superpowers 严格执行 RED-GREEN-REFACTOR 循环:
- RED:先写一个会失败的测试
- GREEN:运行测试,确认它真的失败了
- GREEN:写最少的代码让测试通过
- REFACTOR:重构代码,保持测试通过
- COMMIT:提交代码
6. Requesting Code Review(请求代码审查)
每个任务完成后,Agent 会自动发起代码审查:
- 对照计划检查实现是否正确
- 按严重程度报告问题
- 严重问题会阻止进度,必须修复后才能继续
这意味着你不需要人工审查每一行代码——Agent 自己会做第一轮质量把关。
7. Finishing a Development Branch(完成开发分支)
当所有任务完成并通过审查后,Agent 会:
- 验证所有测试通过
- 给你呈现选项:合并到主分支、创建 PR、保留分支、或丢弃
- 清理 Git worktree
整个流程从头到尾,Agent 都是自主运行的。你只需要在开始时确认设计方向,在结束时选择处理方式,中间的过程完全不需要干预。
核心哲学:TDD、YAGNI、DRY
Superpowers 不是随便拼凑的技巧集合,它背后有一套清晰的工程哲学:
TDD(测试驱动开发)
测试不是事后补的,而是开发的起点。通过先写测试,Agent 能明确知道"成功"的定义是什么。这比"写完代码看看对不对"要靠谱得多。
YAGNI(You Aren't Gonna Need It)
不要写你现在不需要的功能。AI Agent 特别容易犯这个错误——你让它加个用户系统,它可能顺手加了个权限管理、日志系统、消息队列。Superpowers 通过严格的计划和审查来约束这种倾向。
DRY(Don't Repeat Yourself)
代码重复是维护的噩梦。Superpowers 的审查阶段会检查是否有重复逻辑,确保每一处功能都有唯一的来源。
安装方法
Superpowers 的安装方式取决于你使用的 AI 编程工具:
Claude Code
最简单的方式是通过插件市场安装:
/plugin install superpowers@claude-plugins-official
安装完成后不需要额外配置,Superpowers 的技能会自动在合适的时机触发。
Codex CLI / Codex App
将 Superpowers 的技能文件添加到你的项目配置中即可。具体方式参考 GitHub 仓库的 README。
Cursor
在 Cursor 的规则配置中引入 Superpowers 的技能文件,它会作为系统提示词的一部分被 Agent 读取。
其他工具
Superpowers 还支持 Gemini CLI、OpenCode、Factory Droid、GitHub Copilot CLI 等。基本上,只要你的 AI 编程工具支持自定义指令或技能系统,就能用 Superpowers。
实战演示
假设你想让 AI Agent 帮你实现一个"用户认证系统"。没有 Superpowers 的话,你可能会得到一堆没有测试的代码。有了 Superpowers,整个过程会是这样的:
- 头脑风暴:Agent 会问你——用 JWT 还是 Session?密码加密用什么算法?需要支持 OAuth 吗?要不要加 rate limiting?
- 创建 worktree:在新分支
feature/user-auth上创建隔离工作区 - 写计划:拆成 8 个小任务,每个 2-5 分钟——创建用户模型、密码哈希、JWT 生成、登录端点、注册端点、中间件、测试、文档
- 逐个执行:每个任务派发给子 Agent,先写测试再写实现,完成后自动审查
- 代码审查:Agent 检查是否有安全漏洞、代码重复、测试覆盖率不足
- 完成分支:所有测试通过后,给你选择——合并、PR、还是保留
整个过程可能需要 2-3 小时,但你只需要在开头回答几个问题,在结尾做一个选择。中间的一切都是 Agent 自主完成的。
支持的 AI 编程工具
Superpowers 的一大优势是跨工具兼容。目前支持的工具包括:
- Claude Code — Anthropic 的官方编程工具,通过插件市场一键安装
- Codex CLI — OpenAI 的命令行编程工具
- Codex App — OpenAI 的桌面编程应用
- Factory Droid — Factory 的 AI 编程助手
- Gemini CLI — Google 的命令行 AI 工具
- OpenCode — 开源终端 AI 编程工具
- Cursor — 基于 VS Code 的 AI IDE
- GitHub Copilot CLI — GitHub 的命令行编程助手
不管你习惯用哪个工具,Superpowers 都能无缝集成,提供一致的开发体验。
与其他方法论的对比
AI 编程领域不缺方法论,但 Superpowers 有几个独特的设计决策:
- vs 直接写代码:大多数 AI 工具是"你说它写",Superpowers 加入了完整的工程流程
- vs 人工提示词工程:你不需要精心设计提示词,技能自动触发
- vs 单一 TDD 工具:Superpowers 不只是 TDD,它是从头脑风暴到代码审查的完整方法论
- vs 其他 Agent 框架:Superpowers 不是框架,是一套方法论,不依赖特定的代码结构或目录布局
总结
Superpowers 代表了 AI 编程的一个新方向:不是让 AI 写更多的代码,而是让 AI 写更好的代码。
它的核心价值可以总结为三点:
- 自动化工程流程:TDD、代码审查、分支管理这些工程师的基本功,现在由 AI 自动执行
- 质量保障:通过测试驱动、子代理审查、严格计划来确保代码质量
- 跨工具兼容:支持 8 种主流 AI 编程工具,不绑定任何单一平台
如果你正在使用 Claude Code、Codex、Cursor 或任何其他 AI 编程工具,强烈建议试试 Superpowers。一行安装命令,就能让你的 AI Agent 从"偶尔能用"变成"持续可靠"。