SkillHub 技能发布助手

解决什么问题

当你把某个能力写成了 SKILL.md，它通常只能在本地被调用。要让其他人也能安装和使用，就需要把它发布到 SkillHub 商店。这个过程看起来只是「上传一个文件」，实际踩坑不少：slug 和已有技能冲突、version 写成 1.0 被拒、漏填 displayName 字段导致校验失败。这个技能的作用，就是把发布流程固化成一套 agent 可执行的步骤，让它自己完成检查、校验、提交，而不是靠人盯着报错信息反复试。

技能如何工作

核心能力是引导 agent 走完一条固定链路：

• 前置检查：确认 SkillHub 已安装、当前处于登录状态；未登录时向用户索取 API Token，而不是假设凭据一定存在。
• 规范撰写 SKILL.md：按字段表逐项核对——name、slug、displayName、description、version、author、tags 全部必填，slug 需保证唯一，version 必须是合法 SemVer（如 1.0.0）。
• 本地 dry-run：先在本地跑一遍验证，成功才允许发布；失败时按错误表定位原因，比如缺 slug、版本号格式不对、slug 冲突。
• 发布与编号：校验通过后提交发布，记录返回的 skillId，作为技能在商店中的唯一标识。
• 生成安装方式：发布完成后产出对应的安装提示，方便他人复用。

适用边界与注意点

这个技能适合「自建技能、自行发布」的场景，它不负责技能的内容设计，也不替代 SkillHub 本身的安装流程。几个容易翻车的点值得留意：

• 发布前必须 dry-run，跳过验证直接发布，大概率撞上字段缺失或格式错误。
• slug 唯一性靠抢，冲突时没有捷径，只能换一个独特的 slug。
• 版本号严格遵守 SemVer，1.0 和 v1.0.0 都不合法。
• 描述和 changelog 要写实，前者决定别人会不会安装，后者交代本次改动内容。
• 登录态是前提，发布前确认已登录，否则会在提交阶段报错。