Communitygithub.com

AcTePuKc/bg-game-translation-qa

Codex 技能,用於保加利亞語遊戲在地化品質保證,專注於精準翻譯與檔案格式保留。

bg-game-translation-qa 是什麼?

這是一個專為 Codex 設計的 AI 代理技能,用於執行保加利亞語遊戲在地化的品質保證工作。其核心理念是在改善文字的同時,嚴格保留原始的檔案格式。它要求 AI 代理首先識別檔案格式與可翻譯欄位,然後僅修改面向玩家的文字,並絕對保留所有結構、佔位符、格式化標籤、變數與跳脫序列。此技能特別強調對內部識別碼、技術術語與檔案結構的保護,避免誤譯。 此技能適用於任何需要與 Codex 互動的開發環境,特別是在處理遊戲在地化專案時。它透過多個參考指南文件(如 placeholders.md、bg-text.md、qa-checklist.md)來輔助決策,要求 AI 在翻譯術語時先判斷其技術角色,並偏好自然、文化適切的保加利亞語表達,同時避免不必要的俄語或烏克蘭語影響。技能還要求區分遊戲機制中重複出現的詞彙,避免因聽覺相似而混淆不同系統。 工作流程包含翻譯、編輯與 QA 檢查,並要求對不確定的字串進行獨立報告,而非默默猜測。最終輸出應以補丁式變更為主,並對變更進行簡短說明。此技能支援 CSV、TSV、JSON、XML、INI 與 PO 等多種遊戲常見的結構化檔案格式。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add AcTePuKc/bg-game-translation-qa

在你喜歡的 AI 中提問

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

說明文件

保加利亞語遊戲在地化品質保證

使用此技能進行保加利亞語遊戲在地化工作,在此工作中,保留檔案格式與改善文字同等重要。請進行最小且安全的變更,並偏好聚焦的修補程式,而非改寫整個檔案,除非使用者明確要求全面改寫。

核心工作流程

  1. 在編輯前,先識別檔案格式與可翻譯的欄位。
  2. 保留所有結構、排序、分隔符號、引號、跳脫、註解、鍵值、ID 與後設資料。
  3. 僅翻譯或編輯面向使用者的文字。
  4. 除非使用者明確要求變更,否則完全保留佔位符、格式化標籤、變數、跳脫序列與換行符號。
  5. 遵循使用者提供或專案中存在的任何專案詞彙表、術語庫、風格指南或現有翻譯記憶庫。
  6. 將不確定的字串獨立報告,而非默默猜測。
  7. 總結變更的內容、未變更的內容,以及任何風險或問題。

不可翻譯的內容

請勿翻譯或標準化內部識別碼、列舉名稱、檔案名稱、檔案路徑、類別名稱、函式名稱、物件名稱、資源名稱、事件名稱、主控台指令、設定鍵值、ID 或技術性後設資料,除非使用者明確將其標記為面向玩家的文字。

對於結構化檔案,請保持列數、鍵值順序、巢狀結構、分隔符號與編碼不變。對於 CSV/TSV 表格,請保留確切的欄位結構。對於 JSON/XML/INI/PO 風格的檔案,請保留語法與跳脫。

佔位符與標籤

請逐位元組保留佔位符與格式化標籤,包括大小寫、標點符號、巢狀結構、間距與順序。除非文字明確是面向玩家的顯示文字,否則請勿翻譯變數內的文字。

請務必保護以下模式:

  • {PLAYER}
  • {0}
  • %s
  • %d
  • <color=...>
  • </color>
  • <b>
  • </b>
  • \n
  • \t
  • [br]
  • [[...]]
  • $VARIABLE
  • ${variable}

當任務包含不熟悉的標記、RTF(Rich Text Format)文字、UI 標記、腳本語法或特定格式的佔位符時,請參閱 references/placeholders.md。

保加利亞語在地化風格

