Superpowers技能包：让Claude Code告别重复提示词，拥有稳定工作流

如果你也在用 Claude Code 做日常开发，大概早就被它的“Agent 自主干活”能力惊艳过，但用久了你会发现一个尴尬：每次让它做同一类事，比如整理需求、拆任务、生成示意图，它都要重新理解一遍你的流程，像是每次都从零开始。后来我找到一套叫 superpowers 的技能包，等于把这些高频工作流统一封装成了 Claude Code 可以随时调用的“肌肉记忆”。这篇文章就从实际使用角度，聊聊 superpowers 是什么、怎么装、里面到底有哪些 skills、以及如何把它真正用起来。

1. Superpowers 不只是技能包，而是一套“能力工作流”框架

1.1 它解决的是 prompt 越来越长的痛点

很多人在 Claude Code 里积累了一套自己的提示词模板，比如 “你现在是项目经理，请先拆解任务再分配” 之类的，每次开工前都要复制粘贴一大段。问题是这种模板没有结构，放多了 Claude Code 也分不清优先级，更别提复用和维护。

superpowers 的做法是把这些模板变成规范的“技能文件”。每个技能都以目录形式存在，里面有一个SKILL.md主文件，再加上若干参考文档、脚本和模板。Claude Code 在对话中会按需自动读取这些技能文件，而不是你手动粘提示词。相当于你给 Claude 装了一套可检索的“操作手册”，它干活前自己会翻对应那一章。

1.2 和插件的区别：它更像是“技能操作系统”

不少人听到 superpowers 第一反应是“这算不算 Claude Code 插件”。严格说它不是插件，它主要干两件事：往 Claude Code 里加载自定义 Skills，同时提供一套完整的工作流体系。Skills 是 Claude Code 原生支持的机制，而 superpowers 本质上是帮你把一堆高质量的 SKILL.md 文件组织起来，并提供安装、更新、创建新技能的脚手架。

如果你用过 VS Code 的插件体系，可以这样理解：插件是外部封装好的功能，而 superpowers 更像是“插件生成器 + 插件管理集合”，它给的不是单一功能，而是创建技能和组合技能的基础设施。所以你想扩展成自己的风格，也非常容易。

1.3 谁适合用 superpowers

我个人的判断是：只要你每天在 Claude Code 里做重复性工作，就值得装。尤其是这几类人受益最大：

• 用 Claude Code 做项目管理，需要频繁拆解任务、写计划、做状态跟踪；
• 经常让 AI 生成图片、SVG 示意图、PDF 或电子书的人；
• 希望把自己的工作方法论沉淀成可复用模板的个人或团队；
• 对 Claude Code 默认行为不满意，想深度定制回复风格和流程的人。

如果你只是偶尔问一句代码报错，那装不装都可以；但如果你想用 Claude Code 稳定交付一个小型项目，superpowers 基本属于必备工具。

2. 安装前必须搞清楚的环境准备和前置条件

2.1 先确认 Claude Code 本体能正常运行

superpowers 是在 Claude Code 之上工作的，所以第一条就是 Claude Code 得能跑。我见过有人在没有登录 Claude 账号的情况下直接装 superpowers，装完后一脸懵，因为技能文件虽然复制过去了，但 Claude Code 根本不走自己那套对话流程，自然也就触发不了技能。

建议先随便在 Claude Code 里问一个问题，确认它能正常调模型再开始安装。另外注意 Claude Code 的版本不要太太太老，因为 Skills 机制是后加的，如果版本太旧可能识别不了SKILL.md。遇到这种情况，升级一下 Claude Code 即可。

2.2 Git 和 Node 环境检查

安装 superpowers 官方推荐方式是git clone加执行安装脚本。所以机器上需要提前装好 Git 和 Node.js。Node 其实主要看版本，Claude Code 本身也会依赖 Node，通常你用 npm 装过 Claude Code 就说明 Node 是好的。

