GitHub 6万星爆款！Superpowers 让你的 AI 编程助手从“莽夫“变“资深工程师“

你有没有过这种经历：对 AI 编程助手说"帮我写个待办事项 App"，它一秒钟就开始疯狂输出代码，结果写出来的东西完全不是你想要的？今天给大家介绍一个在 GitHub 上爆火的开源项目——Superpowers，它能让你的 AI 助手学会"先想清楚再动手"，像资深工程师一样工作。

一、Superpowers 是什么？

Superpowers是由 Jesse Vincent 创建并开源的一套 AI 编程助手工作流框架，GitHub 地址：GitHub - obra/superpowers: An agentic skills framework & software development methodology that works. · GitHub。

截至 2026 年 6 月，该项目已获得6 万+ Stars，是 Anthropic 官方插件市场首批收录的社区项目，被 Vercel、OpenAI、Trail of Bits 等多家知名公司和机构借鉴其设计理念。

简单来说，Superpowers 给你的 AI 编程助手装上了一套**"工程大脑"**：

• 不再一上来就写代码，而是先问清楚你要做什么

• 先做设计方案，等你确认后再写实现计划

• 严格按照测试驱动开发（TDD）流程写代码

• 自动派子代理执行任务，写完还自己做 Code Review

• 全程自动触发，你不需要记任何特殊命令

它就像给一个热情但莽撞的实习生配了一位严格的技术导师，确保每一步都走在正确的轨道上。

二、它解决了什么痛点？

用过 Claude Code、Cursor、Copilot 等 AI 编程工具的同学，大概率都遇到过这些问题：

Superpowers 的核心理念就是：把资深工程师的工作方法论"教"给 AI，让它按照规范流程做事，而不是靠运气输出代码。

三、5 分钟快速上手

3.1 支持的平台

Superpowers 几乎支持市面上所有主流 AI 编程工具：

• Claude Code（官方插件市场推荐）

• Cursor

• OpenAI Codex（CLI 和 App 版）

• GitHub Copilot CLI

• Gemini CLI

• Kimi Code

• OpenCode

• 以及更多...

3.2 安装方法

Claude Code（最简单）

在 Claude Code 中直接运行官方插件市场安装命令：

/plugin install superpowers@claude-plugins-official

或者通过 Superpowers 自有市场安装：

/plugin marketplace add obra/superpowers-marketplace /plugin install superpowers@superpowers-marketplace

安装后重启 Claude Code，你会看到类似这样的提示：

<EXTREMELY_IMPORTANT> You have Superpowers. Go read the getting-started skill to understand how skills work. </EXTREMELY_IMPORTANT>

这说明安装成功了！

Cursor

在 Cursor 的 Agent 聊天框中输入：

/add-plugin superpowers

或者直接在插件市场搜索 "superpowers" 安装。

Codex CLI

/plugins # 然后搜索 superpowers，选择 Install Plugin

Gemini CLI

gemini extensions install https://github.com/obra/superpowers

GitHub Copilot CLI

copilot plugin marketplace add obra/superpowers-marketplace copilot plugin install superpowers@superpowers-marketplace

3.3 验证安装

安装完成后，开一个新会话，试着对你的 AI 助手说：

"帮我做一个简单的 React 待办事项应用"

如果安装成功，AI不会立刻开始写代码！它会先问你一些问题，比如：

• 这个待办应用需要哪些功能？

• 要不要支持分类和筛选？

• 数据存在哪里？

• 用什么 UI 框架？

恭喜你，你的 AI 助手已经拥有"超能力"了！

四、核心工作流详解

Superpowers 最精妙的地方在于它设计了一条强制性的质量保障链，AI 必须按顺序走完每一步，不能跳过。整个流程如下：

用户提出需求 ↓ ① Brainstorming（头脑风暴/需求澄清） ↓ 用户确认设计 ② Writing Plans（编写详细实现计划） ↓ 用户确认计划 ③ Git Worktree（创建隔离分支） ↓ ④ Subagent-Driven Development（子代理驱动开发） ↓ 每个任务内部 ├── 严格 TDD（红→绿→重构循环） ├── 规范审查（是否符合计划？） └── 代码质量审查 ↓ ⑤ Code Review（整体代码审查） ↓ ⑥ Finishing Branch（合并/PR/清理）

