i18n & Localisation
Aperçu
Cette copie d'entrée publique empaquette plugins/antigravity-awesome-skills/skills/i18n-localization depuis https://github.com/sickn33/antigravity-awesome-skills dans le format éditorial natif d'Omni Skills sans masquer son 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 plus ORIGIN.md comme ancrage de provenance pour la révision.
i18n & Localisation > Internationalisation (i18n) et Localisation (L10n) - bonnes pratiques ---
Les sections sources importées qui ne correspondaient pas parfaitement aux titres publics sont néanmoins conservées ci-dessous ou dans les fichiers de support. Sections importées notables : 1. Concepts fondamentaux, 3. Modèles d'implémentation, 4. Structure des fichiers, 6. Problèmes courants, 7. Support RTL, 8. Liste de vérification.
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 ne charge des fichiers, n'exécute des commandes ou n'ouvre une pull request.
- Type de projet - i18n nécessaire ?
- Application web publique - ✅ Oui
- Produit SaaS - ✅ Oui
- Outil interne - ⚠️ Peut-être
- Application monorégion - ⚠️ À considérer pour le futur
- Projet personnel - ❌ Optionnel
Tableau d'exploitation
| Situation | Commencez 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é |
| Révision de provenance | ORIGIN.md | Donne aux réviseurs une piste d'audit en langage simple 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 l'intégralité du paquet |
| Décision de transfert | ## 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 à la fois éditorial et opérationnel. Il maintient l'utilité de la source importée pour l'opérateur tout en satisfaisant les normes d'entrée publique qui alimentent le flux d'amélioration aval.
- Confirmer l'objectif de l'utilisateur, la portée du workflow importé et si cette compétence est toujours le routeur approprié pour la tâche.
- Lire l'aperçu et les fichiers 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 explicites la provenance et les limites de source dans les notes de travail.
- Valider le résultat par rapport aux attentes amont et aux preuves que vous pouvez identifier dans les fichiers copiés.
- Escalader ou transférer vers 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 réviseur doit encore vérifier.
Notes de workflow importées
Importé : 1. Concepts fondamentaux
| Terme | Signification |
|---|---|
| i18n | Internationalisation - rendre l'application traduisible |
| L10n | Localisation - traductions effectives |
| 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-v2 pour gérer <tâche>. Commencez par le workflow amont copié, chargez uniquement les fichiers qui modifient le résultat, et gardez 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'intégralité du dépôt.
Exemple 2 : Demander une révision fondée sur la provenance
Révisez @i18n-localization-v2 par rapport à metadata.json et ORIGIN.md, puis expliquez quels fichiers amont copiés vous chargeriez en premier et pourquoi.
Explication : Utilisez ceci avant une révision 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-v2 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 la divulgation progressive au lieu de charger tout le paquet copié par défaut.
Exemple 4 : Constituer un dossier de révision
Révisez @i18n-localization-v2 en utilisant les fichiers amont copiés plus la provenance, puis résumez les éventuelles lacunes avant la fusion.
Explication : Utile lorsque la PR attend une révision 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 garder la provenance explicite et de ne charger que le matériel source copié qui améliore réellement l'exécution.
- Utiliser des clés de traduction, pas de texte brut
- Espacer les traductions par fonctionnalité
- Prendre en charge la pluralisation
- Gérer les formats de date/numéro 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'exploitation importées
Importé : 5. Bonnes pratiques
À FAIRE ✅
- Utiliser des clés de traduction, pas de texte brut
- Espacer les traductions par fonctionnalité
- Prendre en charge la pluralisation
- Gérer les formats de date/numéro par locale
- Planifier le RTL dès le départ
- Utiliser le format de message ICU pour les chaînes complexes
À ÉVITER ❌
- Chaînes codées en dur dans les composants
- Concaténer des chaînes traduites
- Supposer la longueur du 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/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 révision
Symptômes : Les réviseurs voient le SKILL.md généré, mais ne peuvent pas identifier 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 ressources exacts copiés 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érivé 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 transférer délibérément. Gardez la provenance importée visible pour que la prochaine compétence hérite du bon contexte au lieu de partir de zéro.
Compétences connexes
@00-andruia-consultant- Utilisez 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- Utilisez 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- Utilisez 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- Utilisez 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 du matériel source copié réel, pas un échafaudage générique.
| Famille de ressources | Ce qu'elle donne au réviseur | Chemin d'exemple |
|---|---|---|
references | notes de référence, guides ou documentation de fond copiés depuis l'amont | references/n/a |
examples | exemples travaillés ou invites réutilisables copiés depuis 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 paquet importé | agents/n/a |
assets | ressources ou schémas de support copiés depuis le paquet source | assets/n/a |
Notes de référence importées
Importé : 3. Modèles 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é : 4. Structure des fichiers
locales/
├── en/
│ ├── common.json
│ ├── auth.json
│ └── errors.json
├── tr/
│ ├── common.json
│ ├── auth.json
│ └── errors.json
└── ar/ # RTL
└── ...
Importé : 6. Problèmes courants
| Problème | Solution |
|---|---|
| Traduction manquante | Repli vers la langue par défaut |
| Chaînes codées en dur | Utiliser un script de linting/vérification |
| Format de date | Utiliser Intl.DateTimeFormat |
| Format de nombre | Utiliser Intl.NumberFormat |
| Pluralisation | Utiliser le format de message ICU |
Importé : 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é : 8. Liste de vérification
Avant de publier :
- Toutes les chaînes orientées utilisateur utilisent des clés de traduction
- Les fichiers de paramètres régionaux 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é : 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é : Limitations
- Utilisez cette compétence uniquement lorsque la tâche correspond clairement à la portée décrite ci-dessus.
- Ne considérez pas le résultat comme un substitut à une validation, un test ou une révision d'expert spécifiques à l'environnement.
- Arrêtez-vous et demandez des clarifications si les entrées requises, les autorisations, les limites de sécurité ou les critères de succès sont manquants.