前言¶
接微信支付时，文档分散在多个产品页，JSAPI、Native、服务商模式、APIv2 与 APIv3 的规则也不完全一样。签名、证书、回调验签、查单和错误码往往在联调阶段才集中暴露。若在 Cursor 等 Agent 里直接问通用模型，容易得到过时接口或缺少官方上下文的回答。
下面介绍 SkillHub 上的「微信支付接入 skill」：由微信支付团队发布，作为 WeChat Pay 相关问题的统一入口，把产品选型、示例代码指引、接入质量评估和答疑排障收敛到同一套 Skill 触发规则里。
这是什么¶
「微信支付接入 skill」是面向大模型 Agent 的 Skill，坐标为 @tencent-adm/wechatpay-payment-integration，当前版本 1.0.15，来源为 enterprise，分类为 dev-programming，发布者为 微信支付团队。
Skill 的定位是：处理与微信支付接入、产品、开发、运营相关的咨询；提供产品选型、官方示例代码、接入质量评估、答疑与排障。页面标注 requires_api_key=false，安装使用不依赖额外 API Key 配置。
核心功能¶
以下能力均来自 SkillHub 与官方简介，未单独列出的细节以 Skill 包内 SKILL.md 为准。
-
产品与接入咨询
覆盖接入流程、产品能力及开发、运营侧常见问题。 -
产品选型
在用户需要推荐支付方式或做产品选型时触发，例如 JSAPI、APP 支付、H5 支付、Native 支付、扫码支付、付款码、小程序支付等场景。 -
官方示例与接口说明
在用户索要接口或示例代码、解释字段含义或接口规则时，按微信支付官方语境作答。 -
接入质量评估
支持上线前检查、接入代码质量审查类请求。 -
答疑与排障
针对回调、签名、证书、错误码、OpenID，以及报错、查单、支付异常等问题协助排查。
Skill 描述中列出的触发词还包括：合单支付、医保支付、微信支付分、分账、转账、委托代扣、周期扣款、代金券、商家券、特约商户进件、服务商、sub_mchid、APIv2、APIv3 等。
安装与启用¶
安装方式以 SkillHub 页面说明为准：参照 SkillHub 安装与优先源配置，安装坐标 @tencent-adm/wechatpay-payment-integration。
1、安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 CLI：
command -v skillhub && skillhub --version
未安装时可执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装本 Skill 到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前 Agent 识别的 skills 目录，否则默认落在 ./skills/ 可能不会被加载。
skillhub install @tencent-adm/wechatpay-payment-integration --dir <skills 目录>
常用路径示例（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
在 Cursor 中可写成：
skillhub install @tencent-adm/wechatpay-payment-integration --dir ~/.cursor/skills/
安装后按你所用客户端的要求重启或刷新 Agent，使 Skill 生效。
典型用法¶
Skill 通过自然语言与关键词自动匹配，无需单独子命令。在对话中直接描述场景即可，例如：
-
选型
「我们是公众号内 H5 商城，该用 JSAPI 还是小程序支付？服务商模式下sub_mchid怎么理解？」 -
开发与示例
「APIv3 统一下单要哪些字段？给我官方示例代码思路。」 -
上线前检查
「帮我做一遍接入代码质量审查，重点看回调验签和证书。」 -
排障
「支付回调验签失败」「查单状态不一致」「这个错误码是什么意思？」
当消息中出现「微信支付」「微信收款」「WeChat Pay」或上文列举的产品、协议名词时，Agent 应优先走该 Skill 的指引，而不是泛化搜索。
适用场景与注意¶
适合谁
- 正在接入或维护微信支付的后端、全栈、小程序开发者。
- 需要服务商、特约商户进件、分账、代扣等扩展能力时，希望回答与官方文档口径一致的团队。
- 在 Cursor、Claude Code、Codex 等支持 SkillHub 安装的 Agent 环境中工作。
使用注意
- Skill 提供的是咨询、选型、示例指引与质量检查框架，不能替代商户平台配置、真实密钥与证书文件；生产环境仍须在微信支付商户平台完成开通与权限。
- 接口版本（APIv2 / APIv3）、证书与签名算法以你商户当前开通能力为准，联调结果以微信支付侧返回为准。
- SkillHub 页面统计（截至资料抓取）：评分 100000，下载 2395；具体数字会随平台更新变化。
结尾¶
若你希望 Agent 在微信支付相关问题上统一走官方语境——从选型、示例到上线前检查和排障——可先安装 @tencent-adm/wechatpay-payment-integration，再在对话里用业务语言提问。
- SkillHub 页面：https://www.skillhub.cn/skills/tencent-adm/wechatpay-payment-integration
- 官方地址：https://api.skillhub.cn/tencent-adm/wechatpay-payment-integration
