Localization Tw — Development skill for Claude Code

localization-tw — 正體中文（臺灣）在地化技能

正體中文（Traditional Chinese），又稱繁體中文，為臺灣官方使用的標準漢字書寫形式。本技能以「正體中文」為正式名稱，並以臺灣華語慣用方式為規範。

Claude Code 的在地化翻譯技能，確保 AI 產出的中文內容符合臺灣華語母語者的用詞習慣，避免中國用語與簡體直譯。

功能

• EN↔zh-TW 雙向翻譯，也支援 EN↔JA↔zh-TW 三語翻譯
• 用詞規範：內建臺灣 vs. 中國用語對照表（40+ 高頻詞彙速查）
• 領域污染檢查：按電腦資訊、日常生活、娛樂、政經、交通等領域，主動檢查中國用語殘留
• 來源順序：中華語文知識庫 優先；教育部辭典以《簡編本》優先、《重編本》補充，Microsoft 術語等補充專業語境
• 完整建檔與搜尋：取得兩岸差異用詞、《簡編本》文字資料、g0v 固定版本《重編本》及臺灣適用 Microsoft 術語，核對筆數後建立本地索引
• 人工覆核：產生可篩選的離線覆核頁面、CSV 與完整證據；保留不同義項，衝突由人工決定
• 完整翻譯工作流程：理解→翻譯→校對→潤飾四步驟，附品質檢查清單
• 語言參考文件：正體中文、英文、日文各自的語言特性與翻譯策略

安裝

將此資料夾放入 Claude Code 的 skills 目錄即可：

# 方法一：直接 clone
git clone https://github.com/Qmo37/localization-tw.git ~/.claude/skills/localization-tw

# 方法二：手動下載後放入
cp -r localization-tw ~/.claude/skills/

使用方式

安裝後，Claude Code 在處理中文相關任務時會自動套用此技能。你可以：

• 翻譯英文文件為臺灣中文
• 產生符合臺灣用語的 UI 文字、註解、文件
• 檢查既有中文內容是否有中國用語殘留

範例

❌ 請您通過以下鏈接獲取軟件的默認配置信息
✅ 請透過以下連結取得軟體的預設設定資訊

❌ 服務器返回的數據需要進行一個解析的操作
✅ 伺服器回傳的資料需要解析

查詞與完整建檔

一般查詞不需安裝額外套件；完整建檔需要 Python 3.10 以上與 openpyxl：

python3 -m pip install -r requirements-import.txt
python3 scripts/build-vocabulary.py --online
python3 scripts/search.py process --mode exact --domain 電腦資訊 --json
python3 scripts/search.py 行程 --mode exact --source moe-concised
python3 scripts/search.py 行程 --mode exact --source moe-revised

開啟 `reports/review.html` 即可人工覆核。`--online` 對四個預定技術詞做有上限的 Termic 補查；省略時只匯入主要來源。全量紀錄、實際筆數與查詢狀態見 `reports/full-run-summary.json`，不把有上限的查詢結果宣稱為完整翻譯記憶庫。

覆核者填寫語境與理由後，按「匯出已完成決定」取得 JSON，再匯入決定並離線重建。未填完也可用「備份全部草稿」保留所有分頁的選擇；下載失敗時可直接複製頁面上的 JSON：

python3 scripts/review-conflicts.py /path/to/review-decisions.json
python3 scripts/build-vocabulary.py --offline
python3 -m unittest discover -s tests -v

未覆核衝突不會成為確定的推薦用語。後續更新使用 `--refresh`；原始資料與索引預設位於 `~/.cache/localization-tw`，可用 `LOCALIZATION_TW_CACHE` 或 `--cache` 指定位置。生成的 `reports/` 保留在本機，人工決定另存 `data/review-decisions.