应用国际化助手
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_8bb4b4f5/i18n-helper。
技能介绍
背景:硬编码文案拖慢多语言落地
在中文项目里,开发者习惯把文案直接写进代码,比如 btn.text = "确认删除"、Toast("保存失败")。一旦要出英文版,就得全局 grep 找这些字符串,再逐个翻译、替换、联调。埋在深层组件或异步回调里的字符串,往往上线后才被发现没翻译。更麻烦的是,复数规则、日期格式、数字千分位这类格式化文案,硬编码之后各语言的表达差异会直接改变程序行为。
这个技能做什么
它把“抽文案—翻译—写回”这条手工链拆成可交给大模型执行的步骤:
- 扫描与抽取:遍历指定目录的源码文件,匹配字符串字面量,收集原文或 key,产出待翻译清单;
- 组织资源:按模块或文件聚合文案,生成
.po、JSON 这类常见资源文件的结构骨架; - 批量翻译:把清单交给大模型,按目标语言分批生成译文,保留占位符与格式化标记;
- 写回与校验:把译文回填进资源文件或替换源码引用,对照原文数量做一致性核对。
适用边界
- 它依赖代码结构稳定,动态拼接或模板组合的文案容易漏网或翻译错位;
- 占位符配对只有静态检查,运行时传参错误需要测试兜底;
- 品牌词、法律条款、专业术语仍应走人工审校;
- 翻译回填后建议先跑单测或 lint 校验 key 完整性,再合入主干。
它的价值是把机械但易错的文案搬运交给自动化流程,让工程师专注在多语言产品中真正需要人判断的部分。
使用场景
- 团队把界面文案从硬编码迁移到统一资源文件时,批量扫描源码并生成 .po 或 JSON 骨架
- 应用第一次发布英文版,需要把中文字符串清单整批翻译成英文并回填到资源文件
- 新增一种小语种时,基于已有 key 清单生成译文,并对照原文数量核对是否有遗漏
- 错误提示带格式化占位符,需要批量翻译但保留占位符标记并做一致性校验
适合人员
- 前端开发者要把单一语言项目改造成多语言版本,希望减少逐文件 grep 和手动替换文案的重复劳动
- 本地化工程师维护 .po 或 JSON 资源文件,需要批量生成译文条目并保持结构与占位符完整
- 独立开发者从零为应用添加英文版,在没有现成文案拆分流程时希望快速补齐翻译并回填
- 翻译团队负责产品文案本地化,想先用模型跑通批量翻译初稿再交人工审校术语