前言¶
接微信支付时,常见难点不在「能不能调接口」,而在产品选型:公众号里用 JSAPI、小程序里走小程序支付、App 与 H5、扫码 Native、柜台付款码,文档分散、回调与签名规则又容易踩坑。自己翻商户平台文档往往要反复对照场景。下面介绍 SkillHub 上的社区 Skill「微信支付集成」,把全场景选型与集成要点收敛成 Agent 可遵循的 SKILL.md 指引。
这是什么¶
「微信支付集成」是 SkillHub 坐标 @user_8509461a/wechat-pay-integration 下的社区 Skill(community),当前版本 1.0.0,分类为 business-ops,发布者为 user_8509461a;SkillHub 页面标注作者为蜀企投管(四川省)企业管理有限公司。
定位一句话:围绕微信支付商户平台的接入最佳实践,覆盖 JSAPI、小程序、APP、H5、Native、付款码等产品的选型与集成指导。Skill 标签含 requires_api_key=true,表示实际对接需要商户侧 API 密钥等凭证,由你在安全环境中自行配置,Skill 本身不替代商户平台开户与合规流程。
核心功能¶
以下能力均来自 SkillHub 官方简介,未在资料中出现的接口名、配置项不作延伸:
- 全场景产品覆盖:JSAPI 支付、小程序支付、APP 支付、H5 支付、Native 支付、付款码支付。
- 选型与集成指导:在 Agent 对话中按业务形态(公众号、小程序、原生 App、移动浏览器、PC 扫码、线下收银等)对齐应使用的支付产品,并沿商户平台接入思路组织步骤。
- 社区分发形态:标准 SKILL.md 格式,便于在 Cursor、Claude Code、Codex 等支持 Skills 的客户端中加载,由模型按 Skill 内指引回答集成问题。
SkillHub 统计(以抓取资料为准):评分 100000,下载 2716 次,安装 169 次。
安装与启用¶
安装分两种方式:让 AI 按官方安装说明执行,或本机已装 SkillHub CLI 后命令行安装。
方式一:提示词交给 AI¶
SkillHub 页面给出的安装提示为:请 Agent 根据 SkillHub 安装与优先源配置 安装 @user_8509461a/wechat-pay-integration。
把上述要求发给当前使用的 Coding Agent 即可;Agent 会按文档检查 skillhub CLI、选择正确的 skills 目录并完成安装。
方式二:SkillHub CLI¶
先确认是否已安装 CLI:
command -v skillhub && skillhub --version
未安装时,可按官方文档执行完整安装(含 CLI 与默认 Skill):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill 时,必须用 --dir 指向当前 Agent 的 skills 目录,否则默认落在 ./skills/ 可能不会被客户端识别。示例:
skillhub install @user_8509461a/wechat-pay-integration --dir <当前 Agent 的 skills 目录>
常用路径(摘自 SkillHub 安装文档,按你实际使用的客户端择一):
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或项目下的.agents/skills/
安装后按各客户端要求刷新或重启,使 Skill 进入可用列表。
典型用法¶
官方页面未提供单独的可复制代码示例;典型用法是在已启用 Skill 的对话里描述业务场景,由 Agent 结合 Skill 内指引输出接入路径。可复现的提问方式例如:
- 说明载体:「我们只有微信小程序,需要用户下单后支付。」
- 说明约束:「已有微信支付商户号,需要区分 JSAPI 和小程序支付该走哪条。」
- 说明阶段:「Native 扫码支付从下单到回调校验要注意什么顺序。」
因 requires_api_key=true,涉及 AppID、商户号、API 密钥、证书等敏感信息时,应在本地环境或密钥管理服务中配置,勿把完整密钥贴进聊天记录。Agent 宜只引用字段含义与配置位置,不编造未在 Skill 或商户平台文档中出现的参数名。
适用场景与注意¶
适合谁
- 正在或计划接入微信支付商户平台的后端、全栈、小程序开发者。
- 需要在多种支付产品之间做选型、希望减少反复翻分散文档的团队。
- 已使用 Cursor、Claude Code、Codex 等 Skills 能力,希望把「微信支付接入」固化为可重复调用的领域知识包。
限制与注意
- 来源为社区 Skill,集成细节以微信支付商户平台现行文档与审核规则为准;上线前仍需自行联调与合规检查。
- 评分与下载量来自 SkillHub 展示,会随时间变化,选型时可结合简介与自身场景判断,而非单独依赖热度数字。
- 本 Skill 侧重接入与选型指导,不替代法务、财务对收单资质与合同条款的确认。
结尾¶
「微信支付集成」把 JSAPI、小程序、APP、H5、Native、付款码等场景的选型与集成思路装进标准 Skill,适合在 Agent 工作流里做商户接入问答与步骤梳理。官方 Skill 页与 API 入口:
- https://www.skillhub.cn/skills/user_8509461a/wechat-pay-integration
- https://api.skillhub.cn/user_8509461a/wechat-pay-integration