用途
本技能用于在 CocoPod 技能包进入市场分发或被推荐之前，执行 CocoBrew 市场分发质量门禁。其目标是保护用户免受提示词堆砌型技能、未声明权限、安装时执行、未经测试的行为以及无正当理由的网络使用的影响。
调用方式为 $brew distribute <skill-path>。
主要能力
门禁围绕五项标准进行评估：
- 显式工具权限：SKILL.md 的 frontmatter 必须声明该技能所期望的工具或权限。
- 可观测的评估：必须存在 evals/ 目录，且其中至少包含一个可运行的评估。
- 失败行为：SKILL.md 必须记录 on_failure: 行为或等效的失败处理章节。
- 禁止安装时执行：包在安装期间不得执行代码。执行只应发生在显式命令调用时。
- 有正当理由的网络使用：任何 network: frontmatter 声明都必须包含 network_justification:。
判定结果
- Clear：所有质量标准通过，且没有安全门禁失败。可以继续分发。
- Advisory：一项或多项质量标准不完整，但没有安全门禁失败。分发需要开发者确认，CocoBrew 不会自动推荐。
- Block：安全标准失败、检测到安装时执行，或包遗漏关键权限声明。分发停止，且没有绕过标志。
使用方式
工作流如下：
- 解析
$brew distribute <skill-path>。 - 读取 SKILL.md 及其旁边的包目录。
- 在任何 LLM 审查之前运行确定性检查：
- frontmatter 包含 permissions/tools
- evals/ 存在且非空
- 存在失败处理章节
- 未声明安装钩子或安装时命令块
- 网络声明包含正当理由
- 在可用时运行现有的 trifecta/安全 检查。
- 写入
.cocoplus/brew/distribution-gate-<timestamp>.json。 - 若为 Clear，按配置的分发路径继续。
- 若为 Advisory，停止并等待确认。
- 若为 Block，停止并给出确切的失败标准。
退出标准
- Block 判定阻止分发。
- Advisory 判定需要显式确认。
- 报告需列出每一项失败的标准。
- 不允许任何安装时执行。
反合理化
技能文档中列出了常见捷径及其失败原因：
- 因为文件存在就认为技能完整：技能契约必须描述可观测的行为与验证方式，而不仅仅是命令名称。
- 因为命令小就跳过产物与安全检查：小命令同样会改变状态或引导执行，应保留相同的门禁。
适用场景与限制
适用于 CocoPod 技能包在发布或推荐前的质量与安全评估。限制方面，资料未提供关于具体平台支持范围、性能指标或额外配置选项的更多信息。