使用自然的保加利亞語措辭,而非照字面翻譯英文的詞序。保持 UI 文字簡潔易讀,特別是對於按鈕、選單、成就、工具提示與戰鬥訊息。

在可能的情況下,偏好文化上適切的保加利亞語翻譯而非音譯,但保持已建立的遊戲術語與專案詞彙表的選擇一致。保留對話中的角色語氣,並避免將非正式或幽默的對話過度正式化。

當說話者或玩家的性別未知時,請在保加利亞語允許中性結構的情況下,避免強制使用帶有性別色彩的措辭。除非專案風格要求,否則避免引入從英文標題、物品名稱或 UI 標籤中不必要地大寫而複製過來的寫法。

技術術語與外來語

不要僅僅因為某個技術術語在原文中可見就機械地翻譯它。首先要確定它是一個內部識別碼、一個既定的專業術語,還是面向玩家的散文。

  • 保持 API 名稱、指令、設定鍵值、類別名稱和其他識別碼不變。
  • 對於面向玩家的文字,偏好對功能進行自然的保加利亞語描述,而非照字面借用。
  • 如果原文沒有精確定義其技術角色,請不要自行發明一個。使用中性的功能描述或將該字串報告為不確定。
  • 當專案詞彙表定義了一個術語時,即使另一個保加利亞語選項也存在,也請遵循它。

範例:

原文面向玩家的文字技術說明不要假設
hookмеханизъм / точка за включванеобработчик / точка за разширяване它意指某個模組或「кука」
compatibility hookмеханизъм за съвместимостобработчик за съвместимост 或 точка за включване за съвместимостмодул、кука 或 прихващач 總是正確的
fixпоправка / корекцияпоправка за съвместимост俚語 фикс 適合此受眾
handler如有需要,描述其動作обработчик它應該被音譯為 хендлър

例如,將面向玩家的變更記錄 The journal level label was corrected through the compatibility hook. 翻譯為 Надписът за нивото в дневника е коригиран чрез механизма за съвместимост. 請勿預設使用 кука за съвместимост。

重複的遊戲術語

當一個遊戲機制或 UI 概念重複出現時,請在第一次清晰出現時決定其保加利亞語名稱,並將其記錄在專案詞彙表中。請勿僅僅因為它們在英文中聽起來相似,就將相關術語合併為一個保加利亞語詞彙。

需區分的原文可能的保加利亞語選擇QA 風險
skill、ability、perk、trait、featумение、способност、привилегия、черта不同的進度系統變得難以區分
buff、debuff、status effectположителен ефект、отрицателен ефект、ефект на състояние玩家無法區分增益與狀態
cooldown、charge、stackвреме за изчакване、заряд、натрупване時間、資源與累積機制被混淆
loot、dropплячка、изпуснат предмет獎勵池與事件或敵人產出的物品混淆
spawn、despawn、triggerпоявяване、изчезване、задействане世界事件與互動條件變得模糊
crafting、recipe、blueprint、upgradeизработка、рецепта、чертеж、подобрение製作、解鎖與升級失去了其機制上的區別
save、load、save slotзапазване、зареждане、място за запазена игра動作、存檔及其位置被混淆

同時,請審查上下文敏感的技術詞彙,例如 support、state、patch、build、release 和 slot。例如,support 可能意指 съвместимост、поддръжка 或 помощ;patch 可能意指 поправка、корекция 或 обновление。

稱呼與語域

對於面向玩家的遊戲 UI、教學、提示、目標或通用系統訊息,除非專案詞彙表、角色語氣、遊戲設定或原文上下文明確要求正式稱呼,否則請不要預設使用正式的 Вие / -те 措辭。偏好非正式的單數 ти / -ш 或自然的中性結構。

將不一致的稱呼/語域標記為 QA 問題,特別是當英文的 you 在沒有證據顯示遊戲使用正式玩家稱呼的情況下被翻譯為正式保加利亞語時。

