Skip to main content

Dovednosti i18n

AI příkazy pro audit a obalování i18n řetězců

Problém

Váš kód obsahuje 500 hardcodovaných řetězců roztroušených po komponentách, šablonách a views. Ruční obalování zabere dny únavné práce ve stylu find-and-replace. I po obalení Vám stále uniknou rozdělené věty, které se v němčině rozbijí, logika plurálů, která selhává v arabštině, a osiřelé klíče, které nafukují soubory lokálů.

Ruční obalování i18n je náchylné k chybám: vývojáři přehlédnou rozdělené věty, ternárními operátory rozbijí plurály a v okrajových případech nechají natvrdo zadané řetězce. Tyto chyby se projeví až po překladu, kdy je jejich oprava 10× dražší.

Řešení

Dva AI slash příkazy, které pokryjí celý i18n workflow. Spusťte /i18n-review pro audit pouze pro čtení a poté /i18n-wrap, který vše automaticky opraví. Oba příkazy detekují Váš framework, rozumí formátu Vašich locale souborů a před potvrzením ověří změny.

/i18n-review

Audit pouze pro čtení, který najde rozdělené věty, rozbité plurály, neobalené řetězce a nepoužívané klíče. Váš kód nikdy neupravuje.

/i18n-wrap

Automaticky obalí natvrdo zadané řetězce správnou překladovou funkcí, vygeneruje sémantické klíče, aktualizuje locale soubory a ověří build.

Příkaz /i18n-review

Příkaz /i18n-review provede audit Vašeho kódu pouze pro čtení. Prohledá každý soubor kvůli problémům s i18n a vytvoří prioritizovanou zprávu s přesnými umístěními v souborech a návrhy oprav. Váš kód se nikdy neupravuje.

Terminal
/i18n-review src/
/i18n-review src/ --framework=next-intl

Co kontroluje

  • Rozdělené věty: zřetězená volání t(), která v jiných jazycích rozbíjejí slovosled
  • Přehnané obalování: technické řetězce, CSS třídy, URL a hodnoty enumů omylem obalené pomocí t()
  • Nedostatečné obalování: viditelné UI řetězce, jako jsou popisky tlačítek, nadpisy a chybové zprávy, ponechané natvrdo
  • Problémy s plurály: ternární operátory nebo kontroly === 1 místo správné ICU plural syntaxe
  • Nepoužívané klíče: překladové klíče definované v locale souborech, ale nikdy neodkazované v kódu
  • Natvrdo zadané formátované hodnoty: data, měny a čísla, která nepoužívají formátovače Intl
Příkaz /i18n-review je kompletně pouze pro čtení. Spouštějte jej, jak často chcete, během vývoje nebo v CI/CD pipelines, bez rizika nechtěných změn.

Příkaz /i18n-wrap

Příkaz /i18n-wrap automaticky obalí natvrdo zadané řetězce správnou překladovou funkcí pro Váš framework. Detekuje Vaši i18n knihovnu, vygeneruje sémantické klíče seskupené podle komponenty nebo funkcionality, aktualizuje Vaše locale soubory a ověří, že build stále prochází.

Terminal
/i18n-wrap src/components/
/i18n-wrap src/ --framework=react-i18next

Co dělá

  • Detekce frameworku: identifikuje Vaši i18n knihovnu a její překladovou funkci (t, $t, $_, gettext atd.)
  • Generování sémantických klíčů: vytváří smysluplné klíče jako nav.signIn a errors.notFound místo obecných štítků
  • Aktualizace locale souborů: přidává nové klíče do zdrojového locale souboru ve správném formátu (JSON, YAML, PO atd.)
  • Validace buildu: po obalení spustí Váš build, lint a testovací příkazy, aby zachytil regresi
Příkaz /i18n-wrap ověřuje každou změnu spuštěním buildu a test suite. Pokud něco selže, automaticky vše vrátí zpět.

Podporované frameworky

Oba příkazy automaticky detekují Váš framework z projektových závislostí. Můžete jej také explicitně zadat pomocí přepínače --framework. Zde je 10 podporovaných frameworků s jejich překladovými funkcemi a formáty plurálů.

FrameworkPřekladová funkceFormát plurálu
react-i18nextt()key_one / key_other
next-intlt()ICU {count, plural, ...}
vue-i18n$t()Pipe syntax | singular | plural
angular i18n$localizeICU {count, plural, ...}
svelte-i18n$_()ICU {count, plural, ...}
flutter intlS.of(context)Intl.plural()
djangogettext / _()ngettext()
rails i18nt()count key
laravel__() / @langtrans_choice()
swiftNSLocalizedString.stringsdict

Instalace

Zkopírujte soubory příkazů do adresáře .claude/commands/. Hotovo — žádné závislosti, žádná konfigurace. Příkazy jsou prosté Markdown soubory, které může spustit jakýkoli AI coding assistant.

Terminal
mkdir -p .claude/commands
cp commands/i18n-review.md .claude/commands/
cp commands/i18n-wrap.md .claude/commands/
Jde o standardní soubory slash příkazů. V Claude Code fungují hned po instalaci a lze je přizpůsobit i pro jiné AI coding assistenty, které podporují vlastní příkazy.

Příklady použití

React projekt

Proveďte audit React aplikace používající react-i18next a poté obalte všechny natvrdo zadané řetězce. Příkazy detekují react-i18next z Vašeho package.json a použijí správnou funkci t() i plural formát key_one/key_other.

React Project
# Review a React project for i18n issues
/i18n-review src/ --framework=react-i18next

# Wrap all hardcoded strings automatically
/i18n-wrap src/components/ --framework=react-i18next

# Result: t() calls inserted, keys added to en/translation.json

Django projekt

Proveďte audit Django templates a views kvůli problémům s i18n a poté obalte řetězce pomocí gettext. Příkazy detekují Django ze settings.py a používají _() pro jednoduché řetězce a ngettext() pro plurály.

Django Project
# Review Django templates and views
/i18n-review myapp/ --framework=django

# Wrap hardcoded strings with gettext
/i18n-wrap myapp/templates/ --framework=django

# Result: _() calls inserted, .po file updated

Související průvodce pro frameworky

Průvodce i18n pro ReactPrůvodce i18n pro Next.jsPrůvodce lokalizací pro iOSPrůvodce lokalizací pro Android

Vyzkoušejte i18n Agent nyní

Sem přetáhněte svůj překladový soubor

JSON, YAML, PO, XML, CSV, Markdown, Properties

nebo klikněte a vyberte soubor

Cílové jazyky

Bez registraceOkamžitý odhad

Často kladené otázky