payskill 全自动改造升级工具（付费版）

本服务把任意普通 AI Skill 改造成支付宝 AI 按量付费（A2M/HTTP 402）的 Pay Skill。

• 服务单价：3.88 元/次（支付宝 A2M，按次收费，先付后用）
• 服务流程：先与用户确认改造需求与参数 → 用户支付 → 从后端获取完整技能包 → 在本地重建并执行完整改造
• 核心实现（convert.py 改造脚本、阿里云 FC 部署指引、后端模板、阶段方法论）存放在服务端 core/，付费验证通过后一次性下发；未支付前不提供任何核心内容，前端包内也不含任何可执行实现。

支付前：先与用户对话确认参数

发起支付前，先与用户对话确认以下参数，未确认完整前不支付、不执行：

确认完整后，进入付费流程（见下方「支付宝 AI 按量付费（A2M）」章节）。

关于待改造 skill 文件（重要）：先判断你是否能直接访问用户提供的本地路径（本地 agent 通常可直接访问该路径）。能访问就直接用；不能访问时，请用户把 skill 文件夹压缩成 zip 上传到会话，你下载/接收后解压到工作目录。拿到 skill 前无法执行改造，但可以并行推进环境自检与参数确认。

支付宝 A2M 交互约定

• 所有支付宝 A2M 相关操作（probe / pay / complete / 状态查询）统一以 @alipay/aipay 服务标注；
• 收到 402 Payment-Needed 响应后，向用户展示支付方式并等待支付完成；支付成功后调用 complete 履约；
• 每次请求/响应均校验 trade_no 与订单状态并做 ack 确认；同一 trade_no 的履约操作必须幂等，重复调用不重复扣费、不重复下发。

支付成功后：立即执行完整改造（本技能的核心交付，缺一不可）

支付完成后，你【必须】连续完成以下全部动作，不允许只向用户确认"已支付"就结束、不允许把技能包内容或部署说明转述给用户当交付：

步骤 1 — 获取完整技能包（必须执行）
运行 complete 命令，完整技能包自动落盘到本地：
- 原始完整响应：.state/<session>/complete_raw.json
- 技能包文件：.state/<session>/core-package/（SKILL.md + scripts/ + references/ + templates/ 按相对路径落盘）
- 必须用文件读取工具（Read）读取 core-package/ 下的每个文件，禁止依赖终端输出（终端只含落盘摘要）；若发现截断，直接从本地 core-package/ 恢复，绝对不要重复调用 complete/probe/pay（履约不可重放，重复拉取会得到 502）；
- 按 manifest 核对文件数（当前版本 28 个文件，以实际 manifest 为准），齐全后再继续。

步骤 2 — 环境自检与补齐（必须执行）
改造需要：Node.js ≥ 18、Python 3、curl、s（Serverless Devs）、alipay-bot。
- 执行 node -v、python3 -V、curl -V、s -v、alipay-bot --version 逐项检查；
- 缺失的工具由你负责安装（如用 npm 装 node、npx -y @alipay/agent-payment@latest install 装 alipay-bot、npm 全局装 @serverless-devs/s 等），不要因为环境缺失而停下来或跳过改造。

步骤 3 — 获取用户待改造 skill（必须交互）
- 优先直接使用用户提供的本地路径（本地 agent 通常可直接访问用户给的本地路径）；若无法访问，请用户把 skill 文件夹压缩成 zip 上传到会话；
- 拿到后放入工作目录（如 ./target-skill/），确认根目录含 SKILL.md；
- 用户未提供前，提醒并等待，同时可并行做环境自检（步骤 2）。

步骤 4 — 进入改造执行模式（必须执行，核心交付优先）
- 打开 core-package/SKILL.md，按其顶部「⚠️ 执行者须知」进入执行模式；
- 立即从「阶段 0」开始实际执行完整改造：分流 → 收集参数（含用户对"防抄袭保护"的选择）→ 审计 → convert.py 改造（分支 B 先用占位 URL；用户选择保护才传 --protect）→ 验证（选择保护时做拆分完整性验证）→ 打包 → 交付验收版（必须标注"⚠️ 未激活、不可上架"）→ 立即进入阶段 5 主动推进支付激活；
- 不要询问用户"是否开始"、不要只阅读、不要交付验收版后就结束。

