AI翻译读起来像机器写的？这个Skill让老外产品用上地道本地化

大多数 AI 翻译工具做出来的东西，读起来都像机器写的——生硬、死板、完全没有产品该有的语气。

问题不在于翻译质量，而在于翻译思路就错了。AI 把翻译当成”把英文换成德文”，但真正好的多语言产品，翻译是”用德语重新写一遍这个 narrator”，而不是把每个英文词换成德语对应词。

write-translations 这个 Skill，就是来解决这个问题的。

它怎么个工作法？

这个 Skill 来自 Tale 项目（一个多语言产品开发框架），核心用途是：当你要编辑任何非英文文件时——不管是德语、法语的 UI 文本还是多语言文档——它给你一套完整的翻译规则，让 AI 生成地道、符合产品气质的本地化文本，而不是词对词的机器翻译。

触发条件很简单：你要改 services/*/messages/、packages/ui/src/i18n/messages/ 或者 docs/<locale>/ 下的任何非英文文件时，Load 这个 Skill，然后照着它的规则来。

三个铁律，违反直接打回

第一条：Voice-first，意思优先。 翻译是重写，不是渲染。英语的三段从句在德语里往往是一句从句在句尾的复合句；法语里堆叠的名词短语通常要改成关系从句。翻译出来的德语读起来不能像政府公文（不能出现句尾的 “erfolgreich”，不能用第三人称 “Sie”），法语不能像营销软文。Reviewer 会catch这个问题。

第二条：永远用非正式人称。 德语用 du，法语用 tu，永远不用 Sie 或 vous。正式称谓在产品和内容场景里只会拉远和用户的距离。

第三条：UI 标签必须和线上完全一致。 翻译教程类内容时，路径翻译 segment by segment：Settings > Members 翻成 Einstellungen > Mitglieder，而不是 Einstellungen > Members。用户看到的界面是德语，文档里就不能蹦出一个英文菜单名。

那个让所有翻译工具出丑的词：Pull Request

这是最有意思的部分。write-translations 有一套三桶体系（Three Buckets）来处理术语：

• 桶1（永远英语）： 品牌名、缩写、代码标识符——AI、LLM、MCP、env变量、CLI 标志，全部保留英文。
• 桶2（惯用借词）： 行业内已经英语渗透的词——Workflow、Dashboard、Webhook、Pull Request、Branch、Merge——在德语/法语里保持英文。德语里还可以 hyphenate：Webhook-Adresse、Workflow-Schritt。
• 桶3（必须翻译）： Header → 德语 Kopfzeile，法语 En-tête；Email → E-Mail（德语）/Courriel（法语）。

而 Pull Request 在德语里有一个半翻译黑名单：Pull Anfrage、Merge-Anfrage、Code Review-Prozess 全部 fail——Git 领域的词汇就保持英文，不能德语化。这不是随意规则，是有测试用例强制执行的。

背后有测试套件撑腰

每次跑 bun run check，会触发两套检查：

• Parity + Usage：检查各语言消息文件的 key parity（所有英文 key 在其他语言都有对应），以及孤立 key（某语言有但英文没有的 key）。
• 集中测试：26 项检查覆盖 terminology、voice、grammar、style、ICU parity、heuristics 和 markdown，大部分在 rollout 阶段是 report 模式，等 clearance 了再切换到 enforce。

Reviewer 人工负责的是：微妙的 calques（仿译）、段落内的语气漂移、从句间的句子流畅性、ICU 复数正确性（分支内的）、地道的词汇选择。

用起来超简单

只要你在 Claude Code / Cursor / OpenClaw 等 Agent 环境里，Load 这个 Skill：

/skill write-translations

然后当你编辑德语、法语文件时，它会自动引导你完成翻译流程：先回答四个问题（Locale & files、Voice risk、Must-match、Risks & unknowns），然后照着规则来操作。

谁应该用？

如果你在做一个多语言产品，有工程师或 AI 参与本地化工作，这个 Skill 直接可以提升翻译质量下限。它把翻译决策从”看心情”变成”查规则”，而且用测试用例确保规则被遵守——不会有”为什么这个德语文档读起来像政府公告”这种灵魂拷问。

GitHub：https://github.com/tale-project/tale

GitHub: https://github.com/tale-project/tale