VibeSkills 本地技能目录配置教程：用 skill-roots.json 让上百个自定义 Skill 参与智能路由

VibeSkills 本地技能目录配置教程用 skill-roots.json 让上百个自定义 Skill 参与智能路由【免费下载链接】Vibe-SkillsIntelligent Skill routing and workflow orchestration for AI agents — 21.12 pp reward, −29.6% tokens on SkillsBench with DeepSeekV4Flash-VE.项目地址: https://gitcode.com/gh_mirrors/vi/Vibe-SkillsVibeSkills 是一个面向 AI Agent 的智能技能路由与工作流编排框架在 SkillsBench 大规模多技能评测中带来平均任务分数 21.12 个百分点、token 消耗降低 29.6% 的实测收益。本教程教你只需配置一份skill-roots.json就能把自写、团队和第三方的上百个本地自定义 Skill 接入 VibeSkills 的智能路由——无需等待官方收录装好即可参与任务调度。为什么需要配置本地技能目录 很多人用 AI 应用时都有一个共同的烦恼装了越来越多的 Skill却忘了自己都装了什么、也不知道该调哪个。复杂任务往往需要多个不同领域的 Skill 组合协作靠人肉规划既累又容易遗漏。VibeSkills 的做法是先把整个任务拆清楚再为每一部分挑选最合适的 Skill最后统一协调和验收。安装数量只决定可选范围它不会把全部 Skill 都调用一遍。默认的 Skills 目录如~/.agents/skills之外你还有哪些存放技能的文件夹skill-roots.json就是告诉 VibeSkills这些目录里也有技能请一起扫描。找到 skill-roots.json 的正确位置VibeSkills 支持两个层级的配置文件层级文件位置适用场景用户级~/.vibeskills/skill-roots.json个人全局技能库所有项目共用项目级workspace/.vibeskills/skill-roots.json团队协作技能只对当前工作区生效两个文件可以同时存在会按项目级 → 用户级 → 默认 Skills 目录的顺序合并扫描。安装说明详见 docs/install/README.md。skill-roots.json 文件结构与路径写法 ✍️配置文件结构非常简单只需要两个字段{ schema_version: 1, extra_skill_roots: [ ~/my-skills, /data/team/skills, project-skills ] }schema_version必须为1extra_skill_roots必须是字符串列表每项是一个非空路径三种路径写法都支持写法示例解析规则~开头~/my-skills解析到用户主目录下绝对路径D:/user-skills、/data/team/skills直接使用相对路径project-skills项目级文件相对工作区目录用户级文件相对主目录解析逻辑的实现见 packages/runtime-core/src/vgo_runtime/kernel/host_skill_roots.py格式校验与合并行为的测试用例可参考 tests/unit/test_host_skill_roots.py。用户级与项目级添加两个实用示例 示例一添加个人技能库用户级在~/.vibeskills/下创建skill-roots.json把你平时积累的技能目录都列进去。之后所有项目都能路由到这些技能。示例二共享团队技能项目级把团队沉淀的技能放进工作区的project-skills/目录再写入项目级配置{ schema_version: 1, extra_skill_roots: [project-skills, vendor-skills] }如果这个工作区目录是版本库的一部分队友克隆后无需任何额外配置团队技能自动进入智能路由范围。扫描优先级与去重机制 同一个目录即使在项目级和用户级配置中各出现一次也只会被扫描一次按先出现者去重。默认 Skills 目录始终参与扫描Codex 宿主下若存在~/.codex/plugins/cache插件缓存目录也会被自动纳入。也就是说项目级配置先读、用户级配置后读谁先认领某个目录谁生效重复项自动跳过不会出现重复加载。Token 消耗与 Skill 生效条件 ⚡装了 100 个 Skilltoken 会爆炸吗不会。目录发现和索引生成都发生在本机VibeSkills 先提取每个 Skill 的名称、说明、适用场景和边界等紧凑信息为任务的每个部分筛选候选只有保留下来的候选才会被读取完整的SKILL.md。因此 token 开销主要取决于任务保留了多少候选、这些文档有多长而不是技能库的总规模。一个 Skill 要真正参与工作需要同时满足三个条件有可读的SKILL.md名称不与其他 Skill 冲突用途匹配当前任务的某一部分常见问题 FAQ ❓Q配置完要重启或重新安装吗不需要。配置在每次任务启动时读取新增目录后其中的 Skills 即可参与后续任务无需等待 VibeSkills 仓库收录。Q发现了我的 Skill就意味着它被调用了吗不一定。被发现只表示它进入了候选范围计划阶段由agent_skill_organization记录各部分准备使用哪些 Skills执行阶段由module_assignments记录实际分配。是否参与由任务匹配度决定而不是装了就全用。Q效果有多大参考官方在 195 个技能并存的大规模评测环境中测得任务均分提升 21.12 个百分点满分任务从 39 个增至 57 个同时 token 总量从 491.1M 降至 345.8M工具调用减少 33.1%——技能越多路由的价值反而越明显。快速上手3 步完成配置 第 1 步获取 VibeSkills本地还没有时git clone https://gitcode.com/gh_mirrors/vi/Vibe-Skills第 2 步安装到当前 AI 应用的 Skills 目录bash ./install.sh --skills-dir $HOME/.agents/skills第 3 步创建skill-roots.json把技能文件夹路径写入extra_skill_roots然后在 AI 应用的 Skills 入口调用vibe$vibe或/vibe即可。 小提示路径写错或 JSON 格式不合法时运行时会报明确的校验错误如extra_skill_roots must be a list按提示修正即可不影响已安装的 VibeSkills 本身。配置好skill-roots.json之后你的本地技能库就从静静躺在硬盘里变成了每次任务都参与智能路由的活资源——剩下的挑选、编排和验收交给 VibeSkills 就好。【免费下载链接】Vibe-SkillsIntelligent Skill routing and workflow orchestration for AI agents — 21.12 pp reward, −29.6% tokens on SkillsBench with DeepSeekV4Flash-VE.项目地址: https://gitcode.com/gh_mirrors/vi/Vibe-Skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考