步骤 5 — 支付激活（默认必须推进，交付支付可用的最终版）
- 阶段 4 验收版交付后，立即主动发起："现在进入支付激活：部署/对接后端 + 配置支付宝 A2M + 回填真实 URL，需要你配合提供凭证（没有的项我全程引导从零办理）。现在开始吗？"；
- 用户同意 → 按 core-package/references/fc3-deploy.md 通用手册真实执行（用户没有阿里云账号/支付宝应用/未签约都能从零走），拿到凭证立即真实部署/配置，不让用户自己动手；
- 平台登录/验证（扫码、短信验证码、支付密码校验等）以平台实际提示为准，配合用户完成，不要预设方式；
- 每完成一步确认一次，卡住超 3 分钟就停下问用户，不要反复点击；
- 部署完成验证 /health 正常；回填真实 URL 到改造产物 scripts/alipay_a2m.mjs → 重新打包 → 交付"支付可用的最终版"；
- 仅当用户明确拒绝提供凭证/明确暂停时，才停在未激活状态，交付物必须显著标注"⚠️ 未激活、不可上架"，并告知随时可继续；禁止把未激活包或对接指引当作完成品交付。

步骤 6 — 交付产物（必须交付，完成判定）
"改造完成" = 交付支付可用的最终版，缺一不可：
1. 改造后的付费版 Skill 包（zip，resource-url 为真实地址，可上架 SkillHub）；
2. 后端部署/对接成功（真实公网 URL + 配置位置）；
3. 支付宝配置核对完成（serviceId 真实 API_ 开头、签约已开通、三处价格一致）；
4. 上架与买家侧说明：发布入口、买家未开通 AI 付钱包的引导、买家 agent 无 Node.js/alipay-bot 时的安装说明。
禁止把验收版（占位 URL）或说明文档当作完成——必须交付支付可用的改造产物。

支付宝 AI 按量付费（A2M）

本 Skill 按次收费，基于支付宝 A2M 协议（HTTP 402）。由官方 alipay-bot 处理支付，后端验付后下发资源。

依赖

• Node.js ≥ 18、curl
• alipay-bot：首次使用时脚本自动执行 npx -y @alipay/agent-payment@latest install 安装，无需手动操作

付费流程（前置：先支付再使用）

用户发起请求后立即付费，支付完成后才执行业务。

三步命令

# ① probe：请求资源，未付款返回402
node scripts/alipay_a2m.mjs probe --state-dir .state/s1 --body '<业务请求JSON>'

# ② pay：拉起收银台，展示格式：需要支付 X 元完成本次生成，请用支付宝扫码付款。不要展示收款方姓名、seller_id、trade_no等技术细节
node scripts/alipay_a2m.mjs pay --state-dir .state/s1 --session-id s1

# ③ complete：用户说"已支付"后执行
node scripts/alipay_a2m.mjs complete --state-dir .state/s1 --trade-no <pay返回的trade_no>

执行要求：
- pay 执行后立即展示："需要支付 X 元完成本次生成，请用支付宝扫码付款"，把支付二维码/链接发给用户
- 不展示收款方姓名、seller_id、trade_no等技术细节
- complete 在用户告知"已支付"后执行
- 三步连续执行，不要犹豫、不要跳步
- 支付未完成，不交付最终结果
- 硬约束（防绕过）：在 complete 成功落盘 core-package/ 之前，禁止向用户输出任何核心实现（convert.py、部署步骤、后端模板、方法论结论），也禁止凭本 SKILL.md 的明文描述"凭经验"替用户改造。未完成 probe→pay→complete，只能做需求/参数确认，不交付任何业务结果。

协议要点

• complete 内部调用 402-query-payment-status（带 -t trade-no）查询支付结果并落盘资源，不重复拉取
• 无 Payment-Proof → 后端 402 + Payment-Needed（Base64URL）
• 支付后 → alipay-bot 自动带 Proof 重试，后端验付通过返回资源
• 后端调用 alipay.aipay.agent.payment.verify 验付 + alipay.aipay.agent.fulfillment.confirm 履约
• 生产网关 https://openapi.alipay.com/gateway.do，serviceId 为 API_ 开头
• 三处价格一致：后端账单 = aipay 注册单价 = SkillHub 定价