通联收银宝收单联调助手
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_0512de0a/allinpay-syb-skill。
技能介绍
解决的问题
接入通联收银宝(SYB)时,工程师常需要在选请求类、生成 Java 示例、核对响应字段、落地 Maven 工程之间切换。若直接从入口层自由生成代码,容易出现 Request 构造方式错误、client() 初始化遗漏、签名验签边界不清楚、回调与幂等处理不一致等问题。该技能把入口层限定为场景分诊与路由,避免把字段细节和代码生成混在一起。
工作方式
- 按阶段路由:根据下单、查询、退款、回调、文件、前端跳转等任务,先判断应进入哪个子模块。
- 安全与协议能力:涉及签名、验签、异步通知、幂等、凭据边界或运行时约束时,转入
allinpay-syb-pay-shared-base。 - 接口与代码规范:涉及选择
Request类、生成 Java 示例或工程落地时,转入allinpay-syb-sdk-unified。 - 强制命中关键章节:回答前需先读取
MODULE.md的§0 主链路,并命中§0 末尾「写 Java / Demo 前」、§2 初始化 + client()、§3 骨架;若涉及 Maven 工单或工程落地,还需命中§5。 - 交付模式区分:默认使用
show_code_only,只展示 Java 示例;当明确要求生成到目录、修改pom或执行mvn package时,再切换为scaffold_java_maven_demo。 - 本地字段检索:字段与必填性问题优先在本地
req-route.md、req-matrix-*与响应侧resp-matrix中定位,未完成本地检索前不直接断言“不支持/未收录”。
适用边界
该技能适合通联收银宝收单接入的联调、示例生成与工程落地路由。它不展开大字段表,也不替代子模块中的字段真源;如果任务不涉及 SYB 收单、签名回调或 Java SDK 调用,就不应把它当作通用支付问题入口。
使用场景
- 对接通联收银宝下单接口时,先确认该用哪个 Request 类,再生成符合 new+setter 规范的 Java 示例。
- 排查异步回调验签或幂等失败时,定位到 shared-base 的签名、凭据边界与运行时约束。
- 把收银宝查询或退款接口接入现有工程时,按 scaffold 模式生成 Maven 工单和可编译 Demo。
- 核对响应字段必填性和 Extends 继承时,先查本地 req-route 与 req-matrix 再判断是否未收录。
适合人员
- 负责通联收银宝收单接入的后端工程师,要快速选对 Request 类并生成合规 Java 示例。
- 处理支付回调和验签问题的支付平台工程师,要定位签名、幂等与凭据边界规则。
- 要把 SDK Demo 落到 Maven 工程的服务端开发者,要获得可执行的落地步骤和工单。
- 负责接口联调与字段核对的集成顾问,要按本地 req-route 和 req-matrix 判断字段是否支持。