发布守门员

为什么需要在发布前做审计

ClawHub 会对每个 release 做扫描，扫描没通过之前，新版本既不能被安装也不能被下载。很多作者以为拦截原因是内容或功能问题，实际最常见的是元数据不匹配——技能代码读取了一个凭证，但 SKILL.md 的 frontmatter 从未声明过它。等到收到拒绝通知再排查，代价远大于发布前先跑一遍检查。

publish-audit 处理的就是这个阶段。它不发起网络请求，也不需要任何凭证，只读取文件并推理。

它检查什么

对包含 SKILL.md 的文件夹逐项核对，每一项标记 ✓ 通过、⚠ 警告或 ✗ 阻断，并给出确切的修复方式：

• 结构：根目录必须有 SKILL.md；只允许文本文件；包体小于 50 MB；不想发布的文件用 .clawhubignore 排除。
• Slug：必须匹配 ^[a-z0-9][a-z0-9-]*$，大写、空格、下划线、前导连字符都会阻断。
• Frontmatter 必填项：name、description、version（合法 semver，每次发布都需要新版本号）。
• 运行时元数据：先列出代码实际引用的每个环境变量、CLI 二进制和配置路径，再与 metadata.openclaw 的声明对账。引用了但未声明的凭证是排名第一的拦截原因；反过来，声明了却从未使用的「幽灵声明」会被扫描器视为可疑。
• 密钥：任何已发布文件中不得出现硬编码 token、密码或私钥。
• License 与定价：统一按 MIT-0 发布，文件内出现冲突的许可证文本会阻断；不支持付费技能。
• 指令与触发质量：description 决定技能何时被触发，需要写出具体的 IF/THEN 条件和明确的「不要用于」边界，否则技能永远不会触发。
• 抗过期：文档应描述机制与坑点，而不是会随时间失效的配方式步骤。

输出与边界

报告逐条列出后，最后一行固定输出 VERDICT: READY 或 VERDICT: FIX FIRST。干净通过时还会附带一条已填好 slug、name、version 的 clawhub skill publish 命令。

需要注意：这个技能服务于发布侧的门禁，不是安装前的审查工具。判断别人的技能是否值得安装，是 skill-vetter 的工作。