Superpowers是一个革命性的AI编程助手工具，它通过结构化的技能框架和工作流管理，将Claude Code、Cursor或OpenCode等AI编码代理从"只懂打字"的工具提升为"真正的开发伙伴"。该项目由Anthropic公司开发，目前在GitHub上已获得超过5000颗星，日均增长约200颗，显示出其在AI编程领域的巨大影响力和实用性。与传统AI编码工具直接生成代码不同，Superpowers强制AI遵循系统化的软件工程方法，从需求分析、设计确认、任务拆解到代码实现和审查，形成一个完整的开发闭环，极大提高了代码质量和开发效率。

一、项目核心概念与价值

Superpowers本质上是一个"AI编程工作流强制执行框架"，它解决了AI编码工具最常被诟病的问题：AI倾向于直接生成代码而忽略需求分析、设计验证和测试等关键步骤，导致生成的代码质量参差不齐，难以直接投入使用。

1. 项目架构与设计理念

Superpowers采用三层架构设计，确保其跨平台兼容性和可扩展性：

• 共享核心模块：提供基础功能和技能注册系统，确保各平台间功能一致性
• 平台适配层：针对Claude Code、Cursor、OpenCode等不同AI编码环境进行适配
• 可插拔技能层：提供丰富的开发技能，用户可根据需要选择加载

这种架构设计使Superpowers能够：

• 在多种AI编码环境中无缝运行
• 提供可定制的开发流程，适应不同用户需求
• 通过技能扩展机制不断添加新功能

2. 核心功能与优势

Superpowers提供了14+种开发技能，覆盖软件开发生命周期的各个阶段：

技能名称	触发时机	核心价值
brainstorming	开发者提出需求后	5分钟内将模糊需求拆解为可执行的原子任务，形成设计文档
writing-plans	设计确认后	生成带时间估算的Markdown实施计划，拆解为2-5分钟可完成的微任务
executing-plans	计划确认后	按计划推进开发，跟踪进度，确保每个节点完成
test-driven-development	编码阶段	强制执行TDD（测试驱动开发），先写测试用例再实现功能
systematic-debugging	Bug修复时	提供4阶段根本原因分析流程，系统化排查问题
requesting-code-review	任务完成后	触发自动化代码审查，按严重程度标记问题
receiving-code-review	代码审查后	帮助代理有效响应审查反馈，形成闭环
finishing-a-development-branch	所有任务完成后	确保分支开发完成，清理工作树，准备合并主分支
writing-skills	自定义技能时	允许用户创建符合最佳实践的自定义技能

数据来源：

与传统AI编码工具相比，Superpowers的主要优势在于：

• 结构化开发流程：强制AI遵循系统化的开发方法，如TDD、YAGNI、DRY等原则
• 高质量代码输出：通过测试先行和代码审查，确保生成的代码具备可测试性和可维护性
• 跨会话状态保持：通过钩子机制实现上下文记忆，支持长周期复杂任务的连续开发
• 子代理驱动开发：能够将大型任务拆分并分配给多个子代理并行处理
• 轻量无依赖：核心脚本零外部依赖，安装配置过程最快2分钟完成

二、系统要求与依赖项

在安装Superpowers之前，请确保您的系统满足以下基本要求：

1. 硬件要求

• 操作系统：Windows 10+/11、macOS 12+、Linux主流发行版（Ubuntu/Debian/CentOS等）
• 内存：最低4GB（推荐8GB以上，大型项目或团队协作建议16GB+）
• 存储空间：项目本身仅需约200MB空间，但开发环境可能需要更多
• 网络连接：稳定网络用于插件安装和模型调用

2. 软件依赖

Superpowers本身不需要额外的软件依赖，但它需要以下AI编码平台作为运行环境：

• Claude Code CLI：官方推荐环境，提供最完整的功能支持
• Cursor：AI增强的代码编辑器，提供图形界面操作体验
• OpenCode：开源的AI编程助手，支持本地模型运行

注意：Claude Code官方服务目前对中国大陆用户有限制，建议使用镜像站安装。Cursor和OpenCode则无此限制。

三、分平台安装指南

以下是针对Claude Code CLI、Cursor和OpenCode三大主流平台的详细安装步骤：

1. Claude Code CLI 安装

Claude Code CLI是官方推荐的安装环境，提供最完整的Superpowers功能支持：

步骤1：安装Claude Code CLI

# macOS/Linux 用户
curl -fsSL https://myclaudecode.com/scripts/env-install.sh | bash

