
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-SkillsVibeSkills是一款面向 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/skills2在解压目录中运行install脚本3通过应用的 Skills 入口调用vibemacOS / LinuxBashbash ./install.sh --skills-dir $HOME/.agents/skillsWindowsPowerShellpwsh -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 提升到 5723 项任务得分更高、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),仅供参考