Traducción de documentos en inglés a chino
Resumen
Traduce documentos Markdown en inglés al chino uno a uno, generando un archivo con el nombre -中文版.md (p. ej., X.md → X-中文版.md) en el mismo directorio que el original. El principio fundamental es uno a uno: los niveles de título, párrafos, listas, tablas, bloques de código y diagramas se corresponden exactamente, sin añadir ni eliminar contenido, sin fusionar/dividir párrafos, y sin parafrasear o reorganizar.
Todo el proceso de traducción se realiza dentro de subagentes — este agente solo se encarga de localizar el objetivo, enviar subagentes, validar los resultados e informar al usuario. No lee el texto original, no traduce por sí mismo y no consume contexto de este agente.
Reglas de traducción (norma uno a uno)
Las siguientes reglas son las que deben cumplir los subagentes y también los criterios que este agente utiliza para validar los resultados:
- Resultado: Archivo en inglés
X.md→X-中文版.mden el mismo directorio. - Frontmatter:
name:se conserva en inglés original;description:se traduce al chino; otros campos (si los hay) se traducen según su valor. - Frase explicativa: Después del frontmatter y antes del título principal del contenido, se inserta una línea de bloque de cita:
> 📝 Este documento es la traducción al chino de \`. La versión original en inglés es la autoridad; si hay discrepancias, la versión original prevalece.Si se conoce la versión de origen, se escribe comoTraducido de v<versión>`. - Bloques de código sin traducir: Todo el contenido dentro de bloques de código delimitados (
,dot,mermaid,bash, etc.) se conserva tal cual, sin traducir, sin cambiar la sangría y sin eliminar líneas. - Código en línea se conserva: El contenido dentro de comillas invertidas (nombres de skills, rutas de archivos, comandos, identificadores, URL) se conserva en inglés.
- Primera aparición de términos técnicos: La primera aparición de un término técnico se presenta en el formato «chino (English)», y en adelante solo se usa el chino.
- Tablas: Los encabezados y las celdas de texto se traducen; las celdas que contienen solo código, rutas o identificadores se conservan.
- Enlaces: La URL se conserva, el texto del enlace se traduce.
- Notas al pie: Las definiciones de notas al pie (
[^n]: url) conservan la URL, el texto explicativo se traduce; las referencias en el cuerpo ([^n]) se conservan tal cual. - Saltos de línea: Los saltos de línea duros en el archivo fuente en inglés no se conservan en chino (dentro de un párrafo chino no hay saltos de línea); los límites de párrafo y las líneas en blanco se conservan.
Flujo de trabajo
Tanto si se trata de un solo documento como de un directorio, la traducción se delega siempre a subagentes; este agente no traduce por sí mismo.
- Localizar el objetivo: Tomar
$ARGUMENTS— que puede ser la ruta de un archivo a traducir, un directorio, o el nombre de un skill (p. ej.,superpowers:brainstorming→ localizar suSKILL.md). Si$ARGUMENTSestá vacío, significa que no se proporcionó ningún objetivo al invocar el skill; entonces se debe generar un error y salir, sin adivinar. - Determinar los archivos a traducir:
- Documento único → ese archivo (1 solo).
- Directorio → listar todos los
.mddel directorio, excluyendo aquellos que ya tengan un correspondiente-中文版.md(saltar los existentes, no retraducir).
- Enviar subagentes en paralelo: Por cada archivo a traducir, enviar un subagente de propósito general con
model: "haiku"y usar la plantilla de prompt a continuación con la ruta del archivo objetivo. Enviar todos los subagentes en un solo mensaje (múltiples invocaciones de Agent en paralelo). - Validar e informar: Después de que los subagentes devuelvan los resultados, este agente ejecuta una verificación
diffpara cada resultado (contrastando con las reglas anteriores) para confirmar que la traducción es uno a uno y sin omisiones. Solo informa al usuario del resultado (éxito / fallo / lista de omisiones), sin informar del proceso de traducción.
Plantilla de prompt para el subagente
El subagente de propósito general no hereda las reglas de este skill; el prompt debe ser autónomo:
Eres un agente de traducción de documentos en inglés. Traduce el archivo Markdown en inglés especificado uno a uno al chino, generando un archivo con el nombre `-中文版.md` (p. ej., `X.md` → `X-中文版.md`) en el mismo directorio que el original.
Reglas:
- Uno a uno: niveles de título, párrafos, listas, tablas, bloques de código y diagramas se corresponden exactamente, sin añadir ni eliminar contenido, sin fusionar/dividir párrafos y sin parafrasear o reorganizar.
- Frontmatter: name se conserva en inglés, description se traduce al chino.
- Después del frontmatter y antes del título principal, insertar una línea de bloque de cita: > 📝 Este documento es la traducción al chino de `<nombre del archivo original>`. La versión original en inglés es la autoridad; si hay discrepancias, la versión original prevalece.
- Bloques de código sin traducir: todo el contenido dentro de bloques de código delimitados (incluyendo dot/mermaid) se conserva tal cual.
- Código en línea se conserva en inglés (nombres de skills, rutas de archivos, comandos, URL).
- Primera aparición de términos técnicos: usar formato «chino (English)».
- Tablas: traducir texto, conservar código; enlaces: conservar URL, traducir texto; notas al pie: conservar URL, traducir explicación.
- Sin saltos de línea duros dentro de los párrafos en chino.
Archivo objetivo: <ruta absoluta>
Traduce solo este archivo. Al terminar, devuelve una línea de resumen (nombre de archivo + éxito/fallo).
Restricciones
- La regla uno a uno es un requisito estricto: no se añade ni elimina contenido, no se fusionan o dividen párrafos, y no se parafrasea ni reorganiza.
- Los bloques de código nunca se traducen (incluyendo diagramas dot/mermaid; las etiquetas de los nodos dentro de los diagramas también se conservan en inglés).
- Los nombres de archivo/rutas/nombres de skills/comandos en inglés se conservan siempre.
- El proceso de traducción se realiza siempre dentro de los subagentes; este agente no lee el texto original ni traduce por sí mismo.
- El objeto de traducción proviene de
$ARGUMENTS; si es un nombre de skill (p. ej.,superpowers:brainstorming), el sistema localiza automáticamente la ruta delSKILL.mdde ese skill, sin presuponer una ruta absoluta local. - El modo directorio salta por defecto los archivos que ya tienen un correspondiente
-中文版.md; solo cuando el usuario lo solicita explícitamente se sobrescribe la traducción.