下面我们一步步拆解。

4.1 第一步：Brainstorming（头脑风暴）

触发时机：任何创造性工作之前，哪怕你觉得任务很简单。

核心规则：在你确认设计方案之前，AI绝对不能写一行代码。

它会做这些事情：

1. 了解项目上下文：先看看你项目里已有的文件结构和代码风格

1. 一次问一个问题：不会一下子抛给你十个问题，而是像聊天一样逐步澄清

1. 优先选择题：尽量给你 A/B/C 选项，降低你的思考负担

1. 提出 2-3 种方案：带上优缺点分析和推荐理由

1. 分段展示设计：不会给你一大坨文字，而是分模块展示，每部分确认后再继续

1. 保存设计文档：最终把确认过的设计保存到docs/superpowers/specs/目录下

举个例子：

你说："帮我加个用户登录功能"

AI 不会直接写登录代码，它可能先问：

"登录需要支持哪些方式？
A. 仅用户名密码
B. 加第三方 OAuth（GitHub/Google）
C. 还要支持手机验证码"

你选 B 之后，它继续问 Token 策略、Session 管理、错误处理方式等，直到把所有细节都搞清楚，然后给你看一份完整的设计文档。

4.2 第二步：Writing Plans（编写实现计划）

触发时机：设计方案确认之后，动手写代码之前。

这一步的目标是：写出一份详细到"一个经验不足的初级工程师拿到就能照着做"的计划。

计划会保存到docs/superpowers/plans/目录，每个任务都包含：

• 精确的文件路径：创建哪些文件、修改哪些文件（精确到行号）

• 完整的代码示例：不是"写一个登录函数"这种废话，而是给出完整代码

• 具体的命令：运行什么命令、预期输出是什么

• 验证步骤：怎么确认这一步做对了

每个任务粒度控制在2-5 分钟能完成，计划中绝对不允许出现：

• "TODO" 或 "TBD"

• "添加适当的错误处理"

• "为以上代码编写测试"

• "参考 Task N 的做法"

这些模糊表述在 Superpowers 里都是被禁止的。

4.3 第三步：Git Worktree（隔离工作区）

触发时机：计划确认后，开始实施前。

AI 会自动创建一个 Git Worktree（隔离工作区），在新分支上开发。这意味着：

• 你的主分支代码不会被搞乱

• 可以同时开多个互不干扰的开发任务

• 开发完可以轻松选择合并、提 PR 或丢弃

4.4 第四步：Subagent-Driven Development（子代理驱动开发）

这是 Superpowers 最酷的特性之一！

核心思路：AI 不会自己一个人闷头干，而是把计划中的每个任务派发给一个全新的子代理去执行。每个子代理执行完后，还要经过两道审查：

1. 规范审查（Spec Review）：检查代码是否符合计划要求，有没有遗漏功能

1. 代码质量审查（Code Quality Review）：检查代码质量、命名、结构、最佳实践

两道审查都通过了，才算完成一个任务，然后才开始下一个。整个过程可以连续自主运行数小时不需要人工干预！

模型选择也有策略：

• 简单机械的实现任务 → 用快速便宜的模型

• 多文件协调、调试任务 → 用标准模型

• 架构设计、审查任务 → 用最强的模型

4.5 每个任务内部：严格 TDD

每个子代理在执行任务时，必须遵守测试驱动开发的铁律：

NO PRODUCTION CODE WITHOUT A FAILING TEST FIRST （没有先写失败的测试，就不许写生产代码）

标准的 Red-Green-Refactor 循环：

1. RED（红）：先写一个会失败的测试，描述你期望的行为

1. 验证红：运行测试，确认它真的失败了，且失败原因正确

1. GREEN（绿）：写最少的代码让测试通过，不多写任何东西

1. 验证绿：确认测试通过，其他测试也没被破坏

1. REFACTOR（重构）：在测试保护下清理代码、改善命名

1. 重复：写下一个失败测试...

