i18n & Localisation
Aperçu
Cette copie d'entrée publique empaquette plugins/antigravity-awesome-skills-claude/skills/i18n-localization depuis https://github.com/sickn33/antigravity-awesome-skills dans le format éditorial natif d'Omni Skills sans en cacher l'origine.
Utilisez-la lorsque l'opérateur a besoin que le workflow amont, les fichiers de support et le contexte du dépôt restent intacts pendant que le validateur public et l'améliorateur privé poursuivent leur flux aval normal.
Cette entrée conserve les fichiers amont copiés intacts et utilise le bloc external_source dans metadata.json ainsi que ORIGIN.md comme ancrage de provenance pour la relecture.
i18n & Localisation > Internationalisation (i18n) et Localisation (L10n) — bonnes pratiques. ---
Les sections sources importées qui n'ont pas été proprement mappées sur les en-têtes publics sont néanmoins conservées ci-dessous ou dans les fichiers de support. Sections importées notables : 1. Concepts fondamentaux, 3. Patrons d'implémentation, 4. Structure de fichiers, 6. Problèmes courants, 7. Support RTL, 8. Checklist.
Quand utiliser cette compétence
Utilisez cette section comme filtre de déclenchement. Elle doit rendre explicite la limite d'activation avant que l'opérateur charge des fichiers, exécute des commandes ou ouvre une pull request.
- Type de projet - i18n nécessaire ?
- Application web publique - ✅ Oui
- Produit SaaS - ✅ Oui
- Outil interne - ⚠️ Peut-être
- Application mono-région - ⚠️ Considérer le futur
- Projet personnel - ❌ Optionnel
Tableau d'opération
| Situation | Commencer ici | Pourquoi c'est important |
|---|---|---|
| Première utilisation | metadata.json | Confirme le dépôt, la branche, le commit et le chemin importé via le bloc external_source avant de toucher au workflow copié |
| Relecture de provenance | ORIGIN.md | Fournit aux relecteurs une piste d'audit en langage clair pour la source importée |
| Exécution du workflow | scripts/i18n_checker.py | Commence par le plus petit fichier copié qui modifie matériellement l'exécution |
| Contexte de support | scripts/i18n_checker.py | Ajoute le fichier source copié le plus pertinent suivant sans charger la totalité du package |
| Décision de passation | ## Compétences connexes | Aide l'opérateur à basculer vers une compétence native plus forte lorsque la tâche dérive |
Workflow
Ce workflow est intentionnellement à la fois éditorial et opérationnel. Il maintient l'utilité de la source importée pour l'opérateur tout en satisfaisant aux normes d'entrée publique qui alimentent le flux aval de l'améliorateur.
- Confirmer l'objectif de l'utilisateur, le périmètre du workflow importé et si cette compétence est encore le bon routeur pour la tâche.
- Lire les fichiers d'aperçu et de provenance avant de charger les fichiers de support amont copiés.
- Charger uniquement les références, exemples, invites ou scripts qui modifient matériellement le résultat pour la demande en cours.
- Exécuter le workflow amont tout en gardant la provenance et les limites source explicites dans les notes de travail.
- Valider le résultat par rapport aux attentes amont et aux preuves que vous pouvez citer dans les fichiers copiés.
- Escalader ou passer à une compétence connexe lorsque le travail sort du centre de gravité de ce workflow importé.
- Avant la fusion ou la clôture, enregistrer ce qui a été utilisé, ce qui a changé et ce que le relecteur doit encore vérifier.
Notes sur le workflow importé
Importée : 1. Concepts fondamentaux
| Terme | Signification |
|---|---|
| i18n | Internationalisation - rendre l'application traduisible |
| L10n | Localisation - traductions réelles |
| Locale | Langue + Région (en-US, tr-TR) |
| RTL | Langues de droite à gauche (arabe, hébreu) |
Exemples
Exemple 1 : Demander directement le workflow amont
Utilisez @i18n-localization pour gérer <tâche>. Commencez par le workflow amont copié, chargez uniquement les fichiers qui modifient le résultat et maintenez la provenance visible dans la réponse.
Explication : C'est le point de départ le plus sûr lorsque l'opérateur a besoin du workflow importé, mais pas de l'ensemble du dépôt.
Exemple 2 : Demander une relecture basée sur la provenance
Relisez @i18n-localization par rapport à metadata.json et ORIGIN.md, puis expliquez quels fichiers amont copiés vous chargeriez en premier et pourquoi.
Explication : À utiliser avant une relecture ou un dépannage lorsque vous avez besoin d'une explication précise et vérifiable de l'origine et de la sélection des fichiers.
Exemple 3 : Réduire les fichiers de support copiés avant l'exécution
Utilisez @i18n-localization pour <tâche>. Chargez uniquement les références, exemples ou scripts copiés qui modifient le résultat, et nommez les fichiers explicitement avant de procéder.
Explication : Cela maintient la compétence alignée sur une divulgation progressive au lieu de charger tout le package copié par défaut.
Exemple 4 : Construire un dossier de relecture
Relisez @i18n-localization en utilisant les fichiers amont copiés plus la provenance, puis résumez les éventuels écarts avant la fusion.
Explication : Utile lorsque la PR attend une relecture humaine et que vous souhaitez un dossier d'audit reproductible.
Bonnes pratiques
Traitez la compétence publique générée comme une couche d'empaquetage révisable autour du dépôt amont. L'objectif est de maintenir la provenance explicite et de ne charger que le matériel source copié qui améliore matériellement l'exécution.
- Utiliser des clés de traduction, pas du texte brut
- Espacer les traductions par fonctionnalité
- Gérer la pluralisation
- Gérer les formats de date/chiffres par locale
- Planifier le RTL dès le départ
- Utiliser le format de message ICU pour les chaînes complexes
- Chaînes codées en dur dans les composants
Notes d'opération importées
Importée : 5. Bonnes pratiques
À FAIRE ✅
- Utiliser des clés de traduction, pas du texte brut
- Espacer les traductions par fonctionnalité
- Gérer la pluralisation
- Gérer les formats de date/chiffres par locale
- Planifier le RTL dès le départ
- Utiliser le format de message ICU pour les chaînes complexes
À NE PAS FAIRE ❌
- Coder en dur des chaînes dans les composants
- Concaténer des chaînes traduites
- Supposer une longueur de texte (l'allemand est 30% plus long)
- Oublier la mise en page RTL
- Mélanger les langues dans le même fichier
Dépannage
Problème : L'opérateur a ignoré le contexte importé et a répondu de manière trop générique
Symptômes : Le résultat ignore le workflow amont dans plugins/antigravity-awesome-skills-claude/skills/i18n-localization, ne mentionne pas la provenance ou n'utilise aucun fichier source copié.
Solution : Rouvrez metadata.json, ORIGIN.md et les fichiers amont copiés les plus pertinents. Vérifiez d'abord le bloc external_source, puis reformulez la provenance avant de continuer.
Problème : Le workflow importé semble incomplet lors de la relecture
Symptômes : Les relecteurs voient le SKILL.md généré, mais ne peuvent pas déterminer rapidement quelles références, exemples ou scripts sont importants pour la tâche en cours.
Solution : Pointez vers les références, exemples, scripts ou assets copiés exacts qui justifient la voie que vous avez prise. Si l'écart est réel, enregistrez-le dans la PR au lieu de le cacher.
Problème : La tâche a dévié vers une spécialisation différente
Symptômes : La compétence importée commence au bon endroit, mais le travail se transforme en débogage, architecture, conception, sécurité ou orchestration de version qu'une compétence native gère mieux. Solution : Utilisez la section des compétences connexes pour passer délibérément. Maintenez la provenance importée visible afin que la compétence suivante hérite du bon contexte au lieu de partir de zéro.
Compétences connexes
@00-andruia-consultant- À utiliser lorsque le travail est mieux géré par cette spécialisation native après que cette compétence importée a établi le contexte.@00-andruia-consultant-v2- À utiliser lorsque le travail est mieux géré par cette spécialisation native après que cette compétence importée a établi le contexte.@10-andruia-skill-smith- À utiliser lorsque le travail est mieux géré par cette spécialisation native après que cette compétence importée a établi le contexte.@10-andruia-skill-smith-v2- À utiliser lorsque le travail est mieux géré par cette spécialisation native après que cette compétence importée a établi le contexte.
Ressources supplémentaires
Utilisez cette matrice de support et les fichiers liés ci-dessous comme dossier opérateur pour cette compétence importée. Ils doivent refléter le matériel source copié réel, pas un échafaudage générique.
| Famille de ressources | Ce qu'elle donne au relecteur | Chemin exemple |
|---|---|---|
references | notes de référence, guides ou matériel de fond copiés de l'amont | references/n/a |
examples | exemples travaillés ou invites réutilisables copiés de l'amont | examples/n/a |
scripts | scripts d'aide amont qui modifient l'exécution ou la validation | scripts/i18n_checker.py |
agents | notes de routage ou de délégation qui font vraiment partie du package importé | agents/n/a |
assets | assets de support ou schémas copiés du package source | assets/n/a |
Notes de référence importées
Importée : 3. Patrons d'implémentation
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(_("Bienvenue dans notre application"))
Importée : 4. Structure de fichiers
locales/
├── en/
│ ├── common.json
│ ├── auth.json
│ └── errors.json
├── tr/
│ ├── common.json
│ ├── auth.json
│ └── errors.json
└── ar/ # RTL
└── ...
Importée : 6. Problèmes courants
| Problème | Solution |
|---|---|
| Traduction manquante | Repli sur la langue par défaut |
| Chaînes codées en dur | Utiliser un linter/script de vérification |
| Format de date | Utiliser Intl.DateTimeFormat |
| Format de nombre | Utiliser Intl.NumberFormat |
| Pluralisation | Utiliser le format de message ICU |
Importée : 7. Support RTL
/* Propriétés logiques CSS */
.container {
margin-inline-start: 1rem; /* Pas margin-left */
padding-inline-end: 1rem; /* Pas padding-right */
}
[dir="rtl"] .icon {
transform: scaleX(-1);
}
Importée : 8. Checklist
Avant la livraison :
- Toutes les chaînes visibles par l'utilisateur utilisent des clés de traduction
- Les fichiers de locale existent pour toutes les langues prises en charge
- Le formatage des dates/nombres utilise l'API Intl
- La mise en page RTL a été testée (si applicable)
- La langue de repli est configurée
- Aucune chaîne codée en dur dans les composants
Importée : Script
| Script | Objectif | Commande |
|---|---|---|
scripts/i18n_checker.py | Détecter les chaînes codées en dur et les traductions manquantes | python scripts/i18n_checker.py <chemin_du_projet> |
Importée : Limitations
- Utilisez cette compétence uniquement lorsque la tâche correspond clairement au périmètre décrit ci-dessus.
- Ne considérez pas le résultat comme un substitut à la validation, aux tests ou à la relecture par un expert spécifiques à l'environnement.
- Arrêtez-vous et demandez des clarifications si les entrées requises, les permissions, les limites de sécurité ou les critères de succès sont manquants.