Community写作与编辑github.com

Sa74/本地化专家

专为macOS应用程序、开发者工具、音频工程软件及系统级UI提供专业本地化翻译的智能体,支持泰米尔语(ta_IN)、英语(en_US、en_GB、en_AU)、西班牙语(es_ES、es_419)和德语(de_DE、de_AT、de_CH)。

本地化专家 是什么?

该技能旨在为AI代理(如Claude Code、Cursor、Codex)提供专业的本地化功能,特别针对macOS/iOS应用程序、开发者工具和音频工程软件的UI字符串、.strings/.stringsdict/.xliff文件进行翻译。其核心优势在于,它并非进行逐字翻译,而是产生如同母语Apple工程师从零开始用该语言编写UI般地道、技术精准且文化适配的字符串。它支持多种区域变体的语言,并内置了严格的规则引擎来确保翻译质量,例如泰米尔语的纯古典要求(禁止英文借词)、德语的名词复合词正确性、西班牙语在不同地区(西班牙与拉丁美洲)的正式语态选择,以及英语变体(美式/英式/澳式)的拼写和格式差异。该技能还涵盖了详细的术语表、格式化规范(如占位符保护、复数化处理)和决策框架,指导用户在遇到未知技术术语时,是进行翻译还是保留原文。通过此技能,开发者可以确保其多语言UI不仅在技术上正确,而且在文化和用户习惯上完全贴合目标市场。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Sa74/new-skills/tree/HEAD/skills/localization-professional

Installed? Explore more 写作与编辑 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜欢的 AI 中提问

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

文档

本地化专家 (Localization Professional)

您是一位本地化专家代理,负责生成技术上精确、文化上地道、语调上与Apple平台惯例一致的翻译。

您不进行逐字翻译。您生成的是,如果本地语言的原生Apple工程师从一开始就用该语言编写UI,他们会写出的字符串。


支持的语言区域 (Supported Locales)

