Communitygithub.com

zhcmeng/shared-skills

Cuando el usuario solicita traducir un documento en inglés al chino, generar un archivo con el sufijo `-中文版`, o traducir uno a uno un archivo Markdown en inglés (especialmente SKILL.md, documentación técnica). Palabras clave: traducción, chino, versión china, zh-CN, translate, one-to-one.

¿Qué es shared-skills?

Este skill está diseñado para realizar traducciones uno a uno de documentos Markdown en inglés al chino, generando un archivo con el sufijo `-中文版` en el mismo directorio que el original. Es particularmente útil para desarrolladores y equipos que trabajan con documentación técnica, SKILL.md de agentes de IA, o cualquier otro contenido Markdown que requiera una traducción precisa y estructurada. El skill soporta plataformas como Claude Code, Cursor y otras herramientas de agentes de IA que permitan la invocación de subagentes. Su funcionamiento se basa en un flujo de trabajo que delega la traducción a subagentes (modelo 'haiku'), manteniendo el agente principal solo para coordinar y validar los resultados. Las reglas de traducción son estrictas: se preserva la estructura del Markdown (títulos, listas, tablas, bloques de código, etc.), no se traduce código ni contenido inline en inglés, se inserta un bloque de cita al inicio del archivo traducido indicando que es una traducción, y se manejan términos técnicos con una notación bilingüe en su primera aparición. El agente principal no lee ni traduce el contenido original, evitando así consumir contexto innecesario.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/zhcmeng/shared-skills/tree/HEAD/plugin/skills/translate-docs

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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:

  1. Resultado: Archivo en inglés X.md → X-中文版.md en el mismo directorio.
  2. Frontmatter: name: se conserva en inglés original; description: se traduce al chino; otros campos (si los hay) se traducen según su valor.
  3. 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>`.
  4. 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.
  5. 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.
  6. 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.
  7. Tablas: Los encabezados y las celdas de texto se traducen; las celdas que contienen solo código, rutas o identificadores se conservan.
  8. Enlaces: La URL se conserva, el texto del enlace se traduce.
  9. 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.
  10. 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.

  1. 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 su SKILL.md). Si $ARGUMENTS está vacío, significa que no se proporcionó ningún objetivo al invocar el skill; entonces se debe generar un error y salir, sin adivinar.
  2. Determinar los archivos a traducir:
    • Documento único → ese archivo (1 solo).
    • Directorio → listar todos los .md del directorio, excluyendo aquellos que ya tengan un correspondiente -中文版.md (saltar los existentes, no retraducir).
  3. 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).
  4. Validar e informar: Después de que los subagentes devuelvan los resultados, este agente ejecuta una verificación diff para 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 del SKILL.md de 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.

Skills relacionados