i18n-expert

This skill should be used when setting up, auditing, or enforcing internationalization/localization in UI codebases (React/TS, i18next or similar, JSON locales), including installing/configuring the i18n framework, replacing hard-coded strings, ensuring en-US/zh-CN coverage, mapping error codes to localized messages, and validating key parity, pluralization, and formatting.

1. Określ zakres projektu: potwierdź używaną bibliotekę (React, Next.js, Vue), obecny stan i18n (brak, częściowy, legacy), docelowe języki (domyślnie en-US i zh-CN) oraz format plików lokalizacyjnych (JSON, YAML, PO, XLIFF). Jeśli masz specjalne wymagania dotyczące formalności lub kulturowych różnic, podaj je teraz.

2. Skonfiguruj bazę i18n, jeśli brakuje: umiejętność wybierze odpowiednią bibliotekę dla twojego frameworka, zainstaluje pakiety, utworzy plik konfiguracyjny i18n, podłączy providera do głównego komponentu aplikacji oraz załaduje zasoby lokalizacyjne.

3. Zorganizuj strukturę kluczy i pliki lokalizacyjne: ustal schemat nazewnictwa kluczy, utwórz katalogi dla każdego języka, podziel tłumaczenia na moduły (np. common, errors, forms) i zdefiniuj strategię routingu świadomego języka (ścieżka, subdomena lub parametr).

4. Zastąp ciągi znaków kluczami: umiejętność przeskanuje kod, znajdzie wszystkie twarde ciągi znaków widoczne dla użytkownika i zastąpi je odwołaniami do kluczy i18n, zapewniając spójność w całej aplikacji.

5. Wygeneruj i waliduj tłumaczenia: wybierz strategię tłumaczenia (AI, profesjonalne, ręczne), upewnij się, że wszystkie klucze istnieją we wszystkich docelowych językach, sprawdź poprawność pluralizacji i formatowania dat/liczb dla każdego języka.

6. Dodaj przełącznik języka i trwałość: skonfiguruj selektor języka dostępny dla użytkownika, ustaw przechowywanie preferencji (localStorage, cookie lub parametr URL) i przetestuj zmianę języka w całej aplikacji.