Was macht i18n & Lokalisierung?
Überblick
Dieser öffentliche Intake-Kopie enthält plugins/antigravity-awesome-skills/skills/i18n-localization aus https://github.com/sickn33/antigravity-awesome-skills in der nativen Omni-Skills-Redaktionsform, ohne seine Herkunft zu verbergen.
Verwende ihn, wenn der Operator den Upstream-Workflow, die Support-Dateien und den Repository-Kontext intakt halten muss, während der öffentliche Validator und der private Enhancer ihren normalen Downstream-Fluss fortsetzen.
Dieser Intake bewahrt die kopierten Upstream-Dateien intakt und verwendet den external_source-Block in metadata.json sowie ORIGIN.md als Herkunftsanker für die Überprüfung.
i18n & Lokalisierung > Internationalisierung (i18n) und Lokalisierung (L10n) – Best Practices. ---
Importierte Quellabschnitte, die nicht sauber auf die öffentlichen Überschriften abgebildet werden konnten, sind unten oder in den Support-Dateien erhalten. Bemerkenswerte importierte Abschnitte: 1. Kernkonzepte, 3. Implementierungsmuster, 4. Dateistruktur, 6. Häufige Probleme, 7. RTL-Unterstützung, 8. Checkliste.
Wann dieser Skill verwendet werden sollte
Verwende diesen Abschnitt als Auslösefilter. Er sollte die Aktivierungsgrenze explizit machen, bevor der Operator Dateien lädt, Befehle ausführt oder einen Pull Request eröffnet.
- Projekttyp – i18n erforderlich?
- Öffentliche Web-App - ✅ Ja
- SaaS-Produkt - ✅ Ja
- Internes Tool - ⚠️ Vielleicht
- Ein-Regionen-App - ⚠️ Zukunft bedenken
- Persönliches Projekt - ❌ Optional
Betriebstabelle
| Situation | Hier starten | Warum es wichtig ist |
|---|---|---|
| Erste Nutzung | metadata.json | Bestätigt Repository, Branch, Commit und importierten Pfad durch den external_source-Block, bevor der kopierte Workflow berührt wird |
| Herkunftsprüfung | ORIGIN.md | Gibt Prüfern einen Klartext-Prüfpfad für die importierte Quelle |
| Workflow-Ausführung | scripts/i18n_checker.py | Startet mit der kleinsten kopierten Datei, die die Ausführung materiell verändert |
| Unterstützender Kontext | scripts/i18n_checker.py | Fügt die nächstrelevanteste kopierte Quelldatei hinzu, ohne das gesamte Paket zu laden |
| Übergabeentscheidung | ## Verwandte Skills | Hilft dem Operator, zu einem stärkeren nativen Skill zu wechseln, wenn die Aufgabe abweicht |
Workflow
Dieser Workflow ist absichtlich redaktionell und operativ zugleich. Er hält die importierte Quelle für den Operator nützlich, während er gleichzeitig die öffentlichen Intake-Standards erfüllt, die den Downstream-Enhancer-Fluss speisen.
- Bestätige das Benutzerziel, den Umfang des importierten Workflows und ob dieser Skill noch der richtige Router für die Aufgabe ist.
- Lies die Übersichts- und Herkunftsdateien, bevor du kopierte Upstream-Support-Dateien lädst.
- Lade nur die Referenzen, Beispiele, Prompts oder Skripte, die das Ergebnis für die aktuelle Anfrage materiell verändern.
- Führe den Upstream-Workflow aus, während du die Herkunft und Quellgrenzen in den Arbeitsnotizen explizit hältst.
- Validiere das Ergebnis gegen die Upstream-Erwartungen und die Beweise, auf die du in den kopierten Dateien verweisen kannst.
- Eskaliere oder übergebe an einen verwandten Skill, wenn die Arbeit den Schwerpunkt dieses importierten Workflows verlässt.
- Vor dem Merge oder Abschluss dokumentiere, was verwendet wurde, was sich geändert hat und was der Prüfer noch überprüfen muss.
Importierte Workflow-Notizen
Importiert: 1. Kernkonzepte
| Begriff | Bedeutung |
|---|---|
| i18n | Internationalisierung – App übersetzbar machen |
| L10n | Lokalisierung – tatsächliche Übersetzungen |
| Locale | Sprache + Region (en-US, tr-TR) |
| RTL | Rechts-nach-links-Sprachen (Arabisch, Hebräisch) |
Beispiele
Beispiel 1: Direkt nach dem Upstream-Workflow fragen
Verwende @i18n-localization-v2, um <Aufgabe> zu erledigen. Starte mit dem kopierten Upstream-Workflow, lade nur die Dateien, die das Ergebnis ändern, und halte die Herkunft in der Antwort sichtbar.
Erklärung: Dies ist der sicherste Startpunkt, wenn der Operator den importierten Workflow, aber nicht das gesamte Repository benötigt.
Beispiel 2: Um eine herkunftsbasierte Überprüfung bitten
Überprüfe @i18n-localization-v2 anhand von metadata.json und ORIGIN.md und erkläre dann, welche kopierten Upstream-Dateien du zuerst laden würdest und warum.
Erklärung: Verwende dies vor einer Überprüfung oder Fehlersuche, wenn du eine präzise, prüfbare Erklärung zur Herkunft und Dateiauswahl benötigst.
Beispiel 3: Die kopierten Support-Dateien vor der Ausführung eingrenzen
Verwende @i18n-localization-v2 für <Aufgabe>. Lade nur die kopierten Referenzen, Beispiele oder Skripte, die das Ergebnis ändern, und nenne die Dateien explizit, bevor du fortfährst.
Erklärung: Dies hält den Skill auf progressive Offenlegung ausgerichtet, anstatt standardmäßig das gesamte kopierte Paket zu laden.
Beispiel 4: Ein Prüfpaket erstellen
Überprüfe @i18n-localization-v2 unter Verwendung der kopierten Upstream-Dateien sowie der Herkunft und fasse dann etwaige Lücken vor dem Merge zusammen.
Erklärung: Dies ist nützlich, wenn der PR auf eine menschliche Überprüfung wartet und du ein wiederholbares Prüfprotokoll haben möchtest.
Best Practices
Behandle den generierten öffentlichen Skill als eine überprüfbare Verpackungsschicht um das Upstream-Repository. Das Ziel ist es, die Herkunft explizit zu halten und nur das kopierte Quellmaterial zu laden, das die Ausführung materiell verbessert.
- Verwende Übersetzungsschlüssel, keinen Rohtext
- Namespace-Übersetzungen nach Funktion
- Unterstütze Pluralisierung
- Behandle Datums-/Zahlenformate pro Locale
- Plane RTL von Anfang an ein
- Verwende ICU-Nachrichtenformat für komplexe Zeichenfolgen
- Hardcodierte Zeichenfolgen in Komponenten
Importierte Betriebshinweise
Importiert: 5. Best Practices
TUN ✅
- Verwende Übersetzungsschlüssel, keinen Rohtext
- Namespace-Übersetzungen nach Funktion
- Unterstütze Pluralisierung
- Behandle Datums-/Zahlenformate pro Locale
- Plane RTL von Anfang an ein
- Verwende ICU-Nachrichtenformat für komplexe Zeichenfolgen
NICHT TUN ❌
- Hardcodiere Zeichenfolgen in Komponenten
- Verkette übersetzte Zeichenfolgen
- Nimm Textlänge an (Deutsch ist 30 % länger)
- Vergiss RTL-Layout
- Mische Sprachen in derselben Datei
Fehlerbehebung
Problem: Der Operator hat den importierten Kontext übersprungen und zu allgemein geantwortet
Symptome: Das Ergebnis ignoriert den Upstream-Workflow in plugins/antigravity-awesome-skills/skills/i18n-localization, erwähnt keine Herkunft oder verwendet überhaupt keine kopierten Quelldateien.
Lösung: Öffne metadata.json, ORIGIN.md und die relevantesten kopierten Upstream-Dateien erneut. Überprüfe zuerst den external_source-Block und gib dann die Herkunft erneut an, bevor du fortfährst.
Problem: Der importierte Workflow fühlt sich während der Überprüfung unvollständig an
Symptome: Prüfer sehen die generierte SKILL.md, können aber nicht schnell erkennen, welche Referenzen, Beispiele oder Skripte für die aktuelle Aufgabe wichtig sind.
Lösung: Verweise auf die genauen kopierten Referenzen, Beispiele, Skripte oder Assets, die deinen gewählten Weg rechtfertigen. Wenn die Lücke real ist, dokumentiere sie im PR, anstatt sie zu verbergen.
Problem: Die Aufgabe ist in eine andere Spezialisierung abgedriftet
Symptome: Der importierte Skill beginnt an der richtigen Stelle, aber die Arbeit verwandelt sich in Debugging, Architektur, Design, Sicherheit oder Release-Orchestrierung, die ein nativer Skill besser handhabt. Lösung: Verwende den Abschnitt „Verwandte Skills“, um gezielt zu übergeben. Halte die importierte Herkunft sichtbar, sodass der nächste Skill den richtigen Kontext erbt, anstatt blind zu starten.
Verwandte Skills
@00-andruia-consultant– Verwende, wenn die Arbeit besser von dieser nativen Spezialisierung erledigt wird, nachdem dieser importierte Skill den Kontext hergestellt hat.@00-andruia-consultant-v2– Verwende, wenn die Arbeit besser von dieser nativen Spezialisierung erledigt wird, nachdem dieser importierte Skill den Kontext hergestellt hat.@10-andruia-skill-smith– Verwende, wenn die Arbeit besser von dieser nativen Spezialisierung erledigt wird, nachdem dieser importierte Skill den Kontext hergestellt hat.@10-andruia-skill-smith-v2– Verwende, wenn die Arbeit besser von dieser nativen Spezialisierung erledigt wird, nachdem dieser importierte Skill den Kontext hergestellt hat.
Zusätzliche Ressourcen
Verwende diese Support-Matrix und die verlinkten Dateien unten als Operator-Paket für diesen importierten Skill. Sie sollten echtes kopiertes Quellmaterial widerspiegeln, keine generische Gerüste.
| Ressourcenfamilie | Was sie dem Prüfer gibt | Beispielpfad |
|---|---|---|
references | kopierte Referenznotizen, Anleitungen oder Hintergrundmaterial aus dem Upstream | references/n/a |
examples | ausgearbeitete Beispiele oder wiederverwendbare Prompts aus dem Upstream | examples/n/a |
scripts | Upstream-Hilfsskripte, die die Ausführung oder Validierung ändern | scripts/i18n_checker.py |
agents | Routing- oder Delegationsnotizen, die wirklich Teil des importierten Pakets sind | agents/n/a |
assets | unterstützende Assets oder Schemata aus dem Quellpaket | assets/n/a |
Importierte Referenznotizen
Importiert: 3. Implementierungsmuster
React (react-i18next)
import { useTranslation } from 'react-i18next';
function Welcome() {
const { t } = useTranslation();
return <h1>{t('welcome.title')}</h1>;
}
Next.js (next-intl)
import { useTranslations } from 'next-intl';
export default function Page() {
const t = useTranslations('Home');
return <h1>{t('title')}</h1>;
}
Python (gettext)
from gettext import gettext as _
print(_("Welcome to our app"))
Importiert: 4. Dateistruktur
locales/
├── en/
│ ├── common.json
│ ├── auth.json
│ └── errors.json
├── tr/
│ ├── common.json
│ ├── auth.json
│ └── errors.json
└── ar/ # RTL
└── ...
Importiert: 6. Häufige Probleme
| Problem | Lösung |
|---|---|
| Fehlende Übersetzung | Fallback auf Standardsprache |
| Hartcodierte Zeichenfolgen | Linter/Checker-Skript verwenden |
| Datumsformat | Intl.DateTimeFormat verwenden |
| Zahlenformat | Intl.NumberFormat verwenden |
| Pluralisierung | ICU-Nachrichtenformat verwenden |
Importiert: 7. RTL-Unterstützung
/* CSS Logical Properties */
.container {
margin-inline-start: 1rem; /* Nicht margin-left */
padding-inline-end: 1rem; /* Nicht padding-right */
}
[dir="rtl"] .icon {
transform: scaleX(-1);
}
Importiert: 8. Checkliste
Vor der Auslieferung:
- Alle benutzerseitigen Zeichenfolgen verwenden Übersetzungsschlüssel
- Locale-Dateien existieren für alle unterstützten Sprachen
- Datums-/Zahlenformatierung verwendet Intl API
- RTL-Layout getestet (falls zutreffend)
- Fallback-Sprache konfiguriert
- Keine hartcodierten Zeichenfolgen in Komponenten
Importiert: Skript
| Skript | Zweck | Befehl |
|---|---|---|
scripts/i18n_checker.py | Hartcodierte Zeichenfolgen und fehlende Übersetzungen erkennen | python scripts/i18n_checker.py <Projektpfad> |
Importiert: Einschränkungen
- Verwende diesen Skill nur, wenn die Aufgabe klar mit dem oben beschriebenen Umfang übereinstimmt.
- Betrachte die Ausgabe nicht als Ersatz für umgebungsspezifische Validierung, Tests oder Expertenüberprüfung.
- Halte inne und frage nach Klärung, wenn erforderliche Eingaben, Berechtigungen, Sicherheitsgrenzen oder Erfolgskriterien fehlen.