Communitygithub.com

QA за българска локализация на игри

Умение за Codex за проверка качеството на българската локализация на игри.

Qu'est-ce que QA за българска локализация на игри ?

Това умение е предназначено за AI агенти (като Codex, Cursor, Claude Code), работещи по българска локализация на игри. Основният му фокус е върху запазване на файловия формат и структура, докато се подобрява текста, като се правят минимални и безопасни промени. Умението предоставя подробен работен процес за идентифициране на файлови формати, редактиране само на видим за играча текст, запазване на плейсхолдери и тагове, и следване на проектни речници. То включва специфични насоки за българския превод, като използване на естествен български изказ, избягване на русизми и украинизми, и правилен избор между формално и неформално обръщение. Умението също така помага да се разграничават повтарящи се игрови термини (напр. 'skill' vs 'ability'), да се открива 'преводен баласт' и да се следва контролен списък за качество. То е проектирано да работи самостоятелно или в комбинация с допълнителни справочни файлове за типография и стил.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait QA за българска локализация на игри ?

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

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

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

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

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

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

Плейсхолдери и тагове

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

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

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

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

Стил за българска локализация

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

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

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

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

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

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

Примери:

Английски терминТекст, видим за играчаТехническо обяснениеДа не се предполага
hookмеханизъм / точка за включванеобработчик / точка за разширяванече означава модул или „кука“
compatibility hookмеханизъм за съвместимостобработчик за съвместимост или точка за включване за съвместимостче модул, кука или прихващач винаги е правилно
fixпоправка / корекцияпоправка за съвместимостче жаргонът фикс подхожда на аудиторията
handlerопишете действието му, ако е нужнообработчикче трябва да се транслитерира като хендлър

Например, преведете The journal level label was corrected through the compatibility hook. като Надписът за нивото в дневника е коригиран чрез механизма за съвместимост. за видим за играча списък с промени. Не използвайте кука за съвместимост по подразбиране.

Повтарящи се игрови термини

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

Английски термини за разграничаванеВъзможни български избориРиск за качеството
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. -> предпочитайте Трябва да направиш това. или Това трябва да се направи. в зависимост от контекста
  • избягвайте да използвате по подразбиране Вие трябва да направите това. в нормален UI за играча
  • запазете формално обръщение за благородници, официални лица, UI тип „обслужване на клиенти“, умишлено дистанцирано повествование или проекти, чийто установен стил използва Вие

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

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

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

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

  • 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, когато създавате или разширявате проектeн речник.

Връзка с bg-text

Когато умението bg-text е налично или потребителят поиска да го използвате, го използвайте като спътник за справки относно българската типография, яснота, пунктуация, граматика и общо редакционно качество. Първо прилагайте ограниченията за локализация на игри от това умение: никога не позволявайте почистване на типография или стил да променя защитена структура, ключове, идентификатори, плейсхолдери, тагове, последователности за избягване, прекъсвания на редове или проектна терминология.

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

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

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

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

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

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

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

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

Skills associés