逐語言翻譯審查
translation-check 確保每個按鍵都存在且佔位符正確。此技能則負責閱讀文字內容。
1. 範圍與背景
- 哪些文字:變更新增或編輯的按鍵(對比在地化檔案與基底分支的差異),或是指定的命名空間/檔案。取得參考值與每個語言的翻譯值並列對照。
- 出現位置:在程式碼中搜尋每個按鍵的使用方式(
git grep "<key>")。是按鈕、標題、電子郵件、錯誤訊息還是工具提示?空間限制如何?是否與其他按鍵組成句子,或包含{{count}}、姓名、日期? - 專案規則:
AGENTS.md與.claude/translations.json,包括禁用詞、保留不翻譯的產品與方案名稱、正式程度,以及讀者身份(客戶、經銷商、管理員)。 - 現有詞彙表:同一術語在其他語言檔案中如何翻譯。在該語言在地化資料夾內執行
git grep搜尋術語。一致性優於個人偏好。
2. 逐語言審查
針對每一種語言,檢查每個文字是否符合以下項目:
- 語意:與參考原文表達相同。不增刪任何涵義,避免「假朋友」錯誤。佔位符用於正確的文法角色。
- 自然:讀起來像是該語言原生的產品文案,而非逐字翻譯的英文。注意語序、冠詞與大小寫(德語名詞大寫;其他語言不使用英文 Title Case)。
- 術語:同一事物在所有地方使用相同名稱(報表、訂單、信用、VIN、方案名稱),並與步驟 1 的詞彙表一致。
- 正式程度:整個產品使用一致的稱謂,例如德語的 Sie 或 du、烏克蘭語的 ви、法語的 vous、捷克語的 Vy、波蘭語的 Pan/Pani 或中性形式。不要混用。
- 含變數的文法:複數形式要對應實際數量(烏克蘭語、波蘭語、捷克語中的 1、2、5、21、22、25);介係詞後的正確格位;佔位符為名詞時的性別一致。
- 長度:按鈕、分頁標籤與徽章應大致與參考原文等長。若在空間有限處長度超過 40% 則需標記。
- 當地慣例:單位(烏克蘭語/保加利亞語的 км, кВт, к.с.)、小數點逗號、日期順序、貨幣位置、引號樣式(德語 „…“、法語 « … »、烏克蘭語 «…»)。
- 專案規則:禁用詞、品牌拼寫、方案名稱。
3. 報告
依語言分組,每個問題提供按鍵名稱、目前文字、問題描述及建議修正:
uk — 2 項問題
- reportPage:upgrade.cta — "Оновити до Complete звіту" — 語序如同英文;Complete 是方案名稱 → "Перейти на звіт Complete"
- ...
de — 無問題
- 說明你對哪些語言的判斷有信心。對於無法判斷的語言,請直接說明而非猜測,並建議由母語人士檢查。
- 若要求修正:將建議套用至在地化檔案,執行
i18n:translation-check,然後連同變更一併提交。 - 在 PR 審查中,將這些意見標記為 Nits,除非語意錯誤或出現禁用詞 — 此類情況則標記為 Important。