在 AI 编程助手日益普及的今天，开发者们普遍面临一个痛点：AI 虽然能写代码，但常常“太着急”。它往往在需求尚未明确、设计尚未推敲时就直接输出大段代码，导致后续反复修改、调试困难，甚至方向性错误。

Superpowers 正是为了解决这一问题而生。它并非一个简单的代码生成插件，而是一套元技能（Meta-Skill）框架。它的核心作用是给 Claude Code 装上一副“纪律外骨骼”，强制其在每一次回应前先检查并调用相关技能，遵循工程化的工作流程，从而杜绝跳步、凭感觉写代码的行为。

本文将融合两份核心指南，从安装、机制、流程到实战，全方位解析如何在 Claude Code 中使用 Superpowers。

一、Superpowers 是什么？—— 不只是技能，更是“纪律”

Superpowers 是由 Jesse Vincent 开源的一套 Claude Code 插件生态，本质上是一套可组合的软件开发方法论技能框架。它与普通 Skill 包的最大区别在于：它定义的是强制流程，而不是可选建议。

它通过一套环环相扣的技能（如 brainstorming -> writing-plans -> TDD -> executing-plans），强制 Claude 走通“先理需求、再写计划、测试先行、证据验证”的完整工程化路径，有效避免 AI 一上来就乱写代码。

其设计哲学是：技能自动触发，无需刻意记忆。它会根据你描述任务的语义，自动匹配合适的 Skill，引导你完成从需求澄清到最终交付的全过程。

二、安装 Superpowers：三种方式任你选

要开始使用，首先需要将 Superpowers 安装到你的 Claude Code 环境中。根据你的偏好，可以选择以下三种方式之一：

方式 1：官方插件市场安装（最推荐）

这是最直接、最便捷的方式。在 Claude Code 会话中直接输入以下命令即可：

/plugin install superpowers@claude-plugins-official

方式 2：Superpowers 专属市场安装

如果你希望获取最前沿的更新，可以先将 Superpowers 的自有市场添加到 Claude Code，再从市场中安装：

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

方式 3：中文社区优化版

对于英文提示词感到吃力的开发者，可以安装中文社区优化版，该版本的提示词已完成汉化：

/plugin install superpowers-zh@jnMetaCode

验证与激活：安装完成后，建议执行 /reload-plugins 或重启 Claude Code 会话以确保所有技能加载完毕。你可以输入 /plugins 命令来验证 Superpowers 是否已成功激活。

三、核心理念：读懂“1% 原则”与技能优先级

要正确使用 Superpowers，必须深刻理解其背后的两条核心规则。

1. “1% 原则”—— 宪法级别的硬性规定

Superpowers 有一条不可动摇的“宪法条款”：只要对当前任务有哪怕 1% 的可能性某个技能适用，Claude 就必须先调用该技能，再开口说话。
这不是可选项，Claude 不能“理性化”地跳过这一检查。这一机制从根本上杜绝了 AI 凭借“直觉”或“记忆”直接输出内容，确保每次交互都经过深思熟虑。

2. 技能优先级：流程型 > 实现型

Superpowers 套件内的技能有严格的执行层级：

• 流程型技能（优先级高）：如 brainstorming（头脑风暴）、systematic-debugging（系统化调试）。它们负责定义“怎么做”。
• 实现型技能（优先级次之）：如 test-driven-development（测试驱动开发）、executing-plans（执行计划）。它们负责“用什么做”。

例如，当你提出“帮我做一个登录页”时，Claude 会优先触发 brainstorming 来澄清需求，而不是直接调用前端开发技能。

四、技能全览：从头脑风暴到验证收尾

Superpowers 并非单一技能，而是一套完整的流水线工具集。这些技能按开发阶段可分为三大类：

1. 流程与协作型（优先执行）

技能名称	触发/命令方式	核心作用
brainstorming	/superpowers:brainstorming	苏格拉底式追问，输出 2~3 套方案对比，生成设计文档存入 docs/superpowers/specs/。不确认设计，绝不允许写代码。
writing-plans	/superpowers:write-plan	将工作拆解为 2~5 分钟一个的原子任务，每项任务都清晰标注文件路径与验证命令。
systematic-debugging	报错时自动触发	四阶段调试法（复现→列假设→验证→定位根因），禁止在找到根因前盲目修改代码。
using-git-worktrees	自动/手动	自动创建隔离的 Git 工作树，确保主分支不被污染。

