古法编程

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 CLI 插件搜索界面 /plugins → 搜索 → Install Plugin
Codex App 侧边栏 Plugins Coding 分类 → Superpowers → +
OpenCode 修改 opencode.json 加一行 plugin 配置
GitHub Copilot CLI 插件市场命令 两行 copilot plugin 命令
Gemini CLI 扩展命令 gemini extensions install

Claude Code 安装

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

直接从 Claude 官方市场安装，最简单：

/plugin install superpowers@claude-plugins-official

方式二：第三方市场

如果官方市场不可用，先注册第三方市场，再安装：

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

更新 

/plugin update superpowers

技能会随插件自动更新，无需额外操作。

Cursor 安装

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

/add-plugin superpowers

也可以直接在插件市场搜索「superpowers」找到并安装。

Codex 安装

OpenAI Codex 提供两种安装方式：CLI 版本和 App 版本。

Codex CLI 安装

打开插件搜索界面：

/plugins

搜索 Superpowers：

superpowers

选择 Install Plugin 完成安装。

Codex App 安装

  1. 在 Codex App 中，点击侧边栏的 Plugins
  2. 在 Coding 分类中找到 Superpowers
  3. 点击旁边的 + 按钮，按提示完成安装

启用多智能体功能（可选）

部分技能（如 dispatching-parallel-agents、subagent-driven-development）依赖 Codex 的多智能体特性，需在 Codex 配置文件中启用：

[features]
multi_agent = true

OpenCode 安装

OpenCode 通过修改配置文件安装插件，找到你的 opencode.json（全局或项目级别均可），加入以下内容：

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

重启 OpenCode 后，插件通过 Bun 自动安装，所有技能立即可用。

如果你之前用旧版符号链接方式安装过，需先清理旧文件：

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

然后按上述方式重新安装。

版本锁定

如需固定到特定版本，在 URL 后加分支名或标签：

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

GitHub Copilot CLI 安装 

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

Gemini CLI 安装 

# 安装
gemini extensions install https://github.com/obra/superpowers

# 更新
gemini extensions update superpowers

安装后下一步

安装成功只是第一步。建议按这个顺序继续：

下一步 为什么要做 去哪里看
开新会话验证技能是否加载 旧会话通常不会重新加载刚安装的插件 验证安装是否成功
了解 Superpowers 在做什么 避免把它当成普通提示词包，实际它会改变智能体工作流 Superpowers 总览
Windows 用户检查路径和符号链接 Codex、Claude Code、Hook 在 Windows 上更容易遇到路径问题 Windows 设置
学会更新和回滚 插件更新后若缺技能或命令，要知道如何恢复 常见问题排查
遇到报错先看问题库 已收录 Windows、Codex、Hook、重复输出等典型问题 Superpowers 问题库
想在 Codex、Cursor、OpenCode、Hermes 里用 不同工具加载机制不同，不能照搬 Claude Code 命令 不同工具安装后看哪里

验证安装是否成功

安装完成后，开启一个新会话，然后用以下任意一句话触发技能：

  • “帮我规划这个功能”
  • “我们来调试这个问题”
  • “tell me about your superpowers”（OpenCode 专用验证语句）

如果智能体自动调用了对应技能（比如启动 brainstorming 或 writing-plans 流程），说明安装成功。

平台专属验证方式

平台 验证命令 / 方法
Codex CLI/App 开启新会话，说一句「帮我规划这个功能」，确认技能自动触发
OpenCode 在对话中输入 use skill tool to list skills，确认技能列表出现
OpenCode 查看日志：opencode run --print-logs "hello" 2>&1 | grep -i superpowers

常见问题排查

技能没有自动触发

  • 确认安装后开启了新会话（旧会话不会加载新插件）
  • Claude Code 用户确认插件是否仍处于启用状态，必要时运行 /plugin update superpowers
  • Cursor / OpenCode 用户确认是在新的 Agent 会话里验证，而不是旧聊天窗口
  • Codex CLI/App 用户确认插件安装成功后重启了 Codex
  • Hermes 用户确认 skill 已安装到 ~/.hermes/skills/ 并启用，详见 Hermes Skills 系统

更新后找不到 Skills 或 Commands

这类问题通常发生在插件升级、路径迁移或 Windows 用户目录包含空格时。先重启当前工具，再重新执行安装验证。如果仍然缺失，优先看这两篇问题记录：

Codex 输出重复文本

Codex 安装 Superpowers 后如果出现重复输出，先确认是否同时加载了多份技能目录，再参考Codex + Superpowers 重复输出排查。

OpenCode 插件未加载

  1. 检查 opencode.json 中 plugin 字段语法是否正确
  2. 确认运行的是较新版本的 OpenCode
  3. 查看插件加载日志确认是否有报错

卸载说明

Claude Code：

/plugin uninstall superpowers

OpenCode： 从 opencode.json 的 plugin 数组中删除对应行，重启生效。

不同工具安装后看哪里

工具 安装后最该确认的事 推荐下一页
Claude Code 插件是否启用、Skills 是否能自动触发 Superpowers 总览
Cursor /add-plugin 后是否在新 Agent 会话中生效 技能写作与使用
Codex 开启新会话触发技能，确认插件已激活 Codex 重复输出排查 / Codex AGENTS.md
OpenCode opencode.json 的 plugin 配置是否被加载 验证安装是否成功
Hermes ~/.hermes/skills/ 中是否能看到对应 Skill Hermes Skills 系统
Gemini CLI extension 是否安装并更新到当前版本 Gemini CLI 文档入口

FAQ

Q: Claude Code 和 Cursor 哪个安装更简单？ A: 两个都很简单，一行命令搞定。相比之下，Codex 的手动配置步骤更多，Windows 用户还要额外处理目录联接的问题。

Q: OpenCode 每次启动都会重新安装插件吗，会不会很慢？ A: 是的，OpenCode 在每次启动时从 git 仓库重新安装插件。好处是始终保持最新版本；如果对启动速度有要求，可以通过锁定版本标签（#v5.0.3）来跳过网络拉取。

Q: 安装后需要手动学习所有技能吗？ A: 不需要。Superpowers 的设计原则是技能自动触发——智能体根据你在做的任务类型自动选择对应技能。你只需要正常和它对话，它会在合适的时机介入。

Q: 多个平台可以同时安装吗？ A: 可以。每个平台的安装是相互独立的，不会互相干扰。技能文件本身是同一份，只是加载机制因平台而异。