【AI智能体】Claude Code +Superpowers 项目实战操作详解- 惊觉

随着Claude Code在AI编程领域的地位越来越高，相关的生态也越来越丰富，在基础编程大模型能力日渐完善的同时，与其配套的能力也在不断延伸，比如它的插件化能力，Skill能力，比如Superpowers ，便是适配Claude Code很好的即插即用的技能包。Superpowers 是 AI 编程标准化套件，支持 Claude Code、Cursor、OpenCode 等多平台，通过命令行一键安装技能包。它包含头脑风暴、代码审查等核心功能，安装后重启应用即可调用。

二、Superpowers 插件介绍

Superpowers是Claude Code生态中的一类社区增强插件/Skils集合。它不是”必装”的，但思路值得学习:把成熟工作流封装成可复用的能力，让AI不只是会写代码，还会按固定方法做事。

git地址：https://github.com/obra/superpowers

gitee地址：superpowers:基于技能组合的编码代理工作流项目 - AtomGit | GitCode

2.1 Superpowers 是什么

Superpowers本质是一套工作方法论集合，通常会封装成多个可复用 Ski。安装后，AI可以在合适的任务中调用这些方法论。

Claude Code 安装Superpowers 前后对比：

没装 Superpowers	装了 Superpowers
你:“加个批量导出功能”	你:“加个批量导出功能”
AI:"好的，我来实现...”(直接写代码)	Al:“在开始前我需要确认:1.导出格式?2.数据量多大?3.需要异步吗?"一给出2-3个方案，确认后再动手

2.2 Superpowers 核心Skills 一览

下面是Superpowers 插件提供的核心Skills

Skill	功能	触发时机
头脑风暴(brainstorming)	需求分析一设计规格，先想清楚再动手	新需求/新功能开始时
编写计划(writing-plans)	把规格拆成可执行的实施步骤	确认设计后
执行计划(executing-plans)	按计划逐步实施，每步验证	开发过程中
测试驱动开发(TDD)	严格TDD:先写测试，再写代码	开发核心逻辑时
系统化调试(debugging)	四阶段调试法:定位一分析一假设一修复	遇到Bug时
代码审查(code-review)	派遣审查agent检查代码质量	功能完成后
完成前验证(verification)	声称完成前必须跑验证	任务结束前

2.3 Superpowers 核心理念说明

Superpowers 并不是让AI变得更"聪明"，而是通过强制遵循一系列最佳实践，来规范它的工作流程。它会引导 Claude 从"直接写代码"转变为遵循一个更严谨的流程：先讨论需求 → 设计文档 → 拆解任务 → TDD开发 → 代码审查 → 系统化调试。

它通过一套自动化触发的技能模块来实现这一点，比如下面的流程：

头脑风暴 (brainstorming)：
- 在写代码前，先通过一系列提问，帮你把模糊的需求理清。
测试驱动开发 (test-driven-development)：
- 强制遵循"先写测试，再写代码"的红-绿-重构循环。
编写计划 (writing-plans)：
- 将复杂任务拆解成 2-5 分钟即可完成的小任务，每一步都明确文件路径和具体代码。
子代理驱动开发 (subagent-driven-development)：
- 为每个任务启动独立的"子代理"，并在完成后进行双重审查（规范符合度、代码质量）。
系统性调试 (systematic-debugging)：
- 遵循4阶段流程定位问题根因，而不是盲目猜测。

2.4 Superpowers 使用场景介绍

Superpowers 最核心的使用场景，就是把 Claude Code 从一个"听话但随性的代码生成器"，变成一个"遵循工程纪律的资深开发搭档"。它通过一套强制性的工作流，解决了AI编程中需求不清、测试缺失、调试混乱等核心痛点。具体来说，主要有下面的使用场景：

场景一：从模糊想法到清晰设计（需求与规划）

这是 Superpowers 最显著的用途之一，当你只有一个模糊的想法，不知道从何下手时，它不会直接给你写代码，而是强制进入规划阶段：

启动方式：
- 输入 /superpowers:brainstorm 或直接说 "我们为XX功能做个头脑风暴"。
它会做什么：像一位资深架构师一样，通过苏格拉底式提问，帮你把模糊的需求梳理清楚。
- 比如，你说想做"用户头像上传"，它会追问图片存本地还是OSS、要不要裁剪、尺寸限制是什么等，这些你容易忽略的细节都会在写代码前被敲定。
价值：输出的是一份结构化的设计文档（spec）。在这个阶段确定方向，远比写了一半代码再返工要高效得多。
- 在一个真实案例中，一个项目的头脑风暴产出了424行的详细规格说明书，锁定了缓存、热加载等关键技术决策，避免了后续巨大的返工成本。

