桥匠 SkillHub Pay 改造器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @tanco/tencent-skillhub-pay-adapter。
技能介绍
解决什么问题
许多优秀的普通 Skill 只有提示词或本地脚本,直接上架很难支撑按调用计费。主要痛点包括:缺少稳定的生产级 HTTPS 服务入口、没有标准的 402 支付协商响应、订单状态与请求体绑定缺乏约束,以及审核材料不符合平台规范。
这个 Skill(@tanco/tencent-skillhub-pay-adapter)用于把现有的普通 Skill 改造为腾讯 SkillHub / Pay Skill,同时保留原始 slug 和组件结构,让工程团队能走完合规的支付、履约与上架流程。
核心能力与步骤
- 按输入类型分流:已有生产服务则保留
service_url;仅有本地脚本则包装最小可用 HTTP JSON 服务;纯提示词类 Skill 会明确提示无法直接转为 Pay Skill。 - 标准化 402 协议:按照已跑通的微信 Agent Pay X402 流程补齐通用兜底,优先使用
weixinpay_pay;若客户端无法渲染卡片,则展示同一笔订单的checkout_url与payment_status_url。 - 订单一致性保护:轮询、重试和履约必须复用原始
X-Out-Trade-No与完全相同的请求体,防止生成第二笔订单或重复扣款。 - 结构化打包:使用
scripts/audit_pay_skill.py检查风险字段,再用scripts/package_pay_skill.py生成干净的 ZIP 包,并同步 SKILL.md、清单文件与版本号。
适用边界
- 该转换器自身是免费指南与本地打包审计工具,不创建订单、不代收费,也不代表能绕过平台审核、商户权限或人工判断。
- 本地检查通过仅代表当时文件合规,不保证腾讯后续规则、真实用户付款或结算状态一定成立。
- 凭据、商户密钥和证书必须放在运行时环境中,严禁打包进 Skill 包。
使用场景
- 拥有本地脚本的开发者,希望将其包装为生产级 HTTP 服务并接入 SkillHub Pay。
- 准备上架付费 Skill 的团队,需要校验 402 响应和同单重试以通过平台审核。
- 需要为多个 Skill 批量转换、打包,并整理上传清单的工程化发布流程。
- 客户端无法渲染支付卡片时,需要引导用户通过链接查看微信二维码并查询状态。
适合人员
- 负责将旧模型接口封装为 Agent 付费 Skill 的后端工程师。
- 管理多个 Skill 上架审核与发布流程的技术项目负责人。
- 需要排查支付链路与订单状态一致性问题的测试工程师。
- 希望在客户端实现通用付款兜底与履约说明的产品开发人员。