[!info] related notes

• 所属 MOC: Coding Agent MOC
• 相关资源: Superpowers, Claude Code, copilot使用工作流

Superpowers 安装和使用

目标

在主流 coding agent 平台上安装 Superpowers，验证其正常工作，并配置与项目规则文件的共存。

前置条件

• 一个支持的 coding agent 平台（Claude Code、Codex CLI、Gemini CLI、OpenCode、Cursor、Copilot CLI 等）
• 如果使用多个平台，每个平台需分别安装

安装步骤

Claude Code

方式一：从 Anthropic 官方 marketplace 安装

/plugin install superpowers@claude-plugins-official

方式二：添加 Superpowers marketplace 后安装（详见官方 README）

Codex CLI

在 /plugins 中搜索 superpowers 并安装（通过官方 Codex plugin marketplace）

Gemini CLI

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

更新：

gemini extensions update superpowers

OpenCode

在 opencode.json 的 plugin 数组中添加：

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

然后重启 OpenCode。

Cursor

在 Cursor Agent chat 中：

/add-plugin superpowers

或在插件市场搜索 superpowers。

GitHub Copilot CLI

通过 Copilot CLI 插件市场安装（详见官方 README）

验证

基础验证

向 Agent 发送：

Tell me about your superpowers

如果安装成功，Agent 会描述已加载的 skills。

完整验证（推荐）

向 Agent 发送：

Let's make a react todo list

如果 Superpowers 正常工作，Agent 会在写任何代码之前自动触发 brainstorming skill，开始问澄清问题。如果 Agent 直接开始写代码，说明 skills 只是”躺在磁盘上的死文件”。

与项目规则文件共存

Superpowers 可以和项目的 CLAUDE.md、AGENTS.md、Cursor Rules 等共存。

优先级规则

用户明确指令 > Superpowers skills > 默认系统提示

如果项目规则明确说”不用 TDD”，项目规则优先。但如果没有明确跳过，Superpowers 的默认流程会生效。

推荐配置方式

在项目的 CLAUDE.md 或 AGENTS.md 中：

- 本项目使用 pnpm
- 测试命令是 pnpm test
- 不要引入新依赖
- API 变更必须更新 OpenAPI schema
- Superpowers 流程保持启用

这样 Superpowers 负责”怎么做事”，项目规则负责”本项目的约束”。

常见问题

Agent 没有自动触发 brainstorming

• 检查 skills 是否正确安装到平台的 skill 目录
• 确认平台支持 skill 发现机制
• 尝试明确说”使用 brainstorming skill”来测试手动触发

多平台需要重复安装

这是设计如此。每个 harness 需要单独安装 Superpowers，因为不同平台的 skill 加载机制不同。

Related notes

• Superpowers
• Claude Code
• copilot使用工作流