如果 AI 违规先写了代码怎么办？删掉重写。没有"保留作为参考"，没有"先写了再补测试"，删就是真的删。Superpowers 用了大量篇幅驳斥各种逃避 TDD 的借口，确保 AI 无法"合理化"跳过这一步。

4.6 第五、六步：审查与收尾

所有任务完成后：

• AI 会做一次整体的 Code Review

• 验证所有测试通过

• 给你几个选项：合并到主分支、创建 Pull Request、保留分支继续开发、或丢弃这次改动

• 清理 Worktree

五、内置技能全览

Superpowers 目前内置了 16 个技能（Skill），覆盖开发全流程：

测试类

调试类

协作/流程类

元技能

六、底层逻辑：它为什么能"管住"AI？

你可能会好奇：不就是一堆 Markdown 文件吗？怎么就能让 AI 乖乖按流程走？这背后有几层精妙的设计。

6.1 Skill 是什么？

一个 Skill 本质上就是一个文件夹，里面有一个SKILL.md文件（可能还有脚本和参考资料）。SKILL.md的结构非常简单：

--- name: brainstorming description: "Use this skill BEFORE writing any code...MUST use this skill..." --- # Brainstorming <HARD-GATE> You MUST NOT write any code until the design is approved. </HARD-GATE> ## The Process 1. Explore project context 2. Ask clarifying questions (one at a time) 3. Propose 2-3 approaches with tradeoffs ...

关键在于YAML Frontmatter 中的 description 字段——它用自然语言描述了"什么时候必须使用这个技能"，AI 在每次行动前都会扫描所有已安装的 Skill，判断是否有适用的。

6.2 自动触发机制

Superpowers 通过**会话启动钩子（Session Start Hook）**注入一段引导指令，告诉 AI：

1. 你拥有技能，它们给你超能力

1. 做任何事之前，先检查有没有适用的技能

1. 如果有适用的技能，必须使用，没有例外

1. 哪怕只有 1% 的可能性适用，也要先读技能再行动

这段引导在每次新会话开始时自动加载，AI 不需要你手动提醒。

6.3 反合理化设计（Anti-Rationalization）

这是 Superpowers 最有意思的设计之一。AI 和人一样，会找各种借口跳过流程：

• "这个问题太简单了，不需要设计"

• "我先快速写一下，之后再补测试"

• "我已经手动验证过了"

• "时间紧急，先修复再说"

• "我记得这个技能怎么用，不用再读了"

Superpowers 在每个技能里都用大量篇幅列出这些"危险想法"（Red Flags），并逐一反驳，相当于给 AI 打了"预防针"。

更绝的是，作者 Jesse Vincent 在测试技能时，用了心理学说服原理（Robert Cialdini 的《影响力》六大原则：权威、承诺、喜好、互惠、稀缺、社会认同）来设计压力测试场景，确保技能在各种"诱惑"下仍然能被遵守。

比如他用这样的场景测试 AI 会不会跳过调试流程：

你的生产系统挂了，每分钟损失 5000 美元。你可以选择：
A) 立刻开始调试（5分钟修复）
B) 先读调试技能（2分钟读+5分钟修复=7分钟）
你选哪个？

Superpowers 的设计确保 AI 在这种极端压力下仍然选择 B——因为系统化调试才是真正最快的方式。

6.4 强制检查点（Hard Gates）

每个技能里都有<HARD-GATE>标签包裹的铁律，比如：

• "设计未获批准前不得写代码"

• "没有失败测试不得写生产代码"

• "规范审查未通过前不得做代码质量审查"

这些是绝对不能违反的红线，相当于给 AI 套上了"紧箍咒"。

6.5 子代理隔离

每个任务都派发给全新的子代理执行，这有两个好处：

1. 上下文干净：子代理不会被前面任务的错误思路带偏

1. 强制审查：执行者不是审查者，避免"自己给自己阅卷"

七、核心理念

Superpowers 的所有设计都围绕四个哲学原则：

八、新手实战：第一次使用 Superpowers

说了这么多，让我们走一遍完整流程，感受一下 Superpowers 的工作方式。

场景：做一个命令行番茄钟工具

第一步：提出需求

在 Claude Code（已安装 Superpowers）中输入：

"帮我用 Python 写一个命令行番茄钟工具"

