Superpowers 是一个完整的软件开发工作流工具包，为 Cursor 提供可组合的”技能”，指导 AI 代理完成头脑风暴、规划、测试驱动开发、调试、代码审查等任务。本文将介绍如何在 Cursor 中安装和使用 Superpowers。

官方仓库： Superpowers GitHub - 推荐通过 Cursor 插件市场安装（最简单）

什么是 Superpowers？

Superpowers 是一个为 Cursor 设计的软件开发工作流系统，它提供了一系列可组合的”技能”（skills），帮助 AI 代理更高效地完成各种开发任务。这些技能包括：

  • 头脑风暴 - 交互式设计改进
  • 测试驱动开发 - RED-GREEN-REFACTOR 循环
  • 系统化调试 - 4 阶段根本原因分析流程
  • 编写和执行计划 - 结构化任务规划
  • 子代理驱动开发 - 并行处理多个任务
  • Git Worktrees - 并行开发支持
  • 代码审查工作流 - 自动化代码审查流程
  • 自定义技能创建 - 创建自己的工作流

安装方法

参考资源： Superpowers GitHub 仓库

方法一：Cursor 插件市场安装（推荐）⭐

这是最简单、最推荐的安装方式。Superpowers 已集成到 Cursor 的插件市场中，可以直接安装。

安装步骤：

  1. 在 Cursor 中打开 Agent 聊天窗口（Cmd+I 或 Ctrl+I）
  2. 输入以下命令：
/plugin-add superpowers
  1. 等待安装完成

验证安装：

安装完成后，开始一个新会话，询问一个应该触发技能的问题（例如：”help me plan this feature” 或 “let’s debug this issue”）。代理应该自动调用相关的 superpowers 技能。

更新插件：

当有新版本时，使用以下命令更新：

/plugin update superpowers

方法二：Git 克隆（手动安装）

适合需要完全控制安装过程或想要自定义配置的用户。

步骤 1：创建技能目录并克隆仓库

mkdir -p ~/.cursor/skills
git clone https://github.com/obra/superpowers.git ~/.cursor/skills/superpowers

步骤 2：创建引导规则

创建文件 ~/.cursor/rules/superpowers-bootstrap.mdc，内容如下：

# Superpowers Bootstrap

When responding to tasks, check if any Superpowers skill applies, even with just a 1% probability.

Available skills are located in ~/.cursor/skills/superpowers/

Before responding, read relevant skill files to understand available workflows.

步骤 3：验证安装

重启 Cursor，然后在聊天中询问：

@superpowers 有哪些可用的技能？

更新方法：

cd ~/.cursor/skills/superpowers
git pull origin main

使用方法

基本使用

安装完成后，Superpowers 的技能会在 Cursor 的上下文中自动可用。使用 @ 符号引用技能：

@superpowers 帮我进行代码审查

或者直接描述任务，Cursor 会自动识别并使用相应的技能：

使用测试驱动开发的方式实现一个用户认证功能

核心技能详解

1. 头脑风暴（Brainstorming）

用于交互式设计改进和功能规划：

@superpowers 使用头脑风暴技能，帮我设计一个用户管理系统

2. 测试驱动开发（TDD）

遵循 RED-GREEN-REFACTOR 循环：

@superpowers 使用 TDD 方式实现一个计算器类

工作流程： 1. RED - 先写失败的测试 2. GREEN - 写最少的代码让测试通过 3. REFACTOR - 重构代码，保持测试通过

3. 系统化调试（Systematic Debugging）

4 阶段根本原因分析：

@superpowers 使用系统化调试方法，帮我找出这个 bug 的根本原因

四个阶段： 1. 重现问题 - 确认 bug 可以稳定重现 2. 缩小范围 - 定位问题发生的具体位置 3. 根本原因分析 - 找出为什么会出现这个问题 4. 验证修复 - 确保修复有效且没有引入新问题

4. 编写和执行计划

结构化任务规划：

@superpowers 创建一个重构计划，将单体应用拆分为微服务

5. 代码审查工作流

自动化代码审查：

@superpowers 审查这个 PR 的代码质量

6. Git Worktrees

并行开发支持：

@superpowers 使用 git worktree 创建一个新分支来处理新功能

高级配置

自定义技能

你可以创建自己的技能文件，放在 ~/.cursor/skills/ 目录下。技能文件使用 Markdown 格式，描述工作流程和最佳实践。

