Skip to main content

Habilitats d’i18n

Ordres d’IA per auditar i encapsular cadenes d’i18n

El problema

La seva base de codi conté 500 cadenes escrites directament al codi i escampades entre components, plantilles i vistes. Encapsular-les manualment exigeix dies d’una feina tediosa de cerca i substitució. Fins i tot després d’encapsular-les, encara pot passar per alt frases fragmentades que no funcionen en alemany, lògica de plurals que falla en àrab i claus òrfenes que inflen els fitxers de configuració regional.

L’encapsulació manual per a la i18n és propensa a errors: els desenvolupadors passen per alt frases fragmentades, trenquen els plurals amb operadors ternaris i deixen cadenes escrites directament al codi en casos límit. Aquests errors només afloren després de la traducció, quan corregir-los és 10 vegades més car.

La solució

Dues ordres de barra amb IA que gestionen tot el flux de treball d’i18n. Executi /i18n-review per auditar el codi en mode de només lectura i, tot seguit, executi /i18n-wrap per corregir-ho tot automàticament. Ambdues ordres detecten l’entorn de treball, entenen el format dels fitxers de configuració regional i validen els canvis abans de confirmar-los.

/i18n-review

Auditoria de només lectura que detecta frases fragmentades, plurals incorrectes, cadenes sense encapsular i claus que no s’utilitzen. No modifica mai el codi.

/i18n-wrap

Encapsula automàticament les cadenes escrites directament al codi amb la funció de traducció correcta, genera claus semàntiques, actualitza els fitxers de configuració regional i valida la compilació.

Ordre /i18n-review

L’ordre de revisió duu a terme una auditoria de només lectura de la seva base de codi. Analitza tots els fitxers per detectar-hi problemes d’i18n i genera un informe prioritzat amb les ubicacions exactes dels fitxers i suggeriments de correcció. El seu codi no es modifica mai.

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

Què comprova

  • Frases fragmentades: crides concatenades a t() que alteren l’ordre de les paraules en altres llengües
  • Encapsulació excessiva: cadenes tècniques, classes CSS, URL i valors d’enumeració encapsulats incorrectament amb t()
  • Encapsulació insuficient: cadenes visibles de la interfície, com ara etiquetes de botons, encapçalaments i missatges d’error, escrites directament al codi
  • Problemes de plural: operadors ternaris o comprovacions === 1 en lloc d’una sintaxi de plural d’ICU adequada
  • Claus que no s’utilitzen: claus de traducció definides als fitxers de configuració regional però mai referenciades al codi
  • Valors de format escrits directament al codi: dates, monedes i nombres que no fan servir els formatadors d’Intl
L’ordre de revisió funciona exclusivament en mode de lectura. Executi-la tantes vegades com vulgui durant el desenvolupament o en canalitzacions de CI/CD, sense risc de canvis involuntaris.

Ordre /i18n-wrap

L’ordre d’encapsulació encapsula automàticament les cadenes escrites directament al codi amb la funció de traducció correcta per al seu entorn de treball. Detecta la biblioteca d’i18n, genera claus semàntiques agrupades per component o funcionalitat, actualitza els fitxers de configuració regional i valida que la compilació continuï funcionant.

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

Què fa

  • Detecció de l’entorn de treball: identifica la biblioteca d’i18n i la funció de traducció corresponent (t, $t, $_, gettext, etc.)
  • Generació de claus semàntiques: crea claus significatives com nav.signIn i errors.notFound en lloc d’etiquetes genèriques
  • Actualització dels fitxers de configuració regional: afegeix claus noves al fitxer de configuració regional d’origen en el format correcte (JSON, YAML, PO, etc.)
  • Validació de la compilació: executa les ordres de compilació, anàlisi estàtica i proves després de l’encapsulació per detectar qualsevol regressió
L’ordre d’encapsulació valida cada canvi executant la compilació i el conjunt de proves. Si alguna cosa falla, desfà els canvis automàticament.

Entorns de treball compatibles

Ambdues ordres detecten automàticament l’entorn de treball a partir de les dependències del projecte. També pot indicar-lo explícitament amb l’opció --framework. Aquests són els 10 entorns de treball compatibles, amb les funcions de traducció i els formats de plural corresponents.

Entorn de treballFunció de traduccióFormat de plural
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

Instal·lació

Copiï els fitxers d’ordres al directori .claude/commands/. Això és tot: no calen dependències ni configuració. Les ordres són fitxers Markdown senzills que qualsevol assistent de programació amb IA pot executar.

Terminal
mkdir -p .claude/commands
cp commands/i18n-review.md .claude/commands/
cp commands/i18n-wrap.md .claude/commands/
Són fitxers d’ordres de barra estàndard. Funcionen directament amb Claude Code i es poden adaptar a altres assistents de programació amb IA que admetin ordres personalitzades.

Exemples d’ús

Projecte React

Revisi una aplicació React que utilitzi react-i18next i, tot seguit, encapsuli totes les cadenes escrites directament al codi. Les ordres detecten react-i18next a partir del fitxer package.json i utilitzen la funció t() correcta i el format de plural 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

Projecte Django

Auditi les plantilles i les vistes de Django per detectar-hi problemes d’i18n i, tot seguit, encapsuli les cadenes amb gettext. Les ordres detecten Django a partir del fitxer settings.py i utilitzen _() per a cadenes simples i ngettext() per als plurals.

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

Provar i18n Agent ara

Arrossegar aquí el fitxer de traducció

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

o fer clic per explorar

Idiomes de destinació

No cal registrePressupost instantani

Preguntes freqüents