SkillHub Pay Skill 发布全流程
用途
把一个普通 Skill 变成 SkillHub 上按调用次数收费的 Pay Skill。整个链路分两个阶段，
顺序不可颠倒：支付宝侧必须先开通产品，SkillHub 侧的第 ③ 步「完善计费」才进得去。
阶段 A：支付宝 AI 按量付费入驻 → 拿到 serviceId + appId + 密钥
阶段 B：SkillHub Pay Skill 发布 → A2M 改造 + 打包 + 4 步上传 + 案例
何时使用
- 要把 Skill 做成收费（按次计费）发布到 SkillHub
- 卡在 SkillHub「③ 完善计费」进不去
- 平台报「未检测到支付宝 A2M 付费改造」（关键词缺失）
- 需要生成效果案例文案（标题 ≤30 字 + 说明 ≤200 字）
关键认知（先读，能省几小时）
- CLI
publish只能完成第 ② 步。 SkillHub CLI 没有--price参数，
SKILL.md frontmatter 写pricing: {model: per_call, amount_fen: N}只是保底，
真正的价格必须在网页端第 ③ 步手填，AI 无法代劳。 - 平台靠关键词扫描检测付费改造。 SKILL.md 里必须出现
402、
Payment-Proof、Payment-Needed、probe、/pay、/complete、/ack、
trade_no、alipay-sdk-python、@alipay/aipay、幂等—— 缺任一项都会被判定为
「未检测到支付宝 A2M 付费改造」。 - 补案例会触发版本号自动 bump（如 1.0.2 → 1.0.3）并进入安全审核，
审核期间 Skill 会自动下架。这是正常现象，不是失败。 - 审核期间切勿用 CLI 重发，会再 bump 一次版本、重新排队，白等一轮。
- 行业单次定价普遍 ¥0.002–0.3。 定价 ¥10/次 几乎无人问津；建议引流价 ¥0.1/次，
正价走「免费引流 + 授权码订阅」的组合模型。
执行流程
阶段 A：支付宝 AI 按量付费入驻
前置确认（必须问清再动手）：
| 问题 | 为什么重要 |
|---|---|
| 主体是个人身份证还是营业执照？ | aipay 的「在线工具」等类目个人身份即可签；但部分类目需企业资质 |
根意图是 onboarding_only 还是 full_process？ |
只做签约选前者；要改平台代码才选后者（多数人不需要） |
完整命令序列、参数细节与 6 个已知踩坑见 references/alipay-onboarding.md。
红线：应用私钥必须由用户在本机生成并自行保管，
AI 不得生成、读取、传输或保存私钥。只上传公钥。
阶段 A 交付物：serviceId、appId、应用公钥、支付宝公钥、生产网关。
阶段 B：SkillHub Pay Skill 发布
B1. A2M 付费改造（必做）
给目标 SKILL.md 追加 A2M 接入规范章节。模板见 references/a2m-spec.md，
也可用脚本自动追加：
python3 scripts/patch_a2m.py <skill-dir> --price-fen 10 --version 1.0.2
追加后必须校验关键词覆盖：
python3 scripts/check_a2m_keywords.py <skill-dir>
B2. 打包
python3 scripts/make_publish_zips.py <staging-dir> --out <output-dir>
会为每个 Skill 生成独立 zip（含 SKILL.md + package.json + references/ + demos/）。
打包后自检：不得包含 skh_ token、本地绝对路径、图片文件。
B3. 网页端 4 步上传（必须人工操作）
- Pay Skill 改造 —— 读指引，确认支付宝侧产品已开通
- 上传基本信息 —— 拖 zip/文件夹，填 Slug（必须复制粘贴，一字不差） + 显示名称 + 版本
- 完善计费 —— 填单次调用价格（字段标「元」填 0.1，标「分」填 10），填 appId / serviceId / PID
- 验证 & 案例 —— 补 1 个效果案例即可（不必填满 3 个）
Slug 写错会创建新 Skill 而不是升级，务必复制粘贴。
B4. 效果案例文案
SkillHub 弹窗只有两个字段：案例标题 ≤30 字 + 补充说明 ≤200 字。
四要素结构（客户场景 → 输入 → 输出亮点 → 价值）压缩写法见 references/case-templates.md，
内含 6 个岗位（HR/行政/财务/法务/研发/销售）现成文案可直接复用。
B5. 发布后
- 等审核：通常 1–3 个工作日，期间 Skill 显示「安全审核中/已下架」，属正常
- 不要重发：任何改动都会重置审核队列
- 选分类：审核通过后第一件事是给 Skill 选分类，否则市场搜不到
- 对外演示：审核期间客户搜不到，改用独立部署的演示页，与审核状态解耦
交付检查清单
阶段 A：
- [ ] 产品签约状态 = SIGNED_EFFECTIVE
- [ ] 服务市场 serviceId 已创建且 ACTIVE
- [ ] 应用状态 = ON_LINE
- [ ] 应用公钥已确认、支付宝公钥已导出
- [ ] 私钥留在用户本机，未被传输
阶段 B：
- [ ] SKILL.md 关键词自检全通过
- [ ] zip 无敏感信息、无图片
- [ ] Slug 复制粘贴自源目录名
- [ ] 第 ③ 步价格已填（元/分单位核对过）
- [ ] 至少 1 个效果案例
红线
- ❌ 不生成、不读取、不传输应用私钥
- ❌ 审核期间不重发、不改动 SKILL.md
- ❌ 不在 SKILL.md 或发布包中写入真实 appId / serviceId / token / 手机号
- ❌ 不承诺审核时长；只说明「通常 1–3 个工作日」
