1. 先搞清楚Superpowers是什么先聊点实际的。你在网上搜superpowers搜出来的东西很杂有漫画、有健身课程、有励志鸡汤。但如果你看到的是跟skills、安装、引入技能这些词绑定在一起的内容那大概率说的是给AI助手用的那套Superpowers技能包——网上现在热度很高的Claude Skills扩展集合。我第一次见到这玩意儿是在一次偶然的机会翻到一个开发者的工作流分享他管自己的AI叫加了Buff的助手能直接处理PDF、能做表格、能抓网页、还能生成思维导图。当时我还在手动复制粘贴上下文看完他的演示直接破防。后来自己装上试了一圈发现这东西本质上就是一套基于Markdown写成的技能说明书让AI在一个特定方向上表现得像一个专职助手而不是一个什么都会一点的万金油。这套Superpowers具体能干什么我用一句话给你说清楚它就是给AI助手预装了一整套岗位职责说明书每份说明书对应一个具体能力比如做PPT、剪视频、处理Excel、画图表、写SQL、做二维码AI读到哪份说明书就切换到对应的工作模式。对普通用户来说你不用再费劲写一长串提示词去描述我要你做什么、按什么步骤做、输出什么格式因为这些已经被整理成了结构化的指令你只需要说一句帮我做一份PDF总结AI就会自动加载对应的技能按里面的步骤干活。这篇文章我不会跟你扯太多虚的直接从它到底是什么设计逻辑讲到怎么装、怎么用、怎么自己改最后再把我踩过的坑全部倒出来。不管你是第一次听说Superpowers还是装了一半卡住了这篇应该都能帮到你。2. 为什么需要这套东西从Prompt到Skills的进化2.1 直接写提示词的痛点在Superpowers出现之前我跟AI协作的日常是这样的想让它处理一个PDF我得先写你是一个专业的文档分析助手请帮我提取这份PDF里的重点内容包括以下三个部分……然后它给我回一段我发现格式不对又补一句请用表格输出它又给我改一版但漏了几个要点我再追问……一轮对话下来光调教就花了不少时间真正干活的效率反而低了。这个问题在圈内有个很形象的说法叫提示词疲劳——你每次让AI干活都要重新把上下文、角色设定、输出要求从头到尾描述一遍。今天要它做表格写一整套Prompt明天要它分析网页又得重新写一整套Prompt。每次都像是带新人带完一波换一波没有沉淀。Superpowers解决的就是这个重复劳动的问题。它的核心思路是把一套固定的、经过验证的工作流程固化成一个文件AI只需要读那个文件就能按部就班地执行。这就像你给新员工写了一份SOP标准作业流程以后凡是遇到这类任务不用再手把手教直接把SOP甩过去就行。2.2 Superpowers的设计核心把怎么做写下来我看过不少类似的技能类项目Superpowers的特别之处在于它不依赖代码纯粹靠自然语言脚本。每个技能就是一个文件夹里面放一个Markdown文件文件开头有一段特殊格式的元信息叫front matter标明了这个技能叫什么、在什么情况下触发、能解决什么问题。剩下的正文部分就是非常详细的、一步步的操作指南。举个具体的例子它的PDF处理技能里面不只是写提取PDF内容这一句话而是把完整的操作链路都写进去了先读取PDF文本再按章节拆分再判断文档类型学术论文、合同、还是产品手册不同类型的文档用不同的总结模板最后输出结构化摘要。这些步骤看起来并不复杂但AI一旦按这个流程走输出的质量就非常稳定不会出现上一秒像个分析师、下一秒像个小学生的割裂感。这个设计逻辑也决定了它的使用门槛极低——你不需要会写代码不需要了解API不需要配置什么服务只要能把文件夹放到指定位置就能生效。对于我这种能动手敲代码、但懒得写复杂工程的人来说这种轻量级方案恰好是最舒服的。2.3 Superpowers适合谁用如果你的使用场景符合下面任意一条那这套技能包对你就有价值经常让AI处理文档比如总结PDF、提取Word内容、整理Excel表格需要AI做结构化输出比如出表格、出图表、出二维码希望AI能接入一些工具能力比如搜索网页、抓取链接内容受不了对话上下文太长导致AI失忆希望每次执行任务都按一个稳定标准来想自己给AI定义一套专属工作流但又不想写代码。反过来如果你只是偶尔让AI帮忙写一句文案、翻译一段话那确实没必要装Superpowers直接用默认聊天模式就够用了。它就是给高频、重复、有固定套路的任务准备的。3. Superpowers具体有哪些Skills一次给你数清楚3.1 按功能分类的全集清单Superpowers目前包含的skills大致可以分成六个大类我按照实际使用频率给你整理一下。注意这个集合是持续更新的不同版本之间可能会有新增和调整但你看到的这些基本上是常驻的核心技能。文档处理类PDF总结、DOCX生成、XLSX制作、CSV分析、PPT生成。这类最实用基本上是办公场景全覆盖。数据与信息类SQL分析、JSON转换、网页抓取、文章转笔记。适合做数据整理和信息收集。内容创作类Blog写作、新闻报道、书籍写作、剧本创作、YouTube视频脚本。写作者应该会比较喜欢这一类。设计与图表类思维导图、二维码生成、Canva设计、ASCII艺术图、信息图表。这类的可视化输出能力很强。多媒体类视频剪辑自动生成时间线描述、音频转写、图像处理。适合做自媒体的人。效率工具类时间管理、待办清单生成、邮件草拟、法律文书起草、合同审查。日常办公也能用上。3.2 几个我常用的核心技能详解PDF总结是我用得最多的技能。以前我处理一份二十页的学术论文光是读就要十几分钟让AI总结又怕它抓不住重点。用了这个技能之后它会先把文档结构拆开按章节生成摘要再汇总成三个层次一句话概括、关键论点列表、详细内容大纲。如果文档里有数据表格它还会单独把表格提取出来做成可读性更好的Markdown表格。网页抓取技能也很实用你给它一个URL它会先尝试直接读取页面内容如果出现登录墙或者动态加载就会调用搜索接口找缓存版本。这个技能我用来做竞品信息收集比较多比如我需要了解几个同类产品的定价策略给它几个链接它就能整理成对比表格。思维导图技能输出的是结构化的Markdown缩进列表可以直接导入XMind或者MindNode使用。它特别擅长把一个模糊的主题逐级拆解比如你输入做一个关于新能源车市场分析的思维导图它会把市场概况、政策环境、主要玩家、技术路线、消费者偏好、未来趋势全部分层列出来逻辑很清晰。SQL技能解决的是从数据到答案的最后一公里问题。它会先根据你的问题判断需要哪张表、做哪些筛选和聚合然后生成SQL语句并附上执行逻辑说明。我虽然会写SQL但遇到复杂的嵌套查询还是得想半天拿这个技能做草稿再人工校验效率高很多。3.3 技能分类选择建议如果你第一次安装不想全部启用我建议按这个思路选办公族PDF总结、DOCX生成、XLSX制作、邮件草拟。内容创作者博客写作、脚本创作、思维导图、Canva设计。开发者SQL分析、JSON转换、网页抓取、代码审查相关技能。学生党PDF总结、笔记整理、书籍写作、文章转笔记。每个技能占用空间都很小全部装上也无所谓但技能列表太长会略微增加AI的响应选择时间所以按需启用是个好习惯。4. 手把手安装Superpowers三个方法任你挑4.1 方式一一键脚本安装最简单如果你是新手直接按这个来。打开终端Windows用户用PowerShellMac用户用Terminal执行claude install superpowers命令跑完之后Superpowers会自动下载并安装到Claude的配置目录里。装完重启一下Claude在对话里直接输入使用superpowers或者加载技能就能看到技能列表。这个方式最省事适合不想折腾文件结构的用户。但有个前提需要先装好Claude Code这个命令行工具如果你还没装先跑npm install -g anthropic-ai/claude-code装好之后再用上面的命令装Superpowers。整个过程大概两三分钟。4.2 方式二手动下载放到指定目录如果你用的是Claude Desktop桌面客户端或者你用其他支持Agent Skills的AI工具手动放置更通用。步骤如下打开GitHub搜索superpowers仓库官方仓库名是obra/superpowers。点击Code按钮选择Download ZIP下载压缩包。解压之后你会看到里面有一个skills文件夹这里面每一组技能就是一套子技能集合比如skills/pdf、skills/canva。打开Claude的配置目录# macOS/Linux ~/.claude/skills/ # Windows %USERPROFILE%\.claude\skills\把skills文件夹里的内容全部复制到上面的目录里注意是把里面的技能文件夹直接放进去不是把整个skills文件夹套一层。装完之后同样重启Claude再测试一下。4.3 方式三只装你需要的单个技能不想全家桶也可以单点安装。进到Github仓库里找到对应技能的目录只下载那一个文件夹放到~/.claude/skills/下面即可。比如你只想要二维码生成技能就只下skills/qrcode目录放到skills目录下。这种方式我是比较推荐的因为技能包本身在持续更新全量安装以后每次升级都可能出现一些小变化只装自己需要的出问题的概率更小也更容易排查。4.4 验证安装是否成功装完之后别急着用先做个快速验证。在Claude对话里输入请列出你当前可以使用的所有技能如果安装成功它会输出一长串技能列表包括技能名称和对应的功能描述。如果你发现某个技能没有出现在列表里大概率是目录结构放错了或者文件名不对后面我在问题排查部分会细说。5. 怎么真正用好Superpowers从触发到自定义5.1 触发方式与常见指令模板技能装上是一回事会不会触发是另一回事。Superpowers的使用有个要点它靠关键词和意图识别来激活技能不是靠输入指令名称来调用。比如你想用PDF总结技能不需要说调用PDF技能只需要说帮我总结一下这个PDF文件AI就会自动匹配到对应的技能并按里面的流程执行。有几个触发指令模板你可以直接抄作业总结这个PDF文件路径 —— 触发PDF总结技能把这份Excel做成一个漂亮的表格展示 —— 触发XLSX技能抓取这个网页的内容并整理成摘要URL —— 触发网页抓取技能生成一个关于XX主题的思维导图 —— 触发思维导图技能把这段文字做成二维码 —— 触发二维码技能关键技巧是描述你的目标而不是描述操作工具。AI的技能匹配逻辑会更倾向于识别你的意图而不是指令名称。你越接近自然表达匹配越准。5.2 如何编写属于自己的自定义技能用熟了之后你一定会产生一个需求——有些工作Superpowers自带的技能覆盖不到但你有自己的固定套路。没关系自定义一个技能非常简单。新建一个文件夹命名为你的技能名建议小写英文多个单词用横线连接在里面创建一个SKILL.md文件。文件格式如下--- name: my_custom_skill description: 在什么情况下使用这个技能给AI一个清晰的触发信号 --- # 技能名称 ## 工作流程 1. 第一步先做什么 2. 第二步再做什么 3. 第三步按什么格式输出 ## 输出格式 - 用什么结构、什么模板来呈现最终结果 ## 注意事项 - 有哪些边界要避开有哪些细节要强调文件放到~/.claude/skills/目录下重启Claude就能生效。这里的description字段非常重要因为AI就是靠它来判断什么时候该激活这个技能的。描述写得越具体触发越精准。举个例子我自己写了一个周报生成技能description写的是当用户提供本周工作内容列表时自动按照公司模板生成周报包含本周完成、下周计划、风险与问题三个板块。这个描述给AI的信号就很清楚每次我丢一段工作内容给它它就会自动按这个流程整理。5.3 高级用法把多个技能组合成工作流单个技能用好不算本事真正能提升效率的是把多个技能串成一条流水线。举个实际例子我最近做一个市场调研报告用了三个技能组合先用网页抓取技能收集三家竞品的官网信息再用XLSX技能把关键参数整理成对比表最后用思维导图技能把结论拆解成汇报框架。全程我只负责提供链接和提出需求AI按技能规范完成了所有结构化的中间环节。还有一个更常见的组合场景收到一份PDF合同先用PDF总结提取条款再用法律文书起草技能生成风险审查意见最后用邮件草拟技能写一封给法务同事的沟通邮件。一套流程走下来以前要花一上午的活儿现在半小时能出初稿。6. 常见问题与排查技巧实录6.1 问题现象与解决方案对照表我把自己用下来遇到的、以及在社区里看到频率最高的问题整理成一个速查表你遇到问题可以先到这里翻一翻。问题现象可能原因解决方案安装后技能列表为空目录路径不对或文件夹层级多套了一层检查技能文件夹是否直接放在~/.claude/skills/下而不是~/.claude/skills/skills/下部分技能无法触发description字段的描述不够明确AI没识别出意图在触发时更明确地说使用XX技能处理XX或修改描述技能执行到一半中断上下文窗口超长或执行步骤太多拆分子任务一个技能只处理一个大步骤或增加上下文窗口配置自定义技能不生效文件名不是SKILL.md检查文件名必须严格命名为SKILL.md更新后技能失效版本升级后目录结构变化重新clone仓库并对应目录结构覆盖安装在Windows上路径不识别路径分隔符问题使用环境变量%USERPROFILE%代替~6.2 排查思路分享如果你遇到问题但上面表格里没有对应的条目我教你一套通用的排查流程。先看目录结构。百分之八十的技能不生效问题根源都在文件夹层级。正确结构是这样~/.claude/skills/ ├── pdf/ │ └── SKILL.md ├── canva/ │ └── SKILL.md如果出现了skills/skills这种嵌套或者SKILL.md文件放到了子文件夹的子文件夹里AI就找不到。这个检查十秒钟搞定却是最容易被忽视的。再看描述触发词。AI判断该不该用这个技能的唯一依据就是front matter里的description字段。如果你自定义技能的触发词太生僻或者描述内容太抽象那AI大概率会把你的请求当作普通对话处理而不是调用技能。建议描述里把触发场景写具体比如当用户提到撰写会议纪要、整理会议重点时比处理会议相关任务要精准得多。最后看日志。Claude Code支持用--debug参数启动启动后终端会输出详细的调用日志。当你确定某个技能没有生效时跑一条触发指令然后在日志里搜技能名称看它到底有没有被AI注意到。如果日志里连技能名都没出现说明触发词没匹配上改描述如果技能名出现了但执行中断那是技能本身报错去查SKILL.md里的步骤。6.3 我的独家避坑经验最后分享几个常规文档里不会写的经验都是我实测下来的。第一不用装全家桶。我刚入坑时把仓库里所有技能全装上了看起来库很全实际用起来AI在选择用哪个技能这一步会变慢而且偶尔会把相近技能的步骤混在一起用。后来我精简到八个核心技能响应速度和准确度反而提升了。第二自定义技能描述里的负面示例很重要。大多数人在写description时只写在什么情况下用很少写在什么情况下不要用。但我在实测中发现加上一句当用户仅询问概念性问题、不要求实际输出时不要触发该技能能有效减少技能被误激活的概率。这算是个冷门但好用的技巧。第三注意SKILL.md里的步骤要足够详细。这是我自己吃过亏才总结出来的。第一次写自定义技能时我写的是分析客户反馈数据输出洞察结果AI输出的内容非常泛。后来我改成先按时间维度将反馈分组再提取高频关键词再按产品功能点归类最后输出问题严重程度的评分表输出质量直接上了一个台阶。AI的执行质量跟你的步骤详细程度成正比这一点在技能设计上体现得尤其明显。第四版本升级前先备份自定义技能。Superpowers更新时会覆盖整个skills目录如果你自己写过自定义技能升级前先把~/.claude/skills/下面自己创建的那些文件夹复制出来升级完再放回去。我第一次更新时没做备份写了两周的一个自定义技能直接被覆盖了那种心情相信你能体会。7. 从一个技能包到一套个人工作流用了一个多月Superpowers之后我的感觉是这套东西真正的价值不在于它自带的那些技能而在于它让我建立了一种给AI写说明书的思维方式。以前我碰到一个重复性任务第一反应是算了手动弄吧现在我第一反应是能不能把这个流程固化成一个技能。这个转变带来的效率提升远比Superpowers本身那几十个技能大得多。如果你刚接触这个生态我的建议是从PDF总结和网页抓取这两个技能入手用一周时间感受一下什么是结构化输出然后试着把你自己工作中最常做的那件事写成一个自定义技能哪怕只有三个步骤也足以让你理解它的设计逻辑最后再考虑组合多个技能形成工作流比如收集信息→整理数据→输出报告这种完整链路。我个人在实际操作中的体会是这套技能包适合当作一个启蒙工具来用——你可以用它现成的技能解决当下的问题也可以拆解它的SKILL.md文件看看别人是怎么设计一个高质量工作流的。等你看懂了里面的门道写自己的技能就会很自然这时候Superpowers是全家桶还是轻量包都已经不重要了。 
长河君 · 2026/10/8 11:10:38 · 阅读 1.2k Superpowers技能包完全指南：安装、使用与自定义AI工作流
1. 先搞清楚Superpowers是什么先聊点实际的。你在网上搜superpowers搜出来的东西很杂有漫画、有健身课程、有励志鸡汤。但如果你看到的是跟skills、安装、引入技能这些词绑定在一起的内容那大概率说的是给AI助手用的那套Superpowers技能包——网上现在热度很高的Claude Skills扩展集合。我第一次见到这玩意儿是在一次偶然的机会翻到一个开发者的工作流分享他管自己的AI叫加了Buff的助手能直接处理PDF、能做表格、能抓网页、还能生成思维导图。当时我还在手动复制粘贴上下文看完他的演示直接破防。后来自己装上试了一圈发现这东西本质上就是一套基于Markdown写成的技能说明书让AI在一个特定方向上表现得像一个专职助手而不是一个什么都会一点的万金油。这套Superpowers具体能干什么我用一句话给你说清楚它就是给AI助手预装了一整套岗位职责说明书每份说明书对应一个具体能力比如做PPT、剪视频、处理Excel、画图表、写SQL、做二维码AI读到哪份说明书就切换到对应的工作模式。对普通用户来说你不用再费劲写一长串提示词去描述我要你做什么、按什么步骤做、输出什么格式因为这些已经被整理成了结构化的指令你只需要说一句帮我做一份PDF总结AI就会自动加载对应的技能按里面的步骤干活。这篇文章我不会跟你扯太多虚的直接从它到底是什么设计逻辑讲到怎么装、怎么用、怎么自己改最后再把我踩过的坑全部倒出来。不管你是第一次听说Superpowers还是装了一半卡住了这篇应该都能帮到你。2. 为什么需要这套东西从Prompt到Skills的进化2.1 直接写提示词的痛点在Superpowers出现之前我跟AI协作的日常是这样的想让它处理一个PDF我得先写你是一个专业的文档分析助手请帮我提取这份PDF里的重点内容包括以下三个部分……然后它给我回一段我发现格式不对又补一句请用表格输出它又给我改一版但漏了几个要点我再追问……一轮对话下来光调教就花了不少时间真正干活的效率反而低了。这个问题在圈内有个很形象的说法叫提示词疲劳——你每次让AI干活都要重新把上下文、角色设定、输出要求从头到尾描述一遍。今天要它做表格写一整套Prompt明天要它分析网页又得重新写一整套Prompt。每次都像是带新人带完一波换一波没有沉淀。Superpowers解决的就是这个重复劳动的问题。它的核心思路是把一套固定的、经过验证的工作流程固化成一个文件AI只需要读那个文件就能按部就班地执行。这就像你给新员工写了一份SOP标准作业流程以后凡是遇到这类任务不用再手把手教直接把SOP甩过去就行。2.2 Superpowers的设计核心把怎么做写下来我看过不少类似的技能类项目Superpowers的特别之处在于它不依赖代码纯粹靠自然语言脚本。每个技能就是一个文件夹里面放一个Markdown文件文件开头有一段特殊格式的元信息叫front matter标明了这个技能叫什么、在什么情况下触发、能解决什么问题。剩下的正文部分就是非常详细的、一步步的操作指南。举个具体的例子它的PDF处理技能里面不只是写提取PDF内容这一句话而是把完整的操作链路都写进去了先读取PDF文本再按章节拆分再判断文档类型学术论文、合同、还是产品手册不同类型的文档用不同的总结模板最后输出结构化摘要。这些步骤看起来并不复杂但AI一旦按这个流程走输出的质量就非常稳定不会出现上一秒像个分析师、下一秒像个小学生的割裂感。这个设计逻辑也决定了它的使用门槛极低——你不需要会写代码不需要了解API不需要配置什么服务只要能把文件夹放到指定位置就能生效。对于我这种能动手敲代码、但懒得写复杂工程的人来说这种轻量级方案恰好是最舒服的。2.3 Superpowers适合谁用如果你的使用场景符合下面任意一条那这套技能包对你就有价值经常让AI处理文档比如总结PDF、提取Word内容、整理Excel表格需要AI做结构化输出比如出表格、出图表、出二维码希望AI能接入一些工具能力比如搜索网页、抓取链接内容受不了对话上下文太长导致AI失忆希望每次执行任务都按一个稳定标准来想自己给AI定义一套专属工作流但又不想写代码。反过来如果你只是偶尔让AI帮忙写一句文案、翻译一段话那确实没必要装Superpowers直接用默认聊天模式就够用了。它就是给高频、重复、有固定套路的任务准备的。3. Superpowers具体有哪些Skills一次给你数清楚3.1 按功能分类的全集清单Superpowers目前包含的skills大致可以分成六个大类我按照实际使用频率给你整理一下。注意这个集合是持续更新的不同版本之间可能会有新增和调整但你看到的这些基本上是常驻的核心技能。文档处理类PDF总结、DOCX生成、XLSX制作、CSV分析、PPT生成。这类最实用基本上是办公场景全覆盖。数据与信息类SQL分析、JSON转换、网页抓取、文章转笔记。适合做数据整理和信息收集。内容创作类Blog写作、新闻报道、书籍写作、剧本创作、YouTube视频脚本。写作者应该会比较喜欢这一类。设计与图表类思维导图、二维码生成、Canva设计、ASCII艺术图、信息图表。这类的可视化输出能力很强。多媒体类视频剪辑自动生成时间线描述、音频转写、图像处理。适合做自媒体的人。效率工具类时间管理、待办清单生成、邮件草拟、法律文书起草、合同审查。日常办公也能用上。3.2 几个我常用的核心技能详解PDF总结是我用得最多的技能。以前我处理一份二十页的学术论文光是读就要十几分钟让AI总结又怕它抓不住重点。用了这个技能之后它会先把文档结构拆开按章节生成摘要再汇总成三个层次一句话概括、关键论点列表、详细内容大纲。如果文档里有数据表格它还会单独把表格提取出来做成可读性更好的Markdown表格。网页抓取技能也很实用你给它一个URL它会先尝试直接读取页面内容如果出现登录墙或者动态加载就会调用搜索接口找缓存版本。这个技能我用来做竞品信息收集比较多比如我需要了解几个同类产品的定价策略给它几个链接它就能整理成对比表格。思维导图技能输出的是结构化的Markdown缩进列表可以直接导入XMind或者MindNode使用。它特别擅长把一个模糊的主题逐级拆解比如你输入做一个关于新能源车市场分析的思维导图它会把市场概况、政策环境、主要玩家、技术路线、消费者偏好、未来趋势全部分层列出来逻辑很清晰。SQL技能解决的是从数据到答案的最后一公里问题。它会先根据你的问题判断需要哪张表、做哪些筛选和聚合然后生成SQL语句并附上执行逻辑说明。我虽然会写SQL但遇到复杂的嵌套查询还是得想半天拿这个技能做草稿再人工校验效率高很多。3.3 技能分类选择建议如果你第一次安装不想全部启用我建议按这个思路选办公族PDF总结、DOCX生成、XLSX制作、邮件草拟。内容创作者博客写作、脚本创作、思维导图、Canva设计。开发者SQL分析、JSON转换、网页抓取、代码审查相关技能。学生党PDF总结、笔记整理、书籍写作、文章转笔记。每个技能占用空间都很小全部装上也无所谓但技能列表太长会略微增加AI的响应选择时间所以按需启用是个好习惯。4. 手把手安装Superpowers三个方法任你挑4.1 方式一一键脚本安装最简单如果你是新手直接按这个来。打开终端Windows用户用PowerShellMac用户用Terminal执行claude install superpowers命令跑完之后Superpowers会自动下载并安装到Claude的配置目录里。装完重启一下Claude在对话里直接输入使用superpowers或者加载技能就能看到技能列表。这个方式最省事适合不想折腾文件结构的用户。但有个前提需要先装好Claude Code这个命令行工具如果你还没装先跑npm install -g anthropic-ai/claude-code装好之后再用上面的命令装Superpowers。整个过程大概两三分钟。4.2 方式二手动下载放到指定目录如果你用的是Claude Desktop桌面客户端或者你用其他支持Agent Skills的AI工具手动放置更通用。步骤如下打开GitHub搜索superpowers仓库官方仓库名是obra/superpowers。点击Code按钮选择Download ZIP下载压缩包。解压之后你会看到里面有一个skills文件夹这里面每一组技能就是一套子技能集合比如skills/pdf、skills/canva。打开Claude的配置目录# macOS/Linux ~/.claude/skills/ # Windows %USERPROFILE%\.claude\skills\把skills文件夹里的内容全部复制到上面的目录里注意是把里面的技能文件夹直接放进去不是把整个skills文件夹套一层。装完之后同样重启Claude再测试一下。4.3 方式三只装你需要的单个技能不想全家桶也可以单点安装。进到Github仓库里找到对应技能的目录只下载那一个文件夹放到~/.claude/skills/下面即可。比如你只想要二维码生成技能就只下skills/qrcode目录放到skills目录下。这种方式我是比较推荐的因为技能包本身在持续更新全量安装以后每次升级都可能出现一些小变化只装自己需要的出问题的概率更小也更容易排查。4.4 验证安装是否成功装完之后别急着用先做个快速验证。在Claude对话里输入请列出你当前可以使用的所有技能如果安装成功它会输出一长串技能列表包括技能名称和对应的功能描述。如果你发现某个技能没有出现在列表里大概率是目录结构放错了或者文件名不对后面我在问题排查部分会细说。5. 怎么真正用好Superpowers从触发到自定义5.1 触发方式与常见指令模板技能装上是一回事会不会触发是另一回事。Superpowers的使用有个要点它靠关键词和意图识别来激活技能不是靠输入指令名称来调用。比如你想用PDF总结技能不需要说调用PDF技能只需要说帮我总结一下这个PDF文件AI就会自动匹配到对应的技能并按里面的流程执行。有几个触发指令模板你可以直接抄作业总结这个PDF文件路径 —— 触发PDF总结技能把这份Excel做成一个漂亮的表格展示 —— 触发XLSX技能抓取这个网页的内容并整理成摘要URL —— 触发网页抓取技能生成一个关于XX主题的思维导图 —— 触发思维导图技能把这段文字做成二维码 —— 触发二维码技能关键技巧是描述你的目标而不是描述操作工具。AI的技能匹配逻辑会更倾向于识别你的意图而不是指令名称。你越接近自然表达匹配越准。5.2 如何编写属于自己的自定义技能用熟了之后你一定会产生一个需求——有些工作Superpowers自带的技能覆盖不到但你有自己的固定套路。没关系自定义一个技能非常简单。新建一个文件夹命名为你的技能名建议小写英文多个单词用横线连接在里面创建一个SKILL.md文件。文件格式如下--- name: my_custom_skill description: 在什么情况下使用这个技能给AI一个清晰的触发信号 --- # 技能名称 ## 工作流程 1. 第一步先做什么 2. 第二步再做什么 3. 第三步按什么格式输出 ## 输出格式 - 用什么结构、什么模板来呈现最终结果 ## 注意事项 - 有哪些边界要避开有哪些细节要强调文件放到~/.claude/skills/目录下重启Claude就能生效。这里的description字段非常重要因为AI就是靠它来判断什么时候该激活这个技能的。描述写得越具体触发越精准。举个例子我自己写了一个周报生成技能description写的是当用户提供本周工作内容列表时自动按照公司模板生成周报包含本周完成、下周计划、风险与问题三个板块。这个描述给AI的信号就很清楚每次我丢一段工作内容给它它就会自动按这个流程整理。5.3 高级用法把多个技能组合成工作流单个技能用好不算本事真正能提升效率的是把多个技能串成一条流水线。举个实际例子我最近做一个市场调研报告用了三个技能组合先用网页抓取技能收集三家竞品的官网信息再用XLSX技能把关键参数整理成对比表最后用思维导图技能把结论拆解成汇报框架。全程我只负责提供链接和提出需求AI按技能规范完成了所有结构化的中间环节。还有一个更常见的组合场景收到一份PDF合同先用PDF总结提取条款再用法律文书起草技能生成风险审查意见最后用邮件草拟技能写一封给法务同事的沟通邮件。一套流程走下来以前要花一上午的活儿现在半小时能出初稿。6. 常见问题与排查技巧实录6.1 问题现象与解决方案对照表我把自己用下来遇到的、以及在社区里看到频率最高的问题整理成一个速查表你遇到问题可以先到这里翻一翻。问题现象可能原因解决方案安装后技能列表为空目录路径不对或文件夹层级多套了一层检查技能文件夹是否直接放在~/.claude/skills/下而不是~/.claude/skills/skills/下部分技能无法触发description字段的描述不够明确AI没识别出意图在触发时更明确地说使用XX技能处理XX或修改描述技能执行到一半中断上下文窗口超长或执行步骤太多拆分子任务一个技能只处理一个大步骤或增加上下文窗口配置自定义技能不生效文件名不是SKILL.md检查文件名必须严格命名为SKILL.md更新后技能失效版本升级后目录结构变化重新clone仓库并对应目录结构覆盖安装在Windows上路径不识别路径分隔符问题使用环境变量%USERPROFILE%代替~6.2 排查思路分享如果你遇到问题但上面表格里没有对应的条目我教你一套通用的排查流程。先看目录结构。百分之八十的技能不生效问题根源都在文件夹层级。正确结构是这样~/.claude/skills/ ├── pdf/ │ └── SKILL.md ├── canva/ │ └── SKILL.md如果出现了skills/skills这种嵌套或者SKILL.md文件放到了子文件夹的子文件夹里AI就找不到。这个检查十秒钟搞定却是最容易被忽视的。再看描述触发词。AI判断该不该用这个技能的唯一依据就是front matter里的description字段。如果你自定义技能的触发词太生僻或者描述内容太抽象那AI大概率会把你的请求当作普通对话处理而不是调用技能。建议描述里把触发场景写具体比如当用户提到撰写会议纪要、整理会议重点时比处理会议相关任务要精准得多。最后看日志。Claude Code支持用--debug参数启动启动后终端会输出详细的调用日志。当你确定某个技能没有生效时跑一条触发指令然后在日志里搜技能名称看它到底有没有被AI注意到。如果日志里连技能名都没出现说明触发词没匹配上改描述如果技能名出现了但执行中断那是技能本身报错去查SKILL.md里的步骤。6.3 我的独家避坑经验最后分享几个常规文档里不会写的经验都是我实测下来的。第一不用装全家桶。我刚入坑时把仓库里所有技能全装上了看起来库很全实际用起来AI在选择用哪个技能这一步会变慢而且偶尔会把相近技能的步骤混在一起用。后来我精简到八个核心技能响应速度和准确度反而提升了。第二自定义技能描述里的负面示例很重要。大多数人在写description时只写在什么情况下用很少写在什么情况下不要用。但我在实测中发现加上一句当用户仅询问概念性问题、不要求实际输出时不要触发该技能能有效减少技能被误激活的概率。这算是个冷门但好用的技巧。第三注意SKILL.md里的步骤要足够详细。这是我自己吃过亏才总结出来的。第一次写自定义技能时我写的是分析客户反馈数据输出洞察结果AI输出的内容非常泛。后来我改成先按时间维度将反馈分组再提取高频关键词再按产品功能点归类最后输出问题严重程度的评分表输出质量直接上了一个台阶。AI的执行质量跟你的步骤详细程度成正比这一点在技能设计上体现得尤其明显。第四版本升级前先备份自定义技能。Superpowers更新时会覆盖整个skills目录如果你自己写过自定义技能升级前先把~/.claude/skills/下面自己创建的那些文件夹复制出来升级完再放回去。我第一次更新时没做备份写了两周的一个自定义技能直接被覆盖了那种心情相信你能体会。7. 从一个技能包到一套个人工作流用了一个多月Superpowers之后我的感觉是这套东西真正的价值不在于它自带的那些技能而在于它让我建立了一种给AI写说明书的思维方式。以前我碰到一个重复性任务第一反应是算了手动弄吧现在我第一反应是能不能把这个流程固化成一个技能。这个转变带来的效率提升远比Superpowers本身那几十个技能大得多。如果你刚接触这个生态我的建议是从PDF总结和网页抓取这两个技能入手用一周时间感受一下什么是结构化输出然后试着把你自己工作中最常做的那件事写成一个自定义技能哪怕只有三个步骤也足以让你理解它的设计逻辑最后再考虑组合多个技能形成工作流比如收集信息→整理数据→输出报告这种完整链路。我个人在实际操作中的体会是这套技能包适合当作一个启蒙工具来用——你可以用它现成的技能解决当下的问题也可以拆解它的SKILL.md文件看看别人是怎么设计一个高质量工作流的。等你看懂了里面的门道写自己的技能就会很自然这时候Superpowers是全家桶还是轻量包都已经不重要了。