如果你之前是通过原生安装器或其他方式安装 Claude Code，不确定 Node 环境，可以先运行node -v确认。版本太低的话，部分脚本可能跑不起来。我自己的经验是 Node 18 以上基本没问题，但如果提示语法错误，优先升级 Node。

2.3 网络和 GitHub 访问是隐藏大坑

git clone需要能正常访问 GitHub。国内网络环境下，这一步偶尔会因为网络波动卡住。遇到 clone 超时，可以换git clone https://ghproxy.com/https://github.com/obra/superpowers.git这类镜像方式，或者多试几次。当然这只是网络层面的问题，和 superpowers 本身无关。

不想用镜像的话，也可以直接去 GitHub 页面把仓库打包下载，只是更新的时候会麻烦一点。我个人建议尽量用 git 方式安装，因为后续superpowers update之类的更新操作依赖它。

2.4 了解它会动哪些目录

安装前我说一下它大概会改什么，免得你担心：

• 会往~/.claude/skills或你配置的 skills 目录写入技能文件夹；
• 会在~/.claude/commands里注册一些斜杠命令；
• 可能还会生成一个临时目录用于构建技能索引。

以上都属于用户配置目录，不影响系统文件。如果你在团队环境里，也可以提前把超级技能目录指到共享位置，方便多人同步。

3. 安装 superpowers 的完整步骤与目录拆解

3.1 官方脚本一键安装

安装其实并不复杂。先打开终端，然后执行：

git clone https://github.com/obra/superpowers.git cd superpowers ./install.sh

安装脚本跑完后，可以输入/superpowers或直接问 Claude Code 一句“你现在有哪些 superpowers 技能”，如果能回复出技能列表，就说明装好了。

这里有一个容易被忽略的细节：install.sh 执行前最好给脚本加上执行权限。有些系统直接运行会提示 Permission denied，这时先chmod +x install.sh再执行。

提示：安装脚本可能会让你选择安装位置，如果你之前手动配置过 CLAUDE 的 skills 目录，这里要注意保持路径一致。否则会出现“技能明明装了但 Claude 找不到”的假性故障。

3.2 手动安装方案：适合喜欢掌控一切的玩家

如果你不放心一键脚本，手动安装也很简单。本质上就是把仓库里的 skills 复制到 Claude Code 的 skills 目录。

git clone https://github.com/obra/superpowers.git mkdir -p ~/.claude/skills cp -r superpowers/skills/* ~/.claude/skills/ cp -r superpowers/commands/* ~/.claude/commands/

复制完成后，重启 Claude Code 会话，技能就会被自动扫描到。

手动安装的好处是你可以只挑自己需要的技能文件夹放进去，减少 Claude 检索时的负担。比如你很少做电子书相关的任务，那就不复制epub之类的技能文件夹。

3.3 安装后的目录结构长什么样

装完之后，你可能会想看看它到底放了些什么。默认情况下，~/.claude/skills下会多出很多目录，每个目录都代表一个技能。一个标准技能目录大致是：

skills/ ├── project-management/ │ ├── SKILL.md │ ├── templates/ │ │ └── project-plan.md │ └── reference/ │ └── definition-of-done.md ├── svg-illustration/ │ ├── SKILL.md │ └── examples/ │ └── timeline.svg └── ...

看懂这个结构后，你就能明白 superpowers 为什么叫“技能库”而不是“提示词集合”。它有主文件，有辅助资源，Claude Code 需要深入执行某个具体任务时，会层层往下查阅。这种分层结构让复杂技能也能保持清晰。

3.4 验证安装成功的最快方式

安装完先别急着开始干活，做一次快速验证：在 Claude Code 里输入/superpowers或者用自然语言问“请列出你现在可以调用的 superpowers skills”。

如果安装没问题，Claude 会把技能列表按目录名称列出来。这时候你随便挑一个，比如让它用project-management技能拆解一个虚构项目，看它是否主动读取SKILL.md。如果只回复一段泛泛的文本而没有进入工作流状态，多半是技能没有被正确加载。

