技能介绍

要解决的问题

跨境机构类 VA 对接通常卡在签名、字段注释、回调验签和联调证据上。接口表里字段多、中文释义分散，手写 DTO 容易漏字段、错枚举或把 null 键写进报文；出站测试若用 Mock HTTP 客户端，只能证明服务调用过，不能证明真实 TLS、签名和网关响应链路可用。

如何工作

该技能以内嵌 embedded-organ-va-chapter2-6-spec.md 为唯一规范来源，在已有 gcp-api-quick-integration 签名底座前提下生成第二至第六章对接代码：

DTO / 请求响应模型：每个字段带中文注释，含义来自规范表的「中文名称」和「备注」，不臆造字段。
业务服务与回调骨架：先验签，再解析；不重复生成签名算法。
真实 HTTP 集成测试：对合作方到通联的出站接口生成 @SpringBootTest 测试，禁止 Mock HTTP 客户端。
命名与包隔离：用业务域命名，避免 chapter2 这类章节名进入类名、包名或文件名。

适用边界

它默认覆盖规范内接口，适合 Java/Spring 为主、且需要交付可联调代码的场景。Java 生成物要求 UTF-8 无 BOM、字段有 getter/setter 或 Lombok 注解，并避免 Java 8 不支持的高版本 API。若项目缺少签名底座，需要先补齐并满足底座规范；若用户只指定部分接口，需要确认未生成范围。