Communitygithub.com

AcTePuKc/bg-game-translation-qa

Codex-Skill für bulgarische Lokalisierungs-QA in Spielen

Was ist bg-game-translation-qa?

Dieser Skill ist speziell für die Qualitätssicherung bulgarischer Lokalisierungen in Spielen konzipiert. Er unterstützt Entwickler und Lokalisierer dabei, Dateiformate zu bewahren, während sie gleichzeitig die Textqualität verbessern. Der Skill arbeitet mit minimalen, sicheren Änderungen und konzentriert sich auf gezielte Patches anstelle von vollständigen Neuschreibungen. Er ist mit Codex kompatibel und eignet sich für strukturierte Dateien wie JSON, XML, INI, CSV/TSV und PO-ähnliche Formate. Der Skill stellt sicher, dass Platzhalter, Formatierungs-Tags, Escape-Sequenzen und technische Metadaten unverändert bleiben, und bietet detaillierte Richtlinien für die bulgarische Lokalisierung, einschließlich der Behandlung von Fachbegriffen, wiederholten Spielmechaniken und der Anrede. Er enthält eine QA-Checkliste für die abschließende Überprüfung und erwartet patch-artige Ausgaben mit klaren Zusammenfassungen der Änderungen und Risiken.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Bulgarische Spiele-Lokalisierungs-QA

Verwenden Sie diesen Skill für bulgarische Lokalisierungsarbeiten an Spielen, bei denen die Bewahrung des Dateiformats ebenso wichtig ist wie die Verbesserung des Textes. Nehmen Sie minimale, sichere Änderungen vor und bevorzugen Sie gezielte Patches gegenüber dem Umschreiben ganzer Dateien, es sei denn, der Benutzer bittet ausdrücklich um eine vollständige Neufassung.

Kernarbeitsablauf

  1. Identifizieren Sie das Dateiformat und die übersetzbaren Felder, bevor Sie Änderungen vornehmen.
  2. Bewahren Sie die gesamte Struktur, Reihenfolge, Trennzeichen, Anführungszeichen, Escape-Sequenzen, Kommentare, Schlüssel, IDs und Metadaten.
  3. Übersetzen oder bearbeiten Sie nur benutzerseitigen Text.
  4. Bewahren Sie Platzhalter, Formatierungs-Tags, Variablen, Escape-Sequenzen und Zeilenumbrüche exakt bei, es sei denn, der Benutzer bittet ausdrücklich um deren Änderung.
  5. Befolgen Sie ein etwaiges Projektglossar, Terminologiedatenbank, Styleguide oder vorhandenes Übersetzungsspeicher, das/die vom Benutzer bereitgestellt wurde oder im Projekt vorhanden ist.
  6. Melden Sie unsichere Zeichenfolgen separat, anstatt stillschweigend zu raten.
  7. Fassen Sie zusammen, was geändert wurde, was unverändert blieb, sowie etwaige Risiken oder Fragen.

Nicht übersetzbarer Inhalt

Übersetzen oder normalisieren Sie keine internen Bezeichner, Aufzählungsnamen, Dateinamen, Dateipfade, Klassennamen, Funktionsnamen, Objektnamen, Asset-Namen, Ereignisnamen, Konsolenbefehle, Konfigurationsschlüssel, IDs oder technische Metadaten, es sei denn, der Benutzer markiert sie ausdrücklich als spielerseitigen Text.

Bei strukturierten Dateien bleiben Zeilenanzahl, Schlüsselreihenfolge, Verschachtelung, Trennzeichen und Kodierung intakt. Bei CSV/TSV-Tabellen bewahren Sie die exakte Spaltenstruktur. Bei JSON/XML/INI/PO-artigen Dateien bewahren Sie Syntax und Escape-Sequenzen.

Platzhalter und Tags

Bewahren Sie Platzhalter und Formatierungs-Tags bytegenau auf, einschließlich Groß-/Kleinschreibung, Zeichensetzung, Verschachtelung, Abständen und Reihenfolge. Übersetzen Sie keinen Text in Variablen, es sei denn, es handelt sich eindeutig um spielerseitigen Anzeigetext.

Schützen Sie stets Muster wie:

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

Lesen Sie references/placeholders.md, wenn die Aufgabe unbekannte Tokens, Rich-Text, UI-Markup, Skriptsyntax oder formatspezifische Platzhalter enthält.

Bulgarischer Lokalisierungsstil

Verwenden Sie natürliche bulgarische Formulierungen, keine wörtliche englische Wortstellung. Halten Sie UI-Texte prägnant und lesbar, insbesondere für Schaltflächen, Menüs, Errungenschaften, Tooltips und Kampfnachrichten.

Bevorzugen Sie kulturell angemessene bulgarische Übersetzungen gegenüber Transliterationen, wenn möglich, aber bewahren Sie etablierte Spielbegriffe und Projektglossarentscheidungen. Bewahren Sie den Charakterton in Dialogen und vermeiden Sie übermäßige Formalisierung von lässiger oder humorvoller Rede.

Wenn Sprecher- oder Spielergeschlecht unbekannt ist, vermeiden Sie erzwungene geschlechtsspezifische Formulierungen, wo das Bulgarische eine neutrale Konstruktion zulässt. Führen Sie keine russisch oder ukrainisch klingenden Formulierungen ein. Vermeiden Sie unnötige Großschreibung aus englischen Überschriften, Artikelnamen oder UI-Beschriftungen, es sei denn, der Projektstil verlangt dies.

Fachbegriffe und Entlehnungen

Übersetzen Sie einen Fachbegriff nicht mechanisch, nur weil er im Quelltext sichtbar ist. Bestimmen Sie zuerst, ob es sich um eine interne Kennung, einen etablierten Fachbegriff oder spielerseitigen Prosa handelt.

  • Behalten Sie API-Namen, Befehle, Konfigurationsschlüssel, Klassennamen und andere Bezeichner unverändert bei.
  • Bevorzugen Sie für spielerseitigen Text eine natürliche bulgarische Beschreibung der Funktion gegenüber einer wörtlichen Entlehnung.
  • Wenn die Quelle die technische Rolle nicht genau festlegt, erfinden Sie keine. Verwenden Sie eine neutrale funktionale Phrase oder melden Sie die Zeichenfolge als unsicher.
  • Befolgen Sie das Projektglossar, wenn es einen Begriff definiert, auch wenn eine andere bulgarische Option ebenfalls möglich ist.

Beispiele:

QuellbegriffSpielerseitiger TextTechnische ErklärungNicht annehmen
hookмеханизъм / точка за включванеобработчик / точка за разширяванеdass es ein Modul oder „кука“ bedeutet
compatibility hookмеханизъм за съвместимостобработчик за съвместимост oder точка за включване за съвместимостdass модул, кука oder прихващач immer richtig sind
fixпоправка / корекцияпоправка за съвместимостdass Slang фикс zum Publikum passt
handlerbeschreibe seine Aktion, falls nötigобработчикdass es als хендлър transliteriert werden sollte

Zum Beispiel übersetzen Sie The journal level label was corrected through the compatibility hook. als Надписът за нивото в дневника е коригиран чрез механизма за съвместимост. für einen spielerseitigen Änderungsprotokoll. Verwenden Sie standardmäßig nicht кука за съвместимост.

Wiederholte Spielbegriffe

Wenn sich eine Spielmechanik oder ein UI-Konzept wiederholt, entscheiden Sie seinen bulgarischen Namen beim ersten klaren Vorkommen und halten Sie ihn im Projektglossar fest. Fassen Sie verwandte Begriffe nicht zu einem bulgarischen Wort zusammen, nur weil sie im Englischen ähnlich klingen.

Zu unterscheidende QuellbegriffeMögliche bulgarische EntscheidungenQA-Risiko
skill, ability, perk, trait, featумение, способност, привилегия, чертаverschiedene Fortschrittssysteme werden ununterscheidbar
buff, debuff, status effectположителен ефект, отрицателен ефект, ефект на състояниеSpieler kann einen Bonus nicht von einer Bedingung unterscheiden
cooldown, charge, stackвреме за изчакване, заряд, натрупванеZeit-, Ressourcen- und Akkumulationsmechaniken werden vermischt
loot, dropплячка, изпуснат предметein Belohnungspool wird mit einem von einem Ereignis oder Gegner produzierten Gegenstand verwechselt
spawn, despawn, triggerпоявяване, изчезване, задействанеWeltereignisse und Interaktionsbedingungen werden vage
crafting, recipe, blueprint, upgradeизработка, рецепта, чертеж, подобрениеhandwerkliche Herstellung, Freischaltungen und Verbesserungen verlieren ihre mechanische Unterscheidung
save, load, save slotзапазване, зареждане, място за запазена играdie Aktion, der gespeicherte Spielstand und sein Speicherort werden verwechselt

Überprüfen Sie auch kontextsensitive Fachwörter wie support, state, patch, build, release und slot. Zum Beispiel kann support je nach Kontext съвместимост, поддръжка oder помощ bedeuten; patch kann поправка, корекция oder обновление sein.

Anrede und Register

Standardmäßig für spielerseitige UI, Tutorials, Aufforderungen, Ziele oder generische Systemnachrichten nicht die formelle Вие/-те-Formulierung verwenden. Bevorzugen Sie informelles, singuläres ти/-ш oder eine natürliche neutrale Konstruktion, es sei denn, das Projektglossar, die Charakterstimme, das Setting oder der Quellkontext erfordert eindeutig formelle Anrede.

Kennzeichnen Sie nicht übereinstimmende Anrede/Register als QA-Problem, insbesondere wenn englisches you ohne Nachweis formell ins Bulgarische übersetzt wurde.

Beispiele:

  • You have to do this. -> bevorzugen Sie Трябва да направиш това. oder Това трябва да се направи. je nach Kontext
  • vermeiden Sie die Standardverwendung von Вие трябва да направите това. in normaler spielerseitiger UI
  • behalten Sie formelle Anrede für Adlige, Amtspersonen, kundendienstähnliche UI, absichtlich distanzierte Erzählung oder Projekte, deren etablierter Stil Вие verwendet

Übersetzungsballast

Kennzeichnen Sie Quellphrasen, die technisch korrekt übersetzt sind, aber in bulgarischen UI-Texten unnötiges Gewicht hinzufügen. Behandeln Sie dies als QA-Warnungen für manuelle Überprüfung, nicht als automatische Korrekturen.

Verwenden Sie Schweregrad niedrig und Aktion manuelle Überprüfung für möglichen Übersetzungsballast. Behalten Sie die Phrase bei, wenn sie tatsächliche Gameplay-, Raum-, Ziel-, Zeit- oder mechanische Informationen enthält.

Häufige Beispiele:

  • through the air nach Verben wie shoot, fire, throw oder launch
    • shoots arrows through the air -> изстрелва стрели
    • kennzeichnen Sie übermäßig wörtliche Varianten wie изстрелва стрели във въздуха, es sei denn, die Luftbewegung ist mechanisch relevant
  • nearby, wenn die Nähe bereits durch den bulgarischen Satz impliziert wird
    • when enemies are nearby -> когато има врагове наблизо
    • when senses lifeforms nearby -> когато усети живи същества наблизо
    • behalten Sie наблизо, wenn es den Erkennungsradius, das Zielen, den Auslösebereich oder den Ort definiert
  • into pieces / apart nach Verben, die bereits Zerbrechen implizieren
    • smashing things apart -> разбиване на неща
    • vermeiden Sie erzwungene Formulierungen wie разбиване на неща на парчета, es sei denn, Fragmente/Stücke sind wichtig
  • on the ground, in front of you, with your hands oder by hand, wenn das bulgarische Verb oder der Kontext die Information bereits impliziert
    • behalten Sie sie, wenn sie tatsächliche Positions-, Eingabe-, Handwerks- oder Interaktionseinschränkungen tragen

Lesen Sie references/bg-text.md für praktische bulgarische Stilrichtlinien und references/glossary-template.md, wenn Sie ein Projektglossar erstellen oder erweitern.

Beziehung zu bg-text

Wenn der Skill bg-text verfügbar ist oder der Benutzer darum bittet, ihn zu verwenden, nutzen Sie ihn als begleitende Referenz für bulgarische Typografie, Klarheit, Zeichensetzung, Grammatik und allgemeine redaktionelle Qualität. Wenden Sie zuerst die Einschränkungen dieses Skills für Spiel-Lokalisierung an: Lassen Sie niemals zu, dass Typografie- oder Stilbereinigungen geschützte Strukturen, Schlüssel, IDs, Platzhalter, Tags, Escape-Sequenzen, Zeilenumbrüche oder Projektterminologie verändern.

Behandeln Sie für Spieldateien bg-text als sprachliche Qualitätsrichtlinie, nicht als Erlaubnis, ganze Dateien umzuschreiben oder motorspezifische Syntax zu normalisieren.

QA-Checkliste

Überprüfen Sie vor der endgültigen Ausgabe auf:

  • beschädigte, geänderte, umsortierte oder fehlende Platzhalter
  • fehlende, fehlerhafte oder unausgeglichene Formatierungs-Tags
  • geänderte Schlüssel, IDs, Dateinamen, Pfade oder Metadaten
  • fehlende Zeilen oder geänderte Tabellenform
  • eingeführte oder übersehene doppelte IDs
  • unübersetztes Englisch in übersetzten Feldern
  • ukrainische Überbleibsel
  • russische Überbleibsel
  • inkonsistente Glossarbegriffe
  • mechanisch oder inkonsistent übersetzte Fachbegriffe
  • zusammengefasste verwandte Spielmechaniken in einen Begriff ohne Glossarentscheidung
  • übermäßig wörtliches Bulgarisch
  • nicht übereinstimmende formelle/informelle Anrede, insbesondere unnötiges Вие in spielerseitiger UI
  • möglicher Übersetzungsballast / wörtliche Phrase, die manuell überprüft werden sollte
  • UI-Text, der offensichtlich zu lang für sein voraussichtliches Steuerelement ist

Lesen Sie references/qa-checklist.md für einen praktischen endgültigen Überprüfungsdurchlauf.

Ausgabeerwartungen

Bevorzugen Sie Patch-artige Änderungen und gezielte Korrekturen. Erklären Sie bedeutende Übersetzungs- oder QA-Änderungen kurz. Listen Sie unsichere Zeichenfolgen separat mit dem Schlüssel/der ID oder dem Ort, dem Problem und dem sichersten vorgeschlagenen Vorgehen auf.

Wenn die Datei groß ist, prüfen Sie genügend umgebenden Kontext, um Terminologieverschiebungen zu vermeiden, und bearbeiten Sie dann nur den angeforderten Bereich. Wenn eine angeforderte Änderung die Struktur oder Platzhalter gefährden würde, stoppen Sie und fragen Sie nach Klärung.

Verwandte Skills