# Windows 用户需在WSL中执行（原生Windows支持有限）
wsl curl -fsSL https://myclaudecode.com/scripts/env-install.sh | bash

步骤2：验证Claude Code安装

Claude --version

如果显示版本号（如v3.2.1），则表示安装成功。

步骤3：注册Superpowers插件市场

# 启动Claude Code会话
Claude

# 在会话中输入以下命令注册市场源（只需执行一次）
/plugin marketplace addhttps://obra/superpowers-marketplace

# 确认市场源已添加
/help

成功后，会看到"superpowers-marketplace"出现在市场列表中。

步骤4：安装Superpowers插件

# 在Claude Code会话中输入
/plugin install superpowers@superpowers-marketplace

# 或如果已集成到官方市场
/plugin install superpowers

步骤5：重启Claude Code并验证

# 退出当前会话（输入 exit 或按 Ctrl+D）
# 重新启动Claude Code
Claude

# 验证插件是否安装成功
/help

如果看到新增的命令（如/superpowers:brainstorm、/superpowers:write-plan等），则表示安装成功。

2. Cursor 安装

Cursor是一款AI增强的代码编辑器，提供图形界面操作体验：

步骤1：安装Cursor

• 访问官网 https://cursor.sh/ 下载安装包
• 双击安装包并按照提示完成安装

步骤2：安装Superpowers插件

# 打开Cursor，进入Agent聊天窗口（快捷键：Cmd+I 或 Ctrl+I）
# 输入以下命令
/plugin-add superpowers

步骤3：验证安装

• 安装完成后，开始一个新会话
• 提问一个应触发技能的问题，如"help me plan this feature"
• 如果代理自动调用相关的superpowers技能，则表示安装成功

替代方案：手动安装

如果插件市场无法找到Superpowers，可以尝试手动安装：

# 创建技能目录并克隆仓库
mkdir -p ~/.cursor/skills
git clone https://github.com/obra/superpowers.git ~/.cursor/skills/superpowers

# 创建引导规则文件
cat > ~/.cursor/rules/superpowers-bootstrap.mdc << EOF
# Superpowers Bootstrap
When responding to
- "plan"
- "design"
- "develop"
  execute
    /superpowers:brainstorm
    /superpowers:write-plan
    /superpowers:execute-plan
EOF

步骤4：重启Cursor

• 重启Cursor编辑器
• 在项目根目录创建.cursorrules文件，写入：

# 启用Superpowers技能
Use Superpowers for all development work. Load at session start.

3. OpenCode 安装

OpenCode是一款开源的AI编程助手，支持本地模型运行：

步骤1：安装OpenCode

# macOS/Linux 用户
curl -fsSL https://opencode.ai/install | bash

# Windows 用户需在PowerShell中以管理员身份运行
iwr -useb https://opencode.ai/install | bash

步骤2：配置OpenCode

• 确保OpenCode已正确配置API密钥（如OpenRouter或本地模型）
• 选择合适的AI模型（推荐Claude-3.5或GPT-5.2）

步骤3：安装Superpowers插件

# 方式1：通过插件市场一键安装
/plugin install superpowers

# 方式2：手动安装（适用于插件市场不可用的情况）
git clone https://github.com/obra/superpowers.git ~/.config/opencode/superpowers

# 创建插件符号链接
mkdir -p ~/.config/opencode/plugins
ln -sf ~/.config/opencode/superpowers/.opencode/plugins/superpowers.js ~/.config/opencode/plugins/

# 创建技能符号链接
mkdir -p ~/.config/opencode/skills
ln -sf ~/.config/opencode/superpowers/skills ~/.config/opencode/skills/superpowers

步骤4：重启OpenCode

• 重启OpenCode编辑器
• 在项目根目录创建.opencode.md文件，写入：

# 使用Superpowers进行所有开发工作
Load Superpowers at session start.

四、Superpowers核心指令与使用方法

Superpowers通过一系列精心设计的指令引导AI完成结构化开发流程。以下是主要指令及其使用方法：

1. 基础指令

需求分析与设计阶段：

# 头脑风暴：帮助AI理解需求并生成设计文档
/superpowers:brainstorm

# 示例：规划用户登录接口
/superpowers:brainstorm 规划用户登录接口，支持邮箱和手机号注册

任务拆解与计划阶段：

# 编写实施计划：将大型任务拆解为可执行的微任务
/superpowers:write-plan

