SkillHub 发布验证器

要解决什么问题

往 SkillHub 上架技能前，Frontmatter 字段缺漏、name 与版本号在 _meta.json / metadata.json 里对不上、包里夹带 __pycache__ 或 .DS_Store，都会在审核或安装环节踩坑。手工对照文档逐项核对既慢又容易漏项。

技能如何工作

本验证器按 SkillHub 发布规范 对技能目录做静态扫描，并给出带错误码的结构化报告（如 FL001～FL005 文件规范、CN001/CN002 命名、VC001/VC002 版本一致性、FP001 内容规范）。

• Frontmatter：检查 name、version、description、tags、icon、author、license、schema_version、metadata 等必填与格式。
• 文件与体积：限制文件数量与总大小，拦截常见脏文件（__pycache__、.pyc、.DS_Store）。
• 命名与版本：校验 name 字符与长度上限，并比对各 manifest 中的 version 是否一致。
• 内容：对疑似虚假宣传类问题打标，便于发布前人工复核。

实现上依赖 Python 3.8+ 与标准库（yaml、pathlib、json 等），适合在本地打包或 CI 里跑一遍再提交。

适用边界

这是 合规性检查工具，不能替代 SkillHub 平台侧的最终审核；FP001 等语义类规则仍需人工判断。错误码与检查项以技能文档 v1.0.0 为准，平台规范更新后需对照官方文档确认是否仍覆盖全部要求。