Was macht i18n & Lokalisierung?
Überblick
Diese öffentliche Importkopie verpackt plugins/antigravity-awesome-skills-claude/skills/i18n-localization aus https://github.com/sickn33/antigravity-awesome-skills in die native Omni-Skills-Editorialform, ohne ihre Herkunft zu verbergen.
Verwenden Sie diesen Skill, wenn der Betreiber 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 hält 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. Wichtige importierte Abschnitte: 1. Kernkonzepte, 3. Implementierungsmuster, 4. Dateistruktur, 6. Häufige Probleme, 7. RTL-Unterstützung, 8. Checkliste.
Wann dieser Skill verwendet werden sollte
Dieser Abschnitt dient als Auslöserfilter. Er sollte die Aktivierungsgrenze explizit machen, bevor der Betreiber Dateien lädt, Befehle ausführt oder einen Pull Request öffnet.
- Projekttyp - i18n erforderlich?
- Öffentliche Web-App - ✅ Ja
- SaaS-Produkt - ✅ Ja
- Internes Tool - ⚠️ Vielleicht
- Ein-Region-App - ⚠️ Zukunft bedenken
- Persönliches Projekt - ❌ Optional
Betriebstabelle
| Situation | Hier beginnen | Warum es wichtig ist |
|---|---|---|
| Erste Verwendung | metadata.json | Bestätigt Repository, Branch, Commit und importierten Pfad über den external_source-Block, bevor der kopierte Workflow berührt wird |
| Herkunftsprüfung | ORIGIN.md | Gibt Prüfern eine leicht verständliche Audit-Trail für die importierte Quelle |
| Workflow-Ausführung | scripts/i18n_checker.py | Beginnt mit der kleinsten kopierten Datei, die die Ausführung materiell ändert |
| Unterstützender Kontext | scripts/i18n_checker.py | Fügt die nächst-relevanteste kopierte Quelldatei hinzu, ohne das gesamte Paket zu laden |
| Übergabeentscheidung | ## Verwandte Skills | Hilft dem Betreiber, bei Abweichung der Aufgabe zu einem stärkeren nativen Skill zu wechseln |
Workflow
Dieser Workflow ist absichtlich gleichzeitig redaktionell und operativ. Er hält die importierte Quelle für den Betreiber nützlich, während er gleichzeitig die öffentlichen Intake-Standards erfüllt, die den Downstream-Enhancer-Fluss speisen.
- Bestätigen Sie das Benutzerziel, den Umfang des importierten Workflows, und ob dieser Skill noch der richtige Router für die Aufgabe ist.
- Lesen Sie die Übersichts- und Herkunftsdateien, bevor Sie kopierte Upstream-Support-Dateien laden.
- Laden Sie nur die Referenzen, Beispiele, Eingabeaufforderungen oder Skripte, die das Ergebnis für die aktuelle Anfrage materiell ändern.
- Führen Sie den Upstream-Workflow aus, während Sie Herkunft und Quellengrenzen in den Arbeitsnotizen explizit halten.
- Validieren Sie das Ergebnis anhand der Upstream-Erwartungen und der Beweise, auf die Sie in den kopierten Dateien verweisen können.
- Eskalieren oder übergeben Sie an einen verwandten Skill, wenn die Arbeit den Schwerpunkt dieses importierten Workflows verlässt.
- Vor Merge oder Abschluss dokumentieren Sie, was verwendet wurde, was sich geändert hat und was der Prüfer noch verifizieren muss.
Importierte Workflow-Notizen
Importiert: 1. Kernkonzepte
| Begriff | Bedeutung |
|---|---|
| i18n | Internationalisierung - App übersetzbar machen |
| L10n | Lokalisierung - tatsächliche Übersetzungen |
| Locale | Sprache + Region (de-DE, tr-TR) |
| RTL | Rechts-nach-links Sprachen (Arabisch, Hebräisch) |
Beispiele
Beispiel 1: Direkt nach dem Upstream-Workflow fragen
Verwenden Sie @i18n-localization, um <Aufgabe> zu bearbeiten. Starten Sie vom kopierten Upstream-Workflow, laden Sie nur die Dateien, die das Ergebnis ändern, und halten Sie die Herkunft in der Antwort sichtbar.
Erklärung: Dies ist der sicherste Startpunkt, wenn der Betreiber den importierten Workflow benötigt, aber nicht das gesamte Repository.
Beispiel 2: Herkunftsbasierte Überprüfung anfordern
Überprüfen Sie @i18n-localization anhand von metadata.json und ORIGIN.md und erklären Sie dann, welche kopierten Upstream-Dateien Sie zuerst laden würden und warum.
Erklärung: Verwenden Sie dies vor der Überprüfung oder Fehlerbehebung, wenn Sie eine präzise, prüfbare Erklärung der Herkunft und Dateiauswahl benötigen.
Beispiel 3: Kopierte Support-Dateien vor der Ausführung eingrenzen
Verwenden Sie @i18n-localization für <Aufgabe>. Laden Sie nur die kopierten Referenzen, Beispiele oder Skripte, die das Ergebnis ändern, und nennen Sie die Dateien explizit, bevor Sie fortfahren.
Erklärung: Dies hält den Skill auf progressive Offenlegung ausgerichtet, anstatt standardmäßig das gesamte kopierte Paket zu laden.
Beispiel 4: Prüferpaket erstellen
Überprüfen Sie @i18n-localization unter Verwendung der kopierten Upstream-Dateien plus Herkunft und fassen Sie dann etwaige Lücken vor dem Merge zusammen.
Erklärung: Dies ist nützlich, wenn der PR auf menschliche Überprüfung wartet und Sie ein wiederholbares Audit-Paket wünschen.
Best Practices
Behandeln Sie den generierten öffentlichen Skill als überprüfbare Verpackungsschicht um das Upstream-Repository. Ziel ist es, die Herkunft explizit zu halten und nur das kopierte Quellmaterial zu laden, das die Ausführung materiell verbessert.
- Verwenden Sie Übersetzungsschlüssel, keinen Rohtext
- Namensräume für Übersetzungen pro Feature
- Pluralisierung unterstützen
- Datums-/Zahlenformate pro Locale handhaben
- Von Anfang an für RTL planen
- ICU-Nachrichtenformat für komplexe Zeichenketten verwenden
- Zeichenketten in Komponenten hartkodieren
Importierte Betriebsnotizen
Importiert: 5. Best Practices
DO ✅
- Übersetzungsschlüssel verwenden, keinen Rohtext
- Namensräume für Übersetzungen pro Feature
- Pluralisierung unterstützen
- Datums-/Zahlenformatierung pro Locale
- Von Anfang an für RTL planen
- ICU-Nachrichtenformat für komplexe Zeichenketten verwenden
DON'T ❌
- Zeichenketten in Komponenten hartkodieren
- Übersetzte Zeichenketten konkatenieren
- Textlänge annehmen (Deutsch ist 30% länger)
- RTL-Layout vergessen
- Sprachen in derselben Datei mischen
Fehlerbehebung
Problem: Der Betreiber hat den importierten Kontext übersprungen und zu allgemein geantwortet
Symptome: Das Ergebnis ignoriert den Upstream-Workflow in plugins/antigravity-awesome-skills-claude/skills/i18n-localization, erwähnt die Herkunft nicht oder verwendet gar keine kopierten Quelldateien.
Lösung: Öffnen Sie metadata.json, ORIGIN.md und die relevantesten kopierten Upstream-Dateien erneut. Überprüfen Sie zuerst den external_source-Block und wiederholen Sie dann die Herkunftsangabe, bevor Sie fortfahren.
Problem: Der importierte Workflow fühlt sich bei 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 relevant sind.
Lösung: Zeigen Sie auf die genauen kopierten Referenzen, Beispiele, Skripte oder Assets, die den von Ihnen eingeschlagenen Weg rechtfertigen. Wenn die Lücke dennoch real ist, dokumentieren Sie sie im PR, anstatt sie zu verbergen.
Problem: Die Aufgabe driftete in eine andere Spezialisierung ab
Symptome: Der importierte Skill beginnt an der richtigen Stelle, aber die Arbeit wandelt sich zu Debugging, Architektur, Design, Sicherheit oder Release-Orchestrierung, die ein nativer Skill besser handhabt. Lösung: Verwenden Sie den Abschnitt „Verwandte Skills", um bewusst zu übergeben. Halten Sie die importierte Herkunft sichtbar, damit der nächste Skill den richtigen Kontext erbt, anstatt blind zu beginnen.
Verwandte Skills
@00-andruia-consultant- Verwenden, wenn die Arbeit besser von dieser nativen Spezialisierung bearbeitet wird, nachdem dieser importierte Skill den Kontext hergestellt hat.@00-andruia-consultant-v2- Verwenden, wenn die Arbeit besser von dieser nativen Spezialisierung bearbeitet wird, nachdem dieser importierte Skill den Kontext hergestellt hat.@10-andruia-skill-smith- Verwenden, wenn die Arbeit besser von dieser nativen Spezialisierung bearbeitet wird, nachdem dieser importierte Skill den Kontext hergestellt hat.@10-andruia-skill-smith-v2- Verwenden, wenn die Arbeit besser von dieser nativen Spezialisierung bearbeitet wird, nachdem dieser importierte Skill den Kontext hergestellt hat.
Zusätzliche Ressourcen
Verwenden Sie diese Support-Matrix und die verlinkten Dateien unten als Betreiberpaket für diesen importierten Skill. Sie sollten echtes kopiertes Quellmaterial widerspiegeln, keine generischen Gerüste.
| Ressourcenfamilie | Was sie dem Prüfer gibt | Beispielpfad |
|---|---|---|
references | kopierte Referenznotizen, Anleitungen oder Hintergrundmaterial aus Upstream | references/n/a |
examples | ausgearbeitete Beispiele oder wiederverwendbare Prompts aus Upstream | examples/n/a |
scripts | Upstream-Hilfsskripte, die Ausführung oder Validierung ändern | scripts/i18n_checker.py |
agents | Routing- oder Delegationsnotizen, die tatsächlich Teil des importierten Pakets sind | agents/n/a |
assets | unterstützende Assets oder Schemata, die aus dem Quellpaket kopiert wurden | 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(_("Willkommen in unserer 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 | Rückfall auf Standardsprache |
| Hartkodierte Zeichenketten | Linter/Checker-Skript verwenden |
| Datumsformat | Intl.DateTimeFormat verwenden |
| Zahlenformat | Intl.NumberFormat verwenden |
| Pluralisierung | ICU-Nachrichtenformat verwenden |
Importiert: 7. RTL-Unterstützung
/* CSS Logische Eigenschaften */
.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 dem Ausliefern:
- Alle benutzersichtbaren Zeichenketten verwenden Übersetzungsschlüssel
- Locale-Dateien existieren für alle unterstützten Sprachen
- Datums-/Zahlenformatierung verwendet Intl-API
- RTL-Layout getestet (falls zutreffend)
- Rückfallsprache konfiguriert
- Keine hartkodierten Zeichenketten in Komponenten
Importiert: Skript
| Skript | Zweck | Befehl |
|---|---|---|
scripts/i18n_checker.py | Hartkodierte Zeichenketten & fehlende Übersetzungen erkennen | python scripts/i18n_checker.py <project_path> |
Importiert: Einschränkungen
- Verwenden Sie diesen Skill nur, wenn die Aufgabe klar dem oben beschriebenen Umfang entspricht.
- Behandeln Sie die Ausgabe nicht als Ersatz für umgebungsspezifische Validierung, Tests oder Expertenüberprüfung.
- Stoppen Sie und fragen Sie nach Klärung, wenn erforderliche Eingaben, Berechtigungen, Sicherheitsgrenzen oder Erfolgskriterien fehlen.