前言¶
接入通联支付云商通 2.0 时，常见难点不在「会不会写 HTTP 请求」，而在产品形态选型（综合支付版、KA 客户版、ISV 服务版、银行托管等）、国密相关能力（SM2 签名、SM4 加密）、异步通知与对账、以及消费/退款/订单查询等业务接口的组合使用。官方文档分散，排查问题时又需要把错误码、签名与业务规则对齐。
下面介绍 SkillHub 上的 通联支付云商通产品 skill（@user_0512de0a/allinpay-yst-skill）：在对话式开发环境里，把选型、代码生成、质量检查、演示与问题排查串成一条可执行的接入路径。
这是什么¶
通联支付云商通产品 skill 是面向 云商通 2.0 支付接入与账户资金管理 的 Agent Skill，基于通用 SKILL.md 格式发布。
- 坐标：
@user_0512de0a/allinpay-yst-skill - 当前版本：1.0.2（SkillHub 页面标注）
- 分类：dev-programming
- 来源：community
- 发布者：user_0512de0a
- 标签：
requires_api_key=false（安装 Skill 本身不要求在 SkillHub 配置 API Key） - 官方入口：SkillHub 技能页、API 地址
Skill 的定位是：引导开发者从产品选型、代码生成、质量检查到端到端演示，完成云商通 2.0 全链路接入；并覆盖问题排查、业务知识查询、接口索引与解决方案咨询；同时涉及账户资金相关场景（如提现、开户、余额查询、资金管理方案等，以 Skill 简介为准）。
核心功能¶
以下能力均来自 SkillHub 公开简介，不展开未在资料中出现的具体接口清单或内部实现。
- 产品选型：在云商通 2.0 相关形态（如综合支付版、KA 客户版、ISV 服务版、银行托管等）下，协助对齐能力与接入路径。
- 代码生成：按接入目标生成或补全支付相关代码（用户侧常见表述为「生成支付代码」「接入云商通」「接入通联支付」）。
- 质量检查：在生成或修改代码后，做与接入相关的检查项引导（与「全链路」描述一致，具体检查项以 Skill 内文档为准）。
- 端到端演示：从申请到回调、查询等环节，组织可演示的接入步骤说明。
- 问题排查：针对签名、加密、异步通知、订单与对账等关键词场景协助定位（如 SM2 签名、SM4 加密、异步通知、对账文件等）。
- 业务知识与接口索引：查询业务概念，并作为接口与方案的索引入口（消费申请、退款申请、订单查询、统一收银台、代收、代付、商户入网等均在触发词范围内）。
- 方案咨询：支持「编写支付方案」「资金管理方案」类需求，与简介中的解决方案咨询能力对应。
何时应启用（触发词，摘自官方简介）：对话中出现「云商通」「通联支付」「AllinPay」，或综合支付版 / KA 客户版 / ISV 服务版 / 银行托管，或消费申请、退款申请、订单查询、对账文件、统一收银台、代收、代付、提现、开户、余额查询、SM2 签名、SM4 加密、商户入网、异步通知、资金管理、账户资金等；也可在用户明确要求接入、生成代码或排查支付问题时使用。
安装与启用¶
SkillHub 页面给出的安装方式，是向当前使用的 AI 助手发送一段固定提示，让其按 SkillHub 安装说明拉取该 Skill：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_0512de0a/allinpay-yst-skill`。
说明：
- 安装流程以 skillhub.md 为准；不同客户端（Cursor、Codex CLI、Claude Code 等）若文档中有分端说明，按文档逐步操作即可。本文未单独核实各客户端差异时，不另写一套命令。
- 坐标中的版本在 SkillHub 展示为 v1.0.2；后续若在 SkillHub 升级，以页面为准。
典型用法¶
官方页面未附带独立的长示例仓库；典型用法是对话驱动，把真实接入上下文交给 Agent，由 Skill 按链路引导。下列表述与官方「Use when」说明一致，可直接作为首轮提示的骨架（请替换为你们自己的商户环境、接口环境与语言栈）：
我们要接入通联支付云商通 2.0，业务是 [简述场景]。
请先帮我在综合支付版 / KA 客户版 / ISV 服务版 / 银行托管 里做产品选型说明，再列出需要对接的接口（如消费申请、异步通知、订单查询）。
语言栈：[Java / Go / …]，需要包含 SM2 签名与 SM4 加密的实现要点。
已有云商通对接代码，退款申请失败 / 异步通知验签不过 / 对账文件字段对不上。
错误现象：[日志或返回码]，请按 Skill 里的排查思路帮我定位，并说明要核对哪些配置与报文字段。
请生成云商通 2.0 [消费申请 + 统一收银台] 的示例代码骨架，并做一轮质量检查清单。
经过上面的步骤，Agent 应结合 Skill 内嵌的流程与知识，而不是仅凭通用支付经验作答；具体输出仍以你提供的商户号、密钥、环境与官方最新接口文档为准。
适用场景与注意¶
适合谁
- 正在做 云商通 2.0 首次接入或改版的后端 / 全栈开发者。
- 需要同时处理 支付链路（消费、退款、查询、收银台、代收代付）与 账户资金（开户、余额、提现、资金管理等）相关问题的团队。
- 希望在 IDE 或 CLI 里用自然语言完成选型、 codegen、检查与排障，而不是只查静态文档的开发者。
使用注意
- 来源与维护：Skill 在 SkillHub 标注为 community 发布，接入生产前仍应以通联支付官方文档、测试环境与合规要求为准；Skill 输出宜作为辅助，关键报文与安全实现需自行复核。
- 无需 SkillHub API Key：标签为
requires_api_key=false，但云商通业务本身仍需要商户侧密钥、证书与国密配置等，这些不属于 Skill 安装配置。 - 统计信息：SkillHub 页面与资料中的评分、下载量会变动；撰写时资料为评分 100000、下载 925、安装 4（以你打开 SkillHub 时的页面为准）。
- 不要混用版本：简介明确为 云商通 2.0；若项目仍是旧版或定制版，应先确认产品版本再让 Agent 生成代码。
结尾¶
通联支付云商通产品 skill 把云商通 2.0 接入里分散的选型、开发、检查、演示与排障收敛到一条对话链路，并覆盖支付与账户资金相关关键词场景。若你正在处理通联 / 云商通 / AllinPay 接入或支付问题排查，可在 SkillHub 安装 @user_0512de0a/allinpay-yst-skill（v1.0.2），官方页面：https://www.skillhub.cn/skills/user_0512de0a/allinpay-yst-skill。