示例：创建自定义技能

创建 ~/.cursor/skills/my-custom-skill/SKILL.md：

# 我的自定义技能

## 何时使用
当需要处理 [特定场景] 时使用此技能。

## 工作流程
1. 第一步
2. 第二步
3. 第三步

## 注意事项
- 注意点 1
- 注意点 2

与 Cursor 功能集成

Superpowers 可以与 Cursor 的核心功能完美集成：

Tab 补全： - Superpowers 会增强代码补全建议，提供更符合最佳实践的代码

内联编辑（Cmd+K）： - 使用 Superpowers 技能时，内联编辑会自动应用相应的工作流

代理模式（Cmd+I）： - 代理模式会自动使用 Superpowers 技能来处理复杂任务

后台代理： - 长时间运行的任务可以使用 Superpowers 的计划和执行技能

最佳实践

1. 明确指定技能

虽然 Superpowers 会自动识别适用的技能，但明确指定可以获得更好的结果：

使用 @superpowers 的 TDD 技能实现用户认证功能

2. 组合使用多个技能

复杂任务可以组合使用多个技能：

使用 @superpowers 的头脑风暴技能设计架构，然后用 TDD 技能实现

3. 定期更新

Superpowers 会持续更新，建议定期拉取最新版本：

cd ~/.cursor/skills/superpowers
git pull origin main

4. 查看可用技能

随时可以查看所有可用的技能：

@superpowers 列出所有可用的技能

或者直接查看技能目录：

ls ~/.cursor/skills/superpowers/

常见问题

Q: 安装后无法使用技能？

A: 检查以下几点： 1. 确保技能目录存在：~/.cursor/skills/superpowers/ 2. 重启 Cursor 3. 检查 MCP 配置是否正确（如果使用 MCP 方式） 4. 查看 Cursor 的日志文件排查错误

Q: 如何更新 Superpowers？

A: 如果使用 Git 安装：

cd ~/.cursor/skills/superpowers
git pull origin main

如果使用 MCP 安装，重新运行安装命令即可。

Q: 可以同时使用多个技能集合吗？

A: 可以。Superpowers 只是众多技能集合之一，你可以安装多个技能集合，Cursor 会自动识别并使用最合适的技能。

Q: 技能会影响性能吗？

A: Superpowers 的技能是轻量级的，主要通过指导 AI 代理的工作流程来工作，不会显著影响性能。但如果安装了多个大型技能集合，可能会增加上下文使用量。

实际应用示例

示例 1：使用 TDD 开发 API 端点

@superpowers 使用测试驱动开发的方式，创建一个用户注册的 REST API 端点

要求：
- 使用 Express.js
- 包含输入验证
- 密码加密
- 返回适当的 HTTP 状态码

Superpowers 会引导你： 1. 先写测试用例 2. 运行测试（应该失败） 3. 实现最小功能让测试通过 4. 重构代码

示例 2：系统化调试生产环境问题

@superpowers 使用系统化调试方法，分析这个生产环境的错误：

错误信息：[粘贴错误日志]
环境：Node.js 18, Express 4.x

Superpowers 会引导你： 1. 重现问题 2. 缩小问题范围 3. 分析根本原因 4. 验证修复方案

示例 3：代码审查工作流

@superpowers 审查这个 PR：
https://github.com/user/repo/pull/123

重点关注：
- 代码质量
- 性能问题
- 安全性
- 测试覆盖率

总结

Superpowers 为 Cursor 提供了强大的工作流工具包，通过结构化的技能指导 AI 代理完成各种开发任务。无论是测试驱动开发、系统化调试，还是代码审查，Superpowers 都能帮助你更高效、更规范地完成工作。

关键要点： 1. 选择适合的安装方式 2. 明确指定技能以获得更好结果 3. 组合使用多个技能处理复杂任务 4. 定期更新以获取最新功能 5. 创建自定义技能以适应特定需求

相关资源： - Superpowers GitHub 仓库：https://github.com/obra/superpowers/tree/main - Superpowers 市场：https://github.com/obra/superpowers-marketplace - Cursor 官方文档：https://docs.cursor.com - MCP 文档：https://modelcontextprotocol.io

注意：Superpowers 是一个活跃开发的项目，功能和 API 可能会随时间变化。建议关注项目更新日志以了解最新变化。