4. 内置 Skills 都有哪些？一组亲测好用的分类清单

4.1 按使用场景给 superpowers 技能分个类

superpowers 的 skills 数量不少，官方仓库的 README 里列得很全。我这里不打算逐条念列表，而是按我的实际使用频率把这些技能重新组织一下，你会发现它远不只是写码工具。

首先是“通用做事类”，包括 brainstorming、critique、todo-tracking、decision-making 这类。这类技能适合任何项目，也是我最常调用的。比如 brainstorming 技能会引导 Claude 先发散再收敛，而不是一上来就给你一个自嗨方案。

其次是“开发交付类”，比如 coding、debugging、test-driven-development、running-development-servers、writing-plans-and-specs。这些对应的是一个软件工程师日常最琐碎的部分。有了它们，Claude Code 能更规范地进入编码流程，而不是每次都追问你没头没尾的问题。

然后是“内容创作类”，包括 svg-illustration、pdf-generate、pdf-input-output、generate-smart-little-bots、interactive-games 等。这组技能很适合做原型演示、画架构图、生成文档，甚至快速搭一个浏览器小游戏。

最后是“管理治理类”，比如 project-management、speaking-with-superpowers、safety-and-security-research。这类主要负责流程规范、沟通风格和敏感操作约束。

4.2 最值得先试的 5 个技能

如果你刚装好，不知道从哪里下手，我建议按这个顺序尝试：

这五个技能全部试过一遍，大概就能理解 superpowers 的设计逻辑：它不替你决定结果，但它确保过程靠谱。

4.3 技能之间可以组合使用

superpowers 真正爽的地方不在于单个技能，而在于技能之间的编排。我举一个自己组合过的例子：先用brainstorming技能确认功能方向，再用project-management技能拆解版本计划，随后用svg-illustration技能画一张系统流程图，最后用pdf-generate把方案文档生成 PDF。

这样一条流水线下来，Claude Code 的工作风格非常稳定。你只管提供输入，它自动调用对应技能。组合使用的时候，注意明确告诉它“先调用哪个技能，再做哪个”。虽然 Claude 具备自动选择技能的能力，但多技能串联时人工给一个顺序，准确率会高不少。

5. 怎么真正引入和触发这些技能：从命令到自然语言

5.1 通过斜杠命令直接打开技能菜单

安装完成后，你可以在 Claude Code 的输入框里直接输入/superpowers。这个命令会调出一个可视化菜单，里面列出了当前可用的技能。你可以直接点击技能名，也可以继续用键盘输入筛选。

菜单方式适合你还没想清楚任务怎么描述的时候，先去技能列表里逛一圈。它会帮你提示“哦，原来还有这种姿势”。但如果你知道自己要干嘛，自然语言触发反而更快。

5.2 在对话中用自然语言让 Claude 自动选技能

superpowers 的技能触发并不强制要求你输入特定魔法词。Claude Code 会根据当前上下文自动判断是否需要读取某个技能文件。

比如你直接说“帮我用 superpowers 的 svg 技能画一个 TCP 三次握手时序图”，它就会去svg-illustration目录查找并使用该技能。这种方式的体验非常接近“给 AI 装上专业人设”，你不用记任何 API。

不过要注意一个细节：技能名字和目录名不一定完全对应。比如svg-illustration，你如果在对话里说“画个图”，Claude 可能也会去读这个技能，取决于它的判断。想要更精准，就在需求里带上技能关键字。

5.3 让技能主动“现身”的配置技巧

还有一种引入方式是直接在系统提示词或项目配置里声明技能偏好。比如你在项目的CLAUDE.md里加上一句“在开始设计前，优先读取 brainstorming 技能”，那么每次新会话都会自然继承这条规则。