範例:

  • You have to do this. -> 偏好 Трябва да направиш това. 或 Това трябва да се направи.,視上下文而定
  • 避免在一般的玩家面向 UI 中預設使用 Вие трябва да направите това.
  • 對於貴族、官員、客戶服務風格的 UI、刻意保持距離的敘述,或專案既定風格使用 Вие 的情況,請保持正式稱呼。

翻譯冗詞

標記那些在技術上已被翻譯,但在保加利亞語 UI 文字中增加了不必要份量的原文短語。將這些視為需要人工審查的 QA 警告,而非自動修正。

對於可能的翻譯冗詞,使用 low 嚴重性和 manual review 操作。當該短語承載了真實的遊戲玩法、空間、目標、時間或機械資訊時,保留它。

常見範例:

  • through the air 跟在動詞 shoot、fire、throw 或 launch 之後
    • shoots arrows through the air -> изстрелва стрели
    • 標記過於照字面翻譯的變體,如 изстрелва стрели във въздуха,除非空中移動在機制上相關
  • nearby 當保加利亞語句子已暗示接近程度時
    • when enemies are nearby -> когато има врагове наблизо
    • when senses lifeforms nearby -> когато усети живи същества наблизо
    • 當 наблизо 定義了偵測半徑、目標鎖定、觸發範圍或位置時,請保留它
  • into pieces / apart 跟在已暗示破壞的動詞之後
    • smashing things apart -> разбиване на неща
    • 避免強制措辭如 разбиване на неща на парчета,除非碎片/部件有實際意義
  • on the ground、in front of you、with your hands 或 by hand 當保加利亞語動詞或上下文已暗示該資訊時
    • 當它們承載了真實的位置、輸入、製作或互動限制時,請保留它們

請參閱 references/bg-text.md 以獲得實用的保加利亞語風格指南,以及在建立或擴充專案詞彙表時參閱 references/glossary-template.md。

與 bg-text 的關係

當 bg-text 技能可用或使用者要求使用它時,請將其作為保加利亞語排版、清晰度、標點符號、語法與一般編輯品質的輔助參考。首先應用此技能的遊戲在地化限制:切勿讓排版或風格清理改變受保護的結構、鍵值、ID、佔位符、標籤、跳脫序列、換行符號或專案術語。

對於遊戲檔案,請將 bg-text 視為語言品質指南,而非允許改寫整個檔案或標準化引擎特定語法的許可。

QA 檢查清單

在最終輸出之前,請檢查:

  • 損壞、變更、重新排序或遺失的佔位符
  • 遺失、格式錯誤或不成對的格式化標籤
  • 變更的鍵值、ID、檔案名稱、路徑或後設資料
  • 遺失的列或變更的表格形狀
  • 引入或遺漏的重複 ID
  • 已翻譯欄位中未翻譯的英文
  • 烏克蘭語殘留
  • 俄語殘留
  • 不一致的詞彙表術語
  • 機械式或不一致翻譯的技術術語
  • 在沒有詞彙表決策的情況下,將相關遊戲機制合併為一個術語
  • 過於照字面翻譯的保加利亞語
  • 不相符的正式/非正式稱呼,特別是面向玩家 UI 中不必要的 Вие
  • 可能為翻譯冗詞/應手動審查的照字面短語
  • 明顯對於其可能控制項過長的 UI 文字

請參閱 references/qa-checklist.md 以獲得實用的最終審查通行證。

輸出期望

偏好修補程式風格的變更與聚焦的修正。簡要說明有意義的翻譯或 QA 變更。將不確定的字串與其鍵值/ID 或位置、問題以及最安全的建議處理方式分開列出。

如果檔案很大,請檢查足夠的周圍上下文以避免術語漂移,然後僅編輯要求的範圍。如果請求的變更可能危及結構或佔位符,請停下來請求釐清。

相關技能