概述

上一篇讲了 Superpowers 是什么，这篇直接动手——挑一个你在用的平台，把它装上跑起来。

Superpowers 支持六个 AI 编码平台。安装方式各有不同，装完效果一样：Agent 每次开会话时自动加载 using-superpowers 元技能，1% 规则和技能检查协议就位。

下面按平台逐个给出安装命令、验证方法和排障思路。挑你用的看就行，不用全读。

平台对比速查

先扫一眼全貌：

平台	安装方式	安装命令	元技能注入方式	子代理工具
Claude Code	官方插件市场	/plugin install superpowers@claude-plugins-official	SessionStart hook	Task
Cursor	内置市场	/add-plugin superpowers	hooks-cursor.json	有限支持
OpenCode	opencode.json 配置	添加 plugin URL	messages.transform hook	@mention
Codex	CLI 或 App 市场	/plugins → 搜索	原生发现	task
Gemini CLI	扩展管理器	gemini extensions install <url>	GEMINI.md 上下文文件	@generalist
Copilot CLI	插件市场	marketplace add	插件注入	task

验证标准统一：给 Agent 一个需要设计的任务（比如「帮我做个 todo list」），它应该先触发 brainstorming 技能问你需求，而不是直接开写代码。

Claude Code

Superpowers 的主开发平台，功能支持最全。

安装

方式一：官方市场（推荐）

/plugin install superpowers@claude-plugins-official

一行搞定。

方式二：社区市场（拿预发布版）

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

先注册社区市场源，再从里面安装。适合想尝鲜最新版的人。

装完发生了什么

安装后的文件结构：

插件目录/
├── skills/                    # 技能库（brainstorming、writing-plans 等）
├── hooks/
│   ├── hooks.json             # 注册 SessionStart 钩子
│   ├── session-start          # bash 脚本，读取元技能并注入上下文
│   └── run-hook.cmd           # Windows/Unix 双栖包装器
└── .claude-plugin/
    └── plugin.json            # 插件清单

hooks.json 注册了一个 SessionStart 钩子，匹配 startup|clear|compact 三种事件。每次会话启动（包括清除或压缩上下文），session-start 脚本把 using-superpowers/SKILL.md 读出来、JSON 转义、包在 <EXTREMELY_IMPORTANT> 标签里塞进 Agent 上下文。注入是同步的（async: false），Agent 说第一句话之前规则就已经就位。

验证

/plugin list

确认列表里有 superpowers。然后开一个新会话，输入：

Let's make a react todo list

装对了的话，Agent 不会直接写 React 代码，而是先调 brainstorming 技能问你需求。

更新

/plugin update superpowers

Cursor

安装

在 Cursor 的 Agent 聊天窗口里执行：

/add-plugin superpowers

或者在内置插件市场 UI 里搜索 “superpowers” 安装。装完立即生效，不需要额外配置。

和 Claude Code 的区别

Cursor 走的是自己的 hook 格式。插件用 hooks-cursor.json（camelCase 命名风格）注册会话启动事件，Windows 下通过 run-hook.cmd polyglot 包装器调 bash 脚本。

元技能注入到 additional_context 字段（Cursor 专用的 snake_case 格式），和 Claude Code 的 hookSpecificOutput.additionalContext 路径不同，但效果一样。

验证

开新会话，输入：

I need to build a new feature that handles user authentication

Agent 应该先找到并加载 brainstorming 技能，问你认证方案的细节，而不是直接写登录页面。

排障

如果 Agent 不用技能，直接写代码：

1. 检查插件是否在已安装列表里
2. 确认版本 ≥ 5.1.0
3. 重装：删掉再执行 /add-plugin superpowers
4. 重启 Cursor 让 hook 系统重新初始化

OpenCode

安装

在全局或项目级的 opencode.json 里加一行：

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

如果想锁定版本：

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

改完重启 OpenCode，插件会自动拉取仓库并注册。

迁移注意

如果之前用的是老的 git clone + 符号链接方式安装，先清掉旧文件：

rm -f ~/.config/opencode/plugins/superpowers.js
rm -rf ~/.config/opencode/skills/superpowers
rm -rf ~/.config/opencode/superpowers

不清可能会和新插件冲突。

技术细节

OpenCode 的集成走 JavaScript 插件（.opencode/plugins/superpowers.js），做两件事：

1. 上下文注入：通过 experimental.chat.messages.transform hook，把元技能内容塞进每次会话的第一条用户消息里。用模块级缓存（getBootstrapContent()）避免重复读文件。
2. 技能路径注册：通过 config hook，把 skills/ 目录加到 config.skills.paths 搜索列表里，让 OpenCode 原生技能发现机制能找到 Superpowers 的技能。

技能优先级

OpenCode 有三级搜索路径，高优先级覆盖低优先级（同名 shadowing）：

1. 项目级：.opencode/skills/（最高）
2. 个人级：~/.config/opencode/skills/
3. Superpowers 库：插件自带的 skills/（最低）

想覆盖某个技能？在项目或个人目录下建同名文件夹放 SKILL.md 就行。

验证

重启后试三步：

