SkillHub 一键发布助手

这个技能解决什么问题

当你把一个本地 Skill 目录开发完之后，想把它发布到 SkillHub 社区，会接连碰到几道硬门槛：CLI 是否装好、登录凭证怎么安全传入、SKILL.md 的 YAML frontmatter 字段是否齐全、目录里有没有 .bat 这类会被平台拒收的可执行文件，最后还要把 payload 和一堆文件按 multipart/form-data 正确组装上传。手工做这些事很容易在半路失败，而且报错信息未必能直接告诉你下一步该改什么。

publish-to-skillhub 把这些环节收进一条固定顺序的流程里，你只需要在适当的时候给出 token 和目标目录。

它怎么工作

核心能力是封装从检查到上传的七个阶段：

• 阶段 1：确认 ~/.skillhub/cli/skills_store_cli.py 存在，缺失时才执行安装。
• 阶段 2：用 skh_ 开头的 token 临时登录，凭证写入 ~/.skillhub/credentials.json，后续发布不必重复登录。
• 阶段 3：用 Read 工具读取目标技能的 SKILL.md，核对 slug、version、displayName、name、description 等字段，缺失就用 Edit 工具补上。
• 阶段 4：用 Glob 找出 .bat 文件并重命名为 .txt，同时跳过 .git、node_modules、__pycache__ 等目录。
• 阶段 5：跑一遍 dry-run 验证，通过后再执行发布。
• 阶段 6：调用 POST /api/v1/community/skills/publish 上传，请求头带 Authorization: Bearer skh_xxx，返回 skillId。
• 阶段 7：提醒你到 SkillHub 官网「我的技能」页面查看审核状态。

发布接口的技术细节：API Host 是 https://api.skillhub.cn，认证走 Bearer token，上传格式是 payload JSON 加多个 files part。

适用边界与注意点

• token 只在命令行临时使用，不要写进任何文件或日志。
• slug 必须是 kebab-case，只能含小写字母、数字和连字符，且以字母或数字开头结尾。
• version 必须符合 SemVer 的 X.Y.Z 格式。
• .bat 文件上传会被拒，改名后记得同步更新 SKILL.md 里的引用说明。
• 遇到 HTTP 401 说明凭证失效，去 skillhub.cn 重新生成；遇到 HTTP 429 是平台按 token 或 IP 限流，稍后重试。
• 新发布的技能要等平台审核通过后才会公开上架，dry-run 通过不等于已经上架。
• 前置条件是本机有 Python 3.x、已安装 SkillHub CLI，并且持有有效的 skh_ token。