Traducir Blog, Traducción de Blogs Optimizada para SEO
Traduce una publicación de blog existente a uno o más idiomas destino. A diferencia de la traducción genérica, esta habilidad produce contenido optimizado para SEO y listo para publicar, con palabras clave localizadas, metaetiquetas y formato culturalmente correcto.
Referencias Clave
Cargar bajo demanda:
references/translation-rules.md, preservación de formato, formatos de número/fecha/moneda por locale, manejo de comillas, criterios de calidad.references/cultural-adaptation.md, perfiles culturales por locale (DACH, Francofonía, Hispanoamérica, Japón, personalizado). Este archivo se comparte conblog-localize(no duplicar).
Flujo de Trabajo
Fase 1: Análisis de Entrada
- Leer el archivo fuente (Markdown, MDX o HTML).
- Detectar automáticamente el idioma fuente. Orden de preferencia:
- Campo
langdel frontmatter. - Atributo
langHTML. - Análisis de contenido (escritura, palabras vacías comunes).
- Campo
- Analizar los idiomas destino de
--tocomo códigos ISO 639-1 separados por comas (de,fr,es,ja,pt-BR). Si falta--to, preguntar al usuario una vez: "¿A qué idiomas debo traducir? Proporcione códigos ISO 639-1 (ej., de, fr, es, ja, pt-BR)." - Validar cada código. Rechazar los inválidos con una sugerencia (
jpse convierte en "¿Quiso decirjapara japonés?"). Si un destino es igual al idioma fuente, omitirlo con un aviso.
Fase 2: Análisis de Contenido
Extraer la superficie traducible:
- Frontmatter:
title,description,tags,author(solo cuando sea traducible, p. ej., etiquetas de rol, no nombres personales). - Todos los encabezados (H1, H2, H3).
- Párrafos del cuerpo.
- Texto
altde imágenes y contenido de<figcaption>. - Contenido de
<text>y<tspan>en gráficos; preservar cada atributo SVG (x,y,font-size,fill,transform). - Preguntas y respuestas de FAQ.
- Texto de cápsulas de citas.
- Conclusiones clave o resumen.
- Texto de CTA.
- Texto de anclaje de zonas de enlaces internos.
Preservar sin cambios:
- Estructura, etiquetas y atributos de Markdown y HTML.
- URLs de imágenes, URLs de enlaces, claves del frontmatter.
- Bloques de código (traducir solo comentarios en línea cuando sea significativo).
- Marcadores de zonas de enlaces internos (
[INTERNAL-LINK: ...]). - Nombres de organizaciones fuente en citas (Gartner, McKinsey, etc.).
- Nombres de personas.
- Bloques de esquema JSON-LD (traducir solo los valores de cadena visibles para el usuario).
Identificar las palabras clave primarias y secundarias para la Fase 3.
Fase 3: Localización de Palabras Clave
Para cada idioma destino:
- Decidir si la palabra clave fuente es el término establecido en el mercado destino. Si es así (p. ej., "Content Marketing" se mantiene en alemán), conservarla.
- Si existe un equivalente local con comportamiento de búsqueda real, cambiarlo.
- Aplicar la misma lógica a las palabras clave secundarias.
- Registrar la asignación. El agente traductor la usa para actualizar el título, la meta descripción y los encabezados H2 de forma coherente.
Fase 4: Traducción
Iniciar el agente blog-translator (mediante Task) para cada idioma destino con:
- El contenido fuente.
- El mapa de localización de palabras clave de la Fase 3.
- El código del idioma destino.
- Punteros a
references/translation-rules.mdy al perfil cultural enreferences/cultural-adaptation.mdsi existe para el locale destino.
Ejecutar los agentes en paralelo al traducir a varios idiomas.
El agente devuelve la publicación completamente traducida en el mismo formato que la entrada.
Fase 5: Post-Procesamiento
Para cada versión traducida:
- Añadir o actualizar el frontmatter de locale:
lang: "es" translatedFrom: "en" translatedDate: "YYYY-MM-DD" slug: "como-evitar-la-basura-de-ia" - Verificar la integridad estructural:
- Mismo número de secciones H2 y H3 que el original.
- Todas las imágenes presentes con texto alt traducido.
- Todos los gráficos SVG presentes con etiquetas de texto traducidas (ajustadas por longitud: DE +30%, FR +15%, JA -20%, otros ver
references/translation-rules.md). - El recuento de FAQ coincide.
- Las cápsulas de citas presentes en cada H2.
- Guardar los archivos traducidos:
Cuando se invoque desdetranslations/ {lang}/{localized-slug}.{ext}blog-multilingual, guardar enmultilingual/{lang}/{localized-slug}.{ext}.
Fase 6: Barreras de Calidad de Traducción
Escanear la salida en busca de artefactos de traducción automática antes de informar como completada:
- Modismos literales (modismos ingleses transliterados, no adaptados).
- Orden de palabras no natural (SOV traducido como SVO en un idioma no SVO, o viceversa).
- Frases en idiomas mezclados (excepto préstamos establecidos).
- Cadenas de números, fechas o monedas aún en el formato fuente.
- Cadenas del frontmatter aún en el idioma fuente.
Señalar cada problema en línea (ruta de archivo, número de línea, sugerencia de corrección). El agente traductor debe volver a pasar cualquier pasaje señalado antes de la entrega.
Fase 7: Entrega
## Traducción completada: [Título original]
### Fuente
- Idioma: [fuente]
- Archivo: [ruta fuente]
### Traducciones
| Idioma | Archivo | Palabras clave adaptadas | Estado |
|--------|---------|--------------------------|--------|
| es | translations/es/{slug}.md | [N] | ok |
| fr | translations/fr/{slug}.md | [N] | ok |
### Controles de calidad
- Integridad estructural: aprobado / fallo por idioma
- Metaetiquetas localizadas: aprobado / fallo por idioma
- Números, fechas, monedas formateados por locale: aprobado / fallo
- Palabras clave localizadas: [N] palabras clave adaptadas
- Artefactos de traducción automática señalados: [N] (ver notas arriba)
### Próximos pasos
- Ejecutar `/blog localize <archivo> --locale <código>` para adaptación cultural profunda.
- Ejecutar `/blog locale-audit translations/` para verificar completitud.
- Usar `/blog multilingual` para combinar escritura, traducción, localización y hreflang en un solo comando.
Manejo de Errores
| Escenario | Acción |
|---|---|
| Código de idioma no soportado | Sugerir el código ISO 639-1 correcto |
| Fuente igual a un destino | Omitir con "La fuente ya está en [idioma]" |
| Archivo no encontrado | Reportar error con ruta sugerida |
| Tiempo de espera del agente traductor | Reintentar una vez, luego reportar resultados parciales |
| Archivo binario o no textual | Reportar error, sugerir archivo correcto |
Referencias Cruzadas
- Siguiente paso (profundidad cultural):
/blog localize <archivo> --locale <código> - Revisión de QA en todas las versiones de idioma:
/blog locale-audit <directorio> - Pipeline de un solo comando:
/blog multilingual <tema> --languages <códigos>