Communitygithub.com

AcTePuKc/bg-game-translation-qa

コードックスキル:ブルガリア語ゲームローカライゼーションの品質保証

bg-game-translation-qa とは?

このスキルは、AIエージェント(Codex)がブルガリア語のゲームローカライゼーションファイルを編集・レビューするための品質保証スキルです。ファイル構造の完全性を保ちながら、プレイヤー向けテキストのみを安全に翻訳・修正することに重点を置いています。サポート対象はJSON、XML、CSV、PO、INIなど、ゲームで一般的な構造化ファイル形式です。スキルはプレースホルダー、タグ、エスケープシーケンス、内部IDをバイトレベルで保護し、プロジェクト内の用語集やスタイルガイドの一貫性を維持します。また、ブルガリア語固有のローカライゼーションスタイル(自然な表現、丁寧/くだけた口調の適切な使い分け、文化的適合性)に関する詳細なガイドラインを提供し、不確実な文字列は報告するよう求めます。最終的に、変更箇所の要約と、未変更のリスクや質問事項を出力するルールを持ち、パッチ的な修正を優先します。

対応~Claude Code✓Codex CLI~Cursor
npx skills add AcTePuKc/bg-game-translation-qa

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Българска локализация на игри – Контрол на качеството

Използвайте това умение за работа по българска локализация на игри, където запазването на файловия формат е също толкова важно, колкото и подобряването на текста. Правете минимални, безопасни промени и предпочитайте целенасочени корекции пред преписване на цели файлове, освен ако потребителят изрично не поиска пълно пренаписване.

Основен работен процес

  1. Идентифицирайте файловия формат и преводимите полета преди редактиране.
  2. Запазете цялата структура, подредба, разделители, кавички, екраниране, коментари, ключове, идентификатори и метаданни.
  3. Превеждайте или редактирайте само текста, видим за потребителя.
  4. Запазете заместителите, форматиращите тагове, променливите, екраниращите последователности и новите редове точно такива, каквито са, освен ако потребителят изрично не поиска да ги промени.
  5. Следвайте всеки речник на проекта, терминологична база, ръководство за стил или съществуваща памет за превод, предоставени от потребителя или присъстващи в проекта.
  6. Отчитайте несигурните низове отделно, вместо да гадаете мълчаливо.
  7. Обобщете какво е променено, какво е останало непроменено и всички рискове или въпроси.

Непреводимо съдържание

Не превеждайте и не нормализирайте вътрешни идентификатори, имена на enum-ове, имена на файлове, пътища до файлове, имена на класове, имена на функции, имена на обекти, имена на асети, имена на събития, конзолни команди, конфигурационни ключове, идентификатори или технически метаданни, освен ако потребителят изрично не ги маркира като текст, видим за играча.

За структурирани файлове запазете броя на редовете, реда на ключовете, влагането, разделителите и кодирането непроменени. За CSV/TSV таблици запазете точната колонна структура. За JSON/XML/INI/PO-подобни файлове запазете синтаксиса и екранирането.

Заместители и тагове

Запазете заместителите и форматиращите тагове байт за байт, включително регистър на буквите, пунктуация, влагане, интервали и подредба. Не превеждайте текст вътре в променливи, освен ако не е ясно текст, видим за играча.

Винаги защитавайте шаблони като:

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

Прочетете references/placeholders.md, когато задачата включва непознати токени, богат текст, UI маркиране, скриптов синтаксис или заместители, специфични за формата.

Български стил на локализация

Използвайте естествена българска фразировка, а не буквален английски словоред. Поддържайте UI текста кратък и четим, особено за бутони, менюта, постижения, подсказки и бойни съобщения.

Предпочитайте културно подходящ български превод пред транслитерация, когато е възможно, но запазете утвърдените игрови термини и изборите от речника на проекта. Запазете гласа на героите в диалозите и избягвайте прекалено официалния тон за неформална или хумористична реч.

Когато полът на говорещия/играча е неизвестен, избягвайте насилствени форми, свързани с пола, когато българският позволява неутрална конструкция. Не внасяйте звучащи по руски или украински изрази. Избягвайте ненужното използване на главни букви, пренесени от английски заглавия, имена на предмети или UI етикети, освен ако стилът на проекта не го изисква.

