最近在 AI 工具圈里，superpowers 这个词出现的频率高得吓人。它不是某个软件的名字，也不是一套开源库，而是一个专门给 Claude.ai 做“技能扩展”的项目，来自老牌 Perl 社区开发者 Jesse Vincent（网名 obra）。很多人第一次看到这个项目时都有个疑问：Claude 本身不是已经什么都能干吗，为什么还需要“技能”？这个问题我一开始也有，真正用起来才明白，再强的模型也需要一份“说明书”。
superpowers 做的事情，一句话概括：让 Claude 通过“在项目里安装技能文件”的方式，获得一系列专门化的能力。你可以把它理解成一个技能市集，里面有处理时间的、画思维导图的、填 PDF 表单的、写特定风格小说的，各式各样的 skills 任你挑选。安装方式也很特别，不需要你写一行代码——你把一段安装指令粘进 Claude 项目的自定义指令里，然后在对话里告诉 Claude“帮我装个 XX 技能”，它就自己去技能仓库把文件拉下来，放进项目的知识库里，下次对话直接生效。
下面把我从“听说过 superpowers”到“日常离不开”的完整过程写下来，包括安装步骤、值得装的技能清单、实际使用效果，以及我踩过的几个坑。给想试但不知道怎么上手的朋友当一份操作参考。
1. Superpowers 到底是什么，它解决什么问题
1.1 传统提示词工程的痛点
先说说没有 superpowers 之前，让 Claude 干专业活的痛苦。举个例子，我想让 Claude 定期帮我做日期推算，比如“下个季度最后一个工作日的下午三点是哪天”。这种需求 Claude 不是不会，而是每次都要你在提示词里把规则讲清楚：要关心时区、要跳过法定节假日、要区分工作周和自然周。这些规则我每次都得复制粘贴一大段，一旦对话太长，Claude 还会把约束条件忘掉，输出结果越来越飘。
再比如我想让 Claude 输出一张思维导图。你直接在对话里说“画个思维导图”，它大概率会给你一段用文本表达的流程图代码，效果时好时坏，风格也不统一。这背后的本质问题是：大模型的能力是“通用”的，但实际干活需要的是“专精”——你得给它一套清晰的操作规范、输出格式、边界条件，它才能稳定地复现同一个结果。这种“规范”如果每次都要用自然语言重新描述，既不高效也不稳定。
1.2 核心机制：SKILL.md 与技能目录
superpowers 把上面这套“规范”做成了标准化的技能文件，核心是一个叫 SKILL.md 的 Markdown 文档。每个技能在 GitHub 仓库里占据一个目录，目录里除了 SKILL.md，还可以附带脚本、模板、示例资源。SKILL.md 的头部有一段元信息，记录技能的名字、描述、适用条件；正文部分则写清楚这个技能负责什么、在什么情况下调用、输出格式是什么、有什么注意事项。
技能装进 Claude 项目后，项目知识库里就多了一份“工作手册”。以后对话时，只要你的请求命中某个技能的描述，Claude 就会自动去读对应的 SKILL.md，按照里面的指引来干活。这有点像给员工发了一本岗位 SOP——不用每次重新培训，照着手册执行就行。技能的输出之所以稳定，不是因为模型变聪明了，而是因为模型拿到了一份写得足够具体的操作流程。
1.3 为什么它突然流行起来
superpowers 能火，我认为有三个原因。第一是时机好，Claude 的 Projects 功能和 Artifacts 功能正好成熟，技能文件能持久地存在项目知识库里，并且能生成可视化内容，这给技能落地提供了基础设施。第二是分享成本低，技能就是 Markdown 加一点资源文件，任何人 fork 一下仓库就能改出自己的技能，社区的贡献门槛非常低。第三是做事的人靠谱，obra 在开源圈闯荡多年，做过不少知名项目，大家对他的工程质量有基本信任。综合下来，一个“低门槛、强规范、有公信力”的生态就这么长起来了。
2. 动手安装：从零到第一个技能生效
2.1 安装前的准备
先说前提条件。superpowers 面向的是 Claude.ai 的用户，需要你有 Claude 的订阅账号（Pro 或者 Max 套餐都行），因为整个安装流程依赖 Projects 项目和 Artifacts 功能，这两个功能目前是需要订阅才能用的。免费用户可能没法用，这一点要先有心理准备。
另外，不需要会写代码。整个安装过程里你做的事情基本就是：复制、粘贴、说一句“帮我安装”。真正把技能文件写进项目的是 Claude 自己，你只负责指挥。我用的是网页版，桌面版和移动端的操作逻辑类似，但按钮位置会有些差异。
2.2 安装步骤详解
我以当时用的流程为例，一步步说。界面按钮的位置可能随着版本更新有变化，但整体逻辑不会变。
第一步，打开 superpowers 的官网（superpowers.obra.dev）。网站首页会展示不同产品的接入方式，找到 Claude.ai 那一栏，复制对应的安装指令。这段指令说白了就是一段比较长的自定义说明，里面写了 superpowers 是什么、技能仓库在哪里、安装技能要走什么流程。
第二步，去 Claude.ai 后台新建一个项目。注意，一定要新建项目，不要直接在普通对话里操作，因为技能需要存放在项目的知识库里。项目相当于一个独立的工作空间，技能只对当前项目内的对话生效。
第三步，打开项目的设置，找到 Custom Instructions（自定义指令）那一栏，把官网给的那段安装说明整个粘贴进去。这段说明本质上是给 Claude 的“初始化手册”，它告诉 Claude 什么是 superpowers、去哪里找技能仓库、以及如何把技能文件安装到项目里。这一步是整个流程最关键的地方，也是出错率最高的地方。
第四步，保存设置，然后回到这个项目新建一个对话。在对话框里直接输入类似“请帮我安装 superpowers”或者“安装技能系统”这样的指令。Claude 读取了自定义指令后，会理解你的意思，开始执行安装流程。
第五步，安装过程需要一点时间。Claude 会读取技能仓库的目录结构，然后把一组技能文件逐个写入项目知识库，这个过程通常以打印出“技能就绪”或者类似的状态信息结束。视网络和项目情况，从几十秒到几分钟不等。
第六步，验证安装。最直接的办法是问 Claude：“你现在拥有哪些技能？”如果安装成功，它会列出一份技能清单；你也可以随便让 Claude 用某个技能做一件小事来测试。
注意：整个流程里最容易出错的地方是第三步。很多人把安装说明粘贴到了对话里，而不是项目设置里的自定义指令栏。那样的话 Claude 只能在这一轮对话里“知道” superpowers，换一个对话就忘了，技能自然装不上。
2.3 第一次安装后的检查确认
安装完不要急着用，先花两分钟做三件事。
第一，确认项目知识库里有技能文件。在项目设置里找到知识库的入口，应该能看到新增的技能文件或者技能目录。这就相当于“文件真的落盘了”的证据。
第二，确认技能能自动调用。找一个明显的技能测试，比如让 Claude 告诉你“今天的日期加上 90 天是几号”。如果它直接给出正确答案，而不需要你提示“请使用时间技能”，说明技能的自动触发机制是正常的。
第三，确认范围。这一个项目里装的技能只在这个项目内生效，其他项目不会共享。如果你希望技能用于所有工作场景，就给每个需要的项目都装一遍，或者干脆开一个专门装技能的“工具箱项目”，需要时切过去用。
3. 有哪些值得装的 skills，以及怎么用
superpowers 的技能分很多类。我个人把常用的整理成了“基础工具型”“效率增强型”“创意趣味型”三类，分别说一下。
3.1 基础工具型技能：让 Claude 更可靠
这类技能解决的是“模型天然短板”的问题，最典型的是 datetime 和 spellcheck。
datetime 技能是我安装后用得最多的一个。模型对时间其实是“没有感觉”的，它不知道今天是周几，也不知道“下个月第三个星期二”这种相对日期怎么算。装了 datetime 之后，Claude 会调用技能里提供的时间计算逻辑，把日期换算做得非常准确。实测下来，我拿它做项目排期、写“截止到 X 月 X 日”之类的文案，再也没有出现过日期错位的低级错误。
spellcheck 技能适合写英文内容的朋友。它给 Claude 一套完整的校对流程：先检查拼写，再检查标点和大小写，最后按优先级列出修改建议。以前你让 Claude 随便“检查一下错别字”，它会一边改一边悄悄改变你的措辞；而 spellcheck 会严格限制它只改错误、不改表达，这个边界感非常重要。
markdown 技能属于“输出规范类”。它规定了 Claude 在生成 Markdown 文档时该遵循的标题层级、列表规范、表格写法，特别适合技术文档和团队协作。有了统一输出格式，Claude 交上来的东西基本可以直接用，不用二次整理。我写项目文档的时候会专门开一个装了 markdown 技能的项目对话，让 Claude 一口气把要点结构化，效率高很多。
3.2 效率增强型技能：把想法变成可交付物
mind-map 技能比较惊艳。你给它任何主题，它会生成一张结构化的思维导图，并且遵循一套一致的布局规则。和直接让 Claude“画个图”不一样的是，装了技能之后它输出的图是稳定的，你甚至可以要求它在现有图上继续扩展节点。我开头脑风暴会的时候，已经把“让 Claude 把我的想法整理成导图”变成了固定动作，散会前就能拿到一张清晰的思路图。
flowchart 技能和 mind-map 类似，区别在于它专注流程图。它会把流程拆成分层级的节点，生成带方向的流程图。这个技能在做业务流程梳理的时候很省事，前提是你在对话里把流程步骤描述得足够清楚。比如我描述“用户注册、手机号校验、创建账号、跳转主页”，它就能画出一张标准的分支流程图，改起来也方便。
pdf-fill-form 技能适合处理纸质表单。你上传一个 PDF 表单，它能读出表单的字段结构，然后用规范的方式帮你填进去，字体、边距这些细节都能保持稳定。这个技能比较小众，但用到的时候很救命——比如批量填报销单、登记表这类重复性劳动，能省下大量时间。我第一次用的时候还担心它会把格式搞乱，实际测试几份之后发现比在线表单工具还顺手。
image-rasterizer 技能解决的是“矢量图转图片”的问题。Claude 生成的图表默认是矢量格式，很多普通用户不知道怎么转成常见的图片格式用。这个技能告诉你如何用最稳妥的方式把图转成位图，保证转换后不乱码、不变形。我写文章配图的时候经常用到，尤其是思维导图和流程图要插入文档里的场景。
3.3 创意与趣味型技能：AI 也能很有个性
这一类对生产可能没那么重要，但体现了 superpowers 更有意思的一面。
haiku 技能让你快速获得规范的俳句——三行、特定的音节结构，内容还要有意境。写标题、写文案卡壳的时候，让 Claude 来几句俳句找灵感，效果意外地好。我有次给活动想宣传语，憋了半天没头绪，让它生成几组俳句，从里面提炼关键词，宣传语很快就出来了。
eliza 技能会召唤一个经典的心理治疗机器人，它用反问句和人对话，模拟早期自然语言处理的交互方式。这个东西更像一个彩蛋，用来给朋友演示 AI 的历史很有意思，也是理解“对话式 AI 从哪来”的一个活教材。
calligraphy 技能让 Claude 用字符拼出大字标题，比如用符号排列出“HELLO”。这种技能基本没有实用价值，但会在你做海报、做视频封面的时候，给你一点视觉上的灵感。程序员可以用它快速生成代码注释区的装饰标题，效果还挺有个性。
dark-fantasy 这类偏风格的技能，本质上是把一整套世界观和文风打包成了一本“风格手册”。Claude 装了这个技能后写作会明显带着黑暗奇幻的味道，遣词造句、角色设定都有固定倾向。对小说创作者来说，这种“一键切换文风”的能力，比在提示词里反复描述“要哥特一点、暗黑一点”靠谱得多。
3.4 怎么批量引入技能包（Collections）
单个技能一个个装太慢，superpowers 也提供了“技能包”的概念，社区里叫 Collections。一个技能包就是一组技能的合集，通常围绕某一类工作场景打包。比如有面向创意写作的包，里面装满风格类、描写类的技能；有面向学习研究的包，里面是笔记整理、文献摘要类的技能；还有面向项目管理的包，侧重任务拆解和进度跟踪。
安装技能包的方式和安装单个技能一样，在对话里告诉 Claude“帮我安装 XX 技能包”就行。Claude 会读取技能包清单，把包里的所有技能一股脑装进项目。我个人建议新手先装基础包，用几天再按需扩充，别一次装十几个技能，不然 Claude 在技能选择上会犯选择困难症，而且项目知识库文件太多也会影响响应速度。技能这东西在精不在多，找到真正覆盖你高频需求的几个，比堆数量重要得多。
4. 常见问题与排查技巧实录
4.1 安装不生效、提示找不到技能
这是我见过最多的求助情况，问题几乎都出在安装指令粘贴的位置不对——把安装说明当成普通对话发给了 Claude。安装指令的正确去处是项目设置里的 Custom Instructions 栏，不是聊天输入框。放在对话里，重启新对话就“失忆”了；放在自定义指令里，它在项目里的每次对话开始时都会生效。
还有一种情况是粘贴进去了但没触发。自定义指令只是让 Claude “知道”，你还要在对话里明确说“请执行安装”。这就好比给了员工一本手册，你得说一句“现在按手册办”，他才会动起来。我见过不少朋友把指令粘好之后就开始直接问“你能干什么”，Claude 当然只会按普通对话回复，自然就卡住了。
最后一个比较隐蔽的问题：项目知识库没有刷新。有时候技能文件写进去了，但 Claude 在同一个对话里还没有把新文件纳入索引，所以它嘴上说“已经安装”，实际用的时候却像没装一样。我的解决办法是先开一个新对话再测试，给知识库刷新留出时间。
4.2 技能与项目内其他指令冲突
当一个项目同时有自定义指令、多个技能文件，还有你上传的参考资料时，Claude 面对的“信息来源”就太多了。技能 A 说“输出要简洁”，技能 B 说“输出要完整”，参考资料里又写着“格式必须用表格”，Claude 很容易无所适从，最后给你一个四不像的结果。
我的经验是给技能划分明确的触发场景。在 SKILL.md 里写好“当用户请求与 XX 相关时，才激活本技能”，避免两个技能同时响应同一个请求。同时在项目自定义指令里加一句兜底的优先级说明，比如“如果技能之间出现冲突，以更具体的一项为准”。其实这就和我们带团队一样，职责分工清楚了，执行力自然就上来了。
4.3 好用的技能自己改：本地化与再造
superpowers 最让我喜欢的一点是它完全开放，技能文件就躺在你的项目里，本质上是 Markdown 和少量脚本。你可以直接让 Claude“打开某个技能的 SKILL.md”，然后按你的需求修改。
举个例子，官方很多技能是英文写的，触发提示词也是英文优先。我让 Claude 把几个常用技能的职责描述改成了中文，并且加了一条“如果用户用中文提问，优先用中文输出结果”。改完技能就变成了“中文版特供”，用起来顺滑很多。
再比如 image-rasterizer，我嫌它的默认图片尺寸不合适，直接要求它把输出分辨率改成适合公众号封面的大小。整个过程我没有写一行代码，全靠对话完成——因为技能文件本身是文本，Claude 自己就是最擅长改文本的“程序员”。你可以这么理解：superpowers 的技能不是买来就不能动的商品，而是可以自己改装修的房子。
4.4 常见问题速查表
| 症状 | 常见原因 | 解决办法 |
|---|---|---|
| 安装后技能不生效 | 指令粘贴到了对话而非项目自定义指令 | 移入项目设置的 Custom Instructions 栏 |
| 要求装技能但 Claude 无反应 | 没有明确下达“执行安装”指令 | 在对话里说“请帮我安装 XX 技能/技能包” |
| Claude 说装好了但用不了 | 知识库索引未刷新 | 新开一个对话再测试 |
| 多个技能同时抢活 | 技能职责重叠 | 精简技能数量，明确各自触发条件 |
| 技能输出英文 | 技能描述偏英文优先 | 让 Claude 修改 SKILL.md，增加中文输出规则 |
| 项目对话越来越慢 | 技能文件太多，上下文负担重 | 只保留高频技能，其余按需再装 |
我个人用了这段时间最深的体会是：superpowers 的真正价值，其实不是某一个技能本身，而是它把“给 AI 配置能力”这件事从“写提示词”升级成了“装软件”。以前我想让 Claude 稳定干一件事，得反复打磨一大段提示词，换项目就得重来；现在直接装技能，项目之间还能复制，思路完全不同了。
最后再分享一个小技巧：别把技能只当成“官方出品”来使用。社区里每天都有新技能冒出来，你完全可以看别人的思路，然后让 Claude 根据你自己的工作流定制一个专属技能。我最近就做了一个给自己用的“周报生成”技能，把周报的结构、语气、数据来源都写死在 SKILL.md 里，每周五只需要说一句“生成这周的周报”，一分钟出稿。这种感觉，才是 superpowers 最让人上瘾的地方。
 插件开发实战：从零写一个自动调用 Codex 的插件)
