VibeSkills 5分钟快速上手教程：Claude Code / Codex / Cursor 安装与验证完整指南
【免费下载链接】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
VibeSkills是一款面向 AI Agent 的智能技能路由与工作流程编排工具（AI Skill Routing / Workflow Orchestration），它能自动发现你本地安装的 195+ 个 Skills，并为每个任务只挑选真正相关的技能来执行。官方基准 SkillsBench 实测：任务得分提升 +21.12 pp，同时 token 消耗降低 29.6%、工具调用减少 33.1%。本文是一份面向新手的完整安装教程，带你 5 分钟内完成 VibeSkills 在 Claude Code、Codex 或 Cursor 中的安装与验证。
一、VibeSkills 能为你做什么？
装了一堆 Skills 之后，最常见的痛点是：忘了自己装过什么、不知道哪个任务该调用哪个技能、多个技能组合起来流程复杂。VibeSkills 解决的正是这些问题：
- 确认需求— 开工前先对齐目标、约束与交付物，需求未批准不启动执行；
- 推荐档位— 根据任务规模推荐
L（多步骤、规模可控）或XL（更大、可拆分为相对独立的部分）； - 组织技能— 扫描本地 Skills 目录，为每个工作单元挑选最合适的技能并明确交付标准；
- 执行并留痕— 按依赖顺序执行，代码任务可按需走 TDD 循环，进度可随时恢复；
- 结果校验— 交付前对照计划逐项检查，未完成或失败的必选项会阻止最终验收。
关键点：它不会自动调用所有已装技能，而是"按需选择、其余留在库中"，因此技能库越大、可选项越丰富，token 开销并不会失控。
二、获取 VibeSkills 安装包（第 1 分钟）
官方建议从发布版本 zip安装，而不是直接从仓库 checkout（仓库安装只面向开发场景）。两种方式任选其一：
- 推荐：下载当前发布包
vibe-skills-4.1.0-public.zip，解压到受管 Skills 目录之外的任意位置； - 或者克隆仓库：
git clone https://gitcode.com/gh_mirrors/vi/Vibe-Skills⚠️ 唯一前置条件：Python 3.10+。安装脚本会自动在
py、python3、python中选择可用的解释器。
安装说明详见官方文档：docs/install/README.md。
三、一键安装到 Claude Code / Codex / Cursor（第 2–3 分钟）
VibeSkills 对所有 AI 应用使用同一份安装包和同一套目录结构，不同宿主只会改变SkillsDir路径与调用语法：
| 步骤 | 说明 |
|---|---|
| 1 | 选择当前应用能扫描的SkillsDir（默认~/.agents/skills，也可用~/.claude/skills、~/.codex/skills） |
| 2 | 在解压目录中运行install脚本 |
| 3 | 通过应用的 Skills 入口调用vibe |
macOS / Linux（Bash）：
bash ./install.sh --skills-dir "$HOME/.agents/skills"Windows（PowerShell）：
pwsh -NoProfile -File .\install.ps1 -SkillsDir "$HOME\.agents\skills"安装脚本入口分别为 install.sh 与 install.ps1，底层调用apps/vgo-cli中的安装器，把运行时统一写入<SkillsDir>/vibe。安装完成后：
- 受管目录：
<SkillsDir>/vibe - 安装收据：
<SkillsDir>/vibe/.vibeskills/install-receipt.json
各宿主的适配说明（能力边界、设置映射、调用方式）可在 adapters/ 目录查看，例如 adapters/codex/、adapters/claude-code/、adapters/cursor/，通用宿主走 adapters/generic/ 契约路径。
四、验证安装是否成功（第 4 分钟）
安装后务必运行 check，它会依据安装收据核对登记文件是否仍然完整：
# macOS / Linux bash ./check.sh --skills-dir "$HOME/.agents/skills" # Windows pwsh -NoProfile -File .\check.ps1 -SkillsDir "$HOME\.agents\skills"两个注意点：
- check 通过只证明"本地安装完整"（installed locally），不证明运行时已就绪、也不代表交付已验收——后两者需要实际跑一个任务来确认；
- 如果安装后在应用中看不到
vibe，最常见原因是该应用没有扫描这个SkillsDir，请检查宿主的技能目录配置。更多排查思路见 docs/troubleshooting.md。
五、第一次调用 vibe
安装成功后，在支持本地 Skills 的 AI 应用中通过技能入口输入$vibe或/vibe即可进入治理运行时（具体语法以宿主为准）。入口契约定义在 SKILL.md，核心协议位于 protocols/ 目录（如 protocols/runtime.md、protocols/do.md）。
一次典型的任务记录会保存这些文件，方便你复盘和续跑：
| 文件 | 作用 |
|---|---|
install-receipt.json | 安装器写入的文件清单，供 check 校验 |
module-work-plan.json | 批准的工作计划：职责、预期产出、检查项 |
module-execution.json | 各部分实际产出与完成/失败/阻塞状态 |
delivery-acceptance-report.json | 最终验收结果，逐项展示通过情况 |
六、性能实证：为什么值得花这 5 分钟
VibeSkills v4.1.0 在 SkillsBench（大规模多技能场景：每个任务面对全部 195 个技能池）中，以 DeepSeekV4Flash-VE + OpenHands 为基线进行对比，结果如下：
任务质量方面：满分任务数从 39 提升到 57，23 项任务得分更高、55 项打平、仅 4 项更低。
资源方面：总 token 从 491.1M 降至 345.8M（-29.6%），工具调用从 9,954 次降至 6,664 次（-33.1%）。日志分析表明，增益并非来自调用更多技能，而是来自更清晰的任务拆解、更少无效试错，以及交付前的系统化检查。
官方还提供了一个端到端的机器学习实验案例（含数据审计、统计复核、4 张结果图、科学报告与 7 页幻灯片），17 项验收检查全部通过，完整过程见 docs/cases/ml-experiment/README.md。下图即为该案例自动产出的模型评估图表之一：
七、更新与卸载
- 更新：下载新版本 zip，解压后对同一个
SkillsDir运行update.ps1/update.sh，再跑一次 check。注意不要将新版本解压进受管目录<SkillsDir>/vibe内部，且更新器会拒绝覆盖被手动修改过的登记文件； - 卸载：直接删除
<SkillsDir>/vibe文件夹即可。
VibeSkills 不会替你修改 Codex、Claude 或 Cursor 的宿主设置，也不会写入系统提示词；额外的技能扫描目录由~/.vibeskills/skill-roots.json（用户级）或<workspace>/.vibeskills/skill-roots.json（项目级）管理。更多架构与设计细节可参考 docs/architecture.md。
🎯总结：下载发布包 →
install.sh/install.ps1一键安装 →check校验 → 在应用中输入$vibe开始编排任务，全流程 5 分钟即可完成。装好后，你的技能库规模越大，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），仅供参考
