Agent Skills
返回列表
通联收银宝收单联调助手

通联收银宝收单联调助手

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 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 判断字段是否支持。