SkillHub 上传资料包预检器
将以下提示词粘贴到你的 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 的独立开发者