oma-translation

翻译——上下文感知本地化

排期

目标

忠实、自然地翻译、审校或改写多语言内容，同时保留必须保持原样的部分：占位符、代码、链接、格式、术语和文件结构。

意图特征

• 翻译、本地化、审校译文、改写文案，或创建术语表／风格指南。
• 在源文件发生变更后更新目标语言文件。

适用场景

• UI 字符串、错误消息、本地化文件、文档、报告、营销文案和散文。
• 审校现有译文的准确性、语体、术语或自然度。

不适用场景

• 国际化基础设施、本地化注册或键提取 → 使用相关的开发技能。
• 日期／复数 API 或其他代码层面的本地化 → 使用对应代码领域的技能。

预期输入

• 源文本、目标语言或区域设置、内容类型和所需输出模式。
• 现有本地化文件、术语表、上下文，以及可选的作者范例。
• 结构化源内容中的占位符和格式约束。

预期输出

• 自然的目标语言文本，或有依据的审校结论。
• 精确保留占位符、代码片段、链接、标题、列表结构和本地化键。
• 仅在存在重要歧义或需要进行文化解释时提供译者注。

依赖项

• 目标语言配置文件：resources/lang/{code}.md，如果存在。
• 实质性内容或审校需使用 resources/translation-rubric.md。
• 英语和韩语需选用外部散文风格技能；加载与执行方式见 resources/style-skills.md。
• 其他目标语言使用共享的散文诊断规则和翻译例外说明。
• 翻译项目内容时，参考现有同类文件和术语表。

控制流特征

• 按 UI 批次或散文、配置文件是否存在、区域设置变体、歧义和审校模式分支处理。
• 仅加载目标语言配置文件及与内容类型相关的参考资料。
• 仅在用户要求修改文件时编辑文件。

结构化流程

开始

1. 确定源语言、目标区域设置、内容类型，以及任务是翻译、审校还是差异同步。
2. 优先保留精确标记：占位符、代码、URL、键和结构标记。
3. 如有目标语言配置文件，则加载；如果目标内容属于某个项目，则阅读同类译文。

阶段

1. 准备：确定区域设置、输出模式、目标受众和受保护语法。
2. 收集：阅读目标语言配置文件、相关同类内容、术语表和源文本上下文。在规范工作流中选择实质性散文风格路径；简短且独立的 UI 字符串采用轻量流程。
3. 推理：确定含义、语体、术语、文化典故和任何歧义。判断习语应按字面解释、替换还是保留。
4. 执行：撰写自然的目标语言文本。遵循项目既有惯例，不添加含义、观点或个性。
5. 验证：检查受保护语法和结构。对于实质性文本，依据评分标准检查含义、术语、语体和目标语言自然度。
6. 完成：仅返回用户要求的文本、补丁或审校结果，并且只提供有依据的结论。

转换条件

• 存在配置文件 → 加载；其中的目标语言规则优先于共享指南。
• 需要区域设置变体 → 起草前先确定变体。
• 不存在配置文件 → 使用共享指南，并且仅说明一次这一限制；不要套用其他语言的规则。
• 简短且独立的 UI 字符串，且存在既有同类译文 → 检查受保护语法和同类译文；完整散文审校可选。
• 长篇散文、文档、营销文案、混合表格／代码或审校模式 → 使用评分标准。
• 歧义会影响结果 → 提出一个有针对性的问题，或标明所采用的处理方式。
• 差异同步 → 仅修改源文件中发生变更的对应内容；根据标题和周围上下文定位，不按行号定位。

失败与恢复

失败	恢复
缺少目标语言上下文	使用源语言规范并说明假设，除非歧义会改变含义
字面措辞与项目惯例冲突	遵循既定的目标语言惯例，并说明实质性差异
占位符或结构不匹配	在输出或应用补丁前修订
缺少语言配置	使用共享指南，并说明覆盖范围的限制一次
文化典故不明确	仅在目标受众需要时添加简短说明
所选外部风格技能不可用	完成受支持的翻译检查，并报告无法执行的风格检查；不要改用其他语言的风格技能，也不要声称已执行该检查

退出

• 成功：文本忠实、自然、结构安全，并根据内容风险进行了适当检查。
• 部分完成：说明尚未解决的歧义、缺失的上下文或不可用的所选风格检查；不得编造答案或声称已执行该检查。

加载语言配置

解析 BCP 47 主子标签，并在存在匹配配置时加载一份：

目标语言	配置
韩语	resources/lang/ko.md
日语	resources/lang/ja.md
中文	resources/lang/zh.md；解析其中声明的变体
英语	resources/lang/en.md
其他	无配置；使用共享指南

语言配置规定排版、语体和目标语言检查。共享指南说明常见风险。如有冲突，以语言配置为准。仅当任务是扩展此技能时，才从 resources/lang/_template.md 添加新配置。

翻译方法

1. 理解原文含义、预期效果、领域术语和受保护语法。将比喻性措辞标记为意译、替换或保留。除非有理由，否则不要添加新比喻，也不要去掉有意使用的比喻。
2. 根据原文、目标受众和同类译文选择语体。仅将 .agents/oma-config.yaml 中的 translation_voice 用作节奏和正式程度偏好：formal（正式）、balanced（平衡，默认）或 interpreter（口译风格）。它绝不能凌驾于含义或目标语言规范之上。
3. 用目标语言重新组织文本。仅在目标语言需要时调整语序、拆分或合并句子，以及省略隐含主语。
4. 仅在适用时保留作者风格：散文、对话、改编文本或明确由用户撰写的文档。应贴合可观察到的节奏和措辞，绝不添加事实、立场、笑话、第一人称或更强烈的情绪。

验证

始终检查：

• 每个占位符、代码片段、标识符、URL 和区域设置键均未更改。
• 标题、链接、表格行、列表嵌套和代码块均保持原有结构。
• 译文符合目标语言配置中的排版和语体规则。
• 如果已有同类译文确立了术语或 UI 风格，则与其保持一致。

对于实质性内容和审校模式，还要检查以下标准：含义、自然度、术语、语体、文化适配度和情感力度。运用所选目标语言风格规范，同时保留原文有意为之的风格和内容。

审校模式

根据证据进行审校，而不要预设每份草稿都是机器翻译。若未确认实质性缺陷，则记录零项发现。区分以下内容：

• 准确性或安全性缺陷：含义改变、占位符损坏、术语错误或语体不当。
• 有依据的风格问题：具体的目标语言问题，并附上理由和建议修改方案。
• 偏好：可选的替代表达，不代表现有译文有误。

不要仅仅为了提出问题而重写已合格的译文。

批处理与差异同步

对于批处理，先读取完整内容集，只翻译值，并统一术语和语体选择。核对整个内容集中的占位符和键结构。

对于差异同步，依据标题和周边上下文映射每个源代码块。仅修改受影响的目标章节；无关文本保持字节级不变。说明已更新的章节、跳过的纯格式代码块，以及重要的术语选择。

输出格式

对于单段文本，提供译文，并简要说明存在歧义或需要调整之处。对于文件，保留输入格式，仅修改指定值。对于审校，展示原文；仅在确有必要时提供建议修订，并为每项发现提供依据。

逻辑操作

操作

操作	SSL 原语	依据
确定区域设置和模式	SELECT	用户请求和文件上下文
按条件读取配置文件和同级文件	READ	目标配置文件、术语表、相邻译文
保护语法和结构	VALIDATE	源文本标记和结构标记
推断含义和语体	INFER	源文本、受众、项目惯例
翻译或修订	WRITE	目标文本或请求的文件补丁
审核实质性内容	VALIDATE	评估标准和具体发现
报告结果和限制	NOTIFY	译文、补丁或审校结果

工具和手段

• 使用原生搜索/读取功能处理本地源文件和同级译文。
• 如可用，使用已配置的 code_intelligence 能力导航代码上下文；若不可用或超时，则使用原生搜索/读取功能。
• 根据规范工作流选择目标配置文件、评估标准、选定的文风实现和语言模板资源。

规范工作流路径

1. 确定目标区域设置并保护精确语法。
2. 加载适用的语言配置文件和相关同级文件；对于实质性内容或审校，加载评估标准。对于实质性文本，根据目标 BCP 47 主子标签进行选择：
   • en（包括区域变体）：加载 resources/style-skills.md 并解析 humanizer。
   • ko（包括区域变体）：加载该资源并解析 humanize-korean。
   • 其他语言：加载 ../_shared/core/anti-ai-prose.md、resources/anti-ai-patterns.md 和目标配置文件。 已有同级译文且内容简短、独立的 UI 字符串，只需检查受保护语法和同级译文；无需进行外部文风审校。
3. 推断含义、语体、术语和修辞语言的处理方式。
4. 按目标语言的自然语序和项目风格起草。
5. 对草稿应用选定的文风实现，同时保留仅审校模式和翻译忠实度。然后核对精确语法、术语、源文本中的主张、结构和差异同步范围，并根据评估标准检查实质性内容。
6. 输出所请求的译文、补丁或有依据的审校意见。如存在重要的配置文件或上下文限制，应予以说明。

资源范围

范围	资源目标
LOCAL_FS	源文件/目标文件、术语表、语言配置文件
CODEBASE	同级译文和代码上下文
PROCESS	语法检查以及选定外部技能的获取或本地检查
NETWORK	尚未获取时，从上游检索文风技能
MEMORY	区域设置、术语、语体、受保护语法、未解决的歧义

影响和副作用

• 生成译文或审校发现。
• 仅在明确请求时更改区域设置/文档文件。
• 保留源文本结构、标识符和占位符。
• 可能会检索缺失的选定文风技能包；重用已安装或缓存的指令。上游中间文件保留在可写的临时工作区中。

护栏

1. 优先保留原意、受保护的语法和文件结构，再考虑文风偏好。
2. 不得编造事实、观点、情绪强调、示例、引文或个性表达。
3. 不得用其他语言的语言配置文件代替。
4. 差异同步时，不得更改未触及的部分。
5. 不得声称已完成无法根据现有源内容验证的检查。

参考资料

• 翻译规范：resources/translation-rubric.md（处理实质性内容或进行审校时加载）
• 已选文风技能：resources/style-skills.md（英文或韩文实质性文本）
• 常见文本诊断：../_shared/core/anti-ai-prose.md（其他目标语言；审校文本风格时可使用翻译例外）
• 翻译例外与语法诊断：resources/anti-ai-patterns.md（其他目标语言；审校文本风格时可结合常见诊断）
• 目标语言配置文件：resources/lang/{ko,ja,zh,en}.md（加载一个匹配的配置文件）
• 配置文件模板：resources/lang/_template.md（仅在添加配置文件时使用）
• 共享上下文加载：../_shared/core/context-loading.md
• 共享质量原则：../_shared/core/quality-principles.md