先说你可能遇到过的事
你让 AI「加个登录」，它很快回你：好了，已经写好。你打开 diff，多了三个文件，路由表被改了，配置文件里还多出几项你没提过的设置。代码也许能跑，但你心里发毛——这敢合进主分支吗？
更难受的是，这类「过度热心」不是偶发。Claude Code、Codex、Cursor 换着用，模型越聪明，越爱一口气改一片。Superpowers 针对的就是这个：不给模型多加智商，而是加流程——该问清楚时不闷头写，该写测试时不空口说「完成了」。
如果你每天用 AI 写业务代码，这篇值得花十分钟读完；几乎不让 AI 碰代码的话，当科普看看就行，没必要装。
先带你看一眼仓库和文档
建议先看图再往下读。知道 star 数、目录长什么样、官方怎么画流程，后文七步就不会像背口诀。
上图里值得先盯三处：star 在 23 万级；根目录有 skills/；还有 .claude-plugin、.codex-plugin、.cursor-plugin 等——多端插件是仓库结构的一部分，不是后来硬凑的。
文档站把流程画成从 Idea 到 Finishing Branch 的链路。README 里写得很硬：Mandatory workflows, not suggestions（强制流程，不是建议）。后文按这个顺序讲，可以一边看图一边对照。
它到底是什么
作者是 Jesse Vincent（Prime Radiant）。README 开头就说是 composable skills 加一组初始指令，让 coding agent 真的去用这些技能。
说白了，AI 不缺聪明，缺的是按步骤办事。 你可以把它想成十几份操作手册（官方叫 Skills，每个是一个 SKILL.md）：澄清需求、写计划、开独立工作区、写测试、派子助手、做审查、收尾分支，各管一段。会话里按场景加载，不是把整本手册塞进上下文。
常被误认成下面几类，其实都不是：
| 你以为它是 | 实际上它是 |
|---|---|
| 更强的代码补全 | 一套可触发的工程流程 |
| 提示词合集 | 带条件的技能包 |
| 某个 IDE 专属插件 | Claude Code、Codex、Cursor 等多端可用 |
一套开发任务，它怎么拦着你乱跑
官方典型流程七步。下面按实际顺序讲；括号里是仓库 skill 名，方便你对照 skills/ 目录。
先把需求聊透。 刚提想法，助手不能立刻新建文件。得像同事一样追问：登录方式？会话怎么保？出错怎么提示？设计分块给你确认，你点头才算过。（brainstorming）
换干净地方干活。 设计定了，在单独分支或 git worktree 里开发。动手前看一眼测试是不是绿的。（using-git-worktrees）
把活拆小。 大功能切成 2～5 分钟能做完的小任务，写清改哪个文件、怎么验证。（writing-plans）
该派帮手就派。 复杂任务交给子助手，做完过两轮检查：先对照计划，再看代码质量。（subagent-driven-development）
测试先行。 先写会失败的测试，再写刚好通过的实现（TDD）。（test-driven-development）
中间也要审。 任务之间就要 review，严重问题没修不能往下走。（requesting-code-review）
分支要有结局。 合并、开 PR、暂留或丢弃，别留半拉子分支。（finishing-a-development-branch）
using-superpowers 还有一条总开关：某条 skill 只要有可能适用，必须先加载再回复。这和 README 末尾那句「建议你看一眼」不是一回事。
和「在项目里写一堆 Rules」有什么不同
很多人已在 Cursor 或 Claude 里配了项目规则：代码风格、目录约定。那些规则一直挂着，像墙上的员工手册。
Superpowers 按你在干什么选流程。写新功能、收尾、调试各走不同 skill，可以和静态规则并存——规则管长期习惯，Superpowers 管这一次任务怎么推进。
| Superpowers | 项目里的静态规则 | |
|---|---|---|
| 用在哪 | Claude Code、Codex、Cursor 等 | 多半绑在某个 IDE |
| 何时生效 | 按任务场景触发 | 多数全程挂着 |
| 擅长什么 | 测试、评审、分支收尾的完整链路 | 编码规范、项目约定 |
怎么安装、怎么判断装对了
用几种编程助手，就要分别装几种（README 原话）。常用方式：
| 工具 | 怎么装 |
|---|---|
| Claude Code | /plugin install superpowers@claude-plugins-official |
| Codex CLI | /plugins → 搜 superpowers → Install |
| Codex App | 侧边栏 Plugins → Superpowers → + |
| Cursor | /add-plugin superpowers 或插件市场搜索 |
| Gemini CLI | gemini extensions install https://github.com/obra/superpowers |
完整列表见 Installation。Mintlify 文档里也有分端安装页。
装好后用同一句话自测——库拾本地用 Cursor 试过，Claude Code 或 Codex 里话术一样：
帮我在项目里加邮箱登录，先别写代码。
正常的话，它会先跟你掰扯登录方案和会话策略，不会马上建 auth.ts。要是直接开改代码，说明插件没生效，或者会话里没加载到 Superpowers。
想看清规范怎么写，翻仓库里这三份 skill 原文就够：
skills/brainstorming/SKILL.md
skills/writing-plans/SKILL.md
skills/subagent-driven-development/SKILL.md
读源码前，几个词对齐一下
- Skill（技能包）：带触发条件的操作手册，规定「这类事必须按这几步做」。
- 子代理：主对话派出的专项小助手。
- git worktree：同仓库另开干净副本，避免把主线改乱。
几件实话
流程再严，模型仍可能编造不存在的 API；测试和审查是兜底，不是万能。小改动也可能走全流程，着急的人会嫌慢——作者选的是稳，不是快。不想开遥测可以设 SUPERPOWERS_DISABLE_TELEMETRY=1。
如果你还想往下走
Star 仓库 以后好找更新；官方工作流文档 把七步拆到每个 Phase。最实在还是自己装一遍，用「先别写代码」试一次。
库拾自己也用 skills/ 和 pipelines/ 管内容，结构和 Superpowers 是同一类东西。想给自己的项目写第一份 SKILL.md，这个仓库当范本就行。
库拾 · Github 开源精选 · 数据与截图 2026-06-18