这对团队项目特别有用。一个人配置好，整个团队的 Claude Code 行为都会统一。我是这么做的：在项目根目录的CLAUDE.md里写清楚“涉及方案设计时调用 brainstorming，涉及计划拆解时调用 project-management”，团队协作时明显少了很多来回校准的时间。

5.4 新会话中技能加载失败的处理方式

有时装完技能，新会话却一直说“找不到技能”。这不一定是安装失败，更常见的是缓存问题。我遇到过几次，解决办法很简单：

• 确认~/.claude/skills下确实有对应技能的文件夹；
• 完全退出并重启 Claude Code；
• 使用/context或者/status查看当前会话是否加载了技能目录；
• 如果还不行，检查是否有多个 Claude 配置目录，可能技能装到了另一个用户环境里。

绝大多数“技能不生效”的问题，都能通过重启会话解决，不用急着重装。

6. 实战演示：用 superpowers 30 分钟跑通一个 SVG 示意图任务

6.1 任务目标与输入

直接说理论太干，我拿一个真实做过的小任务演示：要把一个“用户从下单到支付”的业务流程画成一张清晰的技术方案图，最终输出 SVG 文件。

这个任务如果纯靠普通 prompt 让 Claude 画，经常会出现图层错乱、字体丢失、配色难看等问题。但调用 superpowers 的svg-illustration技能后，Claude 会先读取技能文档，再按文档规范生成代码。

我的输入很简单：

请调用 superpowers 的 svg-illustration 技能，画一张用户下单到支付的时序图，要求横向排列，适合放进技术方案文档。

6.2 Claude 使用技能时的行为变化

如果你观察 Claude Code 的日志，会发现在回答了“好的”之后，它并不是直接输出 SVG 代码，而是先读取了svg-illustration的SKILL.md和相关的示例文件。读完后，它的输出格式明显更规范了：先给出版式策略，再设定主要元素定位，最后写 SVG 代码。

这是 superpowers 最迷人的地方。技能文件里通常写了很多实用约束，比如“使用命名颜色”“保持图标简洁”“优先用 2 的倍数作为坐标”等。这些约束极大地减少了返工率。

6.3 最终产物和我的微调建议

第一次生成的 SVG 已经能看，但我会让它追加修改两处：一是把流程箭头改成圆角箭头，二是把每个节点下方加上简短说明文字。这些追加需求不需要重新触发技能，直接在原有对话里继续，Claude 会参考之前读取过的技能上下文继续处理。

整个任务大约耗时 30 分钟，其中大部分时间花在我微调审美上。换成以前纯手写 SVG，这个流程至少要半天。

7. 进阶操作：自定义一套属于自己的 superpowers 技能

7.1 一个技能文件里最重要的三样东西

除了用现成的技能，superpowers 最大的价值是让你能低成本地创造新技能。我大概花了一个下午搞清楚怎么写，核心就三样东西：

• 技能目录名：建议用横线分隔，比如weekly-report；
• SKILL.md文件：开头写清楚这个技能在什么场景触发、解决什么问题、有哪些步骤；
• 参考文件：比如模板、示例、脚本，放在子目录里。

当 Claude Code 判定任务匹配时，它会先读SKILL.md理解流程，再用辅助文件细化执行。

7.2 一个可复用的 SKILL.md 写作模板

我不藏私，直接给一个我常用的基础模板：

--- name: 周报生成 description: 当用户需要将本周工作内容整理成周报时使用本技能。 --- # 周报生成 ## 输入要求 - 用户提供本周完成的事项列表 - 缺少信息时主动询问，不要猜测 ## 执行步骤 1. 将事项按“项目/日常/学习”分类 2. 每类事项生成一句话结果描述 3. 标注重要事项和待办事项 4. 输出 Markdown 格式周报 ## 输出格式 - 包含标题、日期、分类清单、下周计划

