SkillHub 上架陪跑向导
引导一个没上过架的开发者，从零走完 SkillHub（skillhub.cn）技能上架全流程。
核心理念是陪跑模式：一次只给用户一步，帮用户把网址直接打开，等用户回报「好了」再给下一步——不要一次甩出全部步骤。
陪跑模式铁律
- 每轮只给一个步骤，动作数量控制在 3 个以内（如「点登录 → 选手机号验证码 → 输验证码」）。
- 网址用
open <url>直接帮用户打开（macOS），不要只贴链接让用户自己找。 - 每步结尾明确说「做完回我一声，我给下一步」；页面对不上时让用户描述看到的界面。
- 涉及用户本人身份的动作（手机验证码、人脸核身）只能用户做，agent 不代劳。
第 1 步：注册账号（用户做，约 2 分钟）
open https://skillhub.cn- 右上角「登录」→ 手机号验证码登录（不是微信扫码）→ 收 6 位验证码 → 登录
- 首次登录自动注册。完成判据：右上角出现头像。
第 2 步：实名认证（用户做，约 3 分钟，硬闸门）
open https://skillhub.cn/dashboard- 找「实名认证」入口 → 手机扫二维码 → 腾讯云人脸核身刷脸（信息加密存储，仅用于身份核实）
- 失败多为光线/角度问题，重试即可。
- 不实名连 API Token 都建不了——这步没过，后面全停。完成判据：状态显示「已认证」。
第 3 步：创建 API Token（用户做，约 1 分钟）
open https://skillhub.cn/dashboard/keys- 左下角「创建 API key」→ 名称随意（如
Mac） - 弹窗显示
skh_开头的长串，只显示这一次，让用户立刻复制粘贴给 agent - 安全约定：Token 只在本次会话使用，不写入任何文件；丢了就在 keys 页删掉重建。
第 4 步：装 CLI 并登录（agent 代办）
# 安装（仅 CLI）
curl -fsSL https://skillhub.cn/install/install.sh | bash -s -- --cli-only
# 登录（路径默认 ~/.local/bin/skillhub）
~/.local/bin/skillhub login --key skh_xxx --host https://api.skillhub.cn
# 校验身份
~/.local/bin/skillhub auth whoami
第 5 步：发布前体检（agent 代办，用本技能脚本）
bash scripts/check_publish_ready.sh <技能目录>
体检项与规则来源（均为实测踩过的坑）：
| 检查项 | 规则 |
|---|---|
| frontmatter 完整性 | name / description / version / license / slug / displayName / summary 七个字段必填；dry-run 不查 description，正式发布必查 |
| 盗版检查 | 目录含 _skillhub_meta.json = 从市场装的别人技能，重发即盗版，必须剔除 |
| 敏感信息 | 本机绝对路径（/Users/xxx）、手机号、品牌词、运行日志全部清除 |
| 图标 | 包内不允许 PNG——平台报「不允许的文件类型」；图标在网页端「我的 Skill → 编辑」单独上传，建议 512×512 |
slug 命名建议 <handle>-<技能名> 保证全网唯一；license 个人发布常用 MIT。
第 6 步：发布（agent 代办，用限速脚本）
# 先本地预检
~/.local/bin/skillhub publish <技能目录> --dry-run
# 正式发布（撞限频自动等 70 秒重试）
bash scripts/publish_backoff.sh <技能目录> "首次发布：<一句话说明>"
限速经验（实测）：连续发布会撞「请求过于频繁」，间隔 70 秒稳定通过；批量发布时务必逐个 sleep 70。
常见错误码：
401Token 失效 → keys 页删掉重建403未实名 → 回第 2 步409slug 被占 → 换 slug429限频 → 等 70 秒重试
第 7 步：审核与更新
- 发布成功返回
status=pending_review，审核 1–7 个工作日，通过后详情页自动可见 - 状态在
https://skillhub.cn/dashboard/skills查看 - 版本更新很轻：改完文件再跑一次
skillhub publish <目录> --changelog "改了什么"
变现提示（如实告知用户）
- 免费上架拿的是下载量/评分/搜索排名，不产生现金
- 真收钱走 Pay Skill（按次计费、定价权归商家、平台暂免技术服务费）：个人通道需实名 + 开通收款能力（支付宝即可）；企业通道需企业认证 + 微信商户号
- 本地自动化类技能（依赖用户自己电脑的浏览器/登录态）不能直接转 Pay Skill——Pay Skill 要求云端沙箱可调用
