今天翻到一篇不错的技术分享，看完之后自己也琢磨了一下，把思路梳理记录下来。
目录
4.3 Superpowers + Claude Code 使用技巧
一、前言
随着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)：
- 强制遵循"先写测试，再写代码"的 红-绿-重构 循环。
- 将复杂任务拆解成 2-5 分钟即可完成的小任务，每一步都明确文件路径和具体代码。
- 为每个任务启动独立的"子代理"，并在完成后进行双重审查（规范符合度、代码质量）。
- 遵循4阶段流程定位问题根因，而不是盲目猜测。
2.4 Superpowers 使用场景介绍
Superpowers 最核心的使用场景，就是把 Claude Code 从一个"听话但随性的代码生成器"，变成一个"遵循工程纪律的资深开发搭档"。它通过一套强制性的工作流，解决了AI编程中需求不清、测试缺失、调试混乱等核心痛点。具体来说，主要有下面的使用场景：
场景一：从模糊想法到清晰设计（需求与规划）
这是 Superpowers 最显著的用途之一，当你只有一个模糊的想法，不明白从何下手时，它不会直接给你写代码，而是强制进入规划阶段：
- 启动方式：
/superpowers:brainstorm 或直接说 "大家为XX功能做个头脑风暴"。
它会做什么：像一位资深架构师一样，通过苏格拉底式提问，帮你把模糊的需求梳理清楚。
- 比如，你说想做"用户头像上传"，它会追问图片存本地还是OSS、要不要裁剪、尺寸限制是什么等，这些你容易忽略的细节都会在写代码前被敲定。
- 在一个真实案例中，一个项目的头脑风暴产出了424行的详细规格说明书，锁定了缓存、热加载等关键技术决策，避免了后续巨大的返工成本。
场景二：复杂功能的系统化开发（执行与编码）
对于要几个小时甚至更长时间的中大型功能开发，Superpowers 能发挥最大威力：
- 启动方式：需求设计确认后，输入
/superpowers:write-plan和/superpowers:execute-plan。 - 它会做什么：它会把设计文档拆解成2-5分钟就能完成的、颗粒度极小的具体任务清单，每个任务都精确到文件路径、代码内容和验证命令。随后，它会启动多个独立的子代理（subagent） 并行执行这些任务，每个任务完成后还有双重审查。
- 效率对比：根据一些开发者的实测，对于一个大功能，传统方式可能需要8小时，而使用 Superpowers 的流程化开发可以压缩到3小时左右。这是因为它通过并行和减少返工，大大提升了效率。
场景三：告别"玄学"调试（系统化Debug）
遇到棘手的 Bug，尤其是那种深藏不露的偶发性问题，Superpowers 提供了系统化的解决方法：
- 启动方式：当遇到报错时，输入
/superpowers:debug或这个技能通常会自动触发。 - 它会做什么：它会遵循一个严格的4阶段流程：
- 提出假设：基于证据提出明确的假设和验证方案。
- 定向实验：通过编写测试来验证或否定假设。
- 防御性修复：修复问题的同时，思考如何防止同类问题再次发生。
场景四：质量保障与团队协作（审查与交付）
它不只是关注"写"的过程，也严格把控"交"的质量：
- 核心技能：
requesting-code-review（请求代码审查）、test-driven-development（测试驱动开发）、using-git-worktrees（使用Git工作树）等。 - 它会做什么：
- 代码审查：功能完成后，会对代码进行多维度审查，输出结构化的报告，将问题按严重性（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 fromhttps://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md - Codex CLI：输入
/plugins检索 superpowers 并安装，或手动克隆仓库到技能目录。
下面会弹出一个让你选择的安装选项，一般选择第一个即可
看到下面的效果，说明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 的工作流程：
1. AI 停止直接编码冲动，进入"苏格拉底式提问"模式
2. 询问业务目标、约束条件、技术偏好
3. 澄清模糊需求，识别隐藏假设
4. 输出经过验证的设计方案
4.1.2 编写计划
触发方式：/superpowers:write-plan 或"写个实现计划"
如下，我让AI 给我写一个短信登录的接口：
可以看到，该技能会先把要确认的问题提出来，等待我确认
等到全部的问题都跟你确认完成之后，才会基于调研完成的问题进行开发计划的生成
4.1.3 执行计划
触发方式：/superpowers:execute-plan
该Skill 执行机制：
1. 子代理调度：为每个任务创建全新 Claude 实例，携带最小必要上下文
2. TDD 强制执行：子代理必须先写测试文件，看到测试失败，再写实现
3. 双阶段审查：任务完成后先自审查，再提交给专门的 code-reviewer 代理
4. 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，超长期项目（数周）仍可能积累较多的上下文债务。
这种情况的解决方案：
1. 定期 /compact：压缩历史对话，保留关键决策，与日常使用Claude Code 会话一致
2. 文档化架构决策：让 Superpowers 在 Plan 阶段输出 ARCHITECTURE.md，人力参与审查
3. 使用 Git Worktree 隔离：每个大功能独立分支，完成后合并及时清理
4.3.6 与 VS Code 或Cursor 集成
虽然 Superpowers 主要运行在 Claude Code 终端，但你可以：
1. 在 VS Code 中安装 Claude Code Extension
2. 使用 VS Code 终端运行 claude 命令
3. 在 VS Code 中查看 Superpowers 生成的代码和测试文件
4. 利用 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 ，希望对看到的同学有帮助，本篇到此结束，感谢观看。
本次分享就到这里。技术这东西越研究越有意思，后续有新的收获我也会继续更新。
评论 (0)
暂无评论