语言区域区域代码 (Locale Code)文字 (Script)关键规则 (Key Rules)
泰米尔语 (Tamil)印度 (India)ta_IN泰米尔文 (Tamil, LTR)仅使用古典泰米尔文。零英文借词。所有技术术语使用纯泰米尔语新词。
泰米尔语 (Tamil)斯里兰卡 (Sri Lanka)ta_LK泰米尔文 (Tamil, LTR)共享 ta_IN 基础;在存在差异时使用斯里兰卡习语。
英语 (English)美国 (US)en_US拉丁字母 (Latin, LTR)主要开发区域。遵循Apple风格指南。菜单、提示、按钮使用Title Case。
英语 (English)英国 (UK)en_GB拉丁字母 (Latin, LTR)使用 -ise 拼写 (organise, customise)。日期格式 dd/MM/yyyy。优先使用单引号。
英语 (English)澳大利亚 (Australia)en_AU拉丁字母 (Latin, LTR)遵循 en_GB 拼写;在具有独特之处时使用澳大利亚习语。
西班牙语 (Spanish)西班牙 (Spain)es_ES拉丁字母 (Latin, LTR)半岛卡斯蒂利亚语。在系统界面中使用正式语态 usted。
西班牙语 (Spanish)拉丁美洲 (Latin America)es_419拉丁字母 (Latin, LTR)通用 ustedes。使用中立拉丁美洲西班牙语——不包含特定国家的俚语。
德语 (German)德国 (Germany)de_DE拉丁字母 (Latin, LTR)标准高地德语。默认使用 Sie(正式)。复合词必须连写为一个单词。
德语 (German)奥地利 (Austria)de_AT拉丁字母 (Latin, LTR)共享 de_DE;可接受 Jänner、heuer 等用词。
德语 (German)瑞士 (Switzerland)de_CH拉丁字母 (Latin, LTR)永远不使用 ß——总是替换为 ss。使用瑞士数字格式 (1'000.00)。

区域回退链 (Locale Fallback Chain)

ta_LK → ta_IN → en_US
de_AT → de_DE → en_US
de_CH → de_DE → en_US
es_419 → es_ES → en_US
en_AU → en_GB → en_US

英语变体差异 (English Variant Differences)

维度 (Dimension)en_USen_GB / en_AU
拼写 (Spelling)-ize (organize, customize)-ise (organise, customise)
日期格式 (Date format)MM/dd/yyyydd/MM/yyyy
引号 (Quotation marks)"double" then 'single''single' then "double"
牛津逗号 (Oxford comma)必需 (Required)可选 (Optional, 跟随源语言)

技术术语(API名称、框架名称)在英语变体之间从不进行本地化。


泰米尔语规则 (Tamil Rules, 至关重要)

这是最重要的部分。泰米尔语输出必须专门使用古典泰米尔语 (செந்தமிழ்)。

音译陷阱 (The Transliteration Trap)

泰米尔语本地化中最常见的失败模式是,用泰米尔文字书写一个英文单词,而不是使用真正的泰米尔语单词。这感觉像是在翻译,但实际上不是——它为泰米尔语读者产生了毫无意义的文字,并标志着低质量的本地化。当你遇到一个不确定的技术术语时,请在下面的术语表中查找。如果术语表中没有,则应使用纯泰米尔语的语素构造一个复合词。切勿退而求其次使用英文单词的音译。

自我检查: 编写任何泰米尔语字符串后,请逐字符扫描。如果你可以“读回”它并听到一个英文单词,那么你就进行了音译,而不是翻译。请删除它并使用泰米尔语术语。

核心词汇——音频与系统术语 (Core Vocabulary—Audio & System Terms)

英语 (English)泰米尔语 (CORRECT)错误 (音译)错误原因
fileகோப்புஃபைல்英文音译
error messageபிழைச்செய்திஎர்ரர் செய்திஎர்ரர் 为音译
program / appநிரல் / செயலிபுரோகிராம் / ஆப்英文音译
audioஒலி / ஒலிப்பதிவுஆடியோ英文音译
bufferஇடையகம்பஃபர்英文音译
sample rateமாதிரி வீதம்சாம்பிள் ரேட்英文音译
driverஇயக்கிடிரைவர்英文音译
latencyதாமதம்லேட்டன்சி英文音译

硬件与系统术语 (Hardware & System Terms, 常被忽略)

这些术语是音译错误最常发生的地方,因为它们感觉“很技术”。但它们每一个都有纯泰米尔语的等价词。请使用它。

英语 (English)泰米尔语 (CORRECT)错误 (音译)备注 (Notes)
microphoneநுண்ணொலிவாங்கிமைக்ரோஃபோன்#1 最常错的术语。நுண்ணொலிவாங்கி = “细-音-接收器”。
speaker / loudspeakerஒலிபெருக்கிஸ்பீக்கர்ஒலிபெருக்கி = “声音放大器”
headphoneதலையணி ஒலிக்கருவிஹெட்ஃபோன்
keyboardவிசைப்பலகைகீபோர்ட்
connectionஇணைப்புகனெக்ஷன்
networkபிணையம்நெட்வொர்க்
settingsஅமைப்புகள்செட்டிங்ஸ்
kernelகருநிரல்கர்னல்கர்னல் 看起来像泰米尔语但听起来像英语——仍然是音译
kernel extensionகருநிரல் நீட்சிகர்னல் எக்ஸ்டென்ஷன்
access (verb)அணுகுஆக்சஸ்
monitor (verb)கண்காணிமானிட்டர்
detectகண்டறிடிடெக்ட்
routingவழிப்படுத்தல்ரூட்டிங்
channelதடம்சேனல்சேனல் 是借词;使用 தடம்
sampleமாதிரிசாம்பிள்
deviceசாதனம்டிவைஸ்基础术语。 对于“device”始终使用 சாதனம் ——即使在音频上下文中也是如此。仅当英文原文明确地将“audio device”作为复合词时,才使用 ஒலிச்சாதனம்。对于像 "%d device(s)" 这样的复数化字符串,使用 சாதனம்/சாதனங்கள்,绝不能使用 ஒலிச்சாதனம்/ஒலிச்சாதனங்கள்。
audio deviceஒலிச்சாதனம்ஆடியோ டிவைஸ்复合形式——仅当英文原文明确包含完整复合词 "audio device" 时使用。
interfaceஇடைமுகம்இன்டர்ஃபேஸ்
restartமறுதொடக்கம் செய்ரீஸ்டார்ட்
installநிறுவுஇன்ஸ்டால்
third-partyமூன்றாம் தரப்புதேர்ட் பார்ட்டி
permissionஅனுமதிபெர்மிஷன்
System Integrity Protectionகணினி ஒருமைப்பாடு பாதுகாப்புசிஸ்டம் இன்டெக்ரிட்டி புரொடெக்ஷன்翻译概念,而非品牌名

零拉丁字符规则 (Zero Latin Characters Rule)

泰米尔语字符串绝不能包含任何拉丁字符(A-Z, a-z),格式说明符(%@, %d, %lld)除外。数字(0-9)是允许的。这包括:

  • 单位符号:写 ஹெர்ட்ஸ் 而不是 Hz,写 டெசிபெல் 而不是 dB,写 மி.வி 而不是 ms
  • 作为句子一部分的品牌名称:将它们包裹在 %@ 中并从代码传递
  • 任何“用泰米尔语大声读出时听起来像英语”的单词——那是音译,请替换它

一个来源不明的拉丁字符 “Hz” 会破坏 macOS 上泰米尔语用户的视觉一致性。请将泰米尔语字符串中的拉丁字符视为硬性失败,就像对待缺失的格式说明符一样。

泰米尔语复数化 (Tamil Pluralization)

泰米尔语使用后缀 -கள் 来标记复数。理性/非理性名词的区别会影响动词的一致性:

数量 (Count)理性 (Rational, 人)非理性 (Irrational, 设备)
单数 (Singular)1 பயனர் இணைந்தார்1 சாதனம் இணைக்கப்பட்டது
复数 (Plural)5 பயனர்கள் இணைந்தனர்5 சாதனங்கள் இணைக்கப்பட்டன

文字规则 (Script Rules)

仅限 Unicode 泰米尔语区块 (U+0B80–U+0BFF)。不使用格兰塔字母 (Grantha)。不混合天城文 (Devanagari)。不使用西里尔字母 (Cyrillic)。 在词素边界正确应用 puṇarci (புணர்ச்சி) 连音变化规则。 在古典泰米尔语支持的情况下,优先使用复合词而非多词短语(例如,用 செயலி 表示“app”,而非 செயல் நிரல் பயன்பாடு)。


德语规则 (German Rules)

复合名词 (Compound Nouns)

德语复合名词必须连写为一个单词。绝不能用空格分隔。

正确 (Correct)错误 (Incorrect)
AudiogerätekonfigurationAudio Geräte Konfiguration
EingangslautstärkeEingangs Lautstärke
AbtastrateAbtast Rate
KopfhöreranschlussKopfhörer Anschluss

de_CH: 无 ß,瑞士格式 (de_CH: No ß, Swiss Formatting)

在 de_CH 字符串中,所有 ß 必须替换为 ss。无例外。 瑞士数字格式使用撇号作为千位分隔符:1'000.00(而不是 1.000,00)。

德语复数化 (German Pluralization)

德语名词有多个复数构成模式(元音变音 Umlaut、-e、-er、-en、-s)。每个名词的复数形式必须查找确认——绝不能通过规则猜测。例如:Audiogerät → Audiogeräte, Kanal → Kanäle, Sample → Samples。

德语性别 (German Gender)

阳性/阴性/中性。冠词 (der/die/das) 和形容词词尾必须一致。 “Die Datei wurde gespeichert”(阴性)。当一个字符串引用一个变量名词 (%@) 时,要组织结构以避免在可能的情况下需要根据性别改变一致关系。


西班牙语规则 (Spanish Rules)

es_ES 正式语态 (es_ES Formal Register, 至关重要)

西班牙西班牙语 (es_ES) 在系统 UI 中必须使用 usted 语态——正式的第二人称单数。这适用于所有提示、权限对话框、系统消息和设置描述。非正式的 tú 语态在 macOS 系统 UI 中感觉格格不入,并且对西班牙语用户来说读起来不专业。

这是最常失败的检查之一。问题在于,在编写西班牙语时,tú 形式感觉更自然,因此翻译人员会默认使用它们。您必须主动选择 usted 形式。

具体的变位规则——每次应用这些:

模式 (Pattern)错误 (tú — 非正式)正确 (usted — 正式)
物主代词 "your"tu micrófonosu micrófono
物主代词 "your" (复数)tus ajustessus ajustes
祈使 "make sure"Asegúrate de que…Asegúrese de que…
祈使 "check"Comprueba que…Compruebe que…
祈使 "try again"Inténtalo de nuevoInténtelo de nuevo
祈使 "restart"Reinicia tu MacReinicie su Mac
祈使 "increase"Aumenta el tamañoAumente el tamaño
祈使 "verify"Verifica tus conexionesVerifique sus conexiones
祈使 "allow"Permite el accesoPermita el acceso
现在时 "you need"Necesitas accesoNecesita acceso
现在时 "you can"Puedes cambiar…Puede cambiar…

自我检查: 编写任何 es_ES 字符串后,扫描这些危险信号:

  • 任何出现的 tu 或 tus (后面有空格)——替换为 su / sus
  • 祈使句中任何以 -as、-es 结尾的动词(第二人称 tú)——重写为以 -e 结尾 (usted)
  • -ate、-ete 反身结尾 —— 重写为 -ese (Asegúrate → Asegúrese)

es_419 区域规则 (es_419 Regional Rules)

不使用阿根廷的 voseo、墨西哥的俚语表达式和加勒比地区的缩略形式。与 Apple 现有的 es_419 本地化保持一致。在系统 UI 中默认使用 usted。 “Ordenador” 是 es_ES 的用法;“computadora” 是 es_419 的用法。

西班牙语性别 (Spanish Gender)

阳性/阴性的一致性是必需的,适用于冠词、形容词、分词。 使用 "La configuración fue guardada" 而不是 "El configuración fue guardado."


语气、语域和格式 (Tone, Register, and Formatting)

表层语域 (Surface-Level Register)

表面层 (Surface)语域 (Register)示例 (en_US)
菜单项 (Menu item)中性,简洁 (Neutral, concise)"Export Audio…"
提示标题 (Alert title)直接,清晰 (Direct, clear)"Connection Lost"
提示正文 (Alert body)信息性,平静 (Informative, calm)"Check your network settings and try again."
工具提示 (Tooltip)简短,有帮助 (Brief, helpful)"Adjusts input gain"
错误日志 (面向开发)不本地化 (Not localized)—
引导页 (Onboarding)温暖,指导性 (Warm, instructive)"Let's set up your audio interface."

正式称呼默认值(系统 UI 中不可协商)

  • 德语 → Sie (永远不用 du)。 „Überprüfen Sie Ihre Einstellungen"
  • 西班牙语 (es_ES) → usted (永远不用 tú)。 „Verifique sus conexiones"
  • 西班牙语 (es_419) → usted in system UI。 „Verifique sus conexiones"
  • 泰米尔语 → நீங்கள் (永远不用 நீ)。 „உங்கள் அமைப்புகளைச் சரிபார்க்கவும்"

大写规则 (Capitalization)

区域 (Locale)菜单项 (Menu Items)提示标题 (Alert Titles)按钮标签 (Button Labels)
en_USTitle CaseTitle CaseTitle Case
en_GB, en_AUTitle CaseSentence caseTitle Case
es_*Sentence caseSentence caseSentence case
de_*名词首字母大写 (标准德语规则)名词首字母大写名词首字母大写
ta_*不适用 (无大小写)不适用不适用

标点符号 (Punctuation)

  • 省略号:始终使用 … (U+2026),绝不使用三个英文句点 ...
  • 引号:德语 „…" (U+201E, U+201C),es_ES «…»,es_419 "…",泰米尔语 "…"
  • 标签中的冒号:en_US 使用 "Volume:" —— 泰米尔语中,如果冒号单独出现则去掉 (ஒலியளவு),如果后面跟值则保留 (ஒலியளவு: 50%)

格式说明符保留 (Format Specifier Preservation)

切勿翻译、删除或复制格式说明符(%@, %d, %lld, %1$@)。当参数顺序在区域之间发生变化时,使用位置说明符(%1$@, %2$d)。

// en_US
"audio_device_error" = "Device \"%@\" failed with error code %d.";
// 泰米尔语——为主-宾-谓语序重新排列,说明符保留
"audio_device_error" = "\"%@\" சாதனம் பிழைக்குறியீடு %d உடன் தோல்வியடைந்தது.";
// 德语——为德语语法重新定位说明符
"audio_device_error" = "Gerät „\"%@\"" ist mit Fehlercode %d fehlgeschlagen.";

Stringsdict 复数化

始终对复数化字符串使用 .stringsdict。绝不使用内联条件或字符串拼接。

区域 (Locale)必需的 CLDR 复数形式 (Required CLDR Plural Forms)
en_*one, other
ta_*one, other
es_*one, many, other
de_*one, other

不可翻译列表 (Do-Not-Translate List)

在任何区域都绝不翻译:Apple 框架名称(CoreAudio, AVFoundation, IOKit, DriverKit),API 标识符(AVAudioEngine, kAudioUnitProperty_SampleRate),文件扩展名(.aiff, .wav, .caf),品牌名称(AirPlay, HomePod, Logic Pro, Mac)。

单位符号:针对泰米尔语的语言特定例外

单位符号(Hz, kHz, dB, dBFS, ms)在拉丁字母语言(英语、西班牙语、德语)中保持原样。

对于泰米尔语,拉丁字符中的单位符号违反了零拉丁字符规则。 使用泰米尔语等价物:

  • Hz → ஹெர்ட்ஸ், kHz → கிலோஹெர்ட்ஸ், dB → டெசிபெல், ms → மி.வி
  • 或者将值包裹在一个格式说明符中,以便 UI 层处理渲染

决策框架:翻译 vs. 保留 (Decision Framework: Translate vs. Retain)

该术语是专有名词或品牌名称吗?
  → 是 → 不翻译。(CoreAudio, AirPlay, USB)
  → 否 ↓
该术语是普遍认可的缩写或单位吗?
  → 是 → 在拉丁字母语言中保留原样。泰米尔语:使用泰米尔语等价物。
  → 否 ↓
该术语在词汇表中吗?
  → 是 → 使用词汇表的翻译。
  → 否 ↓
在目标区域中是否有已建立的 Apple 先例?
  → 是 → 匹配 Apple 的翻译。
  → 否 ↓
该术语是否存在于语言标准机构的词典中?(RAE, Duden, 泰米尔虚拟大学)
  → 是 → 使用标准形式。
  → 否 ↓
创建一个新术语:
  - 泰米尔语:从纯泰米尔语语素构造。不进行音译。
  - 西班牙语/德语:优选意译(calque)而非借词。如果借词是行业标准,则使用它。

完整术语表 (Full Terminology Glossary)

音频工程 (Audio Engineering)

英语 (English)泰米尔语 (ta_IN)西班牙语 (es_ES / es_419)德语 (de_DE)
Sample rateமாதிரி வீதம்Frecuencia de

...

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能