拦住 Codex 立刻写代码：先问清需求，再出方案、写测试、按文件改
MIT 开源 · Codex / Claude Code / Cursor
Superpowers 是 Jesse Vincent（@obra，Keyboardio 创始人 / Prime Radiant）开源的「AI 编程方法论」技能框架，MIT 协议完全免费。GitHub 仓库搜索 obra/superpowers，截至 2026-09-01 约 28.0 万 Star、2.5 万 Fork，最新发布 v6.3.0（2026-08-12）。
它要治的不是「模型不够聪明」，而是 Codex 一句话开工时的三种病：瞎写（没问清就动手）、漏需求（你没说的边界它自己猜）、过度改代码（登录页以外的用户表、路由、导航也被重构）。做法是把资深工程师的流程写成会自动触发的 Markdown 技能：头脑风暴 → 分段确认设计 → 写出实施计划 → 子代理按任务做 → 红绿 TDD → 代码审查。
对 Codex 用户，它已经进了官方插件市场：App 侧栏 Plugins 里装，或 CLI 里敲 /plugins 搜索 Superpowers。同一套技能也支持 Claude Code、Cursor、Gemini CLI、GitHub Copilot CLI、OpenCode 等。装上之后，你还是说「做个登录」，它会先问给谁用、要不要记住登录、只许改哪些文件，答完才写。
| 项目 | 说明 |
|---|---|
| 本质 | 一套可组合的 Markdown 技能 + 启动指令，装进 AI 编程工具后按任务自动触发 |
| 覆盖流程 | 头脑风暴 → 写设计/计划 → 子代理执行 或 分批执行 → 红绿 TDD → 代码审查 → 分支收尾 |
| 产出 | 设计文档、精确到文件的实施计划、失败先红的测试、审查过的代码、干净的 Git 分支 |
| 支持的工具 | Codex App / CLI、Claude Code、Cursor、Gemini CLI、GitHub Copilot CLI、OpenCode、Factory Droid、Devin CLI、Hermes、Grok Build CLI、Kimi Code 等 |
| 体量 / 版本 | 约 28.0 万 Star、2.5 万 Fork；最新 v6.3.0（2026-08-12） |
| 环境 | 建议配置 |
|---|---|
| 操作系统 | Windows / macOS / Linux（技能是 Markdown + 脚本，无平台限制） |
| 运行环境 | 已能正常对话的 Codex（App 或 CLI）；或 Claude Code / Cursor 等任一支持的工具 |
| 硬件 | 无 GPU / 显存要求——它不跑模型，只给你的 AI 工具装流程 |
| 低配 / 无卡方案 | 本机装插件即可；没有 Codex 也可用 Claude Code 官方市场一条命令装 |
| 关键依赖 | Git（worktree / 分支流程会用到）；子代理技能需在 Codex 配置里打开 multi_agent |
/plugins 搜索同名即可。装完重启会话，技能会自动触发。先确认 Codex App 或 CLI 已经登录、能发消息。还没装 Codex 的，去 OpenAI 官网下载桌面端或按官方文档装 CLI。已经在用的直接跳第 2 步。
codex --version
Codex App：左侧 Plugins → Coding 分类里点 Superpowers 旁边的加号。Codex CLI：打开插件搜索，搜名字再选 Install Plugin。正文不写网址，在 GitHub 搜索 obra/superpowers 也能看到各工具安装段。
/plugins
# 搜索 superpowers → Install Plugin
市场装不上时，可用克隆 + 符号链接（Windows 用 junction）。子代理技能还要打开多 Agent：
# 在 GitHub 搜索 obra/superpowers，复制仓库后：
git clone <仓库地址> ~/.codex/superpowers
mkdir -p ~/.agents/skills
ln -s ~/.codex/superpowers/skills ~/.agents/skills/superpowers
仓库地址只在页首折叠块。配置文件里再加：
[features]
multi_agent = true
装完重启会话。你照旧提需求，例如「帮我做个登录功能」。它应先进入头脑风暴，而不是立刻改 auth.ts。你要盯住三问：给谁用、要不要记住登录、只许改哪些文件。答完它才出设计、再写计划。
帮我做个登录功能
# 若它直接开改，补一句：
use brainstorming skill，先问清再写
常用技能（自动触发，也可点名）：
| 技能 | 作用 |
|---|---|
brainstorming | 写码前问清需求，分段确认设计 |
writing-plans | 拆成 2–5 分钟小任务，精确到文件路径 |
test-driven-development | 先写失败测试，红了才写实现，绿了才往下 |
subagent-driven-development | 每个任务派子代理，两段审查后再前进 |
requesting-code-review | 对照计划审查，严重问题拦住合并 |
大任务用子代理驱动：计划里每个任务一个新子代理，配合 Git worktree 隔离。v6.3.0 起小任务可合并派发，计划冲突不再无限卡住——不可逆操作才会停下来问你。
用 subagent-driven-development 执行这份计划
每个任务开独立 worktree，计划外的文件不许改
装完先用同一句「做个登录」试一次。如果它还是立刻改三个文件，多半是插件没启用或会话没重启。显式说 use brainstorming skill。Claude Code 用户走官方市场：/plugin install superpowers@claude-plugins-official；Cursor 用 /add-plugin superpowers。
| 指标 | 表现 |
|---|---|
| GitHub 热度（2026-09-01） | 约 28.0 万 Star、2.5 万 Fork；最新 v6.3.0（2026-08-12） |
| 和一句话开工的差别 | 裸跑：立刻改多个文件、自己补需求。装上：先问、先计划、先红测，再写最少代码 |
| v6.3.0 流程变化 | 头脑风暴按任务大小缩放（小改动不再走两份文档）；子代理冲突不再无限卡住；小任务可合并派发 |
| 硬件成本 | 不跑本地模型；多出来的是对话轮次，换的是少返工 |
规则文件是建议，Superpowers 是流程。没有失败测试就不写实现、计划外文件不该被顺手重构，这些靠一句「请先问清楚」很难稳定住。社区在持续改技能，比自己维护一份规则省心。
Codex App / CLI、Claude Code、Cursor、Gemini CLI、GitHub Copilot CLI、OpenCode、Factory Droid、Devin CLI、Hermes、Grok Build CLI、Kimi Code 等。各工具一条命令，见项目 README（链接在页首折叠块）。
先重启会话（技能在启动时发现）。Codex 用 /plugins 确认已启用；仍不行就显式说 use brainstorming skill。子代理不工作就检查配置里是否打开了 multi_agent。
没有硬件要求。框架免费，但「先问再写 + 先测试」会比裸写多几轮对话——换来的是少返工，总账通常更省。
不用。v6.3.0 起头脑风暴会按任务大小缩放，小改动不再走两份文档。你也可以明确说「跳过 brainstorm 直接改」。
是同一仓库、同一套技能。Codex 走官方插件市场或克隆到 ~/.agents/skills；Claude Code 走官方插件市场一条命令。工作流一致：先问、再计划、再红绿测试。
不是。Jesse Vincent（@obra）发起的社区项目，已被两边的插件市场收录。MIT 协议，代码公开。
可以。MIT 协议，个人和商业项目都能用、改、分发，无需授权费。你产出代码的合规性由你的项目自己负责。