Superpowers 让 Claude Code 成为你的专家级助手

先说一个贴切的比喻：把 Claude Code 看作一位能力超群的助手，而 Superpowers 插件，就相当于为他配备了一套“专业工具箱”。

没有 Superpowers 时，Claude Code 采用的是通用对话模式，每次执行任务都需要临时根据情况自由发挥。安装插件后，它就能调用那些预先打磨好的“技能”——每一项技能都是经过精心设计的工作流，能够让 Claude 以更加周全、更具条理的方式来完成特定任务。

一、什么是 Superpowers 插件？

试想一下，Claude Code 是一位聪明的助理，而 Superpowers 插件就是为这位助理配置的一套“专业工具箱”。

未使用 Superpowers 时，Claude Code 以通用对话的形式工作，每次任务全凭临时判断。有了 Superpowers，它便可以调用预先设计好的技能（Skills）——这些技能是经过细致打磨的工作流程，能让 Claude 以更系统、更专业的手段完成特定任务。

Skills 是什么？

Skills 就像是一本“工作手册”。每个 skill 都包含：

• 明确的触发条件（何时使用）
• 具体的执行步骤（如何操作）
• 质量检查点（结果是否正确）

举个例子：

• 没有 skill：你说“帮我设计一个功能”，Claude 随机发挥
• 有 brainstorming skill：Claude 会先探索项目上下文，逐步提问，提出多个方案，最终输出一份完整的设计文档

与普通 Claude Code 的区别

二、安装与配置

前置条件

• 已安装 Claude Code CLI（运行 claude --version 确认）
• macOS / Linux / Windows（WSL）系统
• 网络连接正常

安装步骤

Superpowers 插件通过 Marketplace（市场）机制进行安装。整个过程分为两步：先添加市场源，再安装插件。

第一步：添加 Superpowers Marketplace

/plugin marketplace add obra/superpowers-marketplace

预期输出：

✓ Marketplace added successfully

第二步：安装 Superpowers 核心插件

/plugin install superpowers@superpowers-marketplace

预期输出：

✓ Installing superpowers@superpowers-marketplace...✓ Plugin installed successfully

第三步：验证安装

开启新对话（退出当前会话后重新运行 claude），然后输入：

/find-skills

或直接询问 Claude：“你有哪些可用的 skills？”

预期结果： 应该能看到类似以下的 skills 列表：

The following skills are a vailable:
- superpowers:brainstorming
- superpowers:systematic-debugging
- superpowers:test-driven-development
- superpowers:writing-plans
- superpowers:requesting-code-review
...

可选：安装其他插件

Superpowers Marketplace 还提供了其他实用插件：

Elements of Style — 写作指导工具

/plugin install elements-of-style@superpowers-marketplace

Superpowers: Developing for Claude Code — 插件开发资源

/plugin install superpowers-developing-for-claude-code@superpowers-marketplace

常见问题

Q：提示 “marketplace not found”？ 请确认第一步的 marketplace add 命令已成功执行，并检查网络连接是否正常

Q：不知道 Claude Code 是否已安装？ 运行 claude --version，有版本号输出则表示已安装；否则请参考 安装指南

Q：安装后开启新对话仍看不到 skills？

1. 确认插件已安装：运行 /plugin list 查看
2. 完全退出 Claude Code（Ctrl+C 或 /exit）
3. 重新运行 claude 开启新对话

Q：如何更新插件？ 重新运行安装命令即可覆盖更新：

/plugin install superpowers@superpowers-marketplace

Q：如何卸载插件？

/plugin uninstall superpowers

三、基础使用

如何查看可用的 Skills

开启新对话后，有两种方式可以查看：

方式一： 输入 /find-skills 命令，Claude 会列出所有可用的 skills

方式二： 直接询问 Claude：“你有哪些可用的 skills？”

如何调用 Skill

Skills 有两种触发方式：

方式一：自动触发（推荐）

直接描述你的任务，Claude 会自动判断是否需要调用 skill：

用户：帮我设计一个用户登录功能Claude：（自动调用 brainstorming skill，开始系统化设计流程）

方式二：明确指定

如果 Claude 没有自动触发，可以明确要求：

请使用 brainstorming skill 帮我设计这个功能

Skill 的执行流程

以 brainstorming skill 为例，执行流程如下：

1. 探索项目上下文（读取现有文件）↓2. 逐步提问（每次只问一个问题）↓3. 提出 2-3 个方案（含优缺点对比）↓4. 呈现设计（分段确认）↓5. 保存设计文档↓6. 移交实施计划

理解 Skill 的输出

当 skill 被触发时，你会看到：

Launching skill: superpowers:brainstorming

这意味着 Claude 正在加载并遵循该 skill 的工作流程。接下来 Claude 的每一步行动都是按照 skill 定义的流程执行的，而不是临时发挥。

四、实战案例

案例一：需求分析与设计（brainstorming skill）

场景： 你想开发一个简单的待办事项应用，但不知道从哪里开始。

没有 skill 的做法：

你：帮我做一个 Todo 应用Claude：好的，我来写代码...（直接开始写，可能完全不符合你的需求）

使用 brainstorming skill 的做法：

第一步： 直接描述你的想法

你：我想做一个待办事项应用

