Agent Skills
返回列表
SkillHub 上传资料包预检器

SkillHub 上传资料包预检器

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_cc4c37b3/skillhub-upload-preflight。

技能介绍

为什么要做上传前预检

往 SkillHub 提交技能时,平台对目录结构、SKILL.md frontmatter、包体大小和路径规范都有硬性要求;若 ZIP 里还夹着 macOS 元数据或疑似密钥的文本,审核与安全扫描也会拖慢甚至被拒。与其打包上传后才发现错误,不如在本地用只读方式先跑一遍规则,拿到可执行的修复清单。

技能如何工作

预检器针对你明确指定的 Skill 目录或 ZIP 运行 scripts/validate_skillhub_package.py(Python 标准库即可),不会改写原始资料包。核心检查包括:

  • 根目录是否存在 SKILL.md,且 YAML frontmatter 里 name、description 合规
  • 文件数 ≤ 200、总大小 ≤ 10 MB
  • ZIP 内路径仅用 /,禁止反斜杠、绝对路径、盘符与 ..
  • 提醒清理 __MACOSX、.DS_Store、Thumbs.db 等无关文件
  • 在文本文件中提示疑似 API Key、Token、私钥或硬编码密码(需人工确认,报告不会展示真实密钥)

结果分为三类:错误(必须修复才能视为可上传)、警告(通常可上传但公开前应确认)、通过(仅表示通过本地预检)。需要 CI 对接时可加 --json;退出码 0 表示无阻断项,1 表示存在阻止上传的错误。

边界与注意点

通过预检不代表平台一定审核通过,也不替代平台侧安全扫描。修复问题前应先看报告里指明的目标文件并向用户说明,再动刀改包;不要指望它扫描未指定的目录,也不会把扫描内容上传出去。

使用场景

  • 在本地打好 Skill ZIP 后、上传 SkillHub 前,想确认是否满足 200 文件与 10MB 限制
  • 从 macOS 打包的技能目录里混入了 __MACOSX 或 .DS_Store,提交前需要一份清理与路径问题清单
  • CI 流水线在 merge 前自动跑预检,用 --json 和退出码阻断不合规制品进入发布分支
  • 公开分享技能前,想让脚本扫一遍仓库文本,提示是否误提交 Token 或私钥片段

适合人员

  • 维护团队私有 Skill 仓库、每次发版都要对齐 SkillHub 目录规范的工程维护者
  • 在 Windows/macOS 混编环境下打包 ZIP、经常踩路径分隔符与 .. 规则的技能作者
  • 负责 SkillHub 上架流程、需要把人工检查清单脚本化给贡献者的平台运营
  • 对公开仓库做安全自检、担心 SKILL 附属文档里硬编码了 API Key 的独立开发者