我们项目需要维护 7 套国际语言 JSON 文案文件,每次迭代新功能的完整流程如下:
- 业务开发完成,代码中写入大量全新 i18n 标识:
t('newFeature.title'); - 逐行翻阅代码、比对新旧 JSON 文件,手动筛选新增文案 Key,复制粘贴整理成表格;
- 导出 Excel 交付产品经理进行多语言翻译;
- 拿到翻译完成的表格后,手动转换和替换 7 个语种 JSON 文件
长久下来愈发觉得没必要把精力耗费在这个搬运工作上,于是基于 Claude Code Skills 搭建了一套增量文案自动化流水线。
1. 第一步:根据 Git 提交差异,一键导出新增文案 CSV
自定义 Skill:/export-diff-to-csv 作用:指定历史 Commit 节点,对比当前工作区文案文件,抓取所有新增 i18n Key,自动生成标准 CSV 交付翻译。
调用方式:
arduino
/export-diff-to-csv a68a56f
脚本内部自动执行逻辑:
- 通过 Git 命令拉取指定 Commit 版本下的基准中文文案文件;
- 与本地当前工作区 JSON 内容做深度对比;
- 筛选出本次迭代新增的所有文案键值;
- 遵循 RFC 4180 标准转义内容,生成带日期命名的 CSV 文件:
i18n-diff-2026-08-12.csv
生成 CSV 示例:
vbnet
Key,en-US,zh-CN
"newFeature.title","New Feature","新功能"
"newFeature.description","This is a new feature","这是一个新功能"
过去手动翻代码筛选要 10 分钟,现在执行仅需 5 秒。
2. 第二步:翻译表格一键回填,增量合并 7 套语言 JSON
PM 翻译完毕回传 Excel 表格后,调用第二个回填脚本:/convert-excel-to-json
日常默认调用(无需传参,适配项目固定文案文件):
bash
/convert-excel-to-json
执行逻辑:
- 读取项目约定的 3 类标准文案 Excel,加载预设工作表;
- 拆分表格内 7 个语种列数据;
- 增量合并写入对应 JSON 文件,永久保留历史译文,杜绝覆盖风险;
临时文件适配场景(自定义文件与工作表):
ini
/convert-excel-to-json --file="临时文案.xlsx" --sheets="4.3,4.4"
效率数据直观对比
传统手动模式(总计 30 分钟)
- 检索代码提取新增 Key:10min
- 排版调整 CSV 表格格式:5min
- 7 个语种手动录入 JSON:10min
- 逐文件校验漏译、覆盖问题:5min 缺点:身心疲惫,失误常态化
Claude Code 自动化模式(总计 8 秒)
bash
/export-diff-to-csv a68a56f # 耗时5s
# 交由PM完成多语言翻译
/convert-excel-to-json # 耗时3s
耗时不足一杯咖啡的功夫,全程自动校验,零失误。