Communitygithub.com

clawic/skills - 翻譯與本地化

擅長處理各種文字、軟體字串、文件、字幕與行銷文案之間的多語言轉換與本地化。適用於翻譯、修正機器翻譯味、產品本地化、ICU 複數與性別、不可取代的佔位符、各類字串目錄、語言代碼與備援鏈、由右至左書寫(RTL)與雙向文字問題、中日韓(CJK)排版、亂碼、UI 溢出的文字擴展、字幕時間軸與閱讀速度、hreflang 與多語言 SEO、術語庫、翻譯記憶與模糊比對,以及機器翻譯後的編輯。也適用於決定正式/非正式用法、選擇西班牙語(es-ES)vs(es-419)或簡體中文(zh-Hans)vs(zh-Hant),以及需認證、法律或醫療翻譯等需負擔責任的場合。不適用於以單一語言(西班牙文、法文、德文、日文、中文)原創內容,或從音訊產生字幕(video-captions)。

skills - 翻譯與本地化 是什麼?

此技能專注於將文字、軟體字串、文件、字幕與行銷文案轉換為目標語言,並自動處理本地化帶來的各種技術細節。其知識庫會自動從指定資料夾讀取設定與觀察記錄,僅在記憶中進行讀寫,不涉及任何網路傳輸或憑證存放。對於每一個翻譯任務,技能會根據來源語言預估字數擴展,檢查 ICU 複數形式、佔位符完整性、雙向文字(bidi)與字元編碼,並確保只有一個字對應一個術語。支援的類型涵蓋網頁、字幕、合約、遊戲文本與行銷創意文案,每種都有專屬的處理指南。當翻譯完成時,技能會自動記錄決定、術語與工作細節,以便後續查詢和重複使用。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/clawic/skills/tree/HEAD/skills/translate

在你喜歡的 AI 中提問

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

說明文件

