通译 (tongyi-i18n-eng) · 产品国际化与本地化
一、定位
通译 是国际化 i18n/L10n 工程化 skill。它补齐 vibecoding 生态中"国际化"这一空白，
把"多语言支持"从"翻译几个字符串"升级为可维护的国际化工程，重点覆盖：
- 方案选型：i18next/vue-i18n/react-intl 等框架与目录结构。
- 词条管理：key 规范、词条提取、去重、缺译检测。
- 翻译工作流：翻译文件格式、翻译平台/CI 集成、审校流程。
- 本地化细节：复数、日期、货币、时区、RTL（阿拉伯语/希伯来语）。
二、何时使用
- 国际化 / i18n / 多语言 / 本地化 / l10n
- 翻译 / 语言包 / 多语言切换
- RTL / 时区 / 货币本地化 / 复数
- 出海 / localization / 多语言系统
三、前置信息
| 输入 | 说明 | 缺失时 |
|---|---|---|
| 产品范围 | 前端/后端/移动端，当前技术栈 | 问一个阻塞性问题 |
| 目标语言 | 首批支持哪些语言（含 RTL？） | 默认中/英 |
| 翻译方式 | 人工/平台/机器+人工审校 | 默认机器+人工审校 |
| 本地化深度 | 仅文案 or 含日期/货币/时区 | 默认全量 |
四、工作流（agent 执行）
步骤 1 方案选型 : 按技术栈选 i18n 框架，定目录结构（locale/*.json）与语言切换/持久化。
步骤 2 词条提取 : 扫描硬编码文案，抽取为 key，制定 key 命名规范，去重合并。
步骤 3 框架接入 : 接入 i18n 库，改造渲染层，支持动态语言切换 + 持久化（URL/cookie/本地）。
步骤 4 翻译工作流 : 生成翻译文件，接入翻译平台或 CI，建立缺译/过期词条检测。
步骤 5 本地化细节 : 复数规则、日期/货币/时区格式化、RTL 布局适配。
步骤 6 验收 : 缺译检测、占位符一致性、UI 溢出检查、语言切换回归。
步骤 7 交付 : 输出国际化方案 + 目录结构 + 规范 + 关键配置。
五、国际化要点（必守）
- 文案与逻辑分离：禁止在代码里拼接句子（不同语言语序不同），用占位符 + 整句。
- key 规范：语义化 key（如
login.error.password），禁止用英文原文当 key。 - 缺译检测：CI 检测缺失/未用 key，防止词条漂移。
- 本地化不只翻译：日期/货币/时区/复数/RTL 都要本地化。
- 占位符一致：各语言占位符数量/顺序必须一致（可配置可重排）。
六、质量门控
- 方案须覆盖复数/日期/货币/时区，禁止只做"文案翻译"。
- 必须给出缺译/过期词条的检测机制（CI 或脚本），禁止靠人工肉眼。
- RTL 语言若在目标内，须给出布局适配方案。
七、输出格式
# 国际化落地方案
产品范围 / 技术栈 / 目标语言
## i18n 框架与目录结构
## 词条管理与 key 规范
## 翻译工作流（平台/CI/审校）
## 本地化细节（复数/日期/货币/RTL）
## 验收清单（缺译/占位符/UI 溢出）
八、目录
references/i18n-frameworks.md— i18next/vue-i18n/react-intl 选型references/l10n-details.md— 复数/日期/货币/RTL 本地化要点references/translation-workflow.md— 翻译平台与 CI 集成
九、免责声明
翻译质量与本地化细节需结合目标市场实践，本 skill 提供工程化方法论，具体文案以专业翻译/本地化团队为准。