把这个文件放到~/.claude/skills/weekly-report/SKILL.md，下次再让 Claude 生成周报，它就会自动按这个流程走。比起每次复制粘贴 prompt，这种技能文件可以长期维护。

7.3 把技能分享给整个团队

创建完技能后，可以把整个技能目录丢到团队的共享仓库里。成员各自 clone 或者同步到自己的~/.claude/skills即可。这样的好处是，团队的 prompt 沉淀不再散落在聊天记录里，而是集中成了可版本管理的“团队操作手册”。

团队多人同时开发自定义技能时，建议给每个技能加上 owner，避免两个人往同一个技能文件里塞完全不同的规则。

7.4 更新和卸载技能

更新 superpowers 的方式很简单：如果是 git 仓库安装的，进入仓库目录执行git pull origin main，然后再跑一次./install.sh同步到 Claude 配置目录。卸载则更直接：把~/.claude/skills下对应技能目录删掉，再重启 Claude Code 即可。

有一点需要小心：如果你已经写了自定义技能，不要直接用仓库里的某次强制同步覆盖整个skills目录，否则自定义技能会丢失。建议自定义技能放在单独的目录，比如~/.claude/skills/custom/，和内置技能分开管理。

8. 常见问题、排查链路和我踩过的三个坑

8.1 技能没被触发：先检查路径再检查描述

遇到技能没被触发，我第一反应是看路径，第二反应是看需求描述。路径错了，Claude 扫不到；需求描述太模糊，Claude 不认为它需要读技能文件。比如你说“帮我规划项目”，它可能不会去读 project-management，但你说“使用 superpowers 的项目管理技能，把 0-FAQ 拆成可执行阶段”，基本会稳定触发。

8.2 不要同时安装多个相互冲突的技能

superpowers 里有些技能是针对同一类任务的同类方案，同时有两个会互相干扰。一次我给 Claude Code 同时加载了svg-illustration和另一个画图类技能，结果生成图时 Claude 不知道选用哪套规范，输出风格混乱。现在我只保留一个画图技能，并明确在CLAUDE.md里指定默认使用 superpowers 的那套。

8.3 自定义技能里命令和脚本不要写死绝对路径

如果你在技能里写了类似/Users/me/scripts/build.sh的绝对路径，换个环境就废了。最好在SKILL.md里说明路径的相对位置，或者让 Claude 通过环境变量定位。我把自己的技能都改成了相对项目根目录的写法，之后在同事机器上复现也极少出问题。

8.4 安装后如果报错找不到命令

部分电脑执行./install.sh会提示superpowers: command not found。这个主要是因为安装脚本没有把命令目录加到 PATH 里。手动执行一下安装脚本最后提示的 export 语句就能解决。不过在日常使用中，其实很少需要在终端跑 superpowers 命令，大部分功能都通过对话触发，所以对这个报错不必太焦虑。

9. 我最常被问到的一个问题：它会让 Claude Code 变“重”吗

装了这么多技能后，会不会拖慢 Claude Code 的响应速度？这是身边人问得最多的问题。我的实际体感是：Claud Code 在每次对话时并不会把所有技能都读一遍，它只会在需要时加载对应的SKILL.md。所以日常问答响应速度和没装之前基本没有区别。

但有一点感受很真实：当 Claude 读取了重量级技能（比如 project-management）时，首轮思考时间会长一点点，因为文件里包含不少策略。不过它会把这些策略转化为稳定的输出，少掉很多来回，总体时间反而更省。

如果你真的有洁癖，也可以只装自己最常用的三个技能，其余不复制进 skills 目录。毕竟这是一套灵活体系，没必要全盘照收。

从我自己的体验来说，superpowers 让 Claude Code 从“问答工具”变成了一个能稳定干活的下属。你不需要每次事无巨细地交代流程，只要告诉它目标，它会自觉打开正确的工作手册。如果你已经对每天重复敲同样提示词感到疲倦，那花 30 分钟装一套技术框架，长期来看绝对划算。