最近superpowers这个词在热搜里冒得很快我刷到不少人都在问有没有skills怎么引入这些技能想要安装superpowers。最初我以为又是什么新出的AI模型或者某个编辑器插件真正去翻了一遍开源社区才弄明白它并不是一个独立软件而是一套技能包工作流专门用来给AI助手装上岗位化的专业能力。这篇就围绕大家最关心的几件事展开——superpowers到底能做什么、有哪些skills、怎么安装、怎么在具体场景里真正用起来。我自己从装到用大概折腾了两周中间踩了不少坑也总结出一些和官方文档不太一致的经验。这篇文章不是搬运说明书而是把你真正会遇到的问题、会忽略的细节、会踩的坑一次性说清楚。1. superpowers的真实身份一套技能包而不是某个具体工具1.1 先回答热搜里最常问的那句有没有skills有而且数量不少。superpowers整个项目的核心资产就是一批预先写好的技能文件skills每一个技能文件都对应一种完整的工作能力。你可以把它理解成给AI助手配了一整套岗位职责书它不再只会泛泛地聊天而是遇到具体任务时会自动启用对应的专业流程。我安装后扫描到的技能大致分这几类技能组典型技能适用场景内容创作类写博客、写教程、改写润色、生成大纲公众号推文、技术博客、产品文案研究分析类深度研究、观点整理、数据核查行业调研、竞品分析、资料汇总项目管理类目标拆解、任务规划、风险检查个人OKR、项目启动、需求评审编程辅助类代码审查、重构建议、Bug定位代码评审会、重构任务、线上问题排查学习解释类概念讲解、手把手教学、常见误区分析带新人、技术分享、知识科普每个技能不是一句提示词那么简单它内部带有完整的调用条件、执行步骤、输出结构、自查清单。这是superpowers和其他提示词模板最不一样的地方。1.2 它和普通提示词模板的核心区别很多刚接触的朋友会有一个误解这不就是一堆现成的prompt吗我自己写一份帮我写一篇技术博客的提示词效果好像也差不多。实际用下来差别很大。普通提示词模板是一次性台词你发给AI它回答结束下次再发同样的台词它再从零开始。superpowers这类技能包走的是工作流模式当你触发某个技能AI就进入该技能定义的完整工作流程。比如写作技能会先问清目标读者和文章目的再生成大纲然后逐段写最后自己跑一遍查重和逻辑检查。这个过程不是一次对话完成的而是多轮推进的。打个比方普通提示词像外卖菜单你点一道菜它做一道技能包像请了个带SOP的厨师你说今晚做一桌家常菜他会自己决定先洗菜还是先切菜按什么顺序出菜出锅前还要试味。这就是大家觉得用了superpowers之后AI变聪明了的根本原因——其实模型没变变的是工作方法。2. 核心机制拆解技能文件、触发词与技能目录是如何协作的2.1 SKILL.md一份技能文件的岗位说明书结构想用好superpowers必须先看懂它的技能文件长什么样。每个技能通常是一个独立目录目录里必须有一个SKILL.md主文件里面用结构化的方式描述这个技能的完整信息。下面是我从自己安装的技能里抽出来的一个简化模板--- name: write-blog-post description: 当用户需要撰写一篇结构完整、逻辑清晰的博客文章时使用。 when_to_use: 用户明确说写文章/写博客/写推文或提供素材要求组织成文。 triggers: - 写一篇关于...的文章 - 帮我整理成博客 - 我需要一份发布用的长文 --- # 技能博客写作 ## 输入要求 - 目标读者 - 文章主题 - 参考资料或关键信息点 ## 执行步骤 1. 明确文章定位与核心观点 2. 生成文章大纲并请用户确认 3. 按大纲逐部分撰写 4. 输出后执行自查清单 ## 输出格式 - 标题、摘要、正文分段 - 含小标题和关键信息提示 ## 自查清单 - 开头100字是否抓住注意力 - 段落是否有信息增量 - 结尾是否有明确行动指引这段内容看起来像配置但AI读取时是靠它来判断什么时候该用这个技能用了之后该做什么。其中最关键的是description和when_to_use这两段写得越清楚AI的判断就越准。2.2 触发词的工作逻辑不是硬核命令而是意图匹配很多人第一次接触时会以为技能需要手动输入某个斜杠命令来调用比如输入/write才会触发写作技能。实际不是这样。superpowers的触发词更像火柴AI会根据你对它说的话结合每个技能的description和when_to_use判断要不要点燃这根火柴。举个例子。你直接说帮我写一篇关于智能家居的科普文章AI扫描技能库后发现write-blog-post的when_to_use里写了写一篇关于...的文章于是自动加载这个技能然后开始按技能里的步骤走流程。这个过程不需要你记任何命令也不需要额外输入触发词。这也带来一个技巧如果你希望某个技能稳定触发最好在对话里把任务意图说完整。比如用写博客的技能帮我写一篇面向新手的智能家居科普文比只说写篇文章要稳得多。意图越明确AI匹配到正确技能的概率越高。2.3 技能目录的加载顺序与覆盖规则superpowers安装后会生成一个专门的技能目录AI助手启动时会扫描这个目录下所有技能并建立索引。我本地的目录结构大致是~/.superpowers/ ├── skills/ │ ├── write-blog-post/ │ │ ├── SKILL.md │ │ └── examples/ │ ├── deep-research/ │ │ ├── SKILL.md │ │ └── templates/ │ ├── project-planning/ │ │ └── SKILL.md │ └── ... ├── config/ │ └── settings.json └── logs/ └── skill-loader.log这里有个容易忽略的规则如果多个技能目录里出现同名技能加载顺序通常由配置里的扫描优先级决定。默认情况下先扫描到的技能会优先生效后面的同名技能会被跳过。也就是说你后安装的版本不一定能覆盖先安装的版本必须去config/settings.json里调整优先级或者直接删掉不用的旧技能目录。我最初就在这里栽过跟头后面会专门讲。3. 完整安装过程与目录规划适合想要安装superpowers的新手3.1 安装前的环境准备先说结论你不需要新建什么特殊环境只需要有一个支持技能目录的AI工作台客户端。目前主流做法是使用桌面版AI助手或带工作区读取能力的工作流工具因为superpowers的技能文件放在本地目录里客户端需要能读取这个目录并在对话中把这些技能作为上下文参考。安装前我建议做三件事把现有AI助手的配置文件和对话记录备份一份防止安装过程干扰原环境。确认AI工作台的版本支持加载本地Markdown技能文件如果不支持需要选择兼容的运行方式或配合脚本加载。规划好技能目录的存放位置建议固定在~/.superpowers或项目工作区的.superpowers目录不要随手乱放。这一步别省。我见过不少人上来直接跑安装脚本装完发现AI根本读不到技能回头排查才发现是AI客户端的工作区和技能目录不在同一个路径下。3.2 两种安装方式自动脚本与手动部署superpowers官方仓库提供了自动安装脚本也支持手动部署。我用过的比较稳妥的方式是先自动安装、再手动修正配置。自动安装的命令大致是这样git clone superpowers仓库地址 ~/superpowers-src cd ~/superpowers-src ./install.sh安装脚本会问你几个问题包括技能目录放哪里、是否创建默认配置、是否备份旧配置。回答完它会自动把skills目录复制到目标位置并生成一份settings.json。如果你不想跑脚本也可以手动部署把仓库里的skills目录完整复制到你的~/.superpowers/下。检查settings.json是否存在不存在则手动创建一个空配置。重启AI工作台客户端让技能被重新扫描加载。手动方式适合需要精细控制目录结构的人。我推荐第一次使用先跑自动脚本等熟悉了目录结构再手动调整也不迟。3.3 安装后验证不急着用先做一次技能体检装完之后别急着写文章先花两分钟确认技能真的加载成功。最直接的办法是在对话里问一句你现在加载了哪些技能AI如果正常读到技能目录会列出可用的技能清单。如果它回答不上来大概率是目录路径或权限有问题。我整理了一份简单的验证清单检查项预期结果如果异常怎么办技能目录存在~/.superpowers/skills下有多个技能子目录重新执行安装脚本或手动复制AI能列出技能名对话中询问技能列表有明确回复检查AI工作台的工作区是否指向技能目录触发技能有响应输入帮我写一篇科普文章后AI进入写作流程检查SKILL.md里的when_to_use是否被正确读取日志无报错logs/skill-loader.log没有读取失败记录查看是否有权限不足或YAML格式错误做完这四项检查基本可以确定技能已经就位。我见过很多装完没用上的情况80%都是卡在这一步——不是安装失败是根本没验证AI是否真的读到了技能文件。4. 具体使用的三种高频场景写作、研究、规划4.1 内容创作场景怎么让AI自动进入写作者状态我平时写技术博客最多所以最先测的就是写作技能。进入方式很简单直接在对话里提出完整需求用写博客的技能帮我写一篇关于如何搭建个人知识库的科普文章。目标读者是刚接触知识管理的职场人希望文章能讲清楚工具选择和工作流搭建字数在3000字左右。这时候AI会按照技能流程走先确认读者画像再给出大纲我确认后才开始正文写作。和普通对话最大的区别是它不会一口气把文章全倒出来而是分阶段推进中间还会根据我的反馈调整。写完后它会自动跑自查清单。我常用的是博客写作技能它的检查项包括开头有没有直接点明问题、段落之间有没有逻辑跳跃、信息点是否足够具体。这比自己肉眼校对要省力不少。不过我也发现一个需要留意的点技能生成的大纲质量很高但正文容易偏工整看起来挑不出毛病却缺少个人观点。所以我一般会在输入需求时就补充加入你个人的实践经验这样生成的内容会更贴近真实分享而不是模板感很重的科普。4.2 研究分析场景怎么触发深度研究技能深度研究技能是我认为superpowers里最被低估的一个。触发它不需要说复杂的话只需要把你的研究目标讲清楚使用深度研究技能帮我整理一份关于国内低代码平台选型的调研资料。重点对比主流平台的功能差异、定价模式、适用企业规模、典型落地案例。触发后AI会按研究技能定义的流程工作先列出信息收集框架再逐项填充最后输出一份带信息来源和可信度评估的调研清单。和普通问答的区别在于它会先把需要知道什么拆出来而不是直接给你一段概括。比如它输出的信息框架会有这些维度平台背景、核心能力、价格档位、适用场景、限制与风险。每个维度下面再展开具体信息。这样的结构直接可以拿来当汇报材料底稿比自己看到什么查什么要系统得多。在使用这个技能时我建议配合一个习惯明确提出请区分事实和推测。AI在输出调研内容时有时会把推断内容和已知信息混在一起。加了这句话之后它会在每条信息后面标注可信度方便你判断哪些可以直接用、哪些还需要进一步核实。4.3 项目规划场景把模糊目标拆成可执行任务项目规划技能是我的高频使用项。过去面对一个模糊目标时我习惯自己拿纸笔列步骤想到哪写到哪。现在我会直接这样触发使用项目规划技能帮我把两个月内上线一个轻量级内容社区这个目标拆解成可执行的任务清单包含阶段划分、关键里程碑、风险和验收标准。AI会按照项目规划技能的流程输出一份结构化计划一般包含目标定义、阶段拆分、每阶段的具体任务、负责人建议、时间估算、风险清单、验收标准。它会强迫你把想做的事情变成能执行的任务。这里分享一个我实测的小技巧不要只给一句目标就完事最好把已知的约束条件一起丢进去比如团队只有两个人后端使用现成的服务每天只有晚上有两小时开发时间。技能文件里虽然定义了通用步骤但它非常依赖输入信息。你给的约束越具体输出的计划就越接近可执行状态而不是一份放之四海而皆准的模板。5. 实测中的踩坑记录与进阶组合用法5.1 最常见的三个坑和解决方式第一个坑技能没加载或触发词不生效。这个最隐蔽。我遇到过的情况是AI能正常聊天但输入触发语句时完全进入不了技能流程。排查后发现是AI工作台的工作区目录没有指向技能目录导致它读不到SKILL.md。解决方式是把工作区路径改到包含skills目录的那一级然后重启客户端。如果你也遇到明明安装了却没用上先检查路径别急着重装。第二个坑多个技能同时被触发输出内容串味。有一次我既想要深度研究又想要博客写作结果在对话里同时说了两个技能的触发内容AI居然把两个技能混在一起输出的文章既有研究框架又有写作流程两边都不完整。后来我学到的办法是一次对话只触一个技能如果确实需要组合使用就明确告诉AI先执行A技能的步骤再套用B技能的格式。这样它才会按顺序切换而不是平行地缝合多个流程。第三个坑技能文件格式错误导致加载失败。superpowers的技能文件主要是Markdown格式但其中一些元信息要求特定的写法。我曾在自己的自定义技能里少写了一个字段日志直接报错AI完全忽略了这个技能且没有任何弹窗提示。所以修改技能文件后一定要去看logs/skill-loader.log确认技能被成功索引。这个习惯帮我避开了很多改了没生效的困惑。5.2 组合技能的高级用法让多个技能协同干活技能单独用的时候已经很顺手但真正体现价值的是组合使用。我自己最常做的组合是深度研究 博客写作先用研究技能把资料整理成结构化信息清单再触发写作技能让AI基于清单写文章。这样输出的文章信息密度明显比单纯让AI直接写要高。另一种组合是项目规划 代码审查先让规划技能把功能拆成模块和任务再让代码审查技能对现有代码按模块逐一检查。两者配合起来比单独跑一轮代码审查得出的结论更贴合项目阶段。组合调用的实操要点是一个阶段只激活一个技能阶段切换时要用清晰的语言做标记比如研究部分完成现在进入写作阶段请使用写博客的技能。这样AI不会混淆当前操作流程输出也更连贯。5.3 自定义新技能的注意事项用了一段时间后你大概率会想写自己的技能。我的建议是不要一上来就写复杂的先从一个高频重复的单一任务开始。比如你经常让AI帮你整理会议纪要那就写一个会议纪要整理技能把固定步骤、输出模板全写进SKILL.md。写技能文件时有几个重点description要写清楚适用边界宁可多写几行也不要含糊。when_to_use要包含你实际会用的表达方式。比如你平时习惯说把今天的会议整理一下那就把这个原句写进去。执行步骤要具体到AI可操作的粒度不要只写撰写纪要要写清先列出参会人、再按议题归纳结论、最后标出待办事项和负责人。输出格式最好给一个样例AI照格式输出时偏差会小很多。写完一定要做触发测试并根据结果调整描述和步骤。这里也提醒一点技能不是越多越好。安装太多技能反而会让AI在匹配时犹豫甚至误触发。我自己的原则是把真正高频使用的技能训熟低频需求直接用普通对话解决不为偶尔一次的任务增加技能库的噪声。用到现在我最实际的体会是superpowers没有让AI变聪明但它确实让我的工作方式变得更有章法。以前写文章靠临场发挥现在有固定的写作流程兜底以前做调研东一下西一下现在AI会先给我信息框架再填内容。它把很多隐性的工作方法显性化了。如果你正准备安装superpowers建议从写作、研究、规划这三个技能开始体验不要一上来就把整个技能库全装进去。先用熟一两个建立起对技能式工作流的感觉再慢慢扩展你会找到最适合自己的节奏。