Superpowers 不是那种“装完多几个命令”的小插件，它更像是给 Claude Code、Codex、Cursor 这类 AI 编程工具装上一套完整的开发流程。装好之后，AI 不会一上来就乱写代码，而是会先帮你理清需求、拆计划、按步骤实现，再做检查和收尾。官方把它定义为一套给编码代理使用的完整软件开发工作流，并且不同平台安装方式不一样。(GitHub)

Superpowers 新手教程：从安装到使用

Superpowers 到底是干什么的？

你可以把 Superpowers 理解成：
让 AI 更像一个靠谱开发者，而不是一个只会立刻开写代码的助手。

官方说明里提到，它的工作方式是这样的：

• 先问清楚你真正要做什么

• 再把设计拆成你能看懂、能确认的内容

• 然后生成实现计划

• 最后再交给 AI 去执行、检查、继续推进

而且这些技能会自动触发，你不需要把一堆命令全背下来。(GitHub)

---

安装前先搞清楚：你用的是哪个工具

Superpowers 支持多个平台，但安装方法不一样。官方明确写了：

• Claude Code / Cursor：可以走插件市场

• Codex / OpenCode：需要手动安装

所以你先不要急着复制命令，先确认你现在到底在用哪个 AI 编程工具。(GitHub)

---

Claude Code 安装方法

如果你用的是 Claude Code，最简单。

官方给了两种方式。

方法一：官方 Claude 插件市场

直接安装：

/plugin install superpowers@claude-plugins-official

方法二：先添加市场，再安装

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

这是 README 里现在提供的 Claude Code 安装方式。(GitHub)

---

Codex 安装方法

如果你用的是 OpenAI Codex CLI，安装方式是“克隆仓库 + 建立 skills 链接”。

官方步骤是：

git clone https://github.com/obra/superpowers.git ~/.codex/superpowers
mkdir -p ~/.agents/skills
ln -s ~/.codex/superpowers/skills ~/.agents/skills/superpowers

然后重启 Codex，因为 Codex 会在启动时扫描 ~/.agents/skills/ 目录并自动发现技能。(GitHub)

如果你是 Windows，官方建议用 junction：

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.agents\skills"
cmd /c mklink /J "$env:USERPROFILE\.agents\skills\superpowers" "$env:USERPROFILE\.codex\superpowers\skills"

(GitHub)

---

安装完怎么确认成功？

最简单的判断方法不是看它有没有报错，而是看 技能目录有没有连上。

Codex 官方文档里给的验证方法是：

ls -la ~/.agents/skills/superpowers

如果能看到它正确指向 Superpowers 的 skills 目录，说明安装基本成功。(GitHub)

对于 Claude Code 用户，只要插件安装成功，后续技能通常会自动生效。(GitHub)

---

它不是靠“记命令”来用的

这里是新手最容易误解的地方。

Superpowers 不是那种必须记住几十条命令才能用的插件。官方说明里明确提到：

• 如果你主动提到某个 skill 名字，它会触发

• 如果你的任务符合某个 skill 的描述，它会自动触发

• using-superpowers 这个 skill 也会引导代理去调用其他合适的 skill

也就是说，你平时主要是正常下达任务，Superpowers 会在背后接管流程。 (GitHub)

---

新手正确用法：不要一上来就说“帮我写代码”

最好的用法是，把它当成一个会先思考、再开工的 AI 搭子。

低效写法

帮我做一个博客系统

这种说法太大、太空，AI 很容易理解偏。

更高效的写法

我想做一个个人博客系统，先帮我明确最小可用版本需要哪些页面和功能，再给出实现计划。

或者：

先不要写代码，先帮我梳理需求和设计方案。

因为 Superpowers 本身就强调：
先把需求和设计说清楚，再出计划，再进入实现。(GitHub)

---

新手最推荐的使用顺序

你可以直接按下面这个顺序来。

第一步：先说目标

比如：

我想做一个带后台管理的个人博客，支持文章发布、标签、搜索和评论，先帮我整理需求。

这一步的目的，是让 AI 不要直接写代码，而是先跟你对齐目标。

