多银行模板自动生成工具
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_de220783/multibank-template-generator。
技能介绍
要解决什么问题
对接多家银行时,请求/应答字段往往要落成 Freemarker 模板,且还要对齐 财资云 标准接口与各行接口文档。映射关系通常以 Excel 关系表维护;若每次靠人工对照规则文档改模板,容易漏字段、格式不一致,也难在全量接口与「只改几个接口」之间切换。
技能如何工作
本技能不做 AI 决策,只在你(或 WorkBuddy)已经准备好标准映射表之后,做校验并跑脚本出模板。
典型链路是:
- WorkBuddy 读取技能
assets下的request_rules.md、response_rules.md与caizi_cloud.json,按规则生成映射表,写入output/映射表/,命名如{银行简称}请求关系表.xlsx/{银行简称}应答关系表.xlsx - 调用入口
scripts/startup.py,通过--type(1 请求 / 2 应答)、--format(请求侧xml/json)、--bank、--mode(1 全量 / 2 指定接口)、--interfaces(模式 2 必填)、--file(映射表路径)驱动生成 - 请求侧走
xml_gen.py/json_gen.py,应答侧走back_gen.py,结果分别落到output/请求模版/与output/应答模版/
适用边界
映射表质量决定输出;规则与接口文档变更需同步更新 assets 并重新生成关系表。用户银行接口原文可放在 assets/input/,但技能侧资源需保持 SkillHub 允许的纯文本形态(如 JSON/Markdown)。
使用场景
- WorkBuddy 已按 assets 规则生成某行「请求关系表.xlsx」,需要一次性产出该行全量 XML 请求 Freemarker 模板
- 同一银行只上线「当日交易明细查询、实时余额查询」两个应答接口,需用 mode 2 指定接口名生成应答模板
- 对接新银行时映射表已校对完成,需分别生成 JSON 格式请求模板与标准应答模板并归档到 output 目录
- 财资云标准接口或 request_rules 更新后,重新生成映射表并批量刷新各行请求/应答模版目录
适合人员
- 负责财资云与多家银企直连接口的中间件开发,要把 Excel 映射表落成可部署的 Freemarker 模版
- 使用 WorkBuddy 维护「规则文档 → 映射表 → 模板」流水线,需要在 AI 出表后调用纯脚本批量生成
- 银行渠道联调工程师,在全量上线与按接口增量改模板之间频繁切换,依赖 startup.py 参数控制范围
- 接口文档 owner,把各行原始说明放在 assets/input,并确保 assets 内 JSON/Markdown 规则与生成物一致