i18n y Localización
Resumen
Esta copia de importación pública empaqueta plugins/antigravity-awesome-skills/skills/i18n-localization de https://github.com/sickn33/antigravity-awesome-skills en la forma editorial nativa de Omni Skills sin ocultar su origen.
Úsela cuando el operador necesite que el flujo de trabajo ascendente, los archivos de soporte y el contexto del repositorio se mantengan intactos, mientras que el validador público y el mejorador privado continúan su flujo descendente normal.
Esta importación mantiene intactos los archivos ascendentes copiados y utiliza el bloque external_source en metadata.json más ORIGIN.md como ancla de procedencia para la revisión.
i18n y Localización > Internacionalización (i18n) y Localización (L10n): mejores prácticas ---
Las secciones importadas que no se asignaron claramente a los encabezados públicos aún se conservan a continuación o en los archivos de soporte. Secciones importadas notables: 1. Conceptos básicos, 3. Patrones de implementación, 4. Estructura de archivos, 6. Problemas comunes, 7. Soporte RTL, 8. Lista de verificación.
Cuándo usar esta habilidad
Use esta sección como filtro de activación. Debe hacer explícito el límite de activación antes de que el operador cargue archivos, ejecute comandos o abra una solicitud de extracción.
- Tipo de proyecto - ¿Necesita i18n?
- Aplicación web pública - ✅ Sí
- Producto SaaS - ✅ Sí
- Herramienta interna - ⚠️ Quizás
- Aplicación de una sola región - ⚠️ Considere el futuro
- Proyecto personal - ❌ Opcional
Tabla de operación
| Situación | Comience aquí | Por qué es importante |
|---|---|---|
| Primer uso | metadata.json | Confirma el repositorio, la rama, la confirmación y la ruta importada a través del bloque external_source antes de tocar el flujo de trabajo copiado |
| Revisión de procedencia | ORIGIN.md | Proporciona a los revisores un rastro de auditoría en lenguaje sencillo para la fuente importada |
| Ejecución del flujo de trabajo | scripts/i18n_checker.py | Comienza con el archivo copiado más pequeño que cambia materialmente la ejecución |
| Contexto de soporte | scripts/i18n_checker.py | Agrega el siguiente archivo fuente copiado más relevante sin cargar todo el paquete |
| Decisión de transferencia | ## Habilidades relacionadas | Ayuda al operador a cambiar a una habilidad nativa más sólida cuando la tarea se desvía |
Flujo de trabajo
Este flujo de trabajo es intencionalmente editorial y operativo al mismo tiempo. Mantiene la fuente importada útil para el operador mientras satisface los estándares de importación pública que alimentan el flujo del mejorador descendente.
- Confirme el objetivo del usuario, el alcance del flujo de trabajo importado y si esta habilidad sigue siendo el enrutador correcto para la tarea.
- Lea la descripción general y los archivos de procedencia antes de cargar cualquier archivo de soporte ascendente copiado.
- Cargue solo las referencias, ejemplos, indicaciones o scripts que cambien materialmente el resultado para la solicitud actual.
- Ejecute el flujo de trabajo ascendente manteniendo explícitos la procedencia y los límites de la fuente en las notas de trabajo.
- Valide el resultado con las expectativas ascendentes y la evidencia que pueda señalar en los archivos copiados.
- Escale o transfiera a una habilidad relacionada cuando el trabajo se salga del centro de gravedad de este flujo de trabajo importado.
- Antes de fusionar o cerrar, registre qué se usó, qué cambió y qué aún necesita verificar el revisor.
Notas del flujo de trabajo importado
Importado: 1. Conceptos básicos
| Término | Significado |
|---|---|
| i18n | Internacionalización: hacer que la aplicación sea traducible |
| L10n | Localización: traducciones reales |
| Locale | Idioma + Región (en-US, tr-TR) |
| RTL | Idiomas de derecha a izquierda (árabe, hebreo) |
Ejemplos
Ejemplo 1: Solicitar directamente el flujo de trabajo ascendente
Use @i18n-localization-v2 para manejar <tarea>. Comience desde el flujo de trabajo ascendente copiado, cargue solo los archivos que cambien el resultado y mantenga la procedencia visible en la respuesta.
Explicación: Este es el punto de partida más seguro cuando el operador necesita el flujo de trabajo importado, pero no todo el repositorio.
Ejemplo 2: Solicitar una revisión basada en la procedencia
Revise @i18n-localization-v2 contra metadata.json y ORIGIN.md, luego explique qué archivos ascendentes copiados cargaría primero y por qué.
Explicación: Use esto antes de una revisión o solución de problemas cuando necesite una explicación precisa y auditable del origen y la selección de archivos.
Ejemplo 3: Reducir los archivos de soporte copiados antes de la ejecución
Use @i18n-localization-v2 para <tarea>. Cargue solo las referencias, ejemplos o scripts copiados que cambien el resultado, y nombre los archivos explícitamente antes de continuar.
Explicación: Esto mantiene la habilidad alineada con la divulgación progresiva en lugar de cargar todo el paquete copiado por defecto.
Ejemplo 4: Crear un paquete para el revisor
Revise @i18n-localization-v2 usando los archivos ascendentes copiados más la procedencia, luego resuma cualquier brecha antes de fusionar.
Explicación: Esto es útil cuando la PR espera revisión humana y desea un paquete de auditoría repetible.
Mejores prácticas
Trate la habilidad pública generada como una capa de empaquetado revisable alrededor del repositorio ascendente. El objetivo es mantener explícita la procedencia y cargar solo el material fuente copiado que mejore materialmente la ejecución.
- Use claves de traducción, no texto sin formato
- Espacio de nombres de traducciones por funcionalidad
- Soporte para pluralización
- Maneje formatos de fecha/número por configuración regional
- Planifique RTL desde el principio
- Use el formato de mensaje ICU para cadenas complejas
- Cadenas hardcodeadas en componentes
Notas operativas importadas
Importado: 5. Mejores prácticas
HAGA ✅
- Use claves de traducción, no texto sin formato
- Espacio de nombres de traducciones por funcionalidad
- Soporte para pluralización
- Maneje formatos de fecha/número por configuración regional
- Planifique RTL desde el principio
- Use el formato de mensaje ICU para cadenas complejas
NO HAGA ❌
- Cadenas hardcodeadas en componentes
- Concatenar cadenas traducidas
- Asumir longitud de texto (el alemán es un 30% más largo)
- Olvidar el diseño RTL
- Mezclar idiomas en el mismo archivo
Solución de problemas
Problema: El operador omitió el contexto importado y respondió de manera demasiado genérica
Síntomas: El resultado ignora el flujo de trabajo ascendente en plugins/antigravity-awesome-skills/skills/i18n-localization, no menciona la procedencia o no usa ningún archivo fuente copiado.
Solución: Vuelva a abrir metadata.json, ORIGIN.md y los archivos ascendentes copiados más relevantes. Verifique primero el bloque external_source, luego reafirme la procedencia antes de continuar.
Problema: El flujo de trabajo importado se siente incompleto durante la revisión
Síntomas: Los revisores pueden ver el SKILL.md generado, pero no pueden determinar rápidamente qué referencias, ejemplos o scripts son importantes para la tarea actual.
Solución: Señale las referencias, ejemplos, scripts o activos copiados exactos que justifiquen el camino que tomó. Si la brecha aún es real, regístrela en la PR en lugar de ocultarla.
Problema: La tarea se desvió hacia una especialización diferente
Síntomas: La habilidad importada comienza en el lugar correcto, pero el trabajo se convierte en depuración, arquitectura, diseño, seguridad u orquestación de lanzamientos que una habilidad nativa maneja mejor. Solución: Use la sección de habilidades relacionadas para transferir deliberadamente. Mantenga visible la procedencia importada para que la siguiente habilidad herede el contexto correcto en lugar de comenzar a ciegas.
Habilidades relacionadas
@00-andruia-consultant- Úselo cuando el trabajo sea mejor manejado por esa especialización nativa después de que esta habilidad importada establezca contexto.@00-andruia-consultant-v2- Úselo cuando el trabajo sea mejor manejado por esa especialización nativa después de que esta habilidad importada establezca contexto.@10-andruia-skill-smith- Úselo cuando el trabajo sea mejor manejado por esa especialización nativa después de que esta habilidad importada establezca contexto.@10-andruia-skill-smith-v2- Úselo cuando el trabajo sea mejor manejado por esa especialización nativa después de que esta habilidad importada establezca contexto.
Recursos adicionales
Use esta matriz de soporte y los archivos vinculados a continuación como el paquete del operador para esta habilidad importada. Deben reflejar material fuente copiado real, no andamiaje genérico.
| Familia de recursos | Lo que proporciona al revisor | Ruta de ejemplo |
|---|---|---|
references | notas de referencia, guías o material de fondo copiados del ascendente | references/n/a |
examples | ejemplos trabajados o indicaciones reutilizables copiadas del ascendente | examples/n/a |
scripts | scripts auxiliares ascendentes que cambian la ejecución o validación | scripts/i18n_checker.py |
agents | notas de enrutamiento o delegación que son genuinamente parte del paquete importado | agents/n/a |
assets | activos de soporte o esquemas copiados del paquete fuente | assets/n/a |
Notas de referencia importadas
Importado: 3. Patrones de implementación
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(_("Bienvenido a nuestra aplicación"))
Importado: 4. Estructura de archivos
locales/
├── en/
│ ├── common.json
│ ├── auth.json
│ └── errors.json
├── tr/
│ ├── common.json
│ ├── auth.json
│ └── errors.json
└── ar/ # RTL
└── ...
Importado: 6. Problemas comunes
| Problema | Solución |
|---|---|
| Traducción faltante | Recurrir al idioma predeterminado |
| Cadenas hardcodeadas | Usar script de linter/verificador |
| Formato de fecha | Usar Intl.DateTimeFormat |
| Formato de número | Usar Intl.NumberFormat |
| Pluralización | Usar formato de mensaje ICU |
Importado: 7. Soporte RTL
/* Propiedades lógicas CSS */
.container {
margin-inline-start: 1rem; /* No margin-left */
padding-inline-end: 1rem; /* No padding-right */
}
[dir="rtl"] .icon {
transform: scaleX(-1);
}
Importado: 8. Lista de verificación
Antes de enviar:
- Todas las cadenas orientadas al usuario usan claves de traducción
- Los archivos de configuración regional existen para todos los idiomas admitidos
- El formato de fecha/número usa la API Intl
- Diseño RTL probado (si corresponde)
- Idioma de respaldo configurado
- No hay cadenas hardcodeadas en los componentes
Importado: Script
| Script | Propósito | Comando |
|---|---|---|
scripts/i18n_checker.py | Detectar cadenas hardcodeadas y traducciones faltantes | python scripts/i18n_checker.py <ruta_proyecto> |
Importado: Limitaciones
- Use esta habilidad solo cuando la tarea coincida claramente con el alcance descrito anteriormente.
- No trate el resultado como un sustituto de la validación, pruebas o revisión de expertos específicos del entorno.
- Deténgase y solicite aclaraciones si faltan entradas requeridas, permisos, límites de seguridad o criterios de éxito.