1. 问 Agent：Tell me about your superpowers
   → 应该描述工作流

2. 让 Agent 列技能：use skill tool to list skills
   → 应该看到 superpowers/brainstorming 等

3. 查日志（如果插件没加载）：
   opencode run --print-logs "hello" 2>&1 | grep -i superpowers

Codex

安装

CLI 方式：

/plugins
# 搜索 superpowers，选择安装

App 方式：

侧栏点 Plugins → Coding 分类 → 找到 Superpowers → 点 + 安装。

手动方式（Git 克隆）：

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

注意符号链接要指向 skills/ 子目录，不是仓库根目录。

和其他平台的区别

Codex 不需要 session hook 来注入元技能——它的技能发现是原生的。插件安装后，Codex 直接扫描 .codex-plugin/plugin.json 里声明的 skills 路径，解析每个 SKILL.md 的 frontmatter，自动索引到内存注册表。using-superpowers 元技能会被自动发现并强制执行。

子代理用 task 工具（agent_type: "general-purpose"）调度，任务追踪用 sql 工具操作 todos 表。

验证

/plugins
# 确认 Superpowers 在列表里且状态为 active

# 然后问：
What skills do you have available?

Gemini CLI

安装

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

工作原理

Gemini CLI 用扩展机制。安装后，gemini-extension.json 告诉 Gemini 在每次会话开始时读取 GEMINI.md 文件。GEMINI.md 用 @ 语法引入两个关键文件：

@./skills/using-superpowers/SKILL.md
@./skills/using-superpowers/references/gemini-tools.md

第一个是元技能本体，第二个是 Gemini 专用的工具映射表。

Gemini 的工具映射差异比其他平台大，值得看一眼：

Claude Code 工具	Gemini CLI 等价物
Skill	activate_skill
Task	@generalist（Gemini 用 @ 语法调子代理）
TodoWrite	write_todos
Read / Write / Edit	read_file / write_file / replace
Bash	run_shell_command
WebSearch	google_web_search

Gemini 还有几个独有工具：save_memory（跨会话记忆）、enter_plan_mode / exit_plan_mode（只读研究模式）、tracker_create_task（任务管理）。

更新

gemini extensions update superpowers

验证

开新会话，给个需要设计的任务。Agent 应该调用 activate_skill 加载 brainstorming。

Copilot CLI

Copilot CLI 的安装走插件市场：

# 添加市场源（如果还没添加）
marketplace add obra/superpowers

# 安装
plugin install superpowers

工具映射和 Claude Code 比较接近：Skill → skill，Task → task，TodoWrite → sql（操作 todos 表），Read → view，Write → create，Edit → edit。

Copilot CLI 还支持异步 shell（bash + async: true）和跨会话记忆（store_memory）。

装好之后：第一次对话实测

不管装在哪个平台，验证流程都一样。开一个新会话，试这句：

帮我做一个 React todo list

期望的 Agent 行为：
┌─────────────────────────────────────────────────────┐
│ 1. Agent 检测到任务涉及新功能开发                      │
│ 2. 触发 1% 规则，调用 Skill 工具                      │
│ 3. 找到 brainstorming 技能，加载并进入                 │
│ 4. 问你几个问题：                                     │
│    - 数据存在哪？localStorage 还是后端？               │
│    - 要不要分类/优先级/截止日期？                       │
│    - 用什么 UI 框架？                                 │
│ 5. 提出 2-3 个方案，分析取舍                           │
│ 6. 等你确认设计方案后才开始下一步                       │
│                                                      │
│ 绝对不会发生的事：                                     │
│ ✗ 直接开始写 App.tsx / TodoList.tsx                   │
│ ✗ 跳过设计直接问"要不要用 TypeScript"然后开写           │
└─────────────────────────────────────────────────────┘

如果 Agent 直接开始写代码，说明元技能没注入成功。检查：

1. 插件是否在已安装列表里
2. 会话是不是新开的（老会话不会触发 startup 事件）
3. 平台版本是否足够新（Superpowers v5.1.0 要求各平台有 hook/扩展支持）

总结

六个平台安装方式各异，底层逻辑一致：把 using-superpowers 元技能塞进 Agent 会话上下文。Claude Code 走 SessionStart hook，Cursor 走自己的 hook 格式，OpenCode 走 JS 插件的 messages.transform，Codex 靠原生技能发现，Gemini CLI 靠 GEMINI.md 上下文文件。记住验证方法：新会话里给个设计类任务，Agent 先问需求不先写代码就算成功。

下一篇讲元技能本身——1% 规则怎么运作、指令优先级怎么排、Red Flag 表凭什么能拦住 Agent 偷懒。

参考资料

• obra/superpowers README — Installation — 官方安装文档（README.md:38-160）
• DeepWiki: Getting Started — 平台安装总览
• DeepWiki: Installing on Claude Code — Claude Code 详细流程
• DeepWiki: Installing on Cursor — Cursor 安装与排障
• DeepWiki: Installing on OpenCode — OpenCode 插件架构
• DeepWiki: Installing on Codex — Codex 原生发现机制
• DeepWiki: Installing on Gemini CLI — Gemini 扩展与工具映射