Communitygithub.com

翻譯審查(逐語言)

如同母語編輯,逐語言審查翻譯品質:比對語意是否與原文一致、用語是否自然、術語是否統一、正式程度是否恰當、計數與性別文法是否正確、UI 長度是否合適、當地數字/日期/單位慣例是否符合,以及專案用詞規則。適用於翻譯檢查通過後的新增或修改文字、審查新增文字的 PR,或當要求檢查所有語言翻譯時使用。

翻譯審查(逐語言) 是什麼?

這項技能(translation-review)專為開發者與 AI 代理設計,用於在翻譯檢查(translation-check)確認所有按鍵存在且佔位符正確之後,逐語言深入評估翻譯品質。它涵蓋八大面向:語意忠實度(無添加、遺漏或假朋友)、自然語感(避免逐字翻譯)、術語一致性(同一事物在同一產品中統一命名)、正式程度(如德語 Sie/du、法語 vous 等)、含變數的文法(複數、格位、性別一致)、UI 長度(按鈕/標籤不超長)、當地慣例(單位、日期格式、貨幣位置、引號樣式),以及專案規則(禁用詞、品牌拼寫、方案名稱)。支援在 PR 審查或批次翻譯更新後使用,可按語言分組報告問題,並建議修正文字。開發者可要求 AI 直接修正檔案,或將意見標記為 Nits 或 Important 級別。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/lec-lerka/claude-skills/tree/main/plugins/i18n/skills/translation-review

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

逐語言翻譯審查

translation-check 確保每個按鍵都存在且佔位符正確。此技能則負責閱讀文字內容。

1. 範圍與背景

  • 哪些文字:變更新增或編輯的按鍵(對比在地化檔案與基底分支的差異),或是指定的命名空間/檔案。取得參考值與每個語言的翻譯值並列對照。
  • 出現位置:在程式碼中搜尋每個按鍵的使用方式(git grep "<key>")。是按鈕、標題、電子郵件、錯誤訊息還是工具提示?空間限制如何?是否與其他按鍵組成句子,或包含 {{count}}、姓名、日期?
  • 專案規則:AGENTS.md 與 .claude/translations.json,包括禁用詞、保留不翻譯的產品與方案名稱、正式程度,以及讀者身份(客戶、經銷商、管理員)。
  • 現有詞彙表:同一術語在其他語言檔案中如何翻譯。在該語言在地化資料夾內執行 git grep 搜尋術語。一致性優於個人偏好。

2. 逐語言審查

針對每一種語言,檢查每個文字是否符合以下項目:

  1. 語意:與參考原文表達相同。不增刪任何涵義,避免「假朋友」錯誤。佔位符用於正確的文法角色。
  2. 自然:讀起來像是該語言原生的產品文案,而非逐字翻譯的英文。注意語序、冠詞與大小寫(德語名詞大寫;其他語言不使用英文 Title Case)。
  3. 術語:同一事物在所有地方使用相同名稱(報表、訂單、信用、VIN、方案名稱),並與步驟 1 的詞彙表一致。
  4. 正式程度:整個產品使用一致的稱謂,例如德語的 Sie 或 du、烏克蘭語的 ви、法語的 vous、捷克語的 Vy、波蘭語的 Pan/Pani 或中性形式。不要混用。
  5. 含變數的文法:複數形式要對應實際數量(烏克蘭語、波蘭語、捷克語中的 1、2、5、21、22、25);介係詞後的正確格位;佔位符為名詞時的性別一致。
  6. 長度:按鈕、分頁標籤與徽章應大致與參考原文等長。若在空間有限處長度超過 40% 則需標記。
  7. 當地慣例:單位(烏克蘭語/保加利亞語的 км, кВт, к.с.)、小數點逗號、日期順序、貨幣位置、引號樣式(德語 „…“、法語 « … »、烏克蘭語 «…»)。
  8. 專案規則:禁用詞、品牌拼寫、方案名稱。

3. 報告

依語言分組,每個問題提供按鍵名稱、目前文字、問題描述及建議修正:

uk — 2 項問題
- reportPage:upgrade.cta — "Оновити до Complete звіту" — 語序如同英文;Complete 是方案名稱 → "Перейти на звіт Complete"
- ...
de — 無問題
  • 說明你對哪些語言的判斷有信心。對於無法判斷的語言,請直接說明而非猜測,並建議由母語人士檢查。
  • 若要求修正:將建議套用至在地化檔案,執行 i18n:translation-check,然後連同變更一併提交。
  • 在 PR 審查中,將這些意見標記為 Nits,除非語意錯誤或出現禁用詞 — 此類情況則標記為 Important。

相關技能