SkillHub 技能发布

解决自动化发布的环境差异与校验难题

在将 WorkBuddy 技能推送到 SkillHub 时，纯粹的命令行调用往往不够。不同平台的环境差异、SKILL.md 元数据格式的严格校验、以及沙箱网络限制，都可能导致发布流程中断。该技能封装了一套标准化的发布工作流，帮助 Agent 在执行上传任务时正确处理环境兼容与校验逻辑。

核心工作流与校验机制

该技能主要覆盖了从元数据检查到最终上传的全过程：

• 校验 Frontmatter：发布前严格检查目标技能的 YAML 头部信息，确保 slug 为 kebab-case 格式，version 符合 Semver 规范，并建议补齐 summary 和 license 等展示字段。
• 预检机制：强制要求在执行真实上传前运行 --dry-run，仅进行格式校验而不会触发网络请求，从而降低因配置错误导致的无效提交。
• Windows 环境兼容：针对 Windows Git Bash 中 install.sh 的路径解析 Bug，提供了基于纯 Python 的 CLI 备用方案（skillhub_kit/cli/skills_store_cli.py），确保跨平台发布的一致性。

适用边界与安全注意点

• 人工介入前置：该技能无法代替用户完成手机号注册、人脸实名认证等依赖真实身份的前置步骤。
• 凭证安全：处理包含 skh_ 前缀的 API Token 时，技能严格遵循不将凭证写入文件或持久化记忆的安全原则。
• 沙箱网络限制：在受限的 Agent 沙箱环境中，直连 SkillHub 或对象存储（COS）可能受阻，此时需要显式申请网络访问权限才能完成下载与发布操作。