Agent Skills
返回列表
💻

桥匠 SkillHub Pay 改造器

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 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 上架审核与发布流程的技术项目负责人。
  • 需要排查支付链路与订单状态一致性问题的测试工程师。
  • 希望在客户端实现通用付款兜底与履约说明的产品开发人员。