2. 实现与开发型（核心执行）

技能名称	触发/命令方式	核心作用
test-driven-development	自动触发	强制 RED-GREEN-REFACTOR 循环：先写失败测试→编写最少代码使测试通过→重构优化。
executing-plans	/superpowers:execute-plan	分批执行计划，每个任务派发独立子代理，配合两阶段评审（先看规格符合度，再看代码质量）。
subagent-driven-development	自动/手动	为每个无依赖的任务启动并行子代理，极大提升多文件、多模块的开发效率。

3. 收尾与质量保障型

技能名称	触发/命令方式	核心作用
requesting-code-review	自动/手动	在提交审查前，提供一份详尽的自检清单。
receiving-code-review	自动/手动	指导如何系统性地响应代码审查意见。
verification-before-completion	完工前自动触发	强制运行全量测试、Lint、类型检查，杜绝“幻觉式完成”，确保交付质量。

五、工作流实战：一个完整的开发周期

安装 Superpowers 后，一次标准的开发会话将严格按照以下路径推进。我们以一个“添加用户登录功能”的任务为例：

1. 需求澄清阶段：用户描述需求后，brainstorming 技能自动触发。AI 不会直接写代码，而是开始向你提问：“技术栈是什么？（JWT/Session）”、“密码加密方案？”、“登录失败的限制策略？”。你需要认真回答这些问题，AI 会将共识整理成设计文档。
2. 计划拆解阶段：设计文档确认后，writing-plans 技能接手。它将“登录功能”拆解为“创建数据库迁移脚本”、“编写密码加密工具函数”、“编写登录 API 路由”、“编写前端表单验证”等 2-5 分钟可完成的原子任务列表。
3. 编码实现阶段：进入 executing-plans 执行。对于列表中的每个任务，test-driven-development 会被自动启用。Claude 会先为“密码加密函数”写一个单元测试（测试跑红），然后编写实现代码（测试跑绿），最后进行重构。
4. 调试排错阶段：若在实现过程中测试报错或程序崩溃，systematic-debugging 会自动介入。它会要求先复现错误、列出根因假设，并逐一验证，坚决杜绝盲目修改代码。
5. 验证收尾阶段：所有任务执行完毕，verification-before-completion 技能自动触发。AI 会主动运行全量测试套件、执行 Lint 检查、验证类型定义，全部通过后才会向你报告“任务完成”。

六、实用建议与常见避坑指南

💡 实用建议

1. 别跳过提问环节：brainstorming 阶段的问题看似繁琐，但它们是在帮你避免方向性错误。认真回答一次，能省下后期大量返工时间。
2. 善用计划确认环节：当 AI 展示 writing-plans 生成的计划时，是纠偏成本最低的时刻。请仔细核对任务拆解是否合理。
3. 配合项目记忆使用：建议先使用 /init 命令让 Claude 记住项目规范，这样 Superpowers 的流程会更贴合你的项目实际。

⚠️ 避坑指南

常见错误操作	✅ 正确做法
用 Read 工具去读取 SKILL.md 文件来“学习”技能。	必须使用 Skill 工具来调用技能，这是触发流程的唯一正确方式。
“我刚才用过这个技能，凭记忆跳过”。	技能会持续进化，每次该用时都必须重新 invoke 一次。
先给用户解释/澄清，再检查技能。	澄清问题本身也是回应，必须先过 Skill 检查再说话。
Subagent 执行任务时重复走元流程。	Subagent 自动跳过 using-superpowers，避免无限嵌套。

七、总结：从“AI 聊天”到“AI 工程流水线”

Superpowers 与普通 Skill 包的差异，本质上是 “建议”与“强制” 的差异。

• 普通 Skill 包：提供参考建议，Claude 可以选择遵守或忽略。
• Superpowers：定义强制流程，Claude 必须遵守。

安装 Superpowers 之后，你不需要记忆任何复杂的命令。只需像往常一样用自然语言描述任务，Claude 就会自动遵循一位资深工程师的工作习惯：先问需求、再定计划、测试驱动、证据验证、最后交付。

当你将 Superpowers 与 everything-claude-code（技术栈规范）、ui-ux-pro-max（设计标准）等技能结合使用时，Claude Code 将彻底进化为一条完整的 AI 软件工程流水线，而不再仅仅是一个“会写代码的聊天机器人”。