Технически термини и заемки

Не превеждайте механично технически термин само защото е видим в изходния текст. Първо определете дали е вътрешен идентификатор, утвърден специализиран термин или проза, видима за играча.

  • Запазете API имената, командите, конфигурационните ключове, имената на класове и други идентификатори непроменени.
  • За текст, видим за играча, предпочитайте естествено българско описание на функцията пред буквална заемка.
  • Ако изходният текст не установява точно техническата роля, не измисляйте такава. Използвайте неутрална функционална фраза или отбележете низа като несигурен.
  • Следвайте речника на проекта, когато дефинира термин, дори когато е възможна и друга българска опция.

Примери:

Изходен терминТекст, видим за играчаТехническо обяснениеНе предполагайте
hookмеханизъм / точка за включванеобработчик / точка за разширяванече означава модул или „кука“
compatibility hookмеханизъм за съвместимостобработчик за съвместимост or точка за включване за съвместимостче модул, кука, или прихващач винаги са правилни
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, уроци, подкани, цели или общи системни съобщения. Предпочитайте неформалното единствено число ти / -ш или естествена неутрална конструкция, освен ако речникът на проекта, гласът на героя, обстановката или контекстът на изходния текст изрично не изискват официално обръщение.

Отбелязвайте несъответстващото обръщение/регистър като проблем с качеството, особено когато английското you е преведено като официално българско Вие без доказателство, че играта използва официално обръщение към играча.

Примери:

  • You have to do this. -> предпочитайте Трябва да направиш това. or Това трябва да се направи. в зависимост от контекста
  • избягвайте използването по подразбиране на Вие трябва да направите това. в нормален UI, видим за играча
  • запазете официално обръщение за благородници, официални лица, UI в стил обслужване на клиенти, умишлено дистанциран разказ или проекти, чийто установен стил използва Вие

Преводен баласт

Отбелязвайте изходни фрази, които са технически преведени, но добавят ненужна тежест в българския UI текст. Отнасяйте се към тях като към QA предупреждения за ръчна проверка, а не като автоматични корекции.

Използвайте тежест ниска и действие ръчна проверка за възможен преводен баласт. Запазете фразата, когато носи реална геймплейна, пространствена, целева, времева или механична информация.

Често срещани примери:

  • 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 е налично или потребителят поиска да го използва, използвайте го като спътник за българска типография, яснота, пунктуация, граматика и общо редакторско качество. Първо прилагайте ограниченията за локализация на игри от това умение: никога не позволявайте типографско почистване или подобрения на стила да променят защитена структура, ключове, идентификатори, заместители, тагове, екраниращи последователности, нови редове или терминология на проекта.

За игрови файлове третирайте bg-text като насока за езиково качество, а не разрешение за пренаписване на цели файлове или нормализиране на специфичен за двигателя синтаксис.

Контролен списък за QA

Преди окончателния изход проверете за:

  • счупени, променени, разместени или липсващи заместители
  • липсващи, неправилно оформени или небалансирани форматиращи тагове
  • променени ключове, идентификатори, имена на файлове, пътища или метаданни
  • липсващи редове или променена форма на таблица
  • дублирани идентификатори, въведени или пропуснати
  • непреведен английски в преведени полета
  • украински остатъци
  • руски остатъци
  • непоследователни термини от речника
  • технически термини, преведени механично или непоследователно
  • свързани игрови механики, обединени в един термин без решение от речника
  • прекалено буквален български
  • несъответстващо официално/неформално обръщение, особено ненужно Вие в UI, видим за играча
  • възможен преводен баласт / буквална фраза, която трябва да бъде ръчно проверена
  • UI текст, който очевидно е твърде дълъг за вероятния си контролен елемент

Прочетете references/qa-checklist.md за практическа окончателна проверка.

Очаквания за изхода

Предпочитайте корекции в стил на пач и целенасочени поправки. Обяснете накратко значими промени в превода или QA. Избройте несигурните низове отделно с ключа/идентификатора или местоположението, проблема и най-безопасното предложено действие.

Ако файлът е голям, проверете достатъчно околен контекст, за да избегнете отклонение в терминологията, след което редактирайте само искания обхват. Ако поискана промяна би рискувала да повреди структура или заместители, спрете и поискайте разяснение.

関連スキル