SuperAPI AI 工具集

translate-content

营销与增长

查看项目

更新于 10-16 09:01

技能介绍

用途

该技能用于翻译营销内容,并在翻译过程中结合品牌术语表与“禁止翻译”(do-not-translate)词表,同时提供质量评分。它面向营销场景,强调在跨语言转换时保留品牌语调、格式与关键术语,并对需要创译而非直译的内容进行识别与处理。

主要能力

  • 支持一个或多个目标语言,接受语言代码(如 hi、de、ja、fr-CA、pt-BR)或语言名称(如 Hindi、German、Japanese、Canadian French、Brazilian Portuguese),可批量翻译。
  • 源语言可选,省略时通过 language-router.py 自动检测并给出置信度。
  • 支持创译标志:可强制对所有内容采用创译方式,适用于高度创意或文化敏感的内容。
  • 支持“禁止翻译”词表与术语表条目,覆盖品牌配置中的默认设置。
  • 支持正式/非正式语体(formality level),适用于有语体区分的语言(如德语 Sie/du、法语 vous/tu)。
  • 按语言族进行能力优先的服务路由:为每个目标语言确定语言族所需的翻译服务特征(如印度语系需要原生文字感知模型、欧洲语言需要语体寄存器、CJK 需要分词与文字混排),并在运行时解析具体服务。
  • 内容分析:扫描习语、双关、幽默、讽刺、情感号召、口号、文化引用、押韵节奏、双关含义等需要创译的元素。
  • 质量评分:从长度比例、格式保留、关键术语一致性、占位符完整性、完整性等维度评分。
  • 品牌语调检查:评估译文是否保持品牌语调特征,标记语调漂移。
  • 创译执行:为标记元素生成 2-3 个创意改编选项,每个选项包含目标语言改编、回译英文、意图保留评分、文化适配说明与语调对齐评估。

使用方式

该技能以命令形式调用:/digital-marketing-pro:translate-content。脚本位于该插件的 scripts/ 文件夹中(与 skills/ 同级)。若宿主未设置 ${CLAUDE_PLUGIN_ROOT},需从该位置运行脚本。使用 Python 3.10 或更新版本,命令为 python,在 macOS 及许多 Linux 系统上若找不到 python 则使用 python3。

用户需提供(或将被提示提供):

  • 待翻译内容:内联文本、文件路径或粘贴的内容块,可以是单条内容(标题、邮件、广告文案)或结构化文档(落地页、带分区的邮件模板)。
  • 目标语言:一个或多个。
  • 源语言:可选,省略时自动检测。
  • 创译标志:可选,设为 true 强制对所有内容采用创译方式。
  • 禁止翻译词表:可选,指定必须保留源语言的术语、产品名或品牌元素,覆盖品牌配置中的列表。
  • 语体级别:可选,formal 或 informal;省略时默认使用品牌配置偏好或 formal。
  • 术语表条目:可选,源:目标 词对,补充品牌级术语表。

处理流程包括:加载品牌上下文(读取 ~/.claude-marketing/brands/_active-brand.json 与 profile.json,提取语言配置、禁止翻译词表、翻译偏好、区域格式规则,加载目标市场合规规则与语调规则,检查机构 SOP);检测源语言;按目标语言路由翻译能力;分析创译需求;执行翻译;评分;处理质量问题;执行创译(如适用);运行品牌语调检查;呈现译文与质量指标。

路由结果会说明 capability_kind 与 service_criteria,并仅从品牌已记录的偏好(basis: brand-preference)或用户已连接的翻译 MCP 服务器(basis: connected-servers)中解析具体服务。若 basis: unresolved,则明确说明,并遵循载荷中的解析阶梯——绝不凭记忆指定服务,也不指示安装任何服务。

翻译执行路径:

  • 已解析 MCP 服务器(basis: brand-preference 或 connected-servers):调用该服务器,使用其已有能力(语体/寄存器参数、术语表或禁止翻译执行、HTML/XML 标签处理、印度语系文字或方言偏好、中文变体选择)。若服务器缺少标准要求的能力,则在发送的指令中强制执行,并在评分步骤中验证。
  • 未解析(basis: unresolved):使用宿主自身的多语言能力翻译,自行应用路由结果中的 service_criteria(寄存器、文字保真、变体)。此路径是合法路径,并非降级回退,但第 6 步质量评分与第 7 步低于 85 分触发人工审核标记对此路径不可协商。

所有路径中均需传递或强制执行:禁止翻译词表(合并品牌配置与用户提供列表)、语体设置、术语表条目、格式保留(HTML 标签、{{first_name}} 等占位符、Markdown 语法)。

质量评分通过 language-router.py 的 score 动作进行,评估维度包括长度比例、格式保留、关键术语一致性、占位符完整性、完整性。若质量分低于 85,则识别具体问题并尝试针对性修正(重译问题片段、修复格式断裂、恢复缺失占位符),修正后重新评分;若仍低于 85,则标记具体问题供人工审核。

品牌语调检查通过 brand-voice-scorer.py 执行,评估译文是否保持品牌语调特征,标记语调漂移并给出示例与建议。

适用场景

  • 营销内容的多语言翻译,如标题、邮件、广告文案、落地页、邮件模板等。
  • 需要保留品牌术语、产品名或特定品牌元素不翻译的场景。
  • 需要区分正式/非正式语体的语言翻译。
  • 内容包含习语、双关、幽默、情感号召、文化引用等需要创译而非直译的元素。
  • 需要批量翻译多个目标语言。
  • 需要质量评分、格式保留验证与品牌语调一致性检查的翻译交付。

限制

  • 脚本需要 Python 3.10 或更新版本。
  • 若宿主未设置 ${CLAUDE_PLUGIN_ROOT},需手动定位插件 scripts/ 文件夹。
  • 服务路由仅在品牌已记录偏好或用户已连接翻译 MCP 服务器时解析具体服务;否则使用宿主自身多语言能力,且质量评分与低于 85 分人工审核标记为强制要求。
  • 绝不凭记忆指定翻译服务,也不指示安装任何服务。
  • 若质量分低于 85 且修正后仍低于 85,需人工审核。
  • 品牌上下文、合规规则、语调规则、机构 SOP 等依赖特定文件路径与配置,缺失时可能提示先设置品牌或使用默认值。
  • 关于具体收费、价格、平台支持范围、效果保证等信息,资料中暂未提供。