Superpowers 让 Claude Code 成为你的专家级助手Superpowers 插件基础教程一、什么是

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

阅读时间：约 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？

确认插件已安装：运行 /plugin list 查看
完全退出 Claude Code（Ctrl+C 或 /exit）
重新运行 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 + JavaScript（或 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<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 ✓

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

五、总结与进阶

核心要点回顾

Superpowers = 给 Claude 配备专业工具箱，让它按最佳实践工作
Skills 是工作流程，不是魔法，它们让 Claude 更系统、更可预期
自动触发为主，描述任务即可，Claude 会判断是否需要 skill
三个最常用的 skills：
- brainstorming：需求分析和功能设计
- systematic-debugging：系统化 Bug 排查
- test-driven-development：测试驱动开发

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 设计你的下一个功能吧。

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