第二步： Claude 自动触发 brainstorming，开始逐步提问

Claude：这个 Todo 应用的目标用户是谁？- 个人使用- 团队协作- 两者都有

第三步： 逐步回答问题，Claude 提出多个方案

Claude：基于你的需求，我提出以下 3 个方案：方案 A：纯前端应用（推荐新手）- 优点：简单快速，无需后端，可立即上手- 缺点：数据仅存储在本地浏览器，不能跨设备同步- 技术栈：HTML + CSS + Ja vaScript（或 React/Vue）方案 B：前端 + 云存储服务- 优点：开发简单，支持跨设备同步，无需自建后端- 缺点：依赖第三方服务（如 Firebase、Supabase）- 技术栈：前端框架 + Firebase/Supabase方案 C：全栈应用- 优点：功能完整，数据完全自主可控，可扩展性强- 缺点：开发周期较长，需要后端和数据库知识- 技术栈：前端 + Node.js/Python + 数据库

第四步： 确认方案后，Claude 输出完整设计文档并保存到 docs/plans/ 目录

收获： 10 分钟内从模糊想法变成清晰的设计文档，避免了“写了一半发现方向错了”的问题。

案例二：系统化 Bug 调试（systematic-debugging skill）

场景： 你的代码报错了，但不知道从哪里开始排查。

示例 Bug：

public class ListUtils {public static String getFirstItem(List items) {return items.get(0); // 当 items 为空时会报错 }}​String result = ListUtils.getFirstItem(new ArrayList<>());// IndexOutOfBoundsException: Index 0 out of bounds for length 0

没有 skill 的做法：

你：这段代码报错了，帮我修Claude：改成 items.isEmpty() ? null : items.get(0)（直接给答案，你不知道为什么，下次遇到类似问题还是不会）

使用 systematic-debugging skill 的做法：

Claude 会引导你按步骤系统排查：

Step 1：重现问题→ 确认错误信息：IndexOutOfBoundsException: Index 0 out of bounds for length 0→ 确认触发条件：items 为空列表时​Step 2：定位根因→ items.get(0) 在空列表上访问索引 0→ 根因：没有对空列表做边界检查​Step 3：提出修复方案→ 方案 A：添加空列表检查（推荐）→ 方案 B：使用 try/catch 捕获异常→ 方案 C：修改调用方，确保不传空列表​Step 4：验证修复→ 编写测试用例覆盖空列表场景→ 运行测试确认通过

收获： 不只是修了这个 bug，而是学会了系统化排查问题的思路，下次遇到类似问题能独立解决。

案例三：测试驱动开发（test-driven-development skill）

场景： 你需要实现一个计算折扣价格的方法。

TDD 的核心理念： 先写测试，再写代码。

使用 TDD skill 的完整流程：

第一步： 告诉 Claude 你要实现什么

你：我需要实现一个 calculateDiscount 方法， 输入原价和折扣率，返回折扣后的价格

第二步： Claude 引导你先写测试（红灯阶段）

import org.junit.jupiter.api.Test;import static org.junit.jupiter.api.Assertions.*;​class DiscountCalculatorTest {private final DiscountCalculator calculator = new DiscountCalculator();​@Testvoid testCalculateDiscount() {assertEquals(80.0, calculator.calculateDiscount(100, 0.2));// 打八折assertEquals(100.0, calculator.calculateDiscount(100, 0));// 无折扣assertEquals(0.0, calculator.calculateDiscount(100, 1)); // 全免 }​@Testvoid testInvalidDiscount() {assertThrows(IllegalArgumentException.class, () -> calculator.calculateDiscount(100, -0.1)); // 折扣率不能为负 }}

第三步： 运行测试，确认失败（因为类还没实现）

mvn test# FAILED - cannot find symbol: class DiscountCalculator

第四步： 写最小实现让测试通过（绿灯阶段）

public class DiscountCalculator {public double calculateDiscount(double price, double discountRate) {if (discountRate < 0) {throw new IllegalArgumentException("折扣率不能为负数"); }return price * (1 - discountRate); }}

第五步： 再次运行测试，确认通过

mvn test# Tests run: 2, Failures: 0, Errors: 0, Skipped: 0 ✓

收获： 代码有测试保护，以后修改时不用担心破坏已有功能。

五、总结与进阶

核心要点回顾

1. Superpowers = 给 Claude 配备专业工具箱，让它按最佳实践工作

2. Skills 是工作流程，不是魔法，它们让 Claude 更系统、更可预期

3. 自动触发为主，描述任务即可，Claude 会判断是否需要 skill

4. 三个最常用的 skills：

   • brainstorming：需求分析和功能设计
   • systematic-debugging：系统化 Bug 排查
   • test-driven-development：测试驱动开发

更多可用的 Skills

三周上手计划

第一周： 在日常开发中尝试使用 brainstorming 和 systematic-debugging

第二周： 尝试 TDD 工作流，养成测试先行的习惯

第三周： 探索 skill-creator，创建适合你团队的自定义 skill

继续探索

• 查看所有可用 skills：在 Claude Code 中输入 /find-skills
• 查看 skill 详情：直接问 Claude “brainstorming skill 是怎么工作的？”
• 创建自定义 skill：使用 skill-creator skill