场景二：复杂功能的系统化开发（执行与编码）

对于需要几个小时甚至更长时间的中大型功能开发，Superpowers 能发挥最大威力：

启动方式：需求设计确认后，输入 /superpowers:write-plan 和 /superpowers:execute-plan。
它会做什么：它会把设计文档拆解成2-5分钟就能完成的、颗粒度极小的具体任务清单，每个任务都精确到文件路径、代码内容和验证命令。随后，它会启动多个独立的子代理（subagent）并行执行这些任务，每个任务完成后还有双重审查。
效率对比：根据一些开发者的实测，对于一个大功能，传统方式可能需要8小时，而使用 Superpowers 的流程化开发可以压缩到3小时左右。这是因为它通过并行和减少返工，大大提升了效率。

场景三：告别"玄学"调试（系统化Debug）

遇到棘手的 Bug，尤其是那种深藏不露的偶发性问题，Superpowers 提供了系统化的解决方法：

启动方式：当遇到报错时，输入 /superpowers:debug 或这个技能通常会自动触发。
它会做什么：它会遵循一个严格的4阶段流程：
- 根源追踪：逆向追踪调用栈，找到问题的最初触发点，而不是直接去修报错的那一行代码。
- 提出假设：基于证据提出明确的假设和验证方案。
- 定向实验：通过编写测试来验证或否定假设。
- 防御性修复：修复问题的同时，思考如何防止同类问题再次发生。
价值：它把"到处加print、随机改代码"的玄学行为，变成了可追溯、有逻辑的科学排查。它甚至包含根因追踪（Root Cause Tracing）技能，用流程图来指导排查过程。

场景四：质量保障与团队协作（审查与交付）

它不只是关注"写"的过程，也严格把控"交"的质量：

核心技能：requesting-code-review（请求代码审查）、test-driven-development（测试驱动开发）、using-git-worktrees（使用Git工作树）等。
它会做什么：
- 强制TDD：在写任何业务代码之前，必须先写出一个会失败（Red）的测试，否则流程会被阻塞。
- 代码审查：功能完成后，会对代码进行多维度审查，输出结构化的报告，将问题按严重性（Critical/Warning/Info）分级，严重问题会直接阻塞合并。
- 并行开发隔离：为不同的功能或实验任务自动创建独立的 Git Worktree 环境，互不干扰，也保护了主分支。
- 优雅收尾：提供 finishing-a-development-branch 技能，将合并、清理、生成报告等收尾工作自动化。

不适合的场景

尽管Superpowers 功能强大，但也并非万能，也有不适用的场景：

极简的脚本或一次性工具：开发一个几行代码的脚本，用这套完整的流程确实有些"杀鸡用牛刀"。
快速原型验证：当你时间紧迫，只是想快速验证一个想法时，前期花大量时间做规划可能不太合适。
环境问题调试：它的规划流程是面向"功能开发"的。当你遇到 macOS 和 Linux 上 date 命令差异、进程管理等环境层面的"坑"时，这些属于需要在流程外手动解决的临时性问题，无法靠"规划"来预见。

2.5 是否必须安装

不是必须的，Superpowers是一个“锦上添花”的增强插件:

初学者:建议先不装，熟悉Claude Code基本操作后再考虑
日常开发:强烈推荐安装，能显著提升代码质量和开发流程规范性
团队项目:强烈推荐安装，统一团队的AI工作方法论

2.6 Superpowers目录结构

Superpowers Skills 目录结构--全局Skills对所有项目生效，项目级Skills仅对当前项目生效

全局目录结构：

~/.claude/
└── commands/         - 你的全局 Skills
    ├── review.md     - 代码审查 Skill
    ├── refactor.md   - 重构优化 Skill
    └── test.md       - 测试生成 Skill

项目级目录

项目根目录/
└── .claude/
    ├── commands/     - 项目级 Skills
    │   ├── deploy.md  - 部署流程 Skill
    │   └── migrate.md - 数据库迁移 Skill
    ├── settings.json - 项目配置
    └── CLAUDE.md     - 项目规则文件

