VibeSkills 验证体系完全指南install-receipt、check 与交付验收的三级语义区别【免费下载链接】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 的智能技能路由与任务编排工具它会把任务拆分给合适的 Skill 执行并全程留下可审计的证据。而它最容易被新手误解的一点就是验证体系安装收据install-receipt、完整性检查check、交付验收delivery acceptance三者各证明什么、不能互相替代什么。本文用一张语义阶梯 一张对照表带你一次看懂这三级验证的区别避免把装上了误当成做完了。为什么 VibeSkills 需要三级验证在 AI 驱动的开发流程里最容易发生的虚报是运行时跑完了、测试通过了、清理也做完了于是宣布项目交付完成。VibeSkills 的治理文档 vibe-governed-project-delivery-acceptance-governance.md 给出了核心规则governance proves process, verification proves code, acceptance proves delivery治理证明过程验证证明代码验收才证明交付。而且有一条铁律低一层的事实不能冒充高一层。check通过了不能直接说项目可交付install成功了也不能说任务跑通了。官方基准测试数据也说明了这套编排体系的价值——在 SkillsBench 上Lean Vibe 的平均奖励从 50.3% 提升到 71.4%且多数任务的奖励差为正第一级install-receipt —— 证明我装过安装 VibeSkills 后安装器会在受管目录写下安装收据收据位置SkillsDir/vibe/.vibeskills/install-receipt.json收据内容安装器实际写入的每个文件清单、来源版本信息以及receipt_kind: vibe-skill-install与install_root等标识实现见 simple_skill_installer.pyRECEIPT_RELPATH常量定义处安装模型说明见 docs/install/README.md。收据的两大实际用途给check当对账单之后检查时逐条核对登记文件是否还在、是否被改动保护更新安全update发现收据登记的文件被用户修改过时会拒绝覆盖避免静默吞掉你的定制内容。⚠️ 注意收据只证明安装发生过且当时写入了这些文件它不关心安装之后运行时是否还能正常跑、更不关心任何任务是否完成。第二级check —— 证明installed locally安装完整check是最常用的日常体检命令入口是 check.sh / check.ps1内部转调 vgo-cli 的check子命令实现见 commands.pybash ./check.sh --skills-dir $HOME/.agents/skills它的逻辑非常克制只对照安装收据检查登记文件是否缺失或被改动输出 PASS / FAIL 的 JSON 结果。官方文档对它的语义边界写得很直白docs/install/README.mdcheck只检查收据登记的文件是否仍然完整。check证明的是installed locally。它不证明runtime coherent也不证明delivery accepted。所以即使check全绿也只说明本地这份安装没被破坏。如果你想进一步证明运行时各治理门禁coherence、freshness 等一致需要走 scripts/verify/ 中的验证门禁族运行顺序参考 gate-family-index.mdCLI 侧对应verify/runtime命令commands.py。第三级delivery acceptance —— 证明项目真的交付了交付验收回答的是治理文档里的关键问题下游项目是否真正完整、可用、可信地交付给了用户它的证据链是module-work-plan.json→agent-execution-handoff.json→module-execution.json→delivery-acceptance-report.json一个真实样例见机器学习实验案例的验收报告 delivery-acceptance-report.json刷新命令与规则详见 runtime_delivery_acceptance_runtime.py。验收时会把事实拆成四层且低层不能冒充高层事实层它证明什么治理事实各治理阶段正确执行、证据链完整工程验证事实测试跑了、验证器明确通过或失败工作流完成事实计划内每个工作单元都真正执行并回收结果产品验收事实行为符合冻结的验收标准、关键流程可用、风险已知同时文档明确列出了禁止的汇报坍缩比如把治理通过说成产品验收通过、把单元测试通过说成整个下游项目被验收、把completed_with_failures说成完整交付等。一张表看懂三级验证的语义区别层级证据文件回答的问题典型命令/位置不能推出的结论1️⃣ 安装收据install-receipt.json安装器写了哪些文件安装时自动生成文件现在是否还在2️⃣ 完整性检查check输出PASS/FAIL登记文件是否完整无损check.sh运行时是否一致、任务是否完成3️⃣ 交付验收delivery-acceptance-report.json项目是否满足验收标准、可交接会话产物 验收刷新脚本——这是最高层结论一句话记忆收据管装没装check 管坏没坏验收管能不能交。新手最常见的三个误区 ❌check 全绿 项目完成—— 错。check 只覆盖收据登记的安装文件完整性与任务结果无关install 成功 vibe 能跑任务—— 错。安装成功只是第一层事实运行时一致性需要验证门禁来证明测试通过 可以宣布交付—— 错。按验收治理规则工程验证事实不能直接升级为产品验收事实交付措辞必须与证据匹配。小结VibeSkills 的验证体系本质上是一条语义阶梯install-receipt→check→ 运行时门禁 →delivery acceptance每一级只回答自己那一层的问题绝不上位冒充。理解这条阶梯你就能在任何一次运行后诚实地回答四个问题装好了吗没坏吗流程跑对了吗真的能交付吗答案分别对应不同证据缺一不可。【免费下载链接】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），仅供参考
