前言¶
接微信支付時，文檔分散在多個產品頁，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
