如果你也在用 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 个技能如果你刚装好不知道从哪里下手我建议按这个顺序尝试技能一句话说明我用它做什么project-management把目标拆成阶段、任务和验收标准让 Claude 根据一句话需求生成完整的项目规划svg-illustration用代码生成可缩放的 SVG 示意图画架构图、流程图、饼图手残党救星brainstorming结构化地发散想法产品命名、方案选型、澄清需求debug-with-tracing一步步追查 bug 根因不瞎猜把难缠的运行时问题拆成可执行排查步骤pdf-input-output读写 PDF 并保持排版把分析报告输出成带格式的 PDF 文件这五个技能全部试过一遍大概就能理解 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-reportSKILL.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 分钟装一套技术框架长期来看绝对划算。