关于 translation
面向 AI Agent 的翻译技能,可根据文本语境、受众和目标地区调整译文。它兼顾格式与术语一致性,并处理习语、文化内容和正式程度。
主要功能
- 01分析语境、领域与语体
- 02统一术语并使用词汇表
- 03保留格式和占位符
- 04适配文化内容与地区规范
- 05检查译文准确性和流畅度
- 06为有歧义的选择添加说明
适用场景
- 01翻译技术文档
- 02本地化 UI 字符串和结构化文件
- 03面向目标地区调整营销文案
- 04翻译法律或通用文本
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ seb1n/ awesome-ai-agent-skills --skill translation安装后在 Claude Code 中输入/translation确认已加载。
详细介绍
翻译
此技能使 AI Agent 能够在不同语言之间翻译文本,同时保留其含义、语气和上下文。它不只是逐字替换,还能处理习惯表达、文化细微差异、领域专用术语和正式程度。Agent 可以翻译技术文档、营销文案、UI 字符串、法律文本和一般散文,并根据目标语言环境的惯例调整译文。
工作流
-
分析源文本上下文 检查源文本,确定其领域(技术、营销、法律、日常)、语域(正式、非正式、中性)和目标受众。识别需要调整而非直译的习惯表达、文化特定内容或幽默。注意文档格式(纯文本、Markdown、JSON、HTML),以便在输出中保留结构。
-
研究术语 对于专业内容,建立或参考术语表,确保术语一致。技术文档要求准确翻译领域术语(例如,在许多语言中,“endpoint”会保留为“endpoint”,或映射为公认的对应词)。营销文案可能需要创造性的转译,而非直接翻译。如果用户提供了术语表或翻译记忆库,请在开始翻译前将其纳入参考。
-
翻译内容 按照确定的语气、正式程度和术语要求进行翻译。保留所有格式标记,例如 Markdown 标题、代码块、HTML 标签和 JSON 键。对于 UI 字符串,保留占位符令牌(例如,
{username}、%d),并将其放在目标语言中正确的语法位置。遵循目标语言特有的复数规则。 -
本地化文化内容 根据目标语言环境调整计量单位、日期格式、货币符号和具有文化特色的比喻。例如,为欧洲受众翻译时,将英里换算为公里,或将美国体育类比替换为目标文化更熟悉的类比。对于营销内容,确保口号和行动号召在目标语言中同样具有说服力。
-
检查准确性和流畅度 重新阅读译文,检查语法是否正确、表达是否自然,以及是否忠实表达源文含义。检查是否意外遗漏或重复了句子。通过对照第 2 步建立的术语表,确认全文术语一致。
-
附注交付 以与源文相同的格式返回译文。如果存在有歧义的翻译选择,请附上简短的译者注,说明理由。如果用户要求多种正式程度或地区变体,请清楚标注各个版本。
用法
提供待翻译的文本和目标语言。还可以选择指定:
- 源语言(如果无法自动检测)
- 正式程度 — 正式、非正式或中性
- 领域 — 技术、营销、法律、医疗、一般
- 术语表 — 关键术语及其指定译法
- 输出格式 — 纯文本、Markdown、JSON 本地化文件等
示例提示:“将以下 API 错误消息翻译成日语(正式)。保留 JSON 结构和所有占位符令牌。”
示例
示例 1:翻译技术段落(英语到德语,正式语体)
输入:
身份验证模块使用 OAuth 2.0 和 PKCE 来保护 API 请求。当用户发起登录时,客户端会生成代码验证器和代码质询。授权服务器会在颁发访问令牌之前验证质询。令牌在 3600 秒后过期,必须通过刷新令牌端点进行续期。
输出:
身份验证模块使用 OAuth 2.0 和 PKCE 来保护 API 请求。当用户发起登录时,客户端会生成代码验证器和代码质询。授权服务器会在颁发访问令牌之前验证质询。令牌在 3600 秒后过期,必须通过刷新令牌端点进行续期。
译者注:“代码验证器”“代码质询”和“刷新令牌端点”尽量贴近英文原文,因为这些是德语开发者社区中约定俗成的术语。
示例 2:本地化 UI 字符串(英语到西班牙语,JSON 本地化文件)
输入:
{
"greeting": "Hello, {username}!",
"items_in_cart": "You have {count} item(s) in your cart.",
"checkout_button": "Proceed to Checkout",
"empty_cart": "Your cart is empty. Start shopping!",
"order_confirmation": "Your order #{orderId} has been placed on {date}."
}
输出:
{
"greeting": "Hola, {username}!",
"items_in_cart": "Tienes {count} artículo(s) en tu carrito.",
"checkout_button": "Proceder al pago",
"empty_cart": "Tu carrito está vacío. ¡Empieza a comprar!",
"order_confirmation": "Tu pedido n.º {orderId} se ha realizado el {date}."
}
**译者注:**占位符标记 {username}、{count}、{orderId} 和 {date} 均保持不变。此处使用非正式的“tú”形式;正式场景下应改用“usted”。
最佳实践
- 保留格式和结构。 翻译时切勿删除 Markdown、HTML 标签或 JSON 键。译文必须能够直接替换源格式中的内容。
- 保持术语一致。 对同一源术语,在整份文档中使用相同的译法。在开始时建立术语表,并在整个翻译过程中持续参照。
- 注意正式程度。 日语、韩语、德语和西班牙语等语言有不同的正式和非正式语体。翻译前务必确认所需语体。
- 处理复数规则。 许多语言的复数形式较复杂(例如,阿拉伯语有六种)。翻译含有数量相关文本的 UI 字符串时,应考虑目标语言的复数规则。
- 避免逐字翻译习语。 “hit the ground running”或“low-hanging fruit”等短语应替换为目标语言中的对应表达,而非逐字翻译。
- 注明有歧义的译法。 如果源术语有多个可行译法,请附上简短说明,解释所选译法及其他选项。
特殊情况
- 无法翻译的术语: 某些技术术语(例如,“API”“OAuth”“webhook”)在某些语言中没有标准译法。保留原文,并说明这一决定。
- 从右向左书写的语言: 翻译成阿拉伯语、希伯来语或波斯语时,应确保混合方向文本(例如阿拉伯语句子中的英文品牌名)使用适当的双向文本标记。
- 字符编码: CJK 语言可能会导致定宽 UI 字段中的字符串长度问题。如果译文的字符数明显超过源字符串,请标注。
- 性别中立语言: 有些目标语言要求使用语法性别。源文不含性别信息时,请向用户确认,或提供带有不同性别形式的译文。
- 空文本或占位符源文本: 如果源文本仅包含占位符或为空字符串,则原样返回,并注明无需翻译。