技能介绍

你不再需要手动翻打包和版本号

手动把本地技能目录发布到 SkillHub，看起来只是"把文件传上去"。实际上，你需要先把发布契约字段写进 SKILL.md 的 frontmatter，确保 slug、version、displayName 全部合法；还要确认本地没有夹带 .git、node_modules 等不该上传的中间文件；发布前还得查一遍线上是否已经有同 slug 或同版本号的技能。如果版本号没注意，很容易撞上 409 VERSION_EXISTS，最后只能重新改版本、重新打包、重新上传。

这个技能把以上流程拆成一条有确定性的流水线：

它做了什么

前置仍是硬门槛：SKILL.md frontmatter 必须包含 slug（kebab-case，2-128 字符）、version（SemVer）、displayName；认证必须使用 skh_ 开头的 PAT，且优先通过环境变量或 CLI 凭据文件传递，不要写进任何本地文件。CLI 则由脚本按 SKILLHUB_CLI 环境变量、~/.skillhub/ 安装目录、工作区内置路径的顺序查找。

执行流程大致分五步：

Step 1 元数据校验：dry-run 在解析 token 之前运行，专门暴露 frontmatter 缺失或格式错误。
Step 2 线上版本查询：判断 @handle/slug 是自己的还是被占用的，据此决定升级旧技能还是更换 slug。
Step 3 正式发布：调用 POST /api/v1/community/skills/publish，返回 skillId、versionId 等信息后进入平台审核。
Step 4 冲突自动处理：遇到 409 / VERSION_EXISTS 时，脚本会按当前版本号建议 minor+1 或 major+1，由执行者确认后重新发布。
Step 5 发布后验证：检查线上可见性，确认状态进入审核或公开。

适用边界

它只负责"发布"这一件事，不负责技能内容生成、审核跟进或市场推广；也要求你的技能目录里已经存在符合契约的 SKILL.md。发布接口有频控，连续发版可能触发 429，需要等待后再试。另外，slug 是技能的身份标识，如果内容变化大，更合理的做法是升 minor 或 major 版本，而不是换一个新 slug 重新发布。