1. 前言

博主最近在研究 AI Coding Agent 的时候，关注到了一个比较特别的开源项目：Superpowers。

它吸引我的地方，并不是又做了一个新的 AI 编程工具，而是换了一个角度来解决问题：

不是让 Agent 变得更“聪明”，而是让 Agent 更“守规矩”。

现在很多 AI 编程工具已经可以写代码、改 Bug、生成测试、做重构，但在真实项目里用久了之后，应该都会遇到类似的问题：

• Agent 很容易一上来就写代码；
• 需求还没问清楚，就开始改文件；
• 测试没有跑完，就说任务完成了；
• 修 Bug 时只修表象，没有真正定位根因；
• 有时候甚至改了一堆代码，却没有留下清晰的设计和验证过程。

而 Superpowers 这个项目真正有价值的地方在于: 它不是给 AI Agent 增加一个新功能，而是给 AI Agent 装上一套软件工程纪律 ，它希望 Agent 在动手写代码之前，先学会澄清需求、设计方案、拆解任务、编写测试、执行 Review，最后再完成代码交付。

换句话说，Superpowers 想解决的不是 “Agent 会不会写代码”，而是 Agent 能不能像一个靠谱工程师一样工作。

2. Superpowers 为何物？

简单来说，Superpowers 是一套给 AI Agent 用的“工程技能包”，它把软件开发过程中常见的关键动作，拆成一个个 Skill，比如：

1. 需求澄清
2. 方案设计
3. 编写实现计划
4. TDD 测试驱动开发
5. 系统化 Debug
6. 使用 Git Worktree 隔离开发
7. 子 Agent 分工执行
8. 代码审查
9. 开发分支收尾

这些 Skill 不是普通文档，而是会影响 Agent 行为的操作指南，Superpowers 的核心思想可以概括为一句话：

不要只让 Agent 会写代码，而是让它按工程流程写代码。

也就是说，Superpowers 更像是给 AI Agent 装了一套“工作流大脑”。

3. Superpowers 适用场景

Superpowers 主要适合这几类人：

• 经常使用 AI 编程工具的开发者：如果你平时使用 Claude Code、Codex CLI、Cursor、Gemini CLI、OpenCode等工具，并且希望 Agent 不只是“帮你写代码”，而是更像一个有流程意识的工程师，那么 Superpowers 很适合。
• 需要维护复杂项目的团队：复杂项目里，最怕的是 Agent 改得太快、太散、太随意，Superpowers 通过设计文档、实现计划、测试、Review、分支隔离等流程，尽量降低这种风险。
• 想把 AI Agent 纳入工程规范的人:比如你希望 Agent 必须先写测试，必须提交小步 Commit，必须经过 Review，必须在完成前验证结果，那么 Superpowers 的理念会比较契合。

从场景来看，它更适合新增功能、修复复杂 Bug、重构旧代码和中大型开发任务。比如做新页面、新接口时，它会先引导 Agent 梳理需求和方案；遇到复杂 Bug 时，它强调系统化排查，而不是靠猜；在重构或多模块开发时，它会通过计划、测试和 Review，让整个过程更可控。

4. SuperPowers 技术实现

这张图可以理解为 Superpowers 的整体技术实现方式。

最上层是各种 AI 编程工具，比如 Claude Code、Codex CLI、Gemini CLI、Cursor、OpenCode 等，Superpowers 本身并不替代这些工具，而是作为插件或扩展安装到它们里面。

中间是 Superpowers 的核心层，主要由一组 Skills 组成，每个 Skill 对应一个工程流程，比如需求澄清、编写计划、TDD 测试驱动开发、代码审查、Git worktree 隔离开发、子代理协作等。Agent 在执行任务前，会先判断当前场景应该调用哪个 Skill，然后按照这个 Skill 定义的步骤去工作。

再往下，是实际的项目工程环境，包括代码仓库、Git 分支、测试套件、设计文档、实现计划、PR 或合并流程，Superpowers 不直接接管这些工具，而是引导 Agent 按正确顺序使用它们。

所以它的典型流程是：把一套工程化开发流程注入到现有 Coding Agent 中，让 Agent 不再直接写代码，而是按照 “需求澄清 → 设计 → 计划 → 开发 → 测试 → 审查 → 收尾” 的流程完成任务。

5. 案例演示

Superpowers 本身不是一个独立软件，而是作为插件接入到 Claude Code 这类 AI 编程工具中。

5.1安装

它目前可以通过官方 Claude 插件市场安装，也可以通过 Superpowers 自己维护的 marketplace 安装，官方 README 中给出的 Claude Code 安装方式主要有两种。

方式一：通过 Claude 官方插件市场安装

打开 Claude Code 之后，在对话框中输入：

/plugin install superpowers@claude-plugins-official

安装完成后，重启 Claude Code。

---

方式二：通过 Superpowers Marketplace 安装

如果你想使用 Superpowers 自己维护的插件市场，可以按照如下命令来安装。

# 先添加 marketplace
/plugin marketplace add obra/superpowers-marketplace

# 然后安装 Superpowers 核心插件
/plugin install superpowers@superpowers-marketplace

安装完成后，同样建议重启 Claude Code。注意，重启后不生效，使用如下命令重启插件：

/reload-plugins   

5.2 Mock 登录案例演示

现在有一个前端项目，是没有后端的，我想让 Claude Code 帮我们新增一个mock用户登录接口。

如果没有 Superpowers，很多 Agent 可能会直接开始写 Controller、Service、Mapper，然后顺手改一堆文件，但安装 Superpowers 之后，它的工作方式会更偏“工程流程”。

你可以这样对 Claude Code 说：

/superpowers:brainstorming 我想给当前项目新增一个用户登录接口，要求：
1. 用户使用 username 和 password 登录；
2. 登录成功后返回 token；
3. 登录失败时返回明确错误信息；
4. 需要补充单元测试；
5. 不要直接写代码，先帮我梳理方案。

这时候，Superpowers 通常会触发类似 brainstorming 的流程，它不会马上写代码，而是先和你确认需求，比如先让你确认后端方案：

为了演示，这里选择Mock登录，接着会继续提问使用场景、UI入口、登录后的行为等，最后他会提示“ 信息足够了，现在我来整理方案”并让你去确认最终的方案。

方案确认后，会展示实现的细节，接着会进一步让你确认技术实现的细节：

整体设计都结束了，会自动帮你写一篇设计文档：

后面就会进入实现计划阶段，这里不再继续贴出详述，完整流程如下：

6. 总结

Superpowers 这个项目有意思的地方是让 AI 按专业工程师的方式写代码。它把需求澄清、方案设计、任务拆解、TDD、代码审查、分支收尾这些流程，包装成一个个可组合的 Skill，让 Agent 不再只靠“聪明”工作，而是靠“流程”工作。

未来的 AI Coding,不只是 Prompt Engineering,而是 Agent Engineering。

附项目地址: https://github.com/obra/superpowers