Claude Code Superpowers 插件基础教程

Superpowers 插件基础教程

阅读时间：约 15-20 分钟 | 难度：新手友好

一、什么是 Superpowers 插件？

想象一下，Claude Code 是一位聪明的助手，而 superpowers 插件就是给这位助手配备了一套"专业工具箱"。

没有 superpowers 时，Claude Code 以通用对话模式工作，每次任务都靠临时判断。有了 superpowers，它可以调用预先设计好的技能（Skills） ------这些技能是经过精心设计的工作流程，能让 Claude 以更系统、更专业的方式完成特定任务。

Skills 是什么？

Skills 就像是"工作手册"。每个 skill 都包含：

• 明确的触发条件（什么时候用）
• 具体的执行步骤（怎么做）
• 质量检查点（做得对不对）

举个例子：

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

与普通 Claude Code 的区别

对比项	普通 Claude Code	使用 Superpowers
工作方式	灵活通用对话	遵循最佳实践流程
输出质量	因对话而异	稳定、可预期
适合场景	简单问答	复杂开发任务
学习成本	低	略高，但值得

二、安装与配置

前置条件

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

安装步骤

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

第一步：添加 Superpowers Marketplace

/plugin marketplace add obra/superpowers-marketplace

预期输出：

✓ Marketplace added successfully

提示： 这一步是将 superpowers 插件市场添加到 Claude Code，类似于添加软件源。

第二步：安装 Superpowers 核心插件

/plugin install superpowers@superpowers-marketplace

预期输出：

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

第三步：验证安装

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

/find-skills

或直接问 Claude："你有哪些可用的 skills？"

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

The following skills are available:
- 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：纯前端应用（推荐）
- 优点：简单快速，无需后端
- 缺点：数据不能跨设备同步
​
方案 B：全栈应用
- 优点：功能完整，支持多端
- 缺点：开发周期较长

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

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

---

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

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

示例 Bug：

public class ListUtils {
    public static String getFirstItem(List<String> 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();
​
    @Test
    void testCalculateDiscount() {
        assertEquals(80.0, calculator.calculateDiscount(100, 0.2));   // 打八折
        assertEquals(100.0, calculator.calculateDiscount(100, 0));    // 无折扣
        assertEquals(0.0, calculator.calculateDiscount(100, 1));      // 全免
    }
​
    @Test
    void 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

Skill 名称	用途
writing-plans	创建详细的实施计划
requesting-code-review	代码审查
finishing-a-development-branch	完成开发分支，准备合并
using-git-worktrees	使用 Git Worktree 隔离开发环境
skill-creator	创建你自己的自定义 skill

三周上手计划

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

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

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

继续探索

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

---

附录：参考资源

官方资源

• Core Plugin 源码 ：github.com/obra/superp... 查看 superpowers 核心插件的完整源代码和文档
• 问题反馈与讨论 ：github.com/obra/superp... 遇到问题或有建议？在这里提交 Issue 或参与讨论

社区教程

• Superpowers 实战教程 ：junki.cn/archives/oL... 更多实战案例和进阶技巧

---

恭喜你完成了 Superpowers 插件基础教程！ 现在打开 Claude Code，试着用 brainstorming skill 设计你的下一个功能吧。