superpowers 这套东西我盯了有一阵子了。如果你已经用上了 Claude Code应该能感觉到原生的能力虽然强但每次干点正事都得反复交代背景、约束格式、提醒别偷懒像带一个聪明但不上心的实习生。superpowers 做的事就是把这一整套“调教AI”的经验打包成可复用的技能skills让它一上来就进入干活状态。这篇文章我想从一个实际使用者的角度把它是什么、怎么装、里面到底有哪些 skills、以及实际用起来会遇到什么问题一次性讲清楚。我不打算写成一个翻译文档式的“说明书”而是把我自己从安装到真正跑起来的完整过程拆给大家。你会看到它的设计思路、目录结构、几个核心技能的底层逻辑以及我在项目里试出来的坑和解决办法。不管你是刚听说这个项目、还在犹豫要不要装还是已经装了但没用明白这篇应该都能帮上忙。1. superpowers 是的核心思路它解决了什么问题先聊一个最基本的疑问Claude Code 本身已经很强了为什么还需要 superpowers 这类技能包1.1 裸装 AI 的“能力边界”问题如果你用过一段时间 Claude Code大概率会有这种感觉在一个干净的项目里让它做事它能干但很“凉”。你想让它批量处理几十个文件它会老老实实一个个来速度慢不说中间稍微有点状态变化它就乱了。你让它写提交信息它能写但风格飘忽不定今天这样明天那样。你让它做个规划它给你的东西不是泛泛而谈就是过度设计。这不是模型能力不够而是缺少“约束和套路”。一个经验丰富的工程师干活是有肌肉记忆的先扫一遍现状再定方案然后分步执行中途随时自检。裸装的 Claude Code 没有这套肌肉记忆每次都是从零开始推理所以你才觉得它不稳定。superpowers 的核心思路就是把这类“肌肉记忆”固化成文件——每个技能一个目录里面有 SKILL.md 描述这个技能怎么用、什么时候用、有什么步骤再加上一些辅助脚本和模板。需要哪个技能的时候通过斜杠命令或者自然语言直接调用AI 就会按照这套流程来干活。1.2 它和插件的区别不是功能增强是行为增强这里有个容易混淆的点。很多人以为 superpowers 是给 Claude Code 加新功能的插件比如“能读 PDF 了”“能连数据库了”。其实不是。它更像是给 AI 换了一套工作方法论。你装上之后Claude Code 不会多出什么魔法按钮但它的工作方式会明显变得更“懂行”做批量操作时知道要分块、要保留现场、要处理中断写代码时知道要先交代设计背景再贴代码写提交信息时知道要按规范拆标题和正文。打个比方原生的 Claude Code 是个什么工具都会一点的新手superpowers 是给这个新手配了一整套老师的批注笔记和工作模板。它不教你知识但教你怎么有条理地做事。1.3 它适合谁不适合谁说实话它不适合完全没用过 Claude Code 的人。如果你连基本对话、跑命令都不太熟上来就装这套东西你会被它的目录结构和各种技能文件搞懵。它适合已经有了几个真实项目、想提升 AI 干活稳定性和效率的人。尤其是这几类场景会很受益频繁做跨文件重构、批量改代码的开发者想让 AI 写文档、写提交信息但又不想每次都苦口婆心定规范的人团队里多人共用同一个 AI 工作流想统一“手感”的人对 AI 生成质量有要求、愿意花时间去调教工作流的人我自己属于最后一类。用了两周之后最大的感受不是它让 AI 变聪明了而是让 AI 变“稳”了。以前每次对话的随机性很大现在走完同一套技能输出质量基本在一个水平线上。2. 安装五步把 superpowers 接入 Claude Code如果你决定要试下面这套流程是我实操验证过的照着走就行。2.1 前置条件确认环境和版本先确认几样东西已安装 Node.js18.0.0 以上我用的 20.x 没问题已安装 Claude Code并且至少完整跑通过一次对话系统是 macOS 或者 Linux 都行Windows 上通过 WSL 也没遇到大问题命令检查一下node -v claude --version如果这两条都能正常输出版本号就可以继续了。2.2 通过插件市场安装的完整步骤在 Claude Code 会话中输入斜杠命令/plugin marketplace add obra/superpowers这个命令的作用是把 superpowers 的仓库注册为插件市场。执行成功后再输入/plugin install superpowers安装过程会拉取插件代码时间取决于网络状况一般一两分钟内完成。装完之后输入/plugin应该能在列表里看到 superpowers。2.3 可选手动安装的备选路径如果你不想走插件市场也可以直接 clone 仓库到本地git clone https://github.com/obra/superpowers.git ~/.claude/plugins/superpowers然后你需要手动把插件的配置路径指到本地目录。这个方案适合你想自己改源码、或者网络访问插件市场不顺畅的情况。不过日常使用我建议优先用插件市场因为后续更新只需要重新执行 install 命令手动 clone 的要自己 pull麻烦一些。2.4 安装后的目录结构装完建议花五分钟看一眼目录结构这能帮你理解它的工作方式。核心目录大概长这样~/.claude/plugins/ └── superpowers/ ├── plugin.json ├── skills/ │ ├── brainstorm/ │ ├── comprehensive-planning/ │ ├── batch-processing/ │ ├── commit-release/ │ ├── info-packed-doc-generation/ │ └── sketching-skills/ ├── scripts/ └── commands/每个 skills 下的子目录就是一个独立技能里面通常有 SKILL.md 说明文件复杂的技能还会带模板和脚本。commands/目录里则是斜杠命令的注册入口。理解了这个结构后面你想自己加技能或者改现成技能就知道去哪动刀了。3. 核心 skills 逐个拆解有哪些、怎么用、何时用装完之后很多人会卡在一件事上skills 这么多到底什么时候该用哪个我把几个我用得最勤的列出来逐个说说它们的使用场景和底层逻辑。3.1 skills 总览速查表技能名称核心用途适用场景启动方式Brainstorming头脑风暴和多方案生成需求模糊、需要探索可能性/superpowers:brainstormComprehensive Planning生成结构化实施计划功能开发、重构、大型任务/superpowers:planBatch Processing批量处理大量文件批量重构、批量修改/superpowers:batchCommit/Release规范生成提交信息提交代码、写 release notes/superpowers:commitInfo-Packed Doc Generation生成高密度技术文档模块说明、架构文档/superpowers:docSketching Skills绘制图表和可视化表示架构图、流程图、时序图/superpowers:sketch3.2 三个我每天都用的技能Batch Processing批量处理这个是我觉得最有价值的一个。原生的 Claude Code 处理大量文件时特别容易半路丢状态——改着改着就忘了开头说了什么。Batch Processing 的思路是把一个大任务拆成小批次每批次处理前先明确目标、处理完做一次小结全部结束后再汇总。我有一次要批量给一个项目里 80 多个组件加错误边界直接用很容易改着改着就走样。后来改用 Batch Processing给它一个清单文件让 AI 按批次读取、修改、确认最后统一跑测试。整个过程下来没有一个文件被遗漏中途我打断它再恢复它也能从断点继续。Comprehensive Planning全面规划这个技能解决的是“猴急综合征”——AI 一上来就写代码写到一半发现方案有问题。它会强制 AI 先产出一份计划包含目标、现状分析、变更点、风险点、验证方式然后等你确认再动手。实际用的时候要注意你不能无脑让 AI 自己定计划。我给它的建议是先跟它聊几分钟需求背景把约束条件和偏好说清楚再让它生成计划。这样出来的计划贴合度会高很多后面实施阶段的返工少一大半。Info-Packed Doc Generation文档生成这个技能写出来的文档信息密度很高。它不是那种“本文介绍了某某功能”的水文而是直接给出背景、接口、数据结构、示例、边界情况、变更影响面。我最近给项目写模块设计文档列了个大纲之后用这个技能一小时内就产出了初稿信息密度比我手写的高。它写文档的时候还会主动去代码里找线索不是凭空造句。这一点靠谱因为穿插代码引用能让文档可信度高一个档次。3.3 技能背后的实现机制了解机制之后你就能自己玩出花来。每个技能本质是一份 SKILL.md 文件格式大概如下--- name: comprehensive-planning description: Generate comprehensive implementation plans --- ## When to Use ... ## Process 1. ... 2. ...Claude Code 在对话中读到这份文件后会把其中的步骤、约束、示例“加载”进上下文。也就是说技能不是外挂逻辑而是通过提示词工程的约束引导模型走固定流程。这也是为什么它的技能可以被自定义、被共享——你只需要按同样的格式写一份新的 SKILL.md丢到~/.claude/plugins/superpowers/skills/或者自定义插件目录里Claude Code 下次启动时就能识别到。我最近就照着这个格式给团队写了个“代码评审”技能效果非常不错。4. 实操全记录让 superpowers 真正跑起来讲完理论说点实际的。下面是我在一个模拟项目里完整实操的记录从启动到完成走了一遍你可以直接照做。4.1 场景准备一个前后端分离的项目我准备了一个模拟仓库包含一个 Flask 后端、一个 React 前端、几十个工具函数和一点测试代码。整体规模中等大概几十个文件适合演示技能的完整工作流。我先在仓库根目录启动 Claude Code输入cd ~/projects/superpowers-demo claude启动后第一件事不是马上让 AI 干活而是先花几分钟梳理项目结构和现状把这个信息喂给它。4.2 用 Comprehensive Planning 生成实施方案我提了一个需求把后端的路由从函数式改造成蓝图Blueprint组织方式。这个需求涉及路由迁移、引用修复、测试调整属于典型的多文件结构变更。我发出指令/plan 将后端的路由改为 Flask Blueprint并保持现有接口不变Claude Code 开始执行 Comprehensive Planning 技能输出了一份计划大致包含目标描述与约束接口兼容现状分析列出所有路由所在文件重构方案蓝图创建、注册方式、文件目录调整变更影响面需要同步修改哪些引用测试验证方案我看了计划之后把其中一条蓝图模块的位置做了调整然后让它继续。注意这里我没有直接说“开始改”而是先改计划再确认。这个步骤很重要等于提前把肠子理清楚了后面执行就不容易跑偏。4.3 用 Batch Processing 做多文件修改计划确认后技能自动切到了执行阶段变成了批量处理模式。它把涉及的文件整理成了一个清单分三批处理第一批创建蓝图模块和目录结构 第二批迁移路由到蓝图并修复 import 第三批更新测试导入路径每批次之间AI 会做状态小结说明这个批次改了什么、有没有异常。中途我故意在第三批次开始时打断它问了一个问题它回答完之后没有丢失上下文直接从断点继续往下跑了。全部完成后它自动汇总了改动清单并跑了一遍测试确认没有破坏现有功能。整个过程我只做了两件事确认计划和中途提问其余全是 AI 自动推进。4.4 用 Commit/Release 生成提交信息修改完成后我输入/commit它会先读一遍git diff --stat和具体的 diff然后按规范生成提交信息。这里有个细节它会主动分析哪些文件是重构、哪些是测试、哪些可能涉及破坏性变更。生成的信息也不是简单拼接而是会写成“重构路由层为蓝图架构保持接口兼容涉及路由注册与引用调整”这种有信息量的句式。我还试过在-n 3参数下生成多个版本让 AI 挑选。实际效果不错——即使我只想要一个它也能顺带解释为什么推荐这个版本。4.5 用 Info-Packed Doc 快速生成文档最后一步是给这个改动补一篇开发文档。我输入/doc 为本次路由重构生成一篇模块说明文档它会自动去翻代码列出新增的蓝图模块、路由注册方式、以及调用方的适配说明。最后产出的文档包含接口列表、文件路径、依赖关系密度很高我稍作润色就能归档。这套组合拳打下来我最大的感受是以前我需要自己一步步盯着 AI 干现在变成了“先跟它对齐计划然后放它自己跑”。省心程度确实不一样。5. 常见问题与排查技巧我踩过的坑任何工具都不可能一次顺畅。下面这些是我在实际使用中遇到并解决的问题整理成速查表供你参考。5.1 问题速查表现象可能原因解决办法安装了但/superpowers:xxx无效插件没被加载或者命令名有变输入/plugin检查加载状态确认命令名技能执行时没有按预期步骤来当前上下文干扰了技能模板新开一个会话或在对话里明确说“按 X 技能执行”批量处理依然丢状态任务自身太大超出上下文窗口把任务拆得更细或多用几次技能入口生成文档内容偏空泛没有给足背景信息先让 AI 读代码再要求引用具体文件路径自定义技能不生效SKILL.md 格式不对或位置不对严格按 YAML frontmatter 写确认放在 skills 目录下5.2 自定义一个自己的技能格式与避坑我把自定义技能这一段单独拿出来说因为很多人的需求不是用现成技能而是想沉淀自己的团队规范。自定义技能的关键是 SKILL.md 的文件头。下面是一个最小可用示例--- name: crash-review description: Review code for potential crash points --- ## When to Use Use when reviewing code changes for potential exceptions. ## Process 1. List all files changed in the diff. 2. For each file, identify paths that could throw errors. 3. Classify error types: NullPointer, IndexOutOfBounds, etc. 4. Suggest mitigations with code snippets. ## Notes - Also check for silent swallowing of exceptions. - Never suggest ignoring errors even if unlikely.这个技能建好之后我在会话里说“用 crash-review 看一下这周的变更”AI 就会严格按照流程执行。避坑经验技能描述要写清楚“什么时候用”AI 是靠 description 字段来判断何时调用这个技能的。写得含糊它就不知道什么时候该触发你的技能。步骤要尽量可执行不要写“分析代码”这种模糊指令。写成“列出 diff 涉及的全部文件”这种具体步骤效果天差地别。不要试图在一个技能里塞太多目标。一个技能解决一个类型的任务别贪多。5.3 几个日常防翻车习惯最后分享几条我用这套东西养成的习惯新开会话之前先“加载”需要的技能。在 Claude Code 里输入相关命令或者直接说“请使用 XX 技能”比让它自己判断要稳定得多。重要任务一定要先出计划再执行不要嫌麻烦。超能力发挥的前提是方向正确计划阶段多花五分钟执行阶段省下来的不止五十分钟。批量修改完成后用/commit生成的提交信息过一遍尤其注意有没有把“删除”“修改”“新增”这类语义搞对的地方。结尾说点实在的吧。我最初接触 superpowers 的时候预期只是“装个插件多点功能”但实际上它改变的是我使用 Claude Code 的整个方式。以前我是个“对话式”用户想到什么问什么现在我是个“流程式”用户先定步骤再放 AI 去跑。这种转变不是因为它有多神奇而是因为它把工程里最常识的那部分——先规划、再动手、分步走、有自检——固化成了 AI 的默认行为。如果你现在手头正有一个 Claude Code 项目我建议你先别急着装一大堆技能。试着用上面的方法装好 superpowers挑一个正在做的任务走一遍“计划-执行-总结”的流程。用个几次你应该就能感受到差别在哪里。我自己用过这段时间之后最大的体会是AI 工具的上限不在于模型多强而在于工作流是否把它放对了位置。superpowers 只是把“正确的位置”这件事变成了可以复制的东西。最后再留一个小技巧把不急的任务留到一天中你能专注的时候第一次用这套流程最好是开着完整的项目上下文而不是零碎对话。状态越完整技能发挥越稳定。