第二步：确认设计

当它开始给你列需求、模块、页面结构时，不要急着说“继续”。

先看看这些内容是不是你真想要的，比如：

• 是否需要登录系统

• 评论要不要审核

• 搜索是全站搜索还是仅文章搜索

• 后台权限是否只有你一个管理员

官方 README 里提到，Superpowers 会把设计内容拆成便于阅读和确认的部分。这个阶段你确认得越认真，后面返工越少。(GitHub)

第三步：让它出计划

你可以直接说：

好，按这个方案继续，请给出实现计划。

Superpowers 的核心能力之一就是先出实现计划，再进入执行。官方还特别强调，这个计划应该清楚到“即使是经验一般、上下文不完整的人也能照着做”。(GitHub)

第四步：再让它开始做

当需求和计划都没问题时，再说：

可以，开始实现。

官方说明里提到，进入执行后会启动子代理驱动的开发流程，边做边检查，持续往前推进。(GitHub)

---

它最适合做什么任务？

Superpowers 特别适合这些情况：

1. 新项目起步

比如：

我要做一个 SaaS 管理后台，先从需求和架构开始。

2. 中等以上复杂功能

比如：

给现有博客增加会员系统、支付和权限控制，先帮我拆方案。

3. 重构和改造老项目

比如：

重构这个评论模块，目标是更清晰的组件结构和更完整的测试。

4. 想让 AI 更稳，而不是更快

Superpowers 的强项不是“秒出代码”，而是“按流程做事”。如果你经常遇到 AI 写着写着跑偏、漏测试、乱改结构，那它会比普通模式更适合你。(GitHub)

---

新手一定要知道的使用原则

先让它想，再让它写

不要把它当成“更强的自动补全”。
它更适合先讨论，再计划，再执行。

一次只推进一件大事

不要一口气说：

帮我把前台、后台、支付、SEO、评论系统、埋点分析全做完

更好的方式是分阶段推进：

• 先定博客 MVP

• 再做前台

• 再做后台

• 再补搜索和评论

看到设计不对，立刻打断

Superpowers 虽然流程更稳，但不是不会误解。
只要发现方向不对，就立刻改，不要想着“先让它写完再说”。

让它明确边界

比如直接说：

先只做 MVP，不考虑支付和多角色权限

这种约束能明显减少 AI 过度设计的问题。

---

一个最适合新手的完整示例

假设你要做一个个人博客，可以这样用。

第 1 句

我想做一个个人博客系统，面向程序员内容创作，先帮我整理 MVP 需求，不要写代码。

第 2 句

等它列出页面、功能、数据结构后，你再说：

可以，继续给出实现方案和开发顺序。

第 3 句

当它把方案讲清楚后，你再说：

好，按这个计划开始实现第一阶段。

这就是最推荐的新手玩法：

目标 → 需求 → 设计 → 计划 → 执行

而这正是 Superpowers 官方强调的核心流程。(GitHub)

---

如果感觉“没反应”，先排查这几个地方

如果安装后觉得它没生效，优先检查：

• 插件是不是装到了正确平台

• Codex 有没有重启

• ~/.agents/skills/superpowers 是否存在

• skills 目录是否真的链接到了仓库里的 skills/

官方文档明确提到，Codex 的技能是在启动时发现的，所以不重启可能就不会生效。(GitHub)

---

更新也很简单

如果你是手动安装到 Codex，更新方法就是：

cd ~/.codex/superpowers && git pull

因为 skills 是通过符号链接暴露出去的，所以仓库更新后通常就会同步生效。(GitHub)

---

总结

Superpowers 最适合新手的理解方式，不是“学一堆命令”，而是记住一句话：

它是帮你把 AI 编程流程变正规。

安装好之后，你最该做的不是研究插件细节，而是学会这样下任务：

• 先说清目标

• 再确认设计

• 再让它出计划

• 最后再开始实现

这样用，Superpowers 才能真正发挥价值。官方 README 也明确说明了这一点：它不是让 AI 直接冲上去写代码，而是先澄清需求、给出设计、制定计划，再由子代理推进开发。(GitHub)