VibeSkills 代码结构深度解析runtime-core、verification-core 等 6 大核心包的分工与协作【免费下载链接】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 pp 的奖励提升与 29.6% 的 token 节省。想读懂这个项目关键就是搞清packages/目录下runtime-core、verification-core 等 6 大核心包的分工与协作方式。本文带你快速建立全局认知无需逐行读代码。一分钟看懂仓库顶层结构VibeSkills 采用Python 多包monorepo 数据面分离的布局顶层目录各司其职目录角色一句话说明packages/ 核心代码层6 个可独立发布的 Python 包core/ 契约层冻结的官方技能契约7 个首批技能config/⚙️ 治理配置数百份 JSON 策略/路由/内存治理配置adapters/ 宿主适配各 AI 宿主claude-code、codex 等的适配描述bundled/skills/ 技能库200 个随附技能scripts/️ 运维脚本安装、校验、发布、路由脚本tests/✅ 测试体系单元/集成/契约/回放四类测试6 大核心包各自的职责边界packages/下的 6 个包版本统一为4.1.0要求 Python ≥ 3.10是理解 VibeSkills 代码结构的主线。1. runtime-core —— 工作内核语义核心包名vgo-runtime自述为 Runtime core for Vibe-Skills clean architecture是整个系统的大脑。源码主入口packages/runtime-core/src/vgo_runtime/kernel/内核负责任务理解 → 技能查找 → 计划构建 → 执行 → 验证 → 证据留存的完整闭环关键模块一览task_card.py把目标固化为任务卡片planner.py构建有界工作计划executor.py执行工作单元verifier.py验证运行结果run_state.py持久化运行状态内核外的 runtime-core 顶层模块如governance.py、memory.py、stage_machine.py负责治理、工作区记忆与阶段状态机设计哲学内核应保持短小、可读——如果一个改动让系统比这条主线更难解释设计就在漂移见 docs/architecture.md。2. verification-core —— 验证核心质量守门员包名vgo-verify即 Verification core for Vibe-Skills clean architecture。源码packages/verification-core/src/vgo_verify/核心职责判断现有证据能证明什么、不能证明什么把绑定了与用过了、脚手架输出与完成的工作严格区分开关键模块gate_engine.py门禁引擎scenario_runner.py scenarios/场景化验证矩阵install/runtime 双矩阵runtime_delivery_acceptance.py运行时交付验收test_baseline_audit.py测试基线审计3. contracts —— 契约层权威数据模型包名vgo-contractsAuthoritative contracts for Vibe-Skills clean architecture。源码packages/contracts/src/vgo_contracts/17 个契约模块定义了包与包之间的权威数据形状例如 adapter_descriptor.py宿主适配描述、runtime_packet.py运行时输入包、verification_scenario.py验证场景、install_ledger.py安装台账它是共享词汇表runtime 与 verification 之间传递的每个结构体都以这里的定义为唯一事实来源4. installer-core —— 安装核心文件落盘与更新安全包名vgo-installer。源码packages/installer-core/src/vgo_installer/职责文件放置 回执receipt驱动的更新安全即installer owns file placement and receipt-owned update safety关键模块install_plan.py / install_runtime.py安装计划与落地、uninstall_service.py卸载、repair.py修复、ledger_service.py台账服务5. adapter-sdk —— 宿主适配 SDK环境边缘层包名vgo-adapters。源码packages/adapter-sdk/src/vgo_adapters/只有 3 个精简模块descriptor_loader.py读取adapters/下的宿主描述、target_root_resolver.py解析目标安装根目录边界纪律宿主层可以执行但不可以解释——PowerShell 脚本等宿主细节在此层止步不再决定工作语义6. skill-catalog —— 技能目录独立能力面包名vgo-skill-catalogDetached skill catalog package强调解耦。目录数据packages/skill-catalog/catalog/含 profiles/full/minimal两种分发包与 metadata/含 official-skill-contracts.json源码exporter.py 负责目录导出设计原则技能应在自己附近自描述新增一个普通技能不应该需要动路由器协作全景一次任务如何穿越 6 个包VibeSkills 的官方架构主线只有一条摘自 docs/architecture.mdtask card - build work model - bind skills - produce evidence - verify scope - prove only what is proven对应到包协作就是skill-catalog / bundled提供能力原料 → 2.contracts统一双方数据结构 → 3.runtime-core的任务卡片 内核完成计划与执行 → 4.verification-core对证据做范围验证并产出证明 → 5.installer-core保证技能文件正确落盘且可安全更新 → 6.adapter-sdk屏蔽 Windows/macOS/Linux 与不同 AI 宿主的差异。边界规则Boundary Rule是理解分工的钥匙内核拥有语义兼容层可以翻译但不能决定宿主层可以运行但不能解释技能层可以贡献能力但不能接管工作流。迁移期哪些旧路由/治理面还算权威、哪些只是外壳统一记录在 config/kernel-boundary-demotion-matrix.json这是阅读config/下数百份治理 JSON 前最值得先看的一份文件。架构效果基准数据佐证这套内核 验证的分工并非纸上谈兵。在 SkillsBench 上接入 VibeSkills 技能编排后任务奖励从 50.3% 提升到 71.4%且 96% 的任务奖励持平或更高同时 token 总消耗从 4.91 亿降至 3.46 亿约 −29.6%工具调用量降至 0.67 倍详见 docs/ 与 docs/architecture.md。新手上手路径建议按这个顺序读代码效率最高先读 docs/architecture.md160 行讲清分层与边界再看 core/README.md7 个首批冻结契约技能vibe、tdd-guide、systematic-debugging 等的入口约定然后按kernel/__init__.py的导出顺序见 kernel 入口TaskCard → WorkPlan → execute_work_unit → verify_run走一遍内核主线最后用 tests/runtime_neutral/100 个测试文件反查各包的行为契约一句话总结VibeSkills 的代码结构 一个短小的工作内核runtime-core 一个严格的证据守门员verification-core 三个各司其职的支撑包contracts / installer-core / adapter-sdk / skill-catalog。读懂这条主线你就掌握了它 80% 的设计。【免费下载链接】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），仅供参考