技能介绍

解决什么问题

在通联支付跨境香港发卡 VCC 项目中，API 字段分散在接口表里，签名、验签、文件上传、卡号脱敏和 DTO 结构又相互交织。直接让模型按文档章节生成代码，常出现包名变成 chapter6、响应字段缺少注释、回调先解析后验签、测试用 Mockito 绕过真实签名链路等问题。该技能把这些问题前置为约束：只基于内嵌规范 embedded-hk-card-api-spec.md 生成业务代码，把签名验签底座单独剥离，避免把外链 Excel 或未内嵌附件当真源。

工作方式

技能按接口的 path、方向、请求表和响应表展开：

模型生成：每个请求、每个响应使用独立顶层类型，Java 侧禁止单文件堆嵌套 static 类，字段须逐条添加中文注释。
服务与回调：生成合作方到通联的主动调用服务，以及通联到合作方的回调骨架，回调保持“先验签，再解析”。
出站测试：Java/Spring Boot 场景要求真实 HTTP 集成测试，注入真实 Service，断言 rspcode 或响应非空，不得 Mock 签名 HTTP 客户端。

适用边界

它不重新实现 RSA 签名、AES 解密、公共 HTTP 头或 StringToSign 规则；这些能力以 gcp-api-quick-integration 的签名底座为准。若项目没有底座，应先补齐再继续。默认覆盖文档列出的出站接口和回调路径；如果用户只要求子集，交付说明需列出未生成部分。