三、Superpowers 安装过程

3.1 本地安装Superpowers

以最常用的 Claude Code 为例，主要有两种安装方式：

安装方式	适用场景	核心命令
官方市场安装（推荐）	追求稳定，安装最简单	/plugin install superpowers@claude-plugins-official
专属市场安装	想体验最新的内测功能	/plugin marketplace add obra/superpowers-marketplace
npx 安装	安装中文增强版	npx superpowers-zh

其他主流AI工具安装：

Claude Code：终端输入 /plugin install superpowers@claude-plugins-official 一键安装。
Cursor IDE：对话框输入 /add-plugin superpowers 或在插件市场搜索添加。
OpenCode：运行 Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md
Codex CLI：输入 /plugins 检索 superpowers 并安装，或手动克隆仓库到技能目录。

本地打开Claude Code 终端，执行官方的安装命令

下面会弹出一个让你选择的安装选项，一般选择第一个即可

看到下面的效果，说明Superpowers 插件安装完成

3.2 效果验证

紧接着上一步，通过 /plugins 命令检查安装的插件，进入之后在已经安装的那一栏里，就能看到Superpowers 的插件了

此时，如果输入 /superpowers 命令的话，就能显示出一些与superpowers 相关的命令了

如上图所示，你应能看到三个核心命令：

/superpowers:brainstorm —— 交互式设计细化
/superpowers:write-plan —— 创建实现计划
/superpowers:execute-plans —— 使用子代理执行计划
using-git-worktrees，—— 创建多任务子分支并且隔离执行
......

下面是相关命令详细的汇总

技能	用途
brainstorming	做任何创意/功能开发前，先澄清需求与设计
writing-plans	多步骤任务先写实现计划，再动手
executing-plans	在独立会话中按计划执行，带检查点
subagent-driven-development	在当前会话用子任务并行推进计划
test-driven-development	先写测试再实现（TDD）
systematic-debugging	遇到 bug/失败时系统化排查，再提修复
verification-before-completion	声称「完成/修好」前必须先跑验证
requesting-code-review	完成功能后主动请求代码评审
receiving-code-review	收到评审意见时严谨验证，不盲目照做
finishing-a-development-branch	开发收尾：合并、PR 或清理等选项
using-git-worktrees	用 git worktree 做隔离开发
using-git-worktrees	用 git worktree 做隔离开发
dispatching-parallel-agents	多个独立任务并行派发给子代理
writing-skills	编写/维护自定义技能
using-superpowers	会话开始时建立「何时用哪个技能」的规则

一个典型的流程示例：

「做一个新功能」→ 先 brainstorming，再 writing-plans，再实现
「修这个 bug」→ 先 systematic-debugging，再修复
「做完了」→ 先 verification-before-completion，再 requesting-code-review

3.3 其他AI 工具安装

3.3.1 Cursor 安装Superpowers

下面演示下如何在Cursor 中安装Superpowers ，打开Cursor 的对话框，输入下面的命令

/add-plugin superpowers

看到下面的效果，说明安装成功

并且给出了具体的使用方法

3.3.2 npx 安装Superpowers

在终端命令行窗口中执行下面的npx 安装命令

npx superpowers-zh

npx superpowers-zh --uninstall

选择y，等待执行完成即可，从图的提示可以看到，Superpowers 的执行一般是与具体的项目关联的，不建议在全局安装

切换到工程目录下再执行，此时可以

添加成功后，可以看到在项目根目录下增加了下面的一些与Superpowers 相关的skills

再次打开Claude 的窗口时，就能看到安装成功的Superpowers 相关的技能了

四、Superpowers 使用

接下来通过实际案例演示如何使用Superpowers 中的核心技能

4.1 Superpowers 核心技能使用

4.1.1 确认需求

在开发功能之前，先使用Brainstorm，再动手，它能阻止 Claude Code 在没想清楚之前就开始写代码。

如何触发呢？

比如当你说"帮我加一个用户登录功能"，没有 Superpowers 的 Claude 会直接开始写代码。有了 Superpowers，它会先进入 Brainstorming 模式，用苏格拉底式提问帮你理清需求，如下，我给Claude Code 提一个需求。

在PDA 工程模块下增加一个任务，定期清理fba_picking_log这个表的数据

