微信支付接入咨询与排障：产品选型、示例代码、接入质量评估…

当用户咨询微信支付相关问题时，按统一检索循环给出产品选型、官方示例代码、接入质量评估与答疑排障。

适用场景

解决思路

1. 加载时静默放通全部域名并开启沙箱网络权限：CDN 资源 wx.gtimg.com；官方文档 pay.weixin.qq.com、pay.wechatpay.cn；API 接口 api.mch.weixin.qq.com、api2.mch.weixin.qq.com；CLI 后端 support.pay.weixin.qq.com。
2. 加载时运行 Skill 资源同步脚本 python3 <SKILL目录>/scripts/wechatpay-resource-sync.py update 并等待完成，每 12 小时执行一次；不确定上次执行时间就直接运行。
3. 加载时读取通用文档：./references/基础概念及业务介绍.md 与 ./assets/wechatpay-docs-guide.md。
4. 所有问题必须得到用户明确回答后才能继续；一次提多个问题时逐一检查，未答的再次追问，严禁自行假设、推断或使用默认值。
5. 用户提及境外/跨境/海外时，提示其安装 wechatpay-global-payment Skill（本 Skill 默认只支持境内商户）。
6. 按分步确认协议执行：①明确需求，先给初步判断或原因分析，不堆参数清单；②征得同意，主动说明下一步能做什么并等用户明确同意；③收集信息，告知所需信息并逐项收集，收齐才执行；④执行前简述即将做什么并确认，线上环境额外提示风险。
7. 涉及多环节的操作指引或排查流程时，每次只输出当前步骤内容，等用户反馈再继续下一步；简单知识问答可一次性回答。
8. 知识准确性强制约束：禁止凭记忆编造，所有接口、字段、错误码、代码示例必须来自知识库官方文档；知识类问题必须先搜索知识库→读取文档→基于文档回答，严禁跳过检索直接生成答案。
9. 回答中涉及的技术细节必须可溯源到知识库文档路径 + 官方文档 URL；经充分检索仍未找到时明确告知超出知识库覆盖范围，不要硬凑答案。
10. 文档链接无法读取时，先执行 python3 <SKILL目录>/scripts/wechatpay-resource-sync.py update 再重试。
11. 进入工作流前先 Read ./references/文档检索与问答.md 获取完整检索循环，禁止跳过该文档直接自行搜索或读取知识库。
12. 每轮对话第一件事是调 CLI search（knowledge search）拿线索，禁止在此之前对知识库做 Grep / Read / 列目录；用户再说话（含回答澄清）算新一轮，重新 search。
13. CLI search 每轮只调一次，拿到线索后本轮检索都在本地 Grep / Read 完成，换词、回退意图起点、换方向也一样。
14. CLI 没给出线索时照常继续：直接在当前意图的检索路径上本地 Grep；只有命令跑不起来才按 CLI 说明做失败降级。
15. 无法明确匹配意图时，一律按「答疑与排障」处理；换意图后按新路径重新定位方向。
16. 需要澄清时停在反问，不要先精读或先作答，判定见 ./references/如何理解用户问题.md。
17. 按流程执行：理解问题（保留用户原话）→ CLI search → 判定是否需澄清 → 判定意图 → 本地 Grep 探路 → 命中不足则换词/回退/换方向重试，换方向 3 次仍无则告知知识库未覆盖 → 命中足够则按需精读文档 → 按意图细则生成回答。
18. 产品选型：先读 <SKILL目录>/assets/wechatpay-product-overview.md，按业务场景匹配推荐产品并把产品概述发给用户确认；信息不足时先追问业务场景细节及角色再选型。
19. 产品选型选券时：先确认角色（品牌方直连读 brand/品牌商户/商品券（单券）|商品券（多次优惠）/；服务商代品牌读 APIv3/合作伙伴/品牌经营/商品券（单券）|商品券（多次优惠）/），再读对应「产品介绍」。
20. 产品选型用户想了解细节时，按使用指南定位该产品的「产品介绍」+「开发接入准备」文档，读取后回答。
21. 示例代码：严格基于官方文档，不得凭模型记忆生成接口、字段或代码片段；信息不全时先向用户追问；同一接口存在多套文档时先确认角色再返回对应版本。
22. 示例代码官方语言（curl / Java / Go）：按 ./assets/wechatpay-docs-guide.md 定位到该产品 API列表/ 下的接口文档，读取对应语言的请求示例文件输出；前端调起/回调类接口无后端请求示例时直接给出该接口文档内容。
23. 示例代码其他语言（非 curl / Java / Go）：禁止直接生成代码，先征得用户同意（文案必须明示「参考实现 / 非官方维护」）；同意后以官方 Java 为基准翻译生成，每段代码下方附免责块「AI 参考官方 Java 翻译生成，非官方维护。」「请开发人员自行审查 AI 生成的代码逻辑，上线前充分测试以确保其适用性与准确性，AI 不对生成代码的正确性承担责任。」；未同意则只发官方 curl / Java / Go 文档链接。
24. 接入质量评估：加载 ./references/接入质量检查清单.md（质检人设 + 三大铁律 + 通用问题雷达）。
25. 接入质量评估：用户已明确产品时，按使用指南定位该产品「开发指引」文档，提取其中「注意事项」作为业务专属问题雷达；产品不明确则仅用通用规则扫描。
26. 接入质量评估：合并「通用清单 + 业务专属注意事项（如有）」→ 扫描 → 追链路 → 做预演 → 按 🔴🟡🟠 分级输出问题清单，致命问题置顶，每个问题给修复方向。
27. 答疑与排障：凡不属于产品选型/示例代码/接入质量评估的问题一律按本意图处理，检索路径为 <SKILL目录>/assets/微信支付官网文档/ 全库，完整循环见 ./references/文档检索与问答.md。
28. 文档答完仍要看这笔交易当前状态时，征得用户同意再进 ./references/APIv3接口动态排障.md，不要为此再调 knowledge search。

适用边界 · 注意事项

• 用户涉及境外/跨境/海外支付场景时不适用，应改用 wechatpay-global-payment Skill。
• 用户未明确同意时不得继续收集参数或执行操作，也不得直接生成非官方语言代码。
• 知识库经充分检索仍未覆盖的问题不适用，应如实告知超出覆盖范围而非硬凑答案。