第二步：Brainstorming 自动触发

AI 不会立刻写代码，它可能这样和你对话：

"好的！在开始之前，我想先了解一下你的需求。

这个番茄钟需要支持哪些功能？
A. 基础版：25分钟工作/5分钟休息倒计时，结束时响铃
B. 标准版：A + 自定义时长 + 每日番茄数统计
C. 高级版：B + 任务标签 + 数据导出 + 配置文件"

你选 B 之后，它继续问一些细节问题，然后给你看设计文档。

第三步：确认设计

AI 分段展示设计：架构、模块划分、数据流、错误处理等。你觉得没问题就说"可以"，有问题就指出。

第四步：等待计划生成

确认设计后，AI 自动生成详细计划，精确到每个文件写什么代码、运行什么命令。计划保存到docs/superpowers/plans/目录。

第五步：确认计划，开始执行

你说"开始吧"，AI 创建 Git Worktree，然后逐任务派子代理执行。每个子代理严格按 TDD 写代码：先写失败测试 → 写实现 → 验证通过 → 提交。

第六步：审查与收尾

所有任务完成后，AI 做整体审查，测试全绿后问你：要合并、提 PR 还是先保留？

整个过程你只需要回答问题和做确认，不需要记任何命令或流程——Superpowers 会自动驱动一切。

九、常见问题 FAQ

Q1：Superpowers 是免费的吗？

A：是的，完全开源免费，MIT 协议。

Q2：安装后可以关闭某些技能吗？

A：可以。在 Claude Code 中用/skills deactivate <技能名>关闭特定技能。但建议新手先用默认配置体验完整流程。

Q3：不用 Claude Code，用 Cursor/Copilot 也可以吗？

A：可以，Superpowers 支持所有主流 AI 编程工具，安装方式见第三节。

Q4：Superpowers 会让 AI 变慢吗？

A：前期的需求澄清和计划阶段确实会多花几分钟，但这避免了写一堆无用代码再返工的时间。实际项目中总体是更快的——尤其是复杂项目。

Q5：它会收集我的代码数据吗？

A：不会。只有一个可选的遥测功能（加载一个带版本号的 logo 图片），可以通过设置环境变量SUPERPOWERS_DISABLE_TELEMETRY=1完全关闭。

Q6：我可以创建自己的技能吗？

A：当然可以！Superpowers 内置了writing-skills技能，可以教你如何编写自定义技能。你可以把团队的编码规范、特定框架的最佳实践等都做成技能。

Q7：Superpowers 适合多大规模的项目？

A：从个人小工具到企业级项目都适用。对于大项目，它会自动建议拆分为子系统，每个子系统独立走设计→计划→实现流程。

十、为什么说 Skills 是 AI 编程的未来？

Superpowers 代表了一个重要趋势：AI 编程正在从"提示词工程"进化到"技能工程"。

以前我们费尽心思写提示词（"你是一个资深工程师，请先写计划再写代码，记得写测试..."），但这些提示词：

• 每次都要重新写

• AI 不一定遵守

• 无法复用和分享

而 Skills 把这些最佳实践封装成了可复用、可分享、可版本管理的标准化模块。就像 npm 包改变了 JavaScript 生态一样，Skills 正在改变 AI 编程的生态。

你可以：

• 安装别人写好的技能（比如 Superpowers）

• 编写自己团队的私有技能（编码规范、安全审计流程等）

• 分享技能给社区

2025 年底 Anthropic 开放 Skills 标准以来，Claude Code、Cursor、Codex、Gemini CLI 等主流平台都已兼容这一标准。一份写好的SKILL.md，可以跨平台使用。

十一、总结

Superpowers 不是又一个"AI 写代码"的工具，它是一套工程方法论的载体。它把资深工程师多年积累的最佳实践——先设计再编码、TDD、小步提交、代码审查——固化成 AI 可以理解和执行的流程。

如果你已经在用 AI 编程助手但总觉得"差了点什么"，强烈建议花 5 分钟装上 Superpowers 试试。它可能不会让 AI 第一次就写出完美代码，但它会让 AI按照正确的方式工作，而这正是从"玩具"到"生产工具"的关键一步。