前言¶

同一个技能，部署在网关后面，加了付费门禁之后，调用方就需要先付款再取用。难点不在”收钱”这一件事，而在收钱前后一连串的配套：要开哪些账号、密钥放哪、环境变量怎么填、网关怎么部署、价目表怎么配、客户端怎么调用、测试怎么分层、最后怎么上架。这些步骤分散在多个控制台和文档里，第一次做很容易卡在某个环节。

下面介绍的 GMAI-SkillPay支付改造大师，就是把这一串配套整理成一份可执行的改造手册，并附带一键注入付费块的工具。

这是什么¶

GMAI-SkillPay支付改造大师 是一个发布在 SkillHub 上的 Skill，坐标 @guomeng/gmai-skillpay-remaster-v2，由果盟数科发布，分类为 business-ops，版本 1.0.1。

它要解决的问题是：把一个已经存在的普通技能，改造成支持 X402 协议支付调用的按次付费技能。交付物有两部分——一份《X402付费技能改造实操手册》，以及一套可直接落到仓库里的付费门禁文件。

按 SkillHub 页面抓取的数据，当前评分 100000，下载 58020 次，安装 0 次。

核心功能¶

1、改造手册。手册按改造顺序覆盖：需要哪些账号与密钥、在哪开通、要准备什么资料、每个环境变量的类型与填法、网关部署、价目表配置、客户端接入、三层测试、上架。每个环节给出分步操作路径，并附排错表，用于定位失败原因。

2、一键注入 PAYGATE 付费块。通过 apply 能力，把标准 PAYGATE 付费块写入现有技能的 SKILL.md，不需要手工粘贴和核对格式。

3、落地 bin/client.js 门禁。付费调用走 X402 协议，客户端文件随改造一并生成，落到技能目录的 bin/client.js。

4、触发方式。当用户提到”技能改付费”、”PAYGATE块”、”支付改造”、”Pay Skill改造”、”怎么接入微信按次付费”时触发该 Skill。搜索词覆盖 payskill、skillpay、pay-skill、pay skill、付费技能、微信支付、支付改造、X402、按次付费、技能改付费、接入付费、PAYGATE、paygate、改造。

安装与启用¶

已给资料和 SkillHub 页面均未给出明确的安装命令或目录路径，官方地址为 https://api.skillhub.cn/guomeng/gmai-skillpay-remaster-v2 ，SkillHub 展示页为 https://www.skillhub.cn/skills/guomeng/gmai-skillpay-remaster-v2 。

该 Skill 基于通用 SKILL.md 格式，启用方式与普通 Skill 一致：将技能放入宿主的 skills 目录后，由宿主加载 SKILL.md。改造过程本身会修改目标技能目录下的 SKILL.md 并新增 bin/client.js，所以对目标技能的目录应有写权限。

资料中 requires_api_key=false，表示安装该 Skill 本身不强制要求 API Key；pricing_type=paid，表示该 Skill 为付费技能，使用前需先完成购买。

典型用法¶

改造场景可以这样走：

1、在 SkillHub 页面获取该 Skill，安装到本机 skills 目录。

2、准备好目标技能。改造会写入 SKILL.md、落地 bin/client.js，建议先提交一次版本或打标签，便于回滚。

3、触发改造。直接说明需求，例如”帮我把这个技能改成按次付费”、”给这个技能加 PAYGATE 块”。Skill 会先输出《X402付费技能改造实操手册》，再执行 apply 注入付费块。

4、按手册逐项配置。依次完成账号开通、密钥获取、环境变量填写、网关部署、价目表配置、客户端接入。手册中每个环境变量都标注了类型与填法，照填即可。

5、分层测试。按手册给出的三层测试路径验证：先验证付费门禁是否拦截未付费调用，再验证付费后能否正常取用，最后验证上架前的整体行为。遇到失败对照排错表定位。

6、上架。测试通过后按手册的上架步骤发布技能。

下面这段只说明改造会动到的文件，命令需以手册为准：

SKILL.md          # 被注入标准 PAYGATE 付费块
bin/client.js     # 新增的 X402 付费门禁客户端

适用场景与注意¶

适合两类人：一是已经有成熟技能、想在调用链路上加一层按次付费的开发者；二是需要按统一格式接入 X402 微信 Agent Pay、不想各自摸索网关和价目表配置的团队。

注意几点。第一，改造会直接修改目标技能的 SKILL.md，务必先备份或提交版本。第二，手册中的账号开通、密钥申请、网关部署等步骤依赖外部平台的实际流程，账号资质和审核结果以对应平台为准。第三，X402 按次付费涉及真实资金，测试阶段建议先用小额价目验证链路。第四，该 Skill 本身是付费的（pricing_type=paid），购买前先确认改造目标和手册内容是否符合需求。第五，SkillHub 页面显示安装数为 0，说明实际使用规模暂无公开数据可参考，改造前建议先试跑一个技能验证全流程。

结尾¶

这个 Skill 的价值在于把”改造一个技能为付费技能”从分散的多步操作收敛成一条固定路径：手册给出每个环节的操作位置和排错方式，apply 负责把标准付费块写进文件。适合需要快速给现有技能接上 X402 按次付费、又不想逐项排查配置的开发者。

官方地址：https://api.skillhub.cn/guomeng/gmai-skillpay-remaster-v2