很多人第一次听到“superpowers”这个词还以为是某个游戏模组或者中二的项目名。实际上它是这两年AI编程和智能体工作流里上升势头很猛的一个VS Code扩展中文圈子里常叫它“技能包”或者“技能管理器”。我最早是在折腾AI自动写代码、自动整理任务的时候接触到的当时被一个问题折磨得不行——每次想让AI干活都得把一堆上下文、规则、示例喂给它换个项目又得重来完全没有复用性。后来我把superpowers装进编辑器配合它预置的skills体系整个工作流变得规矩多了。这篇文章就是想把superpowers这套东西讲透重点回答四个问题它到底是什么、有哪些值得用的skills、怎么把一个现成技能引入到自己的环境里、以及如何自己写一个技能并把它串进日常流程。不管你是写代码的、做内容的还是搞办公自动化的只要你手上有一台能跑VS Code的电脑这套东西都能直接落地。1. 先看清楚superpowers的底层逻辑1.1 它解决的不是“写代码”而是“让AI干活更规范”很多人的误区是superpowers是用来生成代码的。其实代码生成只是它众多技能里的一个分支它真正解决的痛点是如何把AI从“一次性聊天的玩具”变成“可复用、可版本管理、可分享的生产力工具”。聊过AI的人都有体会同样一件事这次问它写Python脚本下次问它做周报每次都得把需求讲一遍AI的回答风格还不稳定。superpowers的思路很简单——把那些反复使用的提示词、工作流步骤、质量标准打包成一个一个的独立技能文件放在项目目录或者全局目录里。需要用的时候直接在编辑器的输入框里键入斜杠加技能名AI就会把这个技能对应的指令文件读进来相当于给AI换上了一套专业的“操作手册”。我这里说个实在的比喻。没有技能包的AI像一个刚入职的实习生你告诉他什么都得从头说有了skill文件的AI像一个干了三年的老员工你只需要说“按老规矩办”他自己就知道该调用哪些工具、按什么顺序执行、输出什么格式。superpowers的定位就是给这个老员工搭好“规章制度”的架子。1.2 技能包在磁盘上的真实长相如果你还没有装过superpowers先在心里记下一个概念技能是什么技能就是一个带格式的Markdown文件通常叫SYSTEM.md或SKILL.md放在一个约定的目录里。整个superpowers体系在磁盘上的组织方式大致是这样几个层次技能根目录通常是用户的home目录下的~/.superpowers/或者项目内部的.superpowers/里面可以放多个技能文件夹。技能文件夹每个技能一个文件夹文件夹名字就是技能名比如image-generation、commit-message里面至少有一个SKILL.md。技能定义文件SKILL.md是技能的核心文件头部有一段YAML格式的元信息包括技能名、描述正文部分则是给AI的详细指令可以写步骤、注意事项、示例、输出格式约束。附属文件技能文件夹里还可以放脚本、模板、参考文档技能运行时AI可以按需读取。这个设计的巧妙之处在于技能文件是纯文本的可以被Git管起来也可以直接分享给别人。你从网上拿到一个别人写好的技能包本质上就是下载了一个文件夹放到指定位置AI就能用了。这也是为什么它的热词里总有人问“怎么引入这些技能”——因为真的就是一个拷贝粘贴的活完全不涉及写代码。1.3 为什么我推荐从superpowers而不是自己堆prompt开始前阵子我试过把几十条prompt模板塞进一个提示词配置文件里最后发现根本维护不了。因为提示词之间会互相干扰同一个AI经常分不清哪个规则优先。而superpowers把每条提示词封装成了独立的“技能”彼此隔离调用时才注入天然避免了这种混乱。更关键的是它的技能体系里有“技能清单”的概念。当你在编辑器里输入斜杠时AI会先读一遍所有可用技能的清单文件自动判断你当前的需求对应哪个技能。这种“注册-发现-调用”的机制比手动复制粘贴prompt要优雅得多。你想让AI生图不用把生成图片的大段指令再讲一遍只需输入/它自己就会匹配到image-generation这个技能。2. 值得上手的skills清单与核心细节2.1 内置的几个热门技能逐个拆开看顺着热搜词里“有那些skills”的疑问我把常见的高频技能分成了几类每一类挑一两个典型给你讲清楚用法。生成与创意类example-generator当你需要示例数据时它会先读取项目的技术栈和数据结构再生成一套符合上下文风格的示例内容。很多人用它来造测试数据、生成API返回样例比手动编JSON快太多。image-generation把自然语言描述转成图片。它对提示词的优化能力比较强会自动把白话描述扩展成包含主体、背景、风格、镜头语言等维度的完整创作用词。我用它生成过好几组配图比我单独写prompt给Midjourney的效果还稳。thought-provoker适合做头脑风暴。它有一套反向提问的框架会从“最容易忽略的约束条件”切入逼你想清楚边界问题。我每次准备一个方案前都会先跑一遍它用来找漏洞。工程提效类commit-message把暂存区的改动批量映射成符合Conventional Commits规范的提交信息。它会先分析diff的大致结构识别出改动类型feat、fix、docs、refactor再生成几条候选commit message你可以挑一条直接提交。unit-test-writer这个技能会先读取源码文件解析出函数和类的结构然后自动生成单测骨架。它厉害的地方在于会识别出边界条件比如空数组、空字符串、除零场景比很多IDE自带生成器考虑得全。vibe-check我愿称它为“代码审查哨兵”。当你不确定某段代码是否够好、风格是否统一时它会对当前代码文件做一次快速体检给出一份可执行的修改清单。内容与办公类blog-post-writer给定一个主题和关键词它会先拉取相关的参考内容再按照吸引人的方式组织出一篇结构完整的短文。它默认带SEO优化的思想会自动铺关键词但不会堆砌。startup-pitch把一个粗糙的创业想法扩展成完整的电梯演讲包含客户痛点、解决方案、市场规模、商业模式等模块。personal-notes-organizer这个技能适合经常记零散笔记的人。它会读取选中的笔记片段重新整理成带标题、标签和相互链接的完整笔记可以理解为“把随笔升级成知识库”。这些技能有一个共同点都长得像一个规范的操作指导书AI在执行时会严格按步骤走而不是自由发挥。这也是技能包和普通对话提示词最大的区别。2.2 核心细节之一技能文件里到底写了什么我刚拿到一个技能文件夹时第一件事就是打开SKILL.md看它的结构。以blog-post-writer为例一个典型文件长这样--- name: blog-post-writer description: Generates a well-structured blog post based on a topic and target audience. --- # Blog Post Writer ## Objective Write a blog post that is engaging, informative, and clear. ## Steps 1. Analyze the topic and identify the target audience. 2. Outline the main points to cover. 3. Create structured sections with headings. 4. Write each section in detail, ensuring flow. ## Quality Criteria - The blog post has a clear introduction, body, and conclusion. - Sentences are short and easy to read. - The post contains specific examples from the users input data if available.这里的奥妙其实在frontmatter里的description。AI在斜杠触发时会优先扫描所有可用技能的description字段根据语义匹配判断该用哪个技能。如果description写得笼统AI可能压根不会激活这个技能所以自己写技能时description里要把适用条件、读取什么文件、输出什么格式都塞进去。2.3 核心细节之二技能不是魔法它只是“上下文”说句实在话技能文件本身没有魔法它本质上是一段被AI自动读取的上下文。但为什么效果差异这么大我观察下来有三个原因一技能文件里的指令结构是经过打磨的远比随手写的prompt要严谨。每个技能都拆成了Objective、Steps、Quality Criteria三个部分相当于告诉AI“目标是什么、按什么顺序来、最终做成什么样算合格”。二技能文件可以利用项目的真实上下文。很多技能会加上一条指令——“读取当前项目下的技术栈或内容风格文件再执行任务”这样AI的输出就不是凭空捏造而是贴着你的实际情况来的。三技能之间可以互相引用。一个技能文件里可以指示AI去读取另一个技能的参考文档或者调用配套的脚本让单个技能具备简单的编排能力。比如commit-message会读取Git暂存区的状态image-generation会自动检查生成图片的脚本是否可用。3. 完整实操从零到一装好并引入技能3.1 前提准备你只需要四样东西就按我当时的安装环境来说其实非常轻量一台装了VS Code或者兼容的编辑器的电脑版本不用最新稳定版就行。一个能连上扩展市场的网络环境到VS Code的扩展面板里搜Superpowers就能看到。一点动手能力能打开终端执行几条命令。一个可用的AI模型接入通常是通过Claude Code等工具或API Key配置好的环境。这里我岔开说一下为什么需要AI模型接入。Superpowers本身不会调用任何大模型它做的是“技能加载和编排”真正干活的还是你背后的AI。它把技能文件转成AI能理解的结构再把这套结构“喂”给正在运行中的AI进程。所以你可以把superpowers理解成一个自动驾驶的控制系统而AI模型则是引擎。3.2 安装过程记录第一步打开VS Code在左侧扩展面板搜索关键词Superpowers。认准官方发布的那个安装量最大的一般没错。点Install之后VS Code会提示重启窗口不用犹豫直接重启。第二步重启后打开命令面板快捷键通常是CtrlShiftP或CmdShiftP输入Superpowers你会看到一堆相关命令比如“Superpowers: Setup”或“Superpowers: Install”。执行这个Setup命令它会自动创建一个~/.superpowers/目录并初始化必要的配置文件。第三步如果你要使用它内置的“标准技能包”通常需要向里写入一个初始化脚本用来部署技能清单。最稳妥的方式是用它自带的构建工具执行构建命令后它会从官方仓库克隆一份默认的skills文件夹到本地。注意这套动作是纯本地的不涉及任何账号体系所以不会有登录或者绑定的步骤。第四步验证一下安装是否成功。随便新建一个文本文件在文件里输入斜杠看看会不会弹出技能列表。如果弹出来一堆技能名说明安装成功了。没弹出来也别慌检查一下技能目录路径是否正确或者重新执行Setup命令。3.3 引入现成的第三方技能这是热搜里“怎么引入这些技能”最核心的答案。引入技能叫做“增加技能包”整个流程说白了三步下载技能文件夹从技能的发布页面下载一个zip包解压之后你会得到一个文件夹里面是SKILL.md和可能存在的参考文件。放到技能目录把整个技能文件夹复制到~/.superpowers/skills/目录下。重新加载编辑器让AI重新扫描技能目录之后输入斜杠就能在列表里看到它。我这么说你可能觉得太简单了确实就这么简单。但有几个坑要提醒一下第一技能文件夹的层级不要搞错。正确的位置是~/.superpowers/skills/技能名/SKILL.md而不是~/.superpowers/skills/某个外层目录/技能名/SKILL.md如果你的技能扫描不到先检查这个层级。第二技能文件夹的名称最好和SKILL.md里frontmatter的name一致不然可能造成混乱。比如文件夹叫image-gen-v2但里面的name写的是image-generationAI有时能识别有时不识别最好保持一致。第三下载后先打开SKILL.md看一眼。确认frontmatter完整、没有乱码、没有奇怪的依赖脚本。我曾经下载过一个自称“全能助手”的技能打开才发现里面引用了一个外部接口作为运行时依赖由于我不会配那个环境这个技能就一直静默失败折腾了我一个下午。3.4 给非技术朋友的三句话我知道看这篇文章的人不一定都是程序员。如果你是做内容运营、项目管理或者其他文档类工作的非技术背景记住这三句话就够了安装超级技能就跟给电脑装一个普通插件差不多界面操作为主不需要会编程。技能就是别人已经写好的“傻瓜说明书”你只需要把说明书放进对应抽屉。以后用AI时别再说“帮我写个周报”而是输入斜杠找到那个叫weekly-report的技能AI会自动按技能里的模板来写质量稳定很多。4. 深入玩转手写一个自己的技能并串联日常流程4.1 技能的标准格式再解释看完了别人的技能咱们来动手写一个。一个标准的SKILL.md由两部分组成头部YAML元信息和正文指令。YAML元信息里通常有这几个字段name技能名字符串最好用小写连字符比如weekly-report-generator。description技能的一句话描述AI靠这个匹配意图所以要写得具体比如“根据当前文件夹下的任务记录生成一份中文项目周报按完成进度和风险输出”。allowed-tools可选技能允许调用的工具列表比如bash、read_file、list_directory。model可选指定用哪个模型跑这个技能不填则用全局默认。正文指令就是给AI看的操作手册你可以写任意规则核心是让AI明确执行边界。我习惯的格式是先写Objective——这个技能到底要产出什么。再写Steps——按顺序列出执行步骤尽量拆细。最后写Quality Criteria——什么样的输出算好比如“必须100字以上”“必须包含三个数据佐证”“标题不得使用感叹号”。4.2 实战演示写一个周报生成器技能我用“周报生成”这个场景来做示例因为这个技能谁都能用不涉及代码。先在你的技能根目录下新建一个文件夹名叫weekly-report然后在里面新建一个SKILL.md填入内容--- name: weekly-report description: Generate a Chinese weekly work report based on the users task notes with progress tracking and risk warnings. --- # Weekly Report Generator ## Objective Create a well-structured weekly report that clearly summarizes completed tasks, ongoing work, pending items, and risks. ## Input Sources If there is a file named tasks.md in the current project directory, read it first. Extract all tasks that are not marked as cancelled, and classify them as: - Done - In Progress - Blocked ## Steps 1. List the tasks according to the categories above. 2. For each task, write a short progress line with one concrete detail. 3. Identify any risk that may delay the schedule, and write a clear risk section. 4. Output the report in Markdown format, using headings and a simple table for status. ## Quality Criteria - The report starts with a summary sentence. - Every task line is under 40 Chinese characters. - The risk section is based on facts from Input Sources, not assumptions.保存后重新加载编辑器。你在一个新文件里输入斜杠就能看到weekly-report如果没出来检查一下目录层级和frontmatter。用的时候你只需要在当前项目里放一个记录了任务状态的tasks.md然后在输入框触发这个技能AI会自动读文件、按步骤生成报告。这个技能我用了很久最大的感受是把“用户要什么”换成“技能怎么执行”是提升AI稳定输出的关键。不同的人对“周报”的理解差异很大——有人要数据有人要故事线有人要风险导向如果你的技能文件里不把这些要求写死AI就会凭感觉输出结果就是每次都不对味。4.3 高级玩法把一个流程拆成多个技能等你摸熟了单个技能就可以开始组合了。Superpowers的好处是技能之间能互相“呼叫”。我在做内容生产时把整个流程拆成了三个技能topic-brainstorm、draft-writer、polish-checker。每个技能只干一件明确的事前一个技能的文件输出正好是后一个技能的输入。这样设计的原因其实朴素**如果一个大技能里塞了几十个步骤AI很容易执行到一半“迷路”尤其是对话轮次变长以后前面的约束条件会被稀释。**拆成多个小技能后每个技能的执行范围都被严格限定从第一步到第三步是“接力”而不是“一口气跑完”。你可能会问技能之间怎么传递上下文我的做法是给技能加一个约定第一个技能把结果写到当前目录下的outline.md第二个技能的开头写上“请先读取outline.md再开始写作”。这就相当于给AI建了一个临时的“交接单”简单直接不需要依赖任何复杂的状态管理机制。4.4 自己维护技能库的几条心得我的技能库里现在有二十多个技能其中大部分是我自己写的。维护这套库我有几条非常个人的经验分享给你一每个技能都要写清楚“输入来源”。很多技能失败是因为AI不知道从哪里拿数据。你可以在frontmatter里注明也可以像我的周报技能一样写明“如果存在tasks.md则读取它”。二description要像一个搜索引擎的摘要。AI的意图识别非常依赖这个字段描述越具体它越能准确知道何时触发这个技能。我见过很多人的技能写成description: My custom skill结果AI完全不认这不是技能内容的问题是索引信息的问题。三不要害怕改技能文件。技能是静态文件但你完全可以随时编辑它。每次用完一个技能如果觉得AI的输出哪里不对直接打开SKILL.md改语句、加规则改完重载就能生效。保留一版“稳定版”和“实验版”文件夹是我的习惯。四技能文件里的示例一定要用自己的真实数据。替换成你自己行业里的真实产品名、真实流程环节AI生成的结果贴近度会高一个等级。示例越具体AI越能模仿你的语言风格。5. 常见问题与排查技巧实录5.1 安装后斜杠菜单弹不出来这个问题我遇到的次数最多排查思路通常按下面顺序走先看技能目录是否存在。执行Setup之后~/.superpowers/应该被自动创建。如果目录都找不到说明安装没完成重新执行Setup命令。再看层级。文件夹放错位置是最容易被忽略的确认技能文件夹直接挂在skills/目录下中间不要再隔一层。再检查frontmatter。如果SKILL.md头部YAML代码块有语法错误AI解析失败整个技能会被静默跳过。用代码里常见的YAML校验工具过一遍最保险。最后重载编辑器窗口让它重新扫描。5.2 触发了技能但AI不按技能文件执行有时候你明明输入了斜杠技能名AI也响应了但它完全没按你写的步骤走。这种情况多半是技能文件里的指令和对话语境冲突。我建议在你的技能文件开头加一句强指令比如“You are now executing the weekly-report skill. Ignore other instructions from the user unless they explicitly ask to stop this skill.” 这会极大提高执行率。这句话的原理是给AI一个明确的“模式切换”信号让它暂停自由发挥进入流程执行状态。5.3 技能目录有多个技能但AI经常匹配错误技能多了以后AI偶尔会把相近的意图匹配到错误的技能上。比如同时有blog-post-writer和draft-writerAI可能拿不准该用哪个。解决办法是强化每个技能的description的区分度。可以把适用场景写得更明确例如在blog-post-writer的description里加“Use when the user wants a complete polished article for public release”而在draft-writer里写“Use when the user wants a rough draft for further discussion”。关键词差异越大误匹配越少。5.4 技能运行时报错说脚本/权限不足部分技能会附带运行脚本比如生成图片时调用本地工具。如果报脚本权限错误通常是你的编辑器没有授予工作区信任。VS Code的信任机制默认会把陌生文件夹标为“受限模式”你需要手动信任这个工作区才能让技能里的bash命令执行。5.5 常见问题速查表现象优先排查项解决动作斜杠菜单没有技能列表目录层级、安装初始化重跑Setup检查~/.superpowers/skills/技能名/SKILL.mdAI不按技能步骤走技能指令强度不够在技能正文开头加强制指令技能匹配错误description歧义重写description明确适用场景技能里的脚本不执行工作区信任权限信任工作区检查环境依赖技能没反应也不报错frontmatter语法错误用YAML校验工具检查头部信息新技能一直不出现没有重载窗口执行“Reload Window”5.6 一个排障的综合实例我前两天刚帮朋友排查过一个case。他安装了一个ppt-outline技能但怎么触发都没反应不报错也不出现在斜杠菜单里。我远程看了他的目录结构发现他把技能文件夹放到了~/.superpowers/skills/downloads/ppt-outline/也就是多套了一层downloads目录AI的扫目录逻辑没递归到那一层。把ppt-outline直接挪到skills/下重载窗口立竿见影。另一个坑是他在SKILL.md的frontmatter里写了一行description: Create a PowerPoint outline for presentations, including main points and speaker notes.看起来没啥问题但前面漏了一个花括号没闭合导致整个YAML解析失败。我帮他把文件里所有不必要的冒号和花括号清掉技能立刻就能用了。这类问题极其常见新手写技能时尽量让YAML部分保持精简别放花式结构。最后再分享一个我自己环境里的独门流程。我现在所有的技能都放在一个Git仓库里托管每次修改完技能文件提交一次备注写明改了什么、为什么改。这样一旦新改法不理想随时能回滚到上一个稳定版本还能在不同电脑之间同步同一个技能库。我的技能库现在已经演化出了两套完整的工作流一套用于编程提效一套用于内容生产每一套都是从几张草稿纸慢慢迭代成现在这个样子的。如果你刚接触superpowers我不建议一上来就下几十个技能那样反而会“消化不良”。找个你最频繁用AI做的事比如周报、写文章、生成测试数据、整理会议纪要先只安装一个对口技能用两周琢磨透它是怎么读上下文、怎么执行步骤、怎么产出的。等你对这个机制有了手感再逐渐扩展技能库。我自己就是从只装一个commit-message开始的到现在整个体系的构建逻辑已经全部跑通整个过程并没有多高的门槛关键就是动手去试。