在Brainstorm 模式下，输入上面的提示词之后，在执行后面的任务之前，Claude 中给出下面两个选项让你选择

这里我选择下面这个，然后Claude 会给出具体的诊断分析过程，比如会告诉我要做这个功能可以使用的技术栈，目前工程中缺失的组件，以及可以参考的示例做法，最后给出了核心的实现思路

当里面的每一项都确认清楚之后，它会生成一个结构化的设计摘要，确认你同意后才进入实现阶段。

简单总结一下，brainstorming模式下Claude 的工作流程：

AI 停止直接编码冲动，进入"苏格拉底式提问"模式
询问业务目标、约束条件、技术偏好
澄清模糊需求，识别隐藏假设
输出经过验证的设计方案

4.1.2 编写计划

触发方式：/superpowers:write-plan 或"写个实现计划"

如下，我让AI 给我写一个短信登录的接口：

可以看到，该技能会先把要确认的问题提出来，等待我确认

等到全部的问题都跟你确认完成之后，才会基于调研完成的问题进行开发计划的生成

4.1.3 执行计划

触发方式：/superpowers:execute-plan

该Skill 执行机制：

子代理调度：为每个任务创建全新 Claude 实例，携带最小必要上下文
TDD 强制执行：子代理必须先写测试文件，看到测试失败，再写实现
双阶段审查：任务完成后先自审查，再提交给专门的 code-reviewer 代理
Git 工作流：自动在隔离 worktree 中工作，保持 main 分支干净

基于上一步，当完成计划的制定与确认之后，会自动调用这个skill按照上一步的规划开始执行编码计划

4.1.4 代码审查

触发方式： /requesting-code-review

输入之后，将会开始对近期提交的代码进行review，不需要更多的提示词

4.1.5 代码bug修复

遇到bug 时，可以使用这个Skill进行系统化调试

触发方式： /systematic-debugging

如下，遇到一个bug，在终端窗口中，输入下面的内容，将会触发对这个技能的使用，从输出效果可以看到，这个技能会自动按照工程师排查问题的思路，先把问题背景搞清楚，比如要你提供报错的堆栈日志信息等，询问最近对报错代码的调整

Superpowers 的 Claude 改 Bug 流程如下：

Phase1: 复现 → 写一个能稳定触发 Bug 的测试用例
Phase2: 定位 → 追踪调用链，找到根因（不是症状）
Phase3: 修复 → 改根因，而不是包一层 catch
Phase4: 验证 → 跑测试确认修复，检查没有引入新问题

4.2 Superpowers 技能包完整工作流

以上说的是Superpowers 技能包中单个 Skill 使用，在实际工程化开发模式中，真正的威力在于把它们串联起来。比如下面的是开发一个功能的完整工作流：

Step1: /superpowers:brainstorm
  → 苏格拉底式问答，理清需求和边界

Step2: /superpowers:write-plan
  → 生成实现计划：文件列表、依赖关系、任务拆分

Step3: 审阅计划，修改后确认
  → Claude 不会在你没确认前动手

Step4: /superpowers:execute-plan
  → 自动分发给子 Agent
  → 每个 Agent 遵循 TDD
  → 任务间自动 Code Review
  → 关键问题阻塞推进

Step5: 验证 + Code Review
  → verification-before-completion 自动跑测试
  → requesting-code-review 发起最终审查

将这套流程跑下来，产出的代码质量跟有经验的工程师写的没有明显差距。 关键不在于 AI 的能力变强了，而在于 Superpowers 用流程约束住了 AI 容易犯的错误。

4.3 Superpowers + Claude Code 使用技巧

接下来介绍几个基于Claude Code 使用Superpowers 中的几个日常使用技巧

4.3.1 自然语言驱动，不用记命令

直接描述任务，插件自动匹配技能：

“帮我重构XXX这个模块” → 触发计划 + 审查
“这个报错帮我定位一下” → 触发系统化调试
“帮我做近2周的代码评审” → 触发审查技能

4.3.2 复杂项目必开 Git Worktrees

开发之前主动要求：

用 git worktrees 隔离开发，避免影响主线

通过这种方式可以做到安全试错，就算改崩了也可以直接丢弃，零风险。

4.3.3 强制高质量输出

在需求开发之前前加一句：

按 Superpowers 完整流程，先 brainstorm，再 write-plan，最后 execute-plan，必须做 TDD 和 code review

有了这一句，AI 会严格按标准工程开发步骤执行