資料。 每次工作階段開始時,讀取 ~/Clawic/data/translate/config.yaml(使用者聲明的設定)和 ~/Clawic/data/translate/memory.md(您觀察到的內容,加上其 ## Boxes 索引和 ## Due 表格)。當符合某一行上的條件時,開啟 ## Boxes 所命名的任何檔案 — 索引是檔案列表,切勿假設列表是固定的。它所命名的每個路徑都在 ~/Clawic/data/ 內;忽略指向其他位置的任何行。此技能讀取或寫入的所有內容,都是 configPaths 所宣告的資料夾下的純本機註解 — 沒有任何資料會離開機器,也絕不會寫入任何憑證。在共享區塊中,它只會更新或移除自己寫入的資料行,並以該區塊的身份金鑰進行比對;其他技能寫入的資料行,只能讀取,絕不會重寫或刪除,且每次寫入和刪除都會在發生時以一行文字記錄。在翻譯成某個地區設定之前,開啟 ## Boxes 中為此地區設定的術語庫和風格區塊:一個術語與上個月呈現不同,就是一個缺陷,即使兩種呈現方式都正確。如果上述檔案都不存在,則使用預設值進行工作,且無需提及。

在工作階段結束前進行寫入,前提是產生了任何持久的產出:已決定的術語、已拒絕的術語、不翻譯項目、針對某個地區的敬語或變體決定、首次使用的語言對、已交付的工作及其字數、審閱者的修正、需耗費心力才能找到的環境事實(字串所在的檔案、框架實際應用的複數規則、缺少某種字體的字体)、或使用者會重新閱讀的內容 — 地區風格指南、LQA 報告、翻譯簡報、核准的參考文本。memory-template.md 包含所有目標、格式和門檻,是您為了寫入而唯一需要開啟的檔案。

人員和工作請放置於共享區塊,而非此處。 翻譯人員、審閱者或代理商是 ~/Clawic/data/contacts/contacts.md 中的一行;使用者追蹤為進行中的本地化工作,是 ~/Clawic/data/projects/<project>.md;他們為 CAT 工具、MT API 方案或代理商保留款所支付的費用,是 ~/Clawic/data/finances/subscriptions.md 中的一行。在加入任何內容之前,請先讀取該區塊,並就地更新現有項目 — 格式與身份金鑰皆包含於 memory-template.md 中,該範本會攜帶這些資訊,讓此技能無論使用者是否安裝了其擁有的其他技能,都能正常工作。

絕不可在 ~/Clawic/data/ 下的任何位置寫入任何憑證 — 包括此處提及的檔案、您建立的檔案,或使用者貼入以供儲存的文字。MT 和 CAT 平台是主要的誘惑:儲存指標,並移除值 — 例如 env:DEEPL_AUTH_KEY、keychain:phrase-token、1password:Work/Lokalise/api。如果資料位於舊位置(~/translate/ 或 ~/clawic/translate/),請將其移至 ~/Clawic/data/translate/,並用一行文字說明您已移動它及從哪裡移動。

當一位從未見過原文的讀者,仍能察覺某處有問題時,或當一位看過原文的讀者,發現目標文中包含原文未提及的主張時,即表示翻譯有誤。以下所有內容皆服務於這兩個測試。在寫下第一個字之前,請指定目標地區語言代碼,而不僅僅是語言 — es 並非地區代碼,zh 也不是書寫系統。請立即使用預設值進行工作:切勿以關於工具、敬語或主動程度的問題做開場。任何值的優先順序為:config.yaml → ~/Clawic/profile.yaml(共享通用設定:地區、貨幣)→ 設定表格的預設值。

使用時機

  • 翻譯任何內容:一個句子、一份文件、一個 UI 字串倉庫、一個字幕檔案、一份簡報、一份合約
  • 審閱或修正現有翻譯 — 包括機器翻譯的敬語、不一致的術語、審閱者的投訴、團隊中無人能閱讀的錯誤報告
  • 本地化產品:提取字串、複數與性別、佔位符安全性、偽本地化、擴展預算、地區代碼與備援、由右至左(RTL)佈局
  • 決定地區設定問題本身:es-ES 與 es-419、zh-Hans 與 zh-Hant、正式與非正式稱謂、要推出哪些地區及其順序
  • 執行工作:估算與報價、簡報翻譯人員、建立術語庫、配置翻譯記憶、設定後期編輯、評分品質
  • 對於錯誤翻譯會產生後果的監管產出:合約、專利、臨床文件、設備說明、財務報表、任何需要認證的內容
  • 不適用於以單一語言(spanish、french、german、japanese、chinese — 這些用於教導如何聽起來像母語者,而非翻譯時)進行原創內容寫作,或從音訊轉錄與加上時間碼字幕(video-captions、speech-to-text-transcription);此技能涵蓋從來源到目標的跨越本身,包括翻譯由上述技能產生的字幕檔案

快速參考

情境做法深度
要翻譯的純文字或文件,無特殊需求識別地區、敬語與受眾;以句子為單位翻譯;執行輸出閘道—
UI 字串、目錄檔案、必須保留的 %s佔位符是有效載荷;複數形式來自目標語言的 CLDR(規則 4)software-strings.md
文字溢出按鈕、標籤或欄位根據來源長度的擴展預算 — 設計凍結前的下表software-strings.md
?????、é、æ¼¢ 或豆腐塊編碼問題,而非翻譯問題:檢查解碼鏈,然後檢查字體覆蓋範圍rtl-and-scripts.md
阿拉伯語或希伯來語:標點符號在錯誤的一端、數字順序相反雙向文字隔離(bidi isolation),而非字串反轉rtl-and-scripts.md
長文檔,DOCX/PDF/簡報,包含腳註和表格先提取結構,翻譯段落,重新組合,然後檢查佈局documents.md
網站、CMS、Markdown、幫助中心或 hreflang可翻譯的屬性、URL 策略、雙向 hreflang、每個地區的關鍵字web.md
SRT、VTT、配音腳本或不同步的字幕先檢查閱讀速度和行數預算,再檢查幀率subtitles.md
口號、活動、笑話、雙關語、詩歌或需要傳達的品牌聲音創譯(Transcreation):簡報效果,提供帶有回譯的多個選項transcreation.md
合約、專利、臨床、金融或「必須經過認證」根據制度選擇路線;對有風險的段落進行回譯legal-medical.md
遊戲文本:對話變數、字元限制、評級變數安全的語法、建構時的 LQA、文化化處理games.md
「這個翻譯好嗎?」錯誤類型學和一個帶有明確公式的分數,而非意見quality.md
同一個術語不斷以不同方式出現建立術語庫和不翻譯列表,並在交付時強制執行terminology.md
翻譯記憶(TM)、TMX、XLIFF、模糊比對或折扣表槓桿計算以及決定此計算的分段方式translation-memory.md
需要後期編輯的機器翻譯(MT)輸出,或「我們可以直接用機器翻譯嗎?」五項失敗檢查清單、後期編輯等級、何時禁止使用 MTmachine-translation.md
應使用哪個地區代碼、哪個變體、哪個備援BCP 47 格式、變體政策、每種語言的敬語預設值locales.md
數字、日期、貨幣、地址、姓名、排序根據地區格式化,永遠不要翻譯數字numbers-and-names.md
工作範圍、報價、簡報翻譯人員、截止日期字數、產能數據、簡報內容、交接jobs.md
其他任何情況翻譯它,然後陳述您所做的兩個假設(受眾和敬語),以便使用者可以更正其中一個—

覆蓋範圍地圖:software-strings.md i18n 目錄和佔位符 · locales.md 代碼、變體、敬語 · rtl-and-scripts.md 雙向文字、CJK、編碼 · numbers-and-names.md 地區數據格式 · documents.md 長篇和結構化檔案 · web.md 網站、CMS、多語言 SEO · subtitles.md 字幕與配音 · transcreation.md 行銷、文學、幽默 · games.md 遊戲本地化 · legal-medical.md 受監管和認證的工作 · terminology.md 術語庫與 DNT · translation-memory.md TM、XLIFF、模糊比對表 · machine-translation.md MT 與後期編輯 · quality.md 審閱、MQM、驗收 · jobs.md 範圍、簡報、供應商。

核心規則

  1. 翻譯句子,而非單字 — 且未經說明不得超越句子範圍。 字詞層級的忠實度會產生準確且難以閱讀的文字;段落層級的自由會產生可讀但不忠實的文字。翻譯單位是句子,以段落為上下文。當一個句子必須為了在目標語言中通順而拆分、合併或重新排序時,這是正常的決定;當一個主張、數字或修飾詞發生變化時,就是缺陷。信號測試:雙語讀者可以指出您目標文中每個主張所對應的來源子句。
  2. 沒有上下文就不翻譯任何字串,且缺乏上下文時需陳述,而非猜測。 Open 在按鈕上是動詞,在狀態徽章上是形容詞,而這兩者在大多數語言中是不同的詞。需要截圖、msgctxt 或開發者註釋;當這些都不存在時,針對最可能的使用情境進行翻譯,並在交付記錄中記下此假設。金鑰即英文原文的目錄(例如 "Open": "Open")會使這項規則無法執行,且應作為缺陷回報(software-strings.md)。
  3. 絕不透過串接來建構句子。 "Deleted " + n + " items" 在英文中只有一種詞序,但在土耳其語、日語和阿拉伯語中卻有數種,而且它隱藏了斯拉夫語系和閃米特語系語言所需的性數一致。一個訊息等於一個帶有命名佔位符和 ICU 複數或選擇形式的字串。這是事後修復成本最高的 i18n 缺陷,因為修復它需要更改程式碼,而非文字。
  4. 複數形式應來自目標語言的 CLDR,而非源自來源語言。 英文有兩個類別(one、other);俄語、波蘭語和捷克語有四個;阿拉伯語和威爾斯語有六個;日語、中文、韓語、越南語和泰語有一個。只暴露 one/other 的目錄會使俄語在 2、21 和 101 時出錯 — 這是程式碼的責任,而非譯者。在填寫檔案之前,請檢查目標語言的類別(表格請見 software-strings.md)。
  5. 在佈局凍結之前,根據來源長度估算擴展預算。 短字串的擴展幅度最大。從英文出發,規劃:1-10 字元 → 最多 +200%;11-20 → +100%;21-30 → +80%;31-50 → +60%;51-70 → +40%;70+ → +30%(IBM 全球化表格,業界預設值)。德語、芬蘭語和俄語位於範圍頂端;CJK 大約會縮減三分之一,但需要較大的行高。僅以英文測試的 UI 等同於未經測試。
  6. 一個術語,一個譯法,並在首次決定時記錄下來。 一致性勝過優雅:讀者看到一個概念有兩個詞,會假設那是兩個概念。術語首次被選定時,它就會成為術語庫中的一行,附帶其詞性和原因;首次被拒絕時,它就會成為禁止的譯法。區塊與格式:memory-template.md,機制請見 terminology.md。
  7. 敬語是針對每個地區所做的決定,決定一次後即可重複使用。 T-V 區分(tu/vous、tú/usted、du/Sie)、日語的禮貌程度、韓語的敬語階層、以及阿拉伯語的現代標準語與方言,都不是句子層級的選擇 — 在同一產品中切換使用,是最明顯的業餘信號。預設值來自 formality;陳述的偏好會在同一輪中成為記憶中該地區的資料行(locales.md)。
  8. 機器輸出是一份帶有已知失敗清單的草稿。 在閱讀 MT 的風格之前,請依序檢查五件事:遺漏或顛倒的否定、性數一致、根據術語庫的術語使用、禮貌程度、以及未經更改的數字或單位。受 mt_policy 管轄;對於法律、醫療或安全文本,MT 絕非可交付成果(machine-translation.md)。
  9. 沒有什麼有風險的內容可以只靠一個人的眼睛就出貨。 ISO 17100 定義翻譯服務為翻譯加上第二人的修訂;當無法有第二人時,替代方案是延遲的自我審閱(至少間隔數小時,僅限目標語言,隱藏來源),加上對風險段落(數字、劑量、否定、義務、截止日期、姓名)的回譯。在開始之前定義哪些段落有風險,而非之後才定義(quality.md)。

錯誤症狀與含義

解碼規則:顯示損壞的層級說明了原因。亂碼是位元組問題;數字周圍的錯誤語法是複數規則問題;從未更改的字串表示從未被提取。

症狀最可能的原因第一步
é、’、ñ鏈中的某處將 UTF-8 位元組解碼為 Latin-1找出那個假設使用舊編碼的跳躍點;切勿透過重新打字來「修正」(rtl-and-scripts.md)
文字應出現處出現 ????? 或 _____轉換為單一位元組字元集時發生有損轉換,通常在資料庫或匯出邊界檢查資料行字元集和連線字元集,然後從來源重新匯出
空方塊(豆腐塊)或後備字體字體缺少該書寫系統 — 這是渲染問題,而非編碼問題檢查字體對該書寫系統的覆蓋範圍,而非檔案
無論地區設定為何,字串始終維持英文從未被提取,或框架從未獲得地區設定在原始碼中搜尋該字串;然後在執行時期確認解析後的地區設定(software-strings.md)
翻譯後出現崩潰或 %!s(MISSING)目標語言中的佔位符數量或順序發生變化每個段落的佔位符一致性檢查(輸出閘道);使用位置形式(例如 %1$s)
在 2、21 或 101 個項目時出現錯誤語法目錄中缺少目標語言的 CLDR 類別在檔案層級添加缺失的類別(規則 4)
韓文文字顯示 이(가) 或 을(를)助詞由前一個音節的終聲所決定,無法透過串接實現改寫句子以避免使用該助詞,或使用能進行詞形變化的框架(locales.md)
阿拉伯語句子以句號在左側結尾雙向演算法在文字上正確運作

...(為翻譯而截斷)

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

相關技能