# 示例：为支付系统API重构生成计划
/superpowers:write-plan 重构支付系统API，包括订单管理和支付网关集成

开发执行阶段：

# 执行实施计划：按计划分步执行开发任务
/superpowers:execute-plan

# 示例：开始执行支付系统API重构计划
/superpowers:execute-plan 开始重构支付系统API

代码审查与验证阶段：

# 请求代码审查：对生成的代码进行质量检查
/superpowers请求代码审查

# 示例：审查用户登录接口代码
/superpowers请求代码审查 审查用户登录接口代码，重点关注安全性和错误处理

分支管理阶段：

# 完成开发分支：确保分支开发完成，准备合并
/superpowers:finish-branch

# 示例：完成支付系统API重构分支
/superpowers:finish-branch 完成支付系统API重构分支

2. 高级技能指令

系统化调试：

# 调试命令：帮助AI系统化地定位和解决Bug
/superpowers系统的调试命令

# 示例：用户登录接口报错"验证码无效"
/superpowers系统的调试命令 问题：用户登录接口报错"验证码无效"，但验证码正确且在有效期内

测试驱动开发：

# 测试驱动开发：先写测试用例再实现功能
/superpowers系统的测试驱动开发命令

# 示例：开发用户登录接口的验证码校验逻辑
/superpowers系统的测试驱动开发命令 开发用户登录接口的验证码校验逻辑，校验规则：6位数字、有效期5分钟

Git工作树管理：

# 使用Git工作树：隔离多个开发分支，避免污染主分支
/superpowers系统的Git工作树命令

# 示例：创建新分支开发支付系统API重构
/superpowers系统的Git工作树命令 创建新分支开发支付系统API重构

3. 指令使用技巧

• 按需加载：对于简单任务，可直接使用AI编码功能；对于复杂任务，再加载Superpowers技能
• 上下文管理：大型项目中，建议在会话开始时使用/superpowers:brainstorm确保AI理解完整上下文
• 技能优先级：当多个技能可能适用时，遵循"过程技能优先（brainstorming，debugging）→ 实现技能第二（frontend-design，mcp-builder）"的加载顺序
• 技能冲突处理：注意避免同时加载冲突技能（如brainstorming与executing-plans），Superpowers会自动检测并提示
• 自定义技能：可通过/superpowers系统的技能编写命令创建符合团队规范的自定义技能

五、实际应用场景与案例

1. 从需求到部署的全流程开发

案例：企业级支付系统API重构

1. 需求分析阶段：

   /superpowers:brainstorm
   重构支付系统API，支持多种支付方式，提高安全性，优化性能
   

2. 设计确认阶段：

   /superpowers:write-plan
   支付系统API重构，包括订单管理、支付网关集成、支付状态轮询等模块
   

3. 任务拆解阶段：

   /superpowers:execute-plan
   开始重构支付系统API，先从订单管理模块开始
   

4. 开发执行阶段：

   # AI会自动按计划推进，先创建新分支
   /superpowers系统的Git工作树命令
   
   # 然后开始编写单元测试
   /superpowers系统的测试驱动开发命令
   
   # 实现功能并确保测试通过
   /superpowers系统的测试驱动开发命令
   

5. 代码审查阶段：

   /superpowers请求代码审查
   审查订单管理模块代码，重点关注并发控制和异常处理
   

6. 分支收尾阶段：

   /superpowers:finish-branch
   完成支付系统API重构分支，准备合并到主分支
   

2. 系统化调试与Bug修复

案例：用户登录接口验证码验证问题

1. 触发调试技能：

   /superpowers系统的调试命令
   问题：用户登录接口报错"验证码无效"，但验证码正确且在有效期内
   

2. AI执行调试流程：

   • 定位问题：分析报错信息，复现问题场景
   • 排查原因：逐一检查可能的诱因，如缓存问题、时区差异等
   • 修复代码：给出最小化修复方案
   • 验证测试：确保修复方案有效且不影响其他功能

3. 修复后审查：

   /superpowers请求代码审查
   审查用户登录接口验证码验证修复代码
   

3. 团队协作与知识共享

Superpowers支持团队协作开发，通过以下方式提升团队效率：

1. 共享规范：

   • 在项目根目录创建.superpowers.md文件，定义团队特定的编码规范和流程
   • 所有团队成员使用相同规范，确保开发一致性

2. 协作开发：

   /superpowers系统的子代理驱动开发命令
   分配支付系统API重构任务给团队成员
   

3. 版本控制：

   • 所有技能操作均通过Git记录，确保开发历史可追溯
   • 分支管理技能自动创建、清理工作树，避免分支混乱

六、常见问题与解决方案

在使用Superpowers过程中，可能会遇到以下常见问题：

1. 安装失败问题

问题：Claude Code CLI安装失败

解决方案：

• Windows用户：必须使用WSL 2环境安装
• macOS/Linux用户：检查curl命令权限，尝试使用curl -fsSL https://myClaudeCode.com/scripts/env-install.sh | sudo bash
• 网络问题：使用镜像站安装（curl -fsSL https://myClaudeCode.com/scripts/env-install.sh | bash）

2. 指令不生效问题

问题：安装后指令/superpowers:brainstorm不生效

解决方案：

• 重启AI编码环境：Claude Code、Cursor或OpenCode都需要重启才能加载新插件
• 检查技能加载：在Cursor或OpenCode中，确保项目根目录有.cursorrules或.opencode.md文件
• 验证插件版本：执行/plugin update superpowers更新到最新版本

3. 上下文丢失问题

问题：长会话后上下文丢失，AI不再遵循Superpowers流程

解决方案：

• 启用上下文管理：在Claude Code中使用/compact压缩会话历史
• 使用结构化文件：将关键设计文档保存为Markdown文件，并在会话中使用/add-dir添加到上下文中
• 按需加载技能：对于长时间项目，可在适当时候重新加载/superpowers系统的技能使用命令

七、进阶技巧与最佳实践

1. 技能自定义与扩展

Superpowers允许用户创建自定义技能，以适应特定团队或项目的开发规范：

1. 创建自定义技能目录：

   mkdir -p ~/.cursor/skills/custom
   

2. 定义技能配置：

   {
     "id": "custom:security审查",
     "name": "安全审查",
     "description": "对生成的代码进行安全漏洞扫描",
     "triggers": ["审查", "安全", "漏洞扫描"],
     "implementation": "使用技能工具加载 superpowers系统的安全审查技能"
   }
   

3. 在会话中使用自定义技能：

   /superpowers系统的技能使用命令
   

2. 与CI/CD工具集成

将Superpowers生成的代码与CI/CD流程集成，可进一步提升开发效率：

1. 自动化测试：

   • Superpowers的TDD技能会生成完整的测试套件
   • 在CI流程中直接运行这些测试，确保代码质量

2. 代码审查：

   • 将Superpowers的代码审查结果作为CI的前置条件
   • 确保只有通过审查的代码才能进入测试环境

3. 部署管理：

   • 使用Superpowers的/superpowers:finish-branch技能生成部署清单
   • 在CI/CD流程中执行这些清单，确保部署一致性

3. 性能优化与效率提升

优化本地模型性能：

# 在OpenCode中配置本地vLLM模型
docker run -d --gpus all --shm-size="1g" \
-p 8000:8000 \
-e MODEL="Qwen/Qwen3-4B-Instruct" \
vllm/vllm-openai:latest \
--host 0.0.0.0 \
--port 8000 \
--dtype auto \
--max-model-len 32768

减少token消耗：

• 使用/compact压缩会话历史，释放token空间
• 对于大型项目，使用/superpowers:brainstorm生成设计文档后，可使用/clear清除会话上下文
• 通过/superpowers系统的技能使用命令按需加载技能，避免不必要的token消耗

八、建议

Superpowers代表了AI编程工具的下一代发展方向——从简单的代码生成工具转变为遵循系统化工程方法的开发伙伴。通过强制执行需求分析、设计确认、测试先行和代码审查等流程，它显著提升了AI生成代码的质量和可维护性。

对于初学者的建议：

• 从简单项目开始体验，如开发一个待办事项应用
• 先使用核心指令（brainstorm、write-plan、execute-plan）熟悉基本流程
• 逐步尝试高级技能（debugging、code-review、TDD）

对于资深开发者的建议：

• 充分利用子代理驱动开发技能，实现复杂任务的并行处理
• 创建自定义技能，将团队最佳实践编码化
• 将Superpowers与现有CI/CD工具集成，实现端到端自动化开发

Superpowers的核心价值在于**：它不是替代开发者思考的工具，而是帮助开发者更系统、更高效地组织和引导AI的开发伙伴。通过遵循其结构化的开发流程，您可以充分利用AI的编码能力，同时保持对开发质量的控制，实现开发效率与代码质量的双赢。