SkillHub 发布前体检

概述

在真正上传前，把格式失败、安全审核风险和文案触发问题分开检查，避免用户只得到一句“看起来没问题”。

运行条件：Python 3.10+，仅使用标准库，支持目录或 ZIP；规则基于 2026-07-20 腾讯云 Skills 文件规范快照，平台规则变化时应以最新官方文档为准。

适用边界

• 支持待发布 Skill 目录或已打包 ZIP。
• 不运行包内脚本，不联网提交，不代替平台安全审核。
• “硬性阻断”依据随包附带的官方规范快照；若用户要求确认今天的规则且可联网，应再核对官方页面。
• 体检通过只表示未发现当前规则覆盖的问题，不保证平台一定上架。

运行前完整性检查

先确认当前 Skill 目录内存在且可读取 scripts/skill_guard.py。若文件不存在，立即停止并明确报告“Skill 包不完整，请重新安装完整版本”。不得临时编写、下载或使用所谓“等价实现”替代，因为那会改变本 Skill 的体检规则和结果口径。

操作流程

1. 确认待发布目录或 ZIP。若是目录，体检的是将成为 ZIP 根目录的那一层。
2. 选择目标之外的报告目录，运行：

   python scripts/skill_guard.py preflight --path <Skill目录或ZIP> --output <报告目录>

1. 读取 skillhub-preflight.md 和 skillhub-preflight.json。退出码 0 表示未发现硬性阻断或高危审核项；2 表示体检完成但存在阻断或高危审核项；1 表示运行失败。
2. 按“硬性阻断 → 安全复核 → 优化建议 → 已通过项目”顺序反馈，并给出具体文件和修复方向。

检查重点

• ZIP 根目录是否直接包含且只确定一个入口 SKILL.md。
• name、description、版本和兼容字段是否符合格式与长度要求。
• description 是否同时说清“做什么”和“什么时候调用”，避免 Agent 找不到。
• ZIP 是否超过 10 MB、300 个有效文件，或混入二进制、媒体、归档文件。
• 是否含疑似密钥、远程执行、广泛删除、数据外发、持久化或隐藏行为。
• 是否残留占位符、缓存、编辑器文件和与运行无关的内容。

规则来源、已知限制和人工核对地址见 references/skillhub-requirements.md。

输出要求

最终说明至少包含：体检状态、硬性阻断数、安全复核数、前三项修复建议、Agent 触发描述是否清晰、报告位置。不得把静态体检包装成腾讯官方认证。