Skill 发布门禁
在发布或分发 Agent Skill 目录 bundle 前使用此 skill。
工作流
- 将
SKILL_ROOT解析为包含本已安装SKILL.md的绝对目录。不要假定进程 cwd 就是已安装 bundle。 - 从原始工作区工作目录解析
TARGET_ROOT，并将用户提供的候选解析为绝对TARGET_BUNDLE。 - 从
SKILL_ROOT读取references/eval-contract.md。 - 检查
TARGET_BUNDLE下evals/cases.json中的正例和近似请求触发案例。 - 检查
TARGET_BUNDLE下evals/artifacts.json中共享的 baseline 与使用 skill 后断言。 - 检查
TARGET_BUNDLE下evals/evidence.json中显式的脚本和安全结果。 - 检查
TARGET_BUNDLE下assets/hosts.json声明的运行时能力，并对照其assets/manifest.json验证目标文件哈希。 - 对于生产，用捕获结果替换确定性预测、产物、证据和宿主能力；设置四种捕获模式；并将每个原始触发观察、两份产物、完整证据集和非空宿主矩阵绑定到非空来源及匹配的 SHA-256 溯源摘要。这些本地检查可设置
localEvidenceReady，但可在本地重算的哈希不能证明捕获真实性。 - 获取一份外部 JSON 证明，其
evidenceRoot与报告相匹配；并从独立受信策略或发布渠道获得其精确字节的 SHA-256。证明必须是目标 bundle 外的常规文件。 - 执行前展示精确解析后的 argv。已安装评估器位于
SKILL_ROOT下的scripts/evaluate_skill.py。对随附课程 fixture，用python3、该绝对评估器路径、--fixture-demo和绝对TARGET_BUNDLE构建 argv。对生产，使用同一已安装脚本并传入--attestation、--trusted-attestation-sha256和绝对TARGET_BUNDLE，但不传--fixture-demo。 - 返回
checksPassed、fixturePassed、localEvidenceReady、trustAnchorValid、productionReady和passed，同时给出证据根、评估模式、失败检查、精确率、召回率、每个原始触发观察、每案例重复运行率、产物比较、脚本和安全证据、已安装目录树验证及可移植性矩阵。包含已解析脚本路径、已解析目标路径、cwd、精确 argv 和退出码。将不可用观察标为未验证。
Output contract
返回完整 JSON 评估报告。保留每项分层检查及其证据，避免一个通过的汇总掩盖路由、产物、脚本、安全、已安装目录树或可移植性失败。fixturePassed 表示教学 fixture 成功；localEvidenceReady 仅表示本地摘要完整性；只有 productionReady 也具有有效的包外信任锚时，passed 才为 true。
Failure behavior
若配置无效、溯源缺失或不匹配、受信证明缺失或无效、文件哈希不同、必需能力缺失，或任一生产门禁失败，均以非零结果停止并报告失败层。显式 --fixture-demo 路径仅在 fixturePassed 为 true 时才可成功退出，且绝不作出发布声明。绝不自动发布、安装到其他位置、修复证据、创建信任决策或放宽阈值。
不要仅因 SKILL.md 能解析或一个正例 prompt 被激活就发布 bundle。目标宿主丢弃必需伴随文件或忽略必需运行时扩展时，不要将包标为可移植。