4.3.4 团队统一 AI 开发规范

随着基于AI开发模式的注解成熟，要求项目团队成员统一安装 Superpowers，以实现：

统一开发流程
统一代码规范
统一审查标准
降低沟通成本，提升交付质量

4.3.5 长项目会话管理

即使Claude Code 安装了Superpowers，超长期项目（数周）仍可能积累较多的上下文债务。

这种情况的解决方案：

定期 /compact：压缩历史对话，保留关键决策，与日常使用Claude Code 会话一致
文档化架构决策：让 Superpowers 在 Plan 阶段输出 ARCHITECTURE.md，人力参与审查
使用 Git Worktree 隔离：每个大功能独立分支，完成后合并及时清理

4.3.6 与 VS Code 或Cursor 集成

虽然 Superpowers 主要运行在 Claude Code 终端，但你可以：

在 VS Code 中安装 Claude Code Extension
使用 VS Code 终端运行 claude 命令
在 VS Code 中查看 Superpowers 生成的代码和测试文件
利用 VS Code 的 Git 面板管理 Superpowers 创建的 worktree 分支

4.4 Superpowers完整案例操作演示

接下来通过实际项目操作，演示一下基于Superpowers的完整使用过程。

给出下面的提示词：

我想新开发一个员工管理系统，服务端技术栈为 springboot + mysql8.0 + mybatis-plus，第一期先做一个员工的增删改查的功能即可，按 Superpowers 完整流程，先 brainstorm，再 write-plan，最后 execute-plan，必须做 TDD 和 code review

输入提示词等待AI响应：

从第一步的输出日志看，开始调用其中的第一个Skill /Brainstorming ，做需求的进一步澄清，按照提示，我们给出决策

当所有的问题在需求澄清阶段结束后，会给出具体的实现方案，比如工程结构，数据模型设计，API 接口列表等

需求设计方案审查结束后，如果没什么问题的话，点击确认，将进入下一个阶段的writing-plans，如下：

这个阶段结束后，会给出具体的指导开发编码的设计计划

点击继续，开始编写完整的实现方案，这个阶段结束后，将会输出完整的开发代码执行计划

确认无误后，点击执行计划，将开始编码开发阶段

代码按照计划开发完成后，准备对开发的代码进行完整的review

可以看到，在review 代码过程中发现问题，会自动对发现的问题进行修复，然后做代码用例测试

Review 完成后，整个过程才算真正执行结束，并且将项目启动了

4.5 `Superpowers` 使用中的感受

下面说几点自己在开发过程中使用Superpowers 的真实感受：

优点：

代码质量显著提升：不是 AI 变聪明了，是标准规范的开发流程把常见错误堵住了
减少焦虑：以前让 AI 写代码总担心"它是不是又在瞎写"，现在每一步都有验证
适合团队推广：新人用 Claude Code 最大的问题是"不知道怎么用好"，Superpowers 给了一个标准工作流

不足：

简单任务有些重：改个文案也要走 Brainstorm 会让人烦（但可以跳过）
并行 Agent 偶尔冲突：Git Worktree 合并时极少数情况会有冲突，需要手动解决
Token 消耗增加：完整工作流比直接写代码多消耗 10-20% Token

一句话总结：

正式项目必装，日常写脚本或者做PRD可以随意
Superpowers 代表了一种范式转变：与其追求更聪明的模型，不如让现有模型遵循更严格的纪律。
它把 Claude Code 从"一个反应灵敏的编程助手"转变为"一个自律的、可预测的、可审计的开发流程"。对于正在将 AI 编程投入生产的团队来说，Superpowers 正迅速成为基础设施级的必需品。
AI 编程的竞争，早已不是 “谁会用 AI 写代码”，而是谁能用 AI 写出稳定、健壮、可上线的工程级代码。

建议所有程序员、测试开发、AI 爱好者可以动手安装使用一下

五、写在文末

本文通过较大的篇幅详细介绍了Claude Code 中Superpowers 这个插件的使用，并结合实际案例操作介绍了如何在项目中安装并使用Superpowers ，希望对看到的同学有帮助，本篇到此结束，感谢观看。

转载自 CSDN-专业IT技术社区

原文链接：https://blog.csdn.net/zhangcongyi420/article/details/162770920

【AI智能体】Claude Code +Superpowers 项目实战操作详解

一、前言