Superpowers 使用教程

📖 项目简介

Superpowers 是一套给 AI 编码代理用的「完整软件开发方法论」，在 GitHub 上已经拿下约 21 万 Star，采用 MIT 协议完全开源免费。

它的本质是一组可组合的技能（Skills）+ 一份让代理一定会用这些技能的初始指令。装上之后，你的 Codex 不再一上来就闷头写代码，而是会自动按一套靠谱流程做事：先和你头脑风暴把需求问清楚 → 把设计拆成你能读懂的小块逐段确认 → 生成一份连实习生都能照做的实施计划 → 启动「子代理驱动开发」逐个任务实现并审查 → 全程遵循红/绿/重构的测试驱动开发（TDD）。技能会自动触发，你不用记任何命令。

最关键的是它不只服务 Codex：Codex CLI、Codex App、Claude Code、 Gemini CLI、Cursor、Factory Droid、OpenCode、GitHub Copilot CLI 这些主流编码代理都能装，每种代理单独安装一次即可。

📎 相关链接与安装市场（点击展开）

GitHub 项目： github.com/obra/superpowers
Codex / Copilot 插件市场： obra/superpowers-marketplace
更多教程：关注公众号 / 抖音 / 视频号「IT小圈」

✨ 核心亮点

🧠

先想后写

自动头脑风暴、产出规格，不再瞎写代码

🧪

真红绿 TDD

先写失败测试，再写实现，最后重构提交

🤖

子代理开发

逐个任务派发 + 两阶段审查，能连续自跑

🧩

技能自动触发

不用记命令，代理会自己挑合适的技能

🚀 安装与使用

💡

Superpowers 按「编码代理」分别安装。下面以最近爆火的 Codex 为例， Claude Code、Cursor 等同理（都走各自的插件市场）。

Codex CLI：从官方插件市场安装

在 Codex CLI 里打开插件界面，搜索 superpowers，选择安装即可：

                        Codex CLI
                        /plugins
superpowers
# 在结果里选择 Install Plugin
                    

Codex App：侧边栏一键添加

打开 Codex App，点击侧边栏的 Plugins，在 Coding 分区找到 Superpowers，点旁边的「+」按提示安装即可。

直接描述你要做的东西

装好后无需任何特殊指令。你只要正常告诉 Codex「我想做一个 XXX」，它就会自动触发技能：先追问需求、分段确认设计，再写实施计划、跑 TDD、派子代理实现并审查。

                        对话示例
                        帮我做一个待办清单的小工具，要能本地存储
                    

放手让它跑

设计确认、计划生成后，说一句「开始」，它就进入子代理驱动开发，一个任务一个任务地实现 + 审查，常常能连续自跑较长时间还不跑偏。全程红灯先写测试、绿灯再写实现、最后重构。

🔁 内置工作流（自动触发）

头脑风暴：写码前先苏格拉底式追问，把模糊想法打磨成需求，存成设计文档。
Git Worktrees：设计通过后，开独立分支隔离工作区，先验证测试基线干净。
写计划：把工作拆成 2-5 分钟一个的小任务，每个都有明确文件路径、代码与验证步骤。
子代理驱动开发：每个任务派一个全新子代理，做完两阶段审查（先合规、再质量）。
测试驱动开发：强制 RED-GREEN-REFACTOR，先写失败测试，再写最小实现，跑通后提交。
请求代码审查：任务之间按严重程度报告问题，关键问题会拦住进度。
收尾分支：任务完成后验证测试，给出合并 / PR / 保留 / 丢弃选项并清理工作区。

❓ 常见问题

Q: 只能给 Codex 用吗？

不是。Codex CLI / Codex App、Claude Code、Gemini CLI、Cursor、Factory Droid、 OpenCode、GitHub Copilot CLI 都支持。如果你同时用多个代理，需要为每个分别安装一次。

Q: 装上之后要记一堆命令吗？

不用。技能是自动触发的——代理一旦发现你在构建东西，就会自己挑合适的技能上场，正常对话即可。

Q: 它会拖慢开发吗？

前期多花几分钟对齐需求和计划，但换来的是更少返工、更高完成度。它强调 TDD、YAGNI、DRY，目标是减少复杂度、用证据代替猜测。