敲代码这些年我一直在琢磨一件事真正能提升开发效率的工具往往不是那种大而全的平台而是一个能安静待在编辑器里的助手。superpowers就是这样一个典型——一个以 AI 技能skills为核心的 VS Code 扩展把大模型接进编辑器用一套可扩展的快捷命令让写代码、改代码、补测试、做代码评审这些日常操作都变成一句话的事。身边同事问我推荐什么 AI 编码方案时我通常会先让他们装上它先摸熟内置技能再自己去定义属于自己的技能。这篇文章我会从实际使用的角度把它的设计思路、安装配置、内置技能、自定义技能和踩坑记录全部过一遍。内容偏实操适合已经用过一点 VS Code、想把 AI 融入日常工作流的开发者。如果你刚接触也没关系每一步都会拆开讲清楚照着做就行。1. 它到底解决什么问题1.1 把能力从 AI 对话框搬进编辑器最早用 AI 辅助写代码流程基本都是去网页对话框敲需求 → 复制生成的代码 → 回到编辑器粘贴 → 手动调整文件位置。麻烦在于上下文丢失AI 不知道当前文件里有什么函数、项目用什么框架、代码风格是什么。superpowers想解决的正是这个割裂感它直接住在 VS Code 里选中一段代码、打开命令面板技能就能基于当前文件内容和光标位置进行操作。它最核心的抽象就是技能skills。一个技能 一组触发描述 一段执行提示词 运行方式。你不需要在每次对话里重新解释背景只要触发对应的技能它就知道自己是干什么的该输出什么格式。这个设计很像把常用的提示词工程打包成了一个个可复用的积木用多了之后你会觉得嗯这才是 AI 工具该有的组织方式。1.2 为什么是 VS Code 扩展而不是独立应用独立应用需要自己实现文件读写、语言服务器、终端调用工程量巨大而且很难做到改完代码立刻看到报错。依托 VS Code 的好处是编辑器本身就把上下文准备好了当前打开的文件、选中的代码片段、项目的目录结构、终端输出全都可以传给模型。你不需要额外做任何把代码喂给 AI的动作它天生就在旁边。这也是我比较喜欢它的地方上手成本低但对老手来说扩展上限又很高。内置技能可以满足大多数日常需求而自定义技能机制又能把团队规范、个人习惯固化下来做到真正人人可用。1.3 典型工作流一行命令完成一个任务用起来之后工作流会变得特别简单。拿写单元测试举例先打开被测文件选中某个函数按CtrlShiftP打开命令面板输入superpowers呼出对应技能再输入类似为这个函数生成测试的指令。它会把选中代码、当前文件结构、你的要求打包发送给模型然后生成一段可直接粘贴的测试代码你确认后落盘。整个过程大概十几秒而你的手始终没有离开编辑器。这才是这类工具最舒服的地方不是让你去适应 AI 的交互方式而是让 AI 迁就你原本的编码习惯。2. 安装与环境准备2.1 在 VS Code 里安装扩展安装方式非常常规直接在扩展面板搜索superpowers。认准发布者和官方仓库避免装到名字相似的山寨包。我习惯在扩展详情页先看一眼下载量和最近更新时间维护频率越高的工具越靠谱。菜单路径左侧扩展图标 → 搜索框输入superpowers→ 找到后点 Install。如果网络环境无法直接访问扩展市场也可以从 GitHub Releases 页面下载.vsix文件然后在 VS Code 右上角扩展菜单里选择从 VSIX 安装。装完重启编辑器绝大部分情况下扩展就会加载。2.2 准备模型 API Keysuperpowers本身不内置模型它需要调用外部模型服务商的 API。所以第二步是去你使用的模型服务商控制台申请一个 API Key。申请时注意看清计费方式很多服务商会送一点免费额度但超出之后按 token 计费。我个人的习惯是先在控制台设置好每月消费上限防止某次异常循环把额度跑光。拿到 Key 之后立刻复制保存到本地密码管理器里。密钥是一串很长的字符常见错误是复制时缺了尾字符或多了换行符导致后面验证 401。千万不要把 Key 提交到 Git 仓库尤其是公开仓库这不是什么纪律问题而是纯粹的钱包问题。2.3 配置扩展三种方式配置路径有三个入口按优先级从低到高分别是默认设置、工作区设置、用户设置。日常个人使用直接改用户设置就行如果是团队协作建议放在工作区.vscode/settings.json里跟项目一起提交别人 clone 下来就能用。主要配置项是模型服务的 Base URL、API Key、模型名称。在设置面板搜索superpowers填好对应字段即可。如果你用的是兼容标准接口的服务网关甚至可以填网关地址这样团队内统一走内部网关Key 也不需要每个人都配一份。示例配置片段{ superpowers.apiKey: sk-xxxxxxx, superpowers.model: your-model-name, superpowers.baseUrl: https://api.example.com/v1 }注意如果你把配置放到工作区.vscode/settings.json它会被 Git 跟踪注意不要包含真实 Key。有这个需求的话建议借助 VS Code 的变量替换机制或本地环境变量方式去注入。2.4 验证配置是否生效配置完成后打开命令面板输入superpowers能看到扩展的若干命令比如打开技能面板、切换技能、新建会话。随便触发一个技能如果它能正常返回内容说明链路已经通了。我第一次配置完其实踩了个小坑填完设置没有重启窗口结果命令一直提示模型未配置。后来才发现扩展读取的是启动时的配置改完必须执行重新加载窗口。如果你也遇到类似问题先别急着怀疑脚本试试CtrlShiftP→Developer: Reload Window。3. 核心技能开箱即用的 skills3.1 内置技能清单安装完扩展内置技能已经自动生效。我常用的大概有下面这几类技能方向作用典型触发词代码生成根据描述生成函数、组件、脚本generate code/write代码解释解释选中代码的逻辑与作用explain/解释这段代码测试生成为选中函数生成单元测试unit test/test代码重构调整结构、拆解大函数refactor/重构代码评审检查潜在 bug 与坏味道review/code review注释补充为代码补充中文或英文注释comment/document提交信息生成根据 Git diff 生成提交信息commit message这不是全部但覆盖了日常开发的大头。关键在于内置技能并不是死的它们底层都是提示词模板你可以通过自定义技能去覆盖、重写甚至增强它们的行为。3.2 代码生成最常用的技能代码生成是我用得最频繁的技能。比如前端写一个防抖函数选中代码区域后直接输入帮我写一个带 cancel 方法的防抖函数参数支持立即执行选项。它会输出完整实现并且通常附带少量注释和使用示例。这里分享一个提高命中率的技巧不要只给一句写一个防抖。先把你想要的行为边界讲清楚——入参类型、返回值、是否需要取消、超时时间单位等。模型对越明确的需求越稳定。你甚至可以在描述里提到目标文件用到的现有函数名它会尝试在生成代码中复用。3.3 代码解释与重构读老代码的利器接到遗留项目时代码解释技能能帮你快速搞清楚一块陌生逻辑。选中一段看得头疼的函数触发解释它会按整体职责 → 关键步骤 → 潜在风险的结构输出。这个结构不是扩展写死的而是提示词引导出来的结果深究一下会发现它输出的解释质量很看模型本身的水平。重构技能则适合处理那种一眼望去有几百行的函数。你可以指定重构目标比如提取公共逻辑到单独函数、改成策略模式。我的经验是重构前先在代码解释技能里让它总结当前行为再让重构技能动手准确率会高非常非常多。因为模型理解了行为才知道怎么保持行为不变地改结构。3.4 会话管理别忽略这些细节扩展会在一个会话里维护历史消息。如果上下文越来越长很容易把模型窗口占满导致后续回答质量下降或不完整。我一般会在切换任务时新建会话把任务边界隔离开别让上一个任务的残留上下文干扰下一个任务。另外某些模型对中文和代码混排的响应会偶尔出现格式漂移如果生成的代码缩进不对或括号不配对不用太紧张手动整理一下即可这是所有基于模型的工具都无法完全避免的问题。4. 自定义技能把流程固化给 AI4.1 技能的本质是提示词 触发规则内置技能能满足 80% 的需求剩下 20% 属于你团队特有的流程。这时候就要自定义技能了。理解它最简单的方式是每个技能就是一个 Markdown 文件文件里写一段提示词外加一段 YAML 格式的元信息告诉扩展什么词可以触发这个技能、该用哪种方式运行。创建位置有两个全局目录放个人通用技能项目目录放团队共享技能。全局目录一般在用户主目录下的.superpowers/skills项目目录则放在项目根目录的.superpowers/skills。扩展加载时会扫描这两个位置。4.2 技能文件怎么写一个例子以生成 Git 提交信息为例在项目.superpowers/skills/git-commit/SKILL.md文件里写入--- name: git-commit description: 根据工作区 Git 改动生成符合规范的提交信息 triggers: - /commit agent: auto version: 1.0.0 --- 你是资深前端工程师擅长写清晰、精简的 Git 提交信息。 请根据用户提供的 Git diff 信息生成一条符合 Conventional Commits 规范的提交信息。 要求 - 类型从 feat / fix / refactor / docs / test / chore 中选择 - 主题不超过 50 个字符 - 如果改动包含破坏性变更在正文中用 BREAKING CHANGE 说明 - 只输出提交信息本身不要输出解释保存后重新加载窗口在技能面板里输入/commit它就会被识别为可用技能。这时候给它一个上下文或直接让它读取 Git 状态就能基于仓库改动生成提交信息。4.3 自定义技能的关键字段YAML 头部有几个字段需要特别留意name技能名称建议使用小写加连字符的格式。description描述技能用途它不光展示给用户在有些模式下还会作为模型判断是否调用该技能的依据。triggers触发词列表一般是斜杠开头的短语例如/commit。用户输入匹配到触发词就会加载这个技能。agent运行模式常见取值是auto和chat区别在于是否要求交互式确认。4.4 把自定义技能导入进来的两种方式热门搜索里反复出现怎么引入这些技能我理解有两个层面一是把别人写好的技能文件放到自己的目录里二是在团队里共享自己写的技能。第一种方式最简单找到别人分享的SKILL.md按目录结构放到.superpowers/skills下重载窗口即可。第二种方式则是把技能文件放到一个 Git 仓库里团队成员 clone 之后就都拥有了同样的技能。你甚至可以把团队规范、代码风格约定写进技能描述让 AI 在生成代码时自动遵循这些约束。我团队里目前有一套前端代码规范技能里面包含组件命名、样式方案、状态管理选型等约定。每次让 AI 生成组件代码它都会按这套规范输出代码风格统一了很多。这是自定义技能极大价值的地方把团队的隐性知识显式地固化给了 AI。5. 常见问题与排查实录5.1 技能面板里看不到某些技能这种情况多数是目录结构不对或者 YAML frontmatter 写错。检查一下文件路径是否位于.superpowers/skills下目录名是否正确SKILL.md文件名的大小写是否一致。还有可能是 YAML 解析失败最典型的是漏了---的三连短线或者冒号后面没加空格。排查顺序建议先看文件路径 → 再看元信息格式 → 最后重载窗口。如果这三个都没问题打开扩展的输出日志很多解析错误会直接打在日志里。5.2 API 报 401 或连接超时401 基本是 Key 的问题最常见的原因是 Key 复制不全、Key 带了换行符、或者没有在服务商控制台开启对应模型权限。连接超时则要检查网络环境能否正常访问模型接口或者换一个更稳定的接口域名。企业里常见做法是让运维搭一个内部网关把外部访问收敛到统一出口既解决了稳定性也便于统计消费。5.3 生成内容不完整或截断多半是上下文太长或单次输出 token 数限制到了。先把会话里的历史消息清掉再精简当前输入。如果还是截断尝试让模型分两步输出第一步先给大纲第二步再逐步实现。这个小技巧在很多模型身上都好使。5.4 技能生成的代码插入在错误位置扩展默认会把生成结果插入到光标光标所在位置。如果你只是想让 AI 输出代码不希望它自动落盘需要先确认当前会话模式。我建议涉及到多文件改动时先把输出内容放到新文件或预览面板人工确认后再替换别让它直接动你正在编辑的主文件。5.5 常见错误速查现象常见原因解决方法命令面板没有扩展命令插件未加载 / 未重载执行 Reload WindowAPI 返回 401Key 错误或无权限重新生成 Key检查权限请求超时网络无法访问接口检查网络出口换网关地址技能不被触发触发词没匹配 / 文件名错误确认触发词和目录结构回复不完整上下文太长 / 输出限制清会话分步生成没有访问模型服务的权限Key 未绑定可用模型在控制台开启模型访问权限5.6 一个提升体验的细节把模型参数调低一点扩展一般会暴露 temperature 之类的采样参数设置。写代码类任务我习惯把 temperature 调低比如 0.2 左右生成的代码更稳定、格式更规范。但它适合写代码不太适合开脑洞的场景。如果做设计其实可以临时调高一点获得更多变体。这也是把工具用熟练之后个人风格逐渐体现出来的地方。这套小工具用到现在我最真实的感受是它的价值不在某一个技能多炫酷而在于让 AI 的使用方式变得可控、可复用、可分享。内置技能帮我把高频动作固化下来自定义技能则让我把团队里的隐性约定也交了出去。你不需要再每次对着 AI 解释项目背景和输出格式一次定义处处可用。最后分享一个小技巧如果你发现自己某个需求被反复用自然语言描述那就把它抽成一个自定义技能。花十分钟写一个SKILL.md往后的每一次调用都能省下这十分钟这才是superpowers最值得投入的地方。