Superpowers 技能系统

概述

Superpowers 是一套预装的 Claude Code 技能集合，由社区开发。它提供了一系列结构化的工作流技能，覆盖软件开发的各个环节：从头脑风暴、写计划、写代码、调试到代码评审。

简单来说：如果 Claude Code 的自定义 Skill 是你自己写的脚本，那 Superpowers 就是别人写好的、开箱即用的"最佳实践"脚本集合。

为什么需要 Superpowers？

Claude Code 默认情况下，你给它一个任务，它会直接开始做。这在简单任务上没问题，但在复杂任务上容易出问题：

场景	没有 Superpowers	有 Superpowers
加个新功能	直接开写代码，可能方向错了	先用 brainstorming 技能探索需求，确认后再动手
遇到 bug	改一处试一下，不行再改	用 systematic-debugging 技能，系统排查根因
完成一大块代码	告诉你"做完了"	用 verification 技能，先跑测试确认再说完成

核心价值：让 Claude 遵循成熟的开发流程，而不是"想到什么做什么"。

技能调用机制

怎么触发？

Superpowers 的技能通过 Skill 工具自动加载。你不需要手动调用——当 Claude 判断某个技能适用于当前任务时，会自动触发。

比如你说"帮我加一个暗黑模式"，Claude 会自动触发 brainstorming 技能，先和你讨论需求，而不是直接开写。

你也可以显式调用，比如告诉 Claude "用 TDD 的方式来做"。

优先级规则

当多个指令冲突时，按以下优先级执行：

用户的明确指令（最高优先级）
      ↓
Superpowers 技能的指令
      ↓
Claude Code 默认行为（最低优先级）

举例：如果 Superpowers 的 TDD 技能说"必须先写测试"，但你在项目的 CLAUDE.md 里写了"这个项目不需要测试"，Claude 会听你的。用户永远有最终决定权。

核心技能详解

1. brainstorming（头脑风暴）

触发时机：创建功能、构建组件、添加新行为之前

做什么：

你说：帮我加个暗黑模式
      ↓
Claude 不会直接开写，而是先问你：
  - 暗黑模式要覆盖哪些页面？
  - 用 CSS 变量还是主题库？
  - 需要跟随系统设置吗？
  - 切换动画要不要？
      ↓
你们讨论达成共识后，才开始实现

为什么重要：避免"做完了才发现方向不对"的问题。5 分钟的讨论可以节省 1 小时的返工。

2. writing-plans（编写计划）

触发时机：确认了需求之后、动手写代码之前

做什么：

分析需要修改哪些文件
列出具体的实现步骤
考虑可能的风险和依赖
生成一个结构化的计划文档

示例输出：

## 实施计划：暗黑模式
 
### 步骤 1：创建主题系统
- 新建 src/theme/colors.ts
- 定义亮色/暗色两套 CSS 变量
 
### 步骤 2：添加切换逻辑
- 修改 src/App.tsx，添加 ThemeProvider
- 修改 src/stores/useSettingsStore.ts，添加 theme 状态
 
### 步骤 3：适配现有组件
- 修改 src/components/Header.tsx
- ...

3. test-driven-development（TDD）

触发时机：开始实现功能或修复 bug 之前

做什么：

第一步：先写失败的测试（Red）
      ↓
第二步：写最少的代码让测试通过（Green）
      ↓
第三步：重构代码，保持测试通过（Refactor）

注意：这是一个"严格型"技能——必须按流程走，不能跳步。先写测试，再写实现。

4. systematic-debugging（系统调试）

触发时机：遇到 bug、测试失败、不符合预期的行为

做什么：

第一步：复现问题，确认错误信息
      ↓
第二步：形成假设（可能是什么原因）
      ↓
第三步：验证假设（加日志、读代码、检查数据）
      ↓
第四步：定位根因
      ↓
第五步：修复并验证

为什么比"直接改"好：随意修改容易"修好一个 bug，引入两个新 bug"。系统调试确保你理解了问题的根本原因，而不是表面现象。

5. verification-before-completion（完成前验证）

触发时机：准备说"做完了"之前

做什么：

运行测试，确认全部通过
检查是否有遗漏的需求
验证代码是否实际工作（而不仅仅是"看起来对"）

核心理念：先拿证据，再下结论。不能只说"应该没问题了"，要用实际的测试结果证明。

6. requesting-code-review（请求代码评审）

触发时机：完成任务后，合并代码前

做什么：回顾所有改动，检查是否符合项目规范和最初的需求。

技能分类

类型	特点	技能
流程类	决定怎么做，必须严格遵循	brainstorming、TDD、debugging、verification
实现类	指导做什么，可以灵活适配	writing-plans、frontend-design

使用顺序：流程类优先，实现类其次。

比如"帮我做个用户认证功能"：

先触发 brainstorming（探索需求）
再触发 writing-plans（制定计划）
最后触发 TDD（按计划实现）

参考

Superpowers 技能文件位于 ~/.claude/skills/ 目录下
Superpowers 项目