Oct 18, 2026

用 VibeSkills 让一个 Skill 调度你所有的本地 Skill

VibeSkills 加了一个规划层:发现你已安装的 skill,把它们分配到任务的各个部分,并在交付之前检查合并后的结果。

#tutorial#ai-agents#skill-management

装的 skill 一多,新问题就出现了:你忘记自己有什么,Agent 也从不检查。VibeSkills 是一个 4k 星的通用 skill,它坐在整个 skill 库之上——发现你机器上已安装的 skill,把相关的那几个分配给任务的各个部分,并在交付之前验证合并后的结果。

为什么这个 Skill 重要

被动的 skill 触发只对几个显眼的词做反应;VibeSkills 先把整个任务拆开。它的 README 描述了一个五阶段流程:确认需求(在你批准目标、约束、材料和预期交付之前流程停在这一步),推荐工作量等级——L 适合可驾驭的多步骤工作、按顺序处理,XL 适合更大的工作、最多两个互不冲突的部分同时进行——通过审阅本地 skill 目录来组织 skill,执行并记录(代码任务可以跑 TDD 循环),最后把实际结果与每一个计划项对照。必需的工作未完成、失败或被阻塞,都会阻止最终验收。

README 为这套方法给出了基准数据:在其改造的大规模 SkillsBench 设置下——每个任务都在装满全部 195 个专业 skill 的环境中评估——vibeskills v4.1.0 相对基线(DeepSeekV4Flash-VE 配 OpenHands)把平均验证者奖励提高了 21.12 个百分点,同时总 token 减少 29.6%、工具调用减少 33.1%。README 自己的分析把收益归因于每个任务只挑选少数真正相关的 skill,而不是调用更多。

token 问题也有文档化的答案:发现和索引生成在本地针对压缩提取的信息进行——名称、描述、预期用途、边界——只有留下的候选才会被当作完整的 SKILL.md 读取。README 说明这部分开销不是零;候选越多、文档越长,消耗的上下文越多。

安装

公开安装路径从已发布的 release zip 开始,而不是仓库检出:从 releases 页面下载 vibe-skills-4.1.0-public.zip,对照 release 页面展示的 SHA-256 摘要校验,然后把它解压到托管 skills 目录之外。在解压出的目录里运行包装脚本:

bash ./install.sh --skills-dir "$HOME/.agents/skills"
bash ./check.sh --skills-dir "$HOME/.agents/skills"

默认目录是 ~/.agents/skills;传入别的目录——~/.claude/skills、~/.codex/skills——同样的运行时就会装到那里。安装器只写入 <SkillsDir>/vibe:它不修改 Codex、Claude 或 Agents 的设置,不写系统提示词或命令包装器,也不会自动安装或推荐 chrome、chrome-devtools、playwright、context7、claude-flow 这几个 MCP。check 证明的是安装存在,不是任务跑过。卸载就是删掉 <SkillsDir>/vibe。

实战:一个多交付物任务走 $vibe

通过应用提供的 skills 入口以 $vibe、/vibe 或它给出的语法调用 VibeSkills。然后把整个任务连同交付物一起交给它:

$vibe 用公开数据完成一个可复现的分类实验:交付数据审计、统计评审、4 张结果图、一份科学报告,以及一个 7 页的组会幻灯片。

README 自带的案例正是这个形状:宿主机配置了超过 100 个 skill,VibeSkills 审阅候选及其 SKILL.md 文件,挑出 7 个,把工作编排成 5 组、10 个工作单元——环境、数据审计、建模、统计评审、图表、报告、幻灯片——并对交付物运行 17 项检查。任务在 10/10 单元完成、17/17 检查通过后通过验收。你的任务记录把批准的需求、计划、执行进度和最终检查保存在同一处,后续会话可以从保存的进度继续。

技巧

  • 通过 ~/.vibeskills/skill-roots.json(用户级)或 <workspace>/.vibeskills/skill-roots.json(工作区级)把共享目录之外的 skill 文件夹加进来;按 README 的说法,一个 skill 需要可读的 SKILL.md、与其他 skill 不冲突的名称、以及对当前工作的明确契合,才能被选中。
  • "发现"一个 skill 只意味着它可以被考虑,不等于它参与了工作——agent_skill_organization 存计划分配,module_assignments 存实际分配。
  • 如实确认需求:流程刻意停在第一阶段等你批准,计划和最终检查的质量完全取决于这个被批准的基础。
  • 安装成功不等于任务完成,任务记录不等于检查通过——README 把这两个区分都写明了。

何时不用这个 Skill

如果你装的 skill 少到脑子里装得下,而且你的 Agent 本来就能挑对,编排层只是多出一个你不需要的规划阶段。它也不是能力的安装器:VibeSkills 只从磁盘上已有的东西里挑选,没有安装的能力对计划而言就是不可用。


查看 排行榜 了解更多 skill。