Superpowers 使用教程-cmzhiku

项目简介

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 等。装上之后，你还是说「做个登录」，它会先问给谁用、要不要记住登录、只许改哪些文件，答完才写。

📎 相关链接与下载地址（点击展开）

核心亮点

❓ 先问再写

写码前强制头脑风暴，把给谁用、改哪些文件问清楚，从源头拦住瞎写

📝 计划精确到文件

实施计划写明每个任务改哪些路径，没在计划里的文件不许顺手重构

🧪 红绿 TDD

没有失败的测试就不许写实现，RED → GREEN → REFACTOR，漏掉的需求会先在测试里露馅

🤖 子代理按任务干

每个小任务派独立子代理，两段审查（规格 + 代码质量），长任务不跑偏

它能做什么、输出什么

项目	说明
本质	一套可组合的 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

如何使用

💡 最省事路径：Codex App 侧栏点 Plugins，在 Coding 分类里找到 Superpowers，点加号装上。CLI 用户敲 /plugins 搜索同名即可。装完重启会话，技能会自动触发。

步骤 1

前置：Codex 能正常对话

先确认 Codex App 或 CLI 已经登录、能发消息。还没装 Codex 的，去 OpenAI 官网下载桌面端或按官方文档装 CLI。已经在用的直接跳第 2 步。

bash

codex --version

步骤 2

装上 Superpowers（优先走官方市场）

Codex App：左侧 Plugins → Coding 分类里点 Superpowers 旁边的加号。Codex CLI：打开插件搜索，搜名字再选 Install Plugin。正文不写网址，在 GitHub 搜索 obra/superpowers 也能看到各工具安装段。

Codex CLI

/plugins# 搜索 superpowers → Install Plugin

市场装不上时，可用克隆 + 符号链接（Windows 用 junction）。子代理技能还要打开多 Agent：

bash

# 在 GitHub 搜索 obra/superpowers，复制仓库后：git clone <仓库地址> ~/.codex/superpowersmkdir -p ~/.agents/skillsln -s ~/.codex/superpowers/skills ~/.agents/skills/superpowers

仓库地址只在页首折叠块。配置文件里再加：

toml

[features]multi_agent = true

步骤 3

基础用法：还是说「做个登录」，看它先问什么

装完重启会话。你照旧提需求，例如「帮我做个登录功能」。它应先进入头脑风暴，而不是立刻改 auth.ts。你要盯住三问：给谁用、要不要记住登录、只许改哪些文件。答完它才出设计、再写计划。

对话

帮我做个登录功能# 若它直接开改，补一句：use brainstorming skill，先问清再写

常用技能（自动触发，也可点名）：

技能	作用
`brainstorming`	写码前问清需求，分段确认设计
`writing-plans`	拆成 2–5 分钟小任务，精确到文件路径
`test-driven-development`	先写失败测试，红了才写实现，绿了才往下
`subagent-driven-development`	每个任务派子代理，两段审查后再前进
`requesting-code-review`	对照计划审查，严重问题拦住合并

步骤 4

进阶：子代理 + worktree，拦住乱改

大任务用子代理驱动：计划里每个任务一个新子代理，配合 Git worktree 隔离。v6.3.0 起小任务可合并派发，计划冲突不再无限卡住——不可逆操作才会停下来问你。

对话

用 subagent-driven-development 执行这份计划每个任务开独立 worktree，计划外的文件不许改

步骤 5

结合 Codex 的验收清单

装完先用同一句「做个登录」试一次。如果它还是立刻改三个文件，多半是插件没启用或会话没重启。显式说 use brainstorming skill。Claude Code 用户走官方市场：/plugin install superpowers@claude-plugins-official；Cursor 用 /add-plugin superpowers。

✅ 验收标准：同一句话，从「立刻改 auth / users / layout」变成「先问三问，再出方案、写测试」。

典型应用场景

🔐 做登录却漏需求

没问记住密码、给谁用，它自己加 JWT；先问三问再写

🧭 改一处动全家

只想动登录页，导航和用户表也被重构；计划锁死文件清单

🐛 修祖传 bug

先写复现失败的测试，修完变绿，不再靠「我觉得修好了」

🏗️ 大型重构

拆小任务 + worktree 隔离，改一半不怕把主分支搞崩

🌙 挂机长任务

子代理按计划推进，检查点拦住跑偏，不必盯着每一行

👥 团队同一套流程

每个人的 Codex 都先问再写，评审标准一致

和裸跑 Codex 比什么

指标	表现
GitHub 热度（2026-09-01）	约 28.0 万 Star、2.5 万 Fork；最新 v6.3.0（2026-08-12）
和一句话开工的差别	裸跑：立刻改多个文件、自己补需求。装上：先问、先计划、先红测，再写最少代码
v6.3.0 流程变化	头脑风暴按任务大小缩放（小改动不再走两份文档）；子代理冲突不再无限卡住；小任务可合并派发
硬件成本	不跑本地模型；多出来的是对话轮次，换的是少返工

🧠 原理一句话：它不换模型，只是把「先问清、先测试、再改指定文件」写成 AI 每次干活前必须遵守的规则。

常见问题

Q: 和我自己写规则文件有什么区别？

规则文件是建议，Superpowers 是流程。没有失败测试就不写实现、计划外文件不该被顺手重构，这些靠一句「请先问清楚」很难稳定住。社区在持续改技能，比自己维护一份规则省心。

Q: 支持哪些 AI 编程工具？

Codex App / CLI、Claude Code、Cursor、Gemini CLI、GitHub Copilot CLI、OpenCode、Factory Droid、Devin CLI、Hermes、Grok Build CLI、Kimi Code 等。各工具一条命令，见项目 README（链接在页首折叠块）。