SuperPowers 的安装方式因你所使用的 AI 编码代理平台而异。Claude Code 用户可通过官方或社区市场插件命令安装；Codex 依赖原生技能目录发现；OpenCode 需在 opencode.json 配置文件中声明插件；Cursor、Copilot CLI 和 Gemini CLI 则使用各自的扩展或插件管理命令。成功安装后，代理在启动相关任务时会自动加载技能，形成从 using-superpowers 开始的强制工作流闭环。

SuperPowers 安装指南：Claude Code、Codex、OpenCode、Cursor、Gemini 与 Copilot CLI

SuperPowers 是一个面向 coding agents 的技能系统，通过一系列可组合的 SKILL.md 文件引导代理遵循结构化的软件开发流程。安装的核心目标是让你所用的编码代理能够发现并加载仓库中的 skills 目录。本文将根据你使用的平台，提供具体的安装命令、配置和验证步骤。

安装完成后，代理会在相关任务启动时自动触发 brainstorming、writing-plans、test-driven-development 等技能，形成完整的工作流闭环。

Claude Code 安装

Claude Code 支持通过 Anthropic 官方市场或 Superpowers 社区市场进行插件安装。

1. 使用 Claude Code 官方市场

这是从 Anthropic 官方插件市场的安装方式。在 Claude Code 的对话界面中，直接运行以下命令：

/plugin install superpowers@claude-plugins-official

执行后，Claude Code 会自动下载并注册 SuperPowers 插件。

2. 使用 Superpowers Marketplace

你也可以通过 Superpowers 社区维护的市场安装。首先注册市场，然后安装插件：

# 第一步：注册市场
/plugin marketplace add obra/superpowers-marketplace

# 第二步：从该市场安装插件
/plugin install superpowers@superpowers-marketplace

安装完成后，重启 Claude Code 以确保所有技能被正确加载。

OpenAI Codex 安装

Codex 的安装依赖于其原生的技能发现机制，该机制会扫描 ~/.agents/skills/ 目录。

1. Codex CLI

最简单的方式是使用 Codex 的插件管理界面：

在 Codex 命令行中，打开插件搜索界面：
```
/plugins
```
搜索 Superpowers：
```
superpowers
```
选择 “Install Plugin”。

或者，你可以手动克隆仓库并创建符号链接：

克隆仓库到 ~/.codex/superpowers 目录。

创建技能目录和符号链接：

# Linux/macOS
mkdir -p ~/.agents/skills
ln -s ~/.codex/superpowers/skills ~/.agents/skills/superpowers

# Windows (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"

重启 Codex CLI，它将在启动时自动发现 ~/.agents/skills/superpowers 中的技能。

2. Codex App

在 Codex 图形界面应用中：

点击侧边栏的 “Plugins”。
在 “Coding” 分类下找到 “Superpowers”。
点击旁边的 “+” 号并根据提示完成安装。

OpenCode 安装

OpenCode 的安装通过在其配置文件中声明插件数组来完成，插件系统会自动处理技能注册，无需手动创建符号链接。

安装步骤

在项目的根目录或用户全局配置文件 opencode.json 中，添加以下内容：

{
  "plugin": ["superpowers@git+https://github.com/obra/superpowers.git"]
}

重启 OpenCode 后，插件会自动通过其包管理器安装并注册所有技能。你可以通过询问 “Tell me about your superpowers” 来验证安装是否成功。

从旧版符号链接迁移

如果此前是通过 git clone 和符号链接手动安装的，需先移除旧文件：

rm -f ~/.config/opencode/plugins/superpowers.js
rm -rf ~/.config/opencode/skills/superpowers
# 可选：移除旧仓库
rm -rf ~/.config/opencode/superpowers
# 从 opencode.json 中移除旧的 `skills.paths` 配置（如果添加过）

然后按照上述 opencode.json 方法重新配置。

Windows 问题排查

一些 Windows 上的 OpenCode 构建版本在处理 git+https 格式的插件包时可能存在上游安装器问题。如果 OpenCode 无法安装插件，可以尝试使用系统 npm 先本地安装，再将 OpenCode 指向本地包路径：

npm install superpowers@git+https://github.com/obra/superpowers.git --prefix "$HOME\.config\opencode"

然后修改 opencode.json，使用本地包路径：

{
  "plugin": ["~/.config/opencode/node_modules/superpowers"]
}

Cursor 安装

在 Cursor 的 Agent 对话窗口中，可以直接通过命令安装：

/add-plugin superpowers

或者在 Cursor 的插件市场中搜索 “superpowers” 进行安装。

GitHub Copilot CLI 安装

在终端中运行以下两条命令：

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

Gemini CLI 安装

Gemini CLI 通过其扩展管理命令进行安装：

gemini extensions install https://github.com/obra/superpowers

安装后，SuperPowers 会通过仓库中的 gemini-extension.json 配置文件和 GEMINI.md 来加载核心技能 using-superpowers 以及适配 Gemini 的工具映射。gemini-extension.json 中的 contextFileName 字段指定了加载技能的入口文件 GEMINI.md。

更新时使用：

gemini extensions update superpowers

Factory Droid 安装

在终端中运行以下两条命令：

droid plugin marketplace add https://github.com/obra/superpowers
droid plugin install superpowers@superpowers

安装后验证与常见操作

验证安装

安装完成后，最直接的验证方法是让代理执行 using-superpowers 技能。该技能会引导代理介绍所有已加载的能力，确认技能库已成功集成。

更新

各平台的更新策略略有不同：

OpenCode：通常重启后会自动拉取最新版本。如果更新未生效，可尝试清除 OpenCode 的包缓存或重新安装插件。
Gemini CLI：使用 gemini extensions update superpowers 命令。
Codex：如果通过克隆安装，需进入克隆目录执行 git pull 更新。
Claude Code：插件更新通常自动完成或通过市场命令管理。

更新后，由于技能是动态加载的，无需额外配置即可生效。

卸载

以 Codex 为例，如果通过符号链接安装，可删除符号链接 rm ~/.agents/skills/superpowers，并可选择删除克隆的仓库 rm -rf ~/.codex/superpowers。其他平台请参考各自的插件管理文档。

FAQ

Q: 安装后代理找不到技能或未触发 brainstorming 等流程，怎么办？ A: 首先确认安装步骤是否正确完成。对于 Codex，请检查 ~/.agents/skills/superpowers 符号链接是否有效，并重启代理。对于 OpenCode，请检查 opencode.json 中的插件声明并重启。使用平台提供的工具（如 OpenCode 的 skill 工具）列出已加载的技能进行排查。

Q: 不同平台安装的技能功能一样吗？ A: 核心技能库（SKILL.md 文件）是跨平台通用的。但某些技能涉及平台特定工具（如文件操作、任务系统），SuperPowers 会通过平台适配层自动处理工具名映射，确保工作流在不同平台表现一致。

Q: 如何为自定义项目创建专属技能？ A: 对于支持项目级技能的平台（如 OpenCode），可以在项目的技能目录下创建符合规范的 SKILL.md 文件。例如，在 OpenCode 的项目目录下创建 .opencode/skills/my-skill/SKILL.md。项目级技能通常具有最高优先级。

SuperPowers 安装指南：Claude Code、Codex、OpenCode、Cursor、Gemini 与 Copilot CLI #

Claude Code 安装 #

1. 使用 Claude Code 官方市场 #

2. 使用 Superpowers Marketplace #

OpenAI Codex 安装 #

1. Codex CLI #

2. Codex App #

OpenCode 安装 #

安装步骤 #

从旧版符号链接迁移 #

Windows 问题排查 #

Cursor 安装 #

GitHub Copilot CLI 安装 #

Gemini CLI 安装 #

Factory Droid 安装 #

安装后验证与常见操作 #

验证安装 #

更新 #

卸载 #

FAQ #