translate-content

/digital-marketing-pro:translate-content

用途

通过以能力为先的服务路由和质量保证来翻译营销内容。对于每种目标语言，路由器会明确说明该语言类别对翻译服务的需求（例如，针对印度语系目标语言使用支持本地文字的模型；针对欧洲语言支持正式程度语体；针对中日韩语言支持分词和文字混用），并在运行时解析出具体服务——使用品牌记录的首选服务，或用户已连接的翻译 MCP 服务。如果无法解析出任何服务，翻译将使用该工具自身的多语言能力进行，并强制进行质量评分——绝不会凭记忆指定产品，也不要求必须使用任何产品。整个过程中都会保留品牌语气、格式和关键术语。

除了直译外，此命令还会分析内容，找出需要意译而非直译的元素，包括习语、文字游戏、幽默、带有情绪感染力的行动号召和文化典故。检测到这些元素时（或用户明确要求意译时），命令会提供多个创意选项，并对意图保留程度进行评分，确保情感冲击力和营销效果能够跨语言传递。交付前，每份译文都会经过质量评分和品牌语气检查。

所需输入

用户必须提供以下信息（或将收到提示）：

• 待翻译内容：内联文本、文件路径或粘贴的内容块。可以是单段内容（标题、邮件、广告文案），也可以是结构化文档（落地页、包含多个部分的邮件模板）
• 目标语言：一种或多种目标语言——可使用语言代码（hi、de、ja、fr-CA、pt-BR）或语言名称（印地语、德语、日语、加拿大法语、巴西葡萄牙语）。可指定多个目标语言进行批量翻译
• 源语言：可选——原始内容所用的语言。如果未指定，将通过 language-router.py 自动检测
• 意译标记：可选——设为 true 可强制对所有内容采用意译方式，无论内容分析结果如何。适用于用户知道内容具有高度创意性或对文化敏感的情况
• 禁止翻译的术语：可选——必须保留源语言形式的特定术语、产品名称或品牌元素。此项会覆盖品牌资料中已有的任何禁止翻译列表
• 正式程度：可选——对于有正式／非正式语体之分的语言，指定 formal 或 informal（如德语的 Sie/du、法语的 vous/tu 等）。如果解析出的翻译服务支持语体控制，则会将此设置传递给该服务；否则会在翻译说明中强制执行，并在审核时验证。如果未指定，则默认采用品牌资料中的偏好，或正式语体
• 术语表条目：可选——术语对（源语言：目标语言），用于确保关键术语采用指定译法。补充品牌级术语表中的条目

流程

1. 加载品牌上下文：读取 ~/.claude-marketing/brands/_active-brand.json 获取当前品牌的 slug，然后加载 ~/.claude-marketing/brands/{slug}/profile.json。提取语言配置——do_not_translate 术语列表、translation_preferences（每种语言对的首选服务、正式程度默认值、术语表），以及 locale_formatting 规则（日期格式、数字分隔符、货币符号）。从 skills/context-engine/compliance-rules.md 加载目标市场的合规规则。检查 ~/.claude-marketing/brands/{slug}/guidelines/_manifest.json 中是否有指南——如果有，加载语气与风格规则（这些规则会影响翻译的品牌声音评分）。检查 ~/.claude-marketing/sops/ 中是否有代理机构的 SOP。如果没有品牌，询问：“先设置品牌（/digital-marketing-pro:brand-setup）？”——或使用默认设置继续。
2. 检测源语言：如果未指定源语言，运行 python "${CLAUDE_PLUGIN_ROOT}/scripts/language-router.py" --action detect --text "{content_or_path}"，以置信度评分识别源语言。如果置信度低于 95%，向用户报告检测到的语言以供确认。
3. 路由到翻译能力：针对每种目标语言，运行 python "${CLAUDE_PLUGIN_ROOT}/scripts/language-router.py" --action route --source "{source_lang}" --target "{target_lang}" --brand {slug}。结果会给出该语言族的 capability_kind 和 service_criteria，并且仅从品牌记录的首选项（basis: brand-preference）或用户已连接的翻译 MCP 服务（basis: connected-servers）中确定具体服务（有多个候选项时，选择最符合标准的一项，并提出通过 /digital-marketing-pro:language-config 记录该选择）。向用户报告确定的服务及其依据。如果 basis: unresolved，请明确说明，并遵循负载中的解决步骤——绝不能凭记忆指定服务，也不能指示用户安装服务。
4. 分析内容的创译需求：扫描源内容，找出不适合直译的元素——习语和口语表达、文字游戏或双关语、幽默和讽刺、情感化的 CTA 和口号、文化典故和类比、押韵或节奏模式、双关含义。如果已设置创译标记，或内容包含需要大量创译的元素，请使用 skills/context-engine/transcreation-framework.md 中定义的方法准备创译简报。针对每个标记的元素，记录其原始意图、情感基调和期望的受众反应，为创意改编提供指导。
5. 执行翻译，使用路由结果确定的方式：
   • 已确定 MCP 服务（basis: brand-preference 或 connected-servers）：调用该服务。利用其现有功能——正式程度/语域参数、术语表或禁止翻译规则的强制执行、用于保留 HTML/XML 的标签处理、印度语目标语言的文字体系或方言偏好、中文变体选择。如果服务缺少标准要求的功能，则在发送的指令中强制执行，并在评分步骤中验证。
   • 未确定服务（basis: unresolved）：使用运行环境自身的多语言能力进行翻译，并自行应用路由结果中的 service_criteria（语域、文字体系保真度、变体）。这条路径合理，并非降级备用方案——但必须执行步骤 6 的质量评分，以及步骤 7 中低于 85 分时的人工审核标记。
   • 所有路径均须：传入或强制执行禁止翻译的术语（合并品牌资料与用户提供的列表）、正式程度设置、术语表条目，以及格式保留要求（HTML 标签、{{first_name}} 之类的占位符、Markdown 语法）。
6. 评估翻译质量：运行 python "${CLAUDE_PLUGIN_ROOT}/scripts/language-router.py" --action score --source "{source}" --target "{target}" --original "{source_content}" --translated "{translated_content}"，从以下维度评估质量：
   • 长度比例（译文相对于原文的长度——标记异常扩写或压缩）
   • 格式保留（HTML 标签、Markdown、占位符均完整）
   • 关键术语一致性（遵守禁止翻译规则，正确应用术语表）
   • 占位符完整性（保留 {{name}}、{price} 等所有动态变量）
   • 完整性（无遗漏的句子或段落）
7. 处理质量问题：如果翻译质量评分低于 85，根据评分明细找出具体问题。尝试针对性修正——重新翻译有问题的片段、修复格式错误、恢复缺失的占位符。修正后重新评分。如果质量仍低于 85，则标记具体问题，交由人工审核。
8. 执行创译（如适用）：对于标记为需要创译的内容，或已设置创译标记的内容，针对每个标记元素提供 2-3 个创意改编选项。每个选项包括：
   • 目标语言中的创意改编
   • 用于审核的英文回译
   • 意图保留评分（原始营销意图的传达程度）
   • 文化适配说明（此改编适用于目标市场的原因）
   • 语气一致性评估（正式/活泼/紧迫的语气是否与原文一致）
9. 检查品牌声音：执行 python "${CLAUDE_PLUGIN_ROOT}/scripts/brand-voice-scorer.py" --brand {slug} --text "{translated_content}"，评估译文是否保持品牌声音特征。标记任何声音偏移，并提供具体示例和建议。
10. 呈现译文和质量指标：交付最终译文，并附上所有质量数据，以便轻松审核和批准。

输出

结构化的翻译交付内容，包括：

• 翻译内容：每种目标语言的最终译文，保留原始格式（HTML、Markdown、占位符）
• 翻译质量评分：总体评分（0-100），并按维度细分——长度比例、格式保留、关键术语一致性、占位符完整性、内容完整性
• 所用服务：处理此语言对的翻译服务，以及选择该服务的原因
• 源语言：检测或确认的源语言及置信度
• 不翻译内容合规性：确认所有受保护术语均保留源语言原文，或标出任何违规情况
• 品牌语气评分：译文对品牌语气特点的保留程度，并具体说明检测到的语气偏移
• 创译选项（如适用）：针对每个标记元素提供 2-3 种创意改编方案，每种方案包括回译、意图保留评分、文化适配说明和语气契合度评估
• 格式保留报告：确认 HTML 标签、Markdown 语法、占位符和结构元素均在翻译中完整保留
• 质量标记：列出低于阈值的问题，并具体说明问题及严重程度（严重：内容缺失或占位符损坏；警告：轻微格式偏移或长度比例异常；提示：细微的风格问题）
• 建议：有关如何改进译文的建议——人工审核重点、今后翻译需添加到术语表中的术语，以及所需的本地化调整（例如日期格式、货币符号、计量单位）

使用的 Agent

• localization-specialist -- 管理端到端翻译工作流，包括服务路由、创译分析、质量评分、文化适配评估、目标语言中的品牌语气保留，以及质量问题解决