SkillHub 发布前体检
在真正上传前，把格式失败、安全审核风险和文案触发问题分开检查，避免用户只得到一句“看起来没问题”。
运行条件：Python 3.10+，仅使用标准库，支持目录或 ZIP；规则基于 2026-07-20 腾讯云 Skills 文件规范快照，平台规则变化时应以最新官方文档为准。
适用边界
- 支持待发布 Skill 目录或已打包 ZIP。
- 不运行包内脚本，不联网提交，不代替平台安全审核。
- “硬性阻断”依据随包附带的官方规范快照；若用户要求确认今天的规则且可联网，应再核对官方页面。
- 体检通过只表示未发现当前规则覆盖的问题，不保证平台一定上架。
运行前完整性检查
先确认当前 Skill 目录内存在且可读取 scripts/skill_guard.py。若文件不存在，立即停止并明确报告“Skill 包不完整，请重新安装完整版本”。不得临时编写、下载或使用所谓“等价实现”替代，因为那会改变本 Skill 的体检规则和结果口径。
操作流程
- 确认待发布目录或 ZIP。若是目录，体检的是将成为 ZIP 根目录的那一层。
- 选择目标之外的报告目录，运行：
text
python scripts/skill_guard.py preflight --path <Skill目录或ZIP> --output <报告目录>
- 读取
skillhub-preflight.md和skillhub-preflight.json。退出码0表示未发现硬性阻断或高危审核项；2表示体检完成但存在阻断或高危审核项；1表示运行失败。 - 按“硬性阻断 → 安全复核 → 优化建议 → 已通过项目”顺序反馈，并给出具体文件和修复方向。
检查重点
- ZIP 根目录是否直接包含且只确定一个入口
SKILL.md。 name、description、版本和兼容字段是否符合格式与长度要求。description是否同时说清“做什么”和“什么时候调用”，避免 Agent 找不到。- ZIP 是否超过 10 MB、300 个有效文件，或混入二进制、媒体、归档文件。
- 是否含疑似密钥、远程执行、广泛删除、数据外发、持久化或隐藏行为。
- 是否残留占位符、缓存、编辑器文件和与运行无关的内容。
规则来源、已知限制和人工核对地址见 references/skillhub-requirements.md。
输出要求
最终说明至少包含：体检状态、硬性阻断数、安全复核数、前三项修复建议、Agent 触发描述是否清晰、报告位置。不得把静态体检包装成腾讯官方认证。
