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.
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.
/i18n-review src/
/i18n-review src/ --framework=next-intlQuè 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
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.
/i18n-wrap src/components/
/i18n-wrap src/ --framework=react-i18nextQuè 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ó
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 treball | Funció de traducció | Format de plural |
|---|---|---|
| react-i18next | t() | key_one / key_other |
| next-intl | t() | ICU {count, plural, ...} |
| vue-i18n | $t() | Pipe syntax | singular | plural |
| angular i18n | $localize | ICU {count, plural, ...} |
| svelte-i18n | $_() | ICU {count, plural, ...} |
| flutter intl | S.of(context) | Intl.plural() |
| django | gettext / _() | ngettext() |
| rails i18n | t() | count key |
| laravel | __() / @lang | trans_choice() |
| swift | NSLocalizedString | .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.
mkdir -p .claude/commands
cp commands/i18n-review.md .claude/commands/
cp commands/i18n-wrap.md .claude/commands/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.
# 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.jsonProjecte 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.
# 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 updatedGuies d’entorns de treball relacionades
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ó