Appearance
Superpowers 是一套运行在多个 AI 编程智能体平台上的工作流插件，核心价值是给 Claude Code、Cursor 等工具注入「技能库」，让智能体在写代码前先做设计、先写测试、先自我审查。安装方式因平台而异：Claude Code 和 Cursor 通过插件市场一条命令搞定，Codex 需要 git clone 加符号链接，OpenCode 改一行 JSON，Gemini CLI 用扩展命令安装。选对方式，5 分钟内即可完成。
Superpowers 完整安装指南：Claude Code / Cursor / Codex / Gemini
Superpowers 不是一个普通的代码补全插件，它的核心思路是：在智能体动手写代码之前，先逼它把需求想清楚、把计划写清楚、把测试准备好。这套工作流由一组「技能（skills）」驱动，技能会在合适时机自动触发，无需你手动喊话。
本文的重点是怎么装，以及装完怎么确认没出问题。
各平台安装命令速览
不同平台的安装机制差异很大，下表帮你快速找到对应命令：
| 平台 | 安装方式 | 核心命令 |
|---|---|---|
| Claude Code（官方市场） | 插件市场 | /plugin install superpowers@claude-plugins-official |
| Claude Code（第三方市场） | 先注册市场，再安装 | 见下方两步命令 |
| Cursor | 插件市场 | /add-plugin superpowers |
| Codex | 手动 git clone + 符号链接 | 见下方步骤 |
| OpenCode | 修改 opencode.json | 加一行 plugin 配置 |
| GitHub Copilot CLI | 插件市场命令 | 两行 copilot plugin 命令 |
| Gemini CLI | 扩展命令 | gemini extensions install |
Claude Code 安装
方式一：官方插件市场（推荐）
直接从 Claude 官方市场安装，最简单：
bash
/plugin install superpowers@claude-plugins-official方式二：第三方市场
如果官方市场不可用，先注册第三方市场，再安装：
bash
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace更新
bash
/plugin update superpowers技能会随插件自动更新，无需额外操作。
Cursor 安装
在 Cursor 的 Agent 聊天窗口中执行：
text
/add-plugin superpowers也可以直接在插件市场搜索「superpowers」找到并安装。
Codex 安装
Codex 没有插件市场，需要手动配置。官方提供了两种方式。
方式一：告诉 Codex 自动安装（最省事）
直接在 Codex 对话框中粘贴以下内容，Codex 会自动拉取并执行安装指令：
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md方式二：手动安装（Linux / macOS）
bash
# 1. 克隆仓库
git clone https://github.com/obra/superpowers.git ~/.codex/superpowers
# 2. 创建技能目录并建立符号链接
mkdir -p ~/.agents/skills
ln -s ~/.codex/superpowers/skills ~/.agents/skills/superpowers
# 3. 重启 Codex手动安装（Windows）
Windows 不支持软链接（需要开发者模式），改用目录联接（junction）：
powershell
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.agents\skills"
cmd /c mklink /J "$env:USERPROFILE\.agents\skills\superpowers" "$env:USERPROFILE\.codex\superpowers\skills"启用多智能体功能（可选）
部分技能（如 dispatching-parallel-agents、subagent-driven-development）依赖 Codex 的多智能体特性，需在 Codex 配置文件中启用：
toml
[features]
multi_agent = true更新
bash
cd ~/.codex/superpowers && git pull符号链接机制让技能更新立即生效，无需重启。
OpenCode 安装
OpenCode 通过修改配置文件安装插件，找到你的 opencode.json（全局或项目级别均可），加入以下内容：
json
{
"plugin": ["superpowers@git+https://github.com/obra/superpowers.git"]
}重启 OpenCode 后，插件通过 Bun 自动安装，所有技能立即可用。
如果你之前用旧版符号链接方式安装过，需先清理旧文件：
bash
rm -f ~/.config/opencode/plugins/superpowers.js
rm -rf ~/.config/opencode/skills/superpowers
rm -rf ~/.config/opencode/superpowers然后按上述方式重新安装。
版本锁定
如需固定到特定版本，在 URL 后加分支名或标签：
json
{
"plugin": ["superpowers@git+https://github.com/obra/superpowers.git#v5.0.3"]
}GitHub Copilot CLI 安装
bash
copilot plugin marketplace add obra/superpowers-marketplace
copilot plugin install superpowers@superpowers-marketplaceGemini CLI 安装
bash
# 安装
gemini extensions install https://github.com/obra/superpowers
# 更新
gemini extensions update superpowers验证安装是否成功
安装完成后，开启一个新会话，然后用以下任意一句话触发技能：
- "帮我规划这个功能"
- "我们来调试这个问题"
- "tell me about your superpowers"（OpenCode 专用验证语句）
如果智能体自动调用了对应技能（比如启动 brainstorming 或 writing-plans 流程），说明安装成功。
平台专属验证方式
| 平台 | 验证命令 / 方法 |
|---|---|
| Codex | ls -la ~/.agents/skills/superpowers，确认符号链接存在 |
| Codex | ls ~/.codex/superpowers/skills，确认技能目录有内容 |
| OpenCode | 在对话中输入 use skill tool to list skills，确认技能列表出现 |
| OpenCode | 查看日志：opencode run --print-logs "hello" 2>&1 | grep -i superpowers |
常见问题排查
技能没有自动触发
- 确认安装后开启了新会话（旧会话不会加载新插件）
- Codex 用户检查符号链接是否正确指向
~/.codex/superpowers/skills
Codex Windows 符号链接失败
联接（junction）通常不需要特殊权限。如果创建失败，尝试以管理员身份运行 PowerShell。
OpenCode 插件未加载
- 检查
opencode.json中plugin字段语法是否正确 - 确认运行的是较新版本的 OpenCode
- 查看插件加载日志确认是否有报错
卸载 Codex 版本
bash
rm ~/.agents/skills/superpowers
# 可选：删除克隆的仓库
rm -rf ~/.codex/superpowersWindows PowerShell：
powershell
Remove-Item "$env:USERPROFILE\.agents\skills\superpowers"
Remove-Item -Recurse -Force "$env:USERPROFILE\.codex\superpowers"FAQ
Q: Claude Code 和 Cursor 哪个安装更简单？ A: 两个都很简单，一行命令搞定。相比之下，Codex 的手动配置步骤更多，Windows 用户还要额外处理目录联接的问题。
Q: OpenCode 每次启动都会重新安装插件吗，会不会很慢？ A: 是的，OpenCode 在每次启动时从 git 仓库重新安装插件。好处是始终保持最新版本；如果对启动速度有要求，可以通过锁定版本标签（#v5.0.3）来跳过网络拉取。
Q: 安装后需要手动学习所有技能吗？ A: 不需要。Superpowers 的设计原则是技能自动触发——智能体根据你在做的任务类型自动选择对应技能。你只需要正常和它对话，它会在合适的时机介入。
Q: 多个平台可以同时安装吗？ A: 可以。每个平台的安装是相互独立的，不会互相干扰。技能文件本身是同一份，只是加载机制因平台而异。