Communitygithub.com

AcTePuKc/bg-game-translation-qa

Codex 技能,用于保加利亚语游戏本地化 QA

bg-game-translation-qa 是什么?

这是一个专为保加利亚语游戏本地化质量保证设计的 AI 助手技能。它的核心原则是:在改进文本的同时,必须严格保留原始文件格式。该技能支持在处理各种游戏文件(如 JSON、XML、CSV、PO 等)时,仅对用户可见的文本进行最小化、安全的修改,并优先采用补丁式更改而非整体重写。技能详细规定了不可翻译的内容范围(如内部标识符、枚举名、文件名、路径等),并严格要求按字节保留占位符和格式标签(如 `{PLAYER}`、`<color=...>`、`\n` 等)。在保加利亚语本地化风格上,它指导使用自然的保加利亚语表达,避免逐字直译;对技术术语进行了细致的区分指导(如 `hook`、`handler` 等不应机械翻译);明确建议在游戏 UI 中优先使用非正式的“ти”称呼而非正式的“Вие”;并提供了识别“翻译赘余”(Translation Ballast)的规则。该技能主要面向使用 AI 编码代理(如 Codex)的开发者和本地化专家,帮助他们进行高效、精准且格式安全的游戏本地化 QA 工作。

兼容平台~Claude Code✓Codex CLI~Cursor
npx skills add AcTePuKc/bg-game-translation-qa

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

保加利亚语游戏本地化 QA

在进行保加利亚语游戏本地化工作时使用此技能,其中保留文件格式与改进文本同等重要。仅进行最小化、安全的更改,并优先采用针对性补丁,除非用户明确要求全面重写,否则不要重写整个文件。

核心工作流程

  1. 在编辑前,先识别文件格式和可翻译字段。
  2. 保留所有结构、排序、分隔符、引号、转义、注释、键、ID 和元数据。
  3. 仅翻译或编辑面向用户的文本。
  4. 除非用户明确要求更改,否则严格按原样保留占位符、格式标签、变量、转义序列和换行符。
  5. 遵循用户提供的或项目中存在的任何项目术语表、术语库、风格指南或现有翻译记忆。
  6. 将不确定的字符串单独报告,而不是默默猜测。
  7. 总结更改了哪些内容、哪些保持不变以及任何风险或问题。

不可翻译的内容

除非用户明确将其标记为面向玩家的文本,否则不要翻译或规范化内部标识符、枚举名称、文件名、文件路径、类名、函数名、对象名、资源名、事件名、控制台命令、配置键、ID 或技术元数据。

对于结构化文件,请保持行数、键顺序、嵌套、分隔符和编码不变。对于 CSV/TSV 表格,保留精确的列结构。对于 JSON/XML/INI/PO 样式文件,保留语法和转义。

占位符和标签

按字节保留占位符和格式标签,包括大小写、标点符号、嵌套、间距和顺序。不要翻译变量内的文本,除非它明显是面向玩家的显示文本。

始终保护此类模式:

  • {PLAYER}
  • {0}
  • %s
  • %d
  • <color=...>
  • </color>
  • <b>
  • </b>
  • \n
  • \t
  • [br]
  • [[...]]
  • $VARIABLE
  • ${variable}

当任务包含不熟悉的标记、富文本、UI 标记、脚本语法或特定格式的占位符时,请阅读 references/placeholders.md。

保加利亚语本地化风格

使用自然的保加利亚语措辞,而不是字面照搬英语语序。保持 UI 文本简洁易读,尤其是按钮、菜单、成就、工具提示和战斗信息。

在可能的情况下,优先采用文化上合适的保加利亚语翻译而非音译,但保持既定的游戏术语和项目术语表选择的一致性。在对话中保留角色语气,避免对随意或幽默的言语过于正式化。

当说话者或玩家的性别未知时,在保加利亚语允许中性结构的地方,避免强加带性别的措辞。不要引入俄语或乌克兰语式的措辞。除非项目风格要求,否则避免复制英语标题、物品名称或 UI 标签中的不必要大写。

技术术语和外来词

不要仅仅因为一个技术术语在源文本中可见就机械地翻译它。首先确定它是一个内部标识符、一个既定的专业术语还是面向玩家的散文。

  • 保持 API 名称、命令、配置键、类名和其他标识符不变。
  • 对于面向玩家的文本,优先使用对功能的自然保加利亚语描述,而不是字面借用。
  • 如果源文本没有精确确定技术角色,不要自行发明。使用中立的功能性短语或将字符串报告为不确定。
  • 当项目术语表定义了一个术语时,即使存在另一个保加利亚语选项,也要遵循它。

示例:

源术语面向玩家的文本技术解释不要假设
hookмеханизъм / точка за включванеобработчик / точка за разширяване它意味着一个模块或「кука」
compatibility hookмеханизъм за съвместимостобработчик за съвместимост 或 точка за включване за съвместимостмодул、кука 或 прихващач 总是正确
fixпоправка / корекцияпоправка за съвместимост俚语 фикс 适合该受众
handler如有需要,描述其动作обработчик它应该被音译为 хендлър

例如,对于面向玩家的更新日志,将 The journal level label was corrected through the compatibility hook. 翻译为 Надписът за нивото в дневника е коригиран чрез механизма за съвместимост. 不要默认使用 кука за съвместимост。

重复出现的游戏术语

当游戏机制或 UI 概念重复出现时,在第一次明确出现时决定其保加利亚语名称,并将其记录在项目术语表中。不要仅仅因为相关术语在英语中听起来相似就将它们合并为一个保加利亚语单词。

需要区分的源术语可能的保加利亚语选择质量保证风险
skill, ability, perk, trait, featумение, способност, привилегия, черта不同的成长系统变得无法区分
buff, debuff, status effectположителен ефект, отрицателен ефект, ефект на състояние玩家无法区分增益和状态
cooldown, charge, stackвреме за изчакване, заряд, натрупване计时、资源和累积机制被混淆
loot, dropплячка, изпуснат предмет奖励池与事件或敌人产生的物品混淆
spawn, despawn, triggerпоявяване, изчезване, задействане世界事件和交互条件变得模糊
crafting, recipe, blueprint, upgradeизработка, рецепта, чертеж, подобрение制作、解锁和升级失去了其机制上的区别
save, load, save slotзапазване, зареждане, място за запазена игра动作、已保存的游戏及其位置被混淆

另请审查上下文敏感的技术词汇,例如 support、state、patch、build、release 和 slot。例如,support 可能表示 съвместимост、поддръжка 或 помощ;patch 可能表示 поправка、корекция 或 обновление。

称呼和语域

对于面向玩家的游戏 UI、教程、提示、目标或通用系统消息,不要默认使用正式的 Вие / -те 措辞。除非项目术语表、角色语气、设定或源上下文明确要求正式称呼,否则更倾向于非正式的单数 ти / -ш 或自然的中性结构。

将不匹配的称呼/语域标记为质量保证问题,特别是当英语的 you 在没有证据表明游戏使用正式玩家称呼的情况下被翻译为正式的保加利亚语时。

示例:

  • You have to do this. -> 根据上下文,优先使用 Трябва да направиш това. 或 Това трябва да се направи.
  • 避免在正常的面向玩家的 UI 中默认使用 Вие трябва да направите това.
  • 对贵族、官员、客服式 UI、故意疏离的叙述或既定风格使用 Вие 的项目保持正式称呼。

翻译赘余

标记那些在技术上被翻译了但在保加利亚语 UI 文本中增加了不必要负担的源短语。将这些视为需要人工审查的质量保证警告,而不是自动修复。

对于可能的翻译赘余,使用严重级别 low 和操作 manual review(人工审查)。当该短语承载真实的游戏玩法、空间、目标、时机或机制信息时,则保留它。

常见示例:

  • 动词如 shoot、fire、throw 或 launch 后的 through the air
    • shoots arrows through the air -> изстрелва стрели
    • 标记过于字面的变体,如 изстрелва стрели във въздуха,除非空气传播在机制上相关
  • 当保加利亚语句子已隐含接近性时的 nearby
    • when enemies are nearby -> когато има врагове наблизо
    • when senses lifeforms nearby -> когато усети живи същества наблизо
    • 当 наблизо 定义了检测半径、目标、触发范围或位置时,则保留它
  • 在已隐含破坏动作的动词后的 into pieces / apart
    • smashing things apart -> разбиване на неща
    • 避免强加措辞如 разбиване на неща на парчета,除非碎片/部分很重要
  • 当保加利亚语动词或上下文已暗示信息时的 on the ground、in front of you、with your hands 或 by hand
    • 当它们承载真实的位置、输入、制作或交互约束时,则保留它们

请阅读 references/bg-text.md 以获取实用的保加利亚语风格指南,并在创建或扩展项目术语表时阅读 references/glossary-template.md。

与 bg-text 的关系

当 bg-text 技能可用或用户要求使用时,将其作为保加利亚语排版、清晰度、标点符号、语法和一般编辑质量的配套参考。首先应用此技能的游戏本地化约束:永远不要让排版或风格清理改变受保护的结构、键、ID、占位符、标签、转义序列、换行符或项目术语。

对于游戏文件,将 bg-text 视为语言质量指南,而不是允许重写整个文件或规范化引擎特定语法。

质量保证检查清单

在最终输出之前,请检查:

  • 占位符是否被破坏、更改、重新排序或缺失
  • 格式标签是否缺失、格式错误或不平衡
  • 键、ID、文件名、路径或元数据是否被更改
  • 行是否缺失或表格形状是否改变
  • 是否引入或遗漏了重复的 ID
  • 已翻译字段中是否有未翻译的英语
  • 是否遗留了乌克兰语内容
  • 是否遗留了俄语内容
  • 术语表术语是否不一致
  • 技术术语是否被机械或不一致地翻译
  • 相关游戏机制是否在没有术语表决策的情况下被合并为一个术语
  • 保加利亚语是否过于字面
  • 称呼/语域是否不匹配,特别是在面向玩家的 UI 中是否出现了不必要的 Вие
  • 是否存在可能需要人工审查的翻译赘余/字面短语
  • UI 文本对其可能的控件来说是否明显过长

请阅读 references/qa-checklist.md 以获取实用的最终审查通过指南。

输出期望

优先采用补丁式更改和有针对性的修正。简要解释有意义的翻译或质量保证更改。将不确定的字符串单独列出,包括键/ID 或位置、问题以及最安全的建议处理方式。

如果文件很大,请检查足够的周围上下文以避免术语漂移,然后仅编辑请求的范围。如果请求的更改可能危及结构或占位符,请停止并请求澄清。

相关技能