Traduction de documents anglais
Aperçu
Traduit les documents Markdown anglais en chinois, en produisant un fichier du même nom suffixé par -中文版.md (X.md → X-中文版.md) dans le même répertoire que l'original. Le principe essentiel est la traduction mot à mot : titres, paragraphes, listes, tableaux, blocs de code, diagrammes doivent correspondre exactement, sans ajout, suppression, fusion/division de paragraphes, ni reformulation interprétative.
L'ensemble du processus de traduction est effectué par un sous-agent — l'agent principal se charge uniquement de localiser la cible, de déléguer la traduction au sous-agent, de vérifier le résultat et de faire rapport à l'utilisateur. Il ne lit pas le document original, ne traduit pas lui-même et n'utilise pas son propre contexte pour la traduction.
Règles de traduction (norme mot à mot)
Les règles suivantes sont celles que le sous-agent doit respecter et servent également de critères de vérification pour l'agent principal :
- Production : Anglais
X.md→X-中文版.mddans le même répertoire. - Frontmatter :
name:conserve l'original anglais ;description:traduit en chinois ; les autres champs (s'ils existent) sont traduits selon leur valeur. - Phrase d'explication : Après le frontmatter et avant le titre du corps, insérer une ligne de citation :
> 📝 Ce document est la traduction chinoise du fichier \`. La version anglaise fait foi ; en cas de divergence, se référer à l'original.Si la version source est connue, écriretraduit depuis v`. - Blocs de code non traduits : Tout le contenu des blocs de code (```, ```dot, ```mermaid, ```bash, etc.) est conservé tel quel, sans traduction, modification d'indentation ni suppression de lignes.
- Code en ligne conservé : Le contenu entre backticks (nom de skill, chemin de fichier, commande, identifiant, URL) est conservé en anglais.
- Première occurrence des termes : La première occurrence d'un terme technique utilise la forme « chinois (English) », ensuite seul le chinois peut être utilisé.
- Tableaux : Les en-têtes et les cellules textuelles sont traduits ; les cellules contenant uniquement du code, des chemins ou des identifiants sont conservées.
- Liens : L'URL est conservée, le texte du lien est traduit.
- Notes de bas de page : La définition de la note (
[^n] : url) conserve l'URL, le texte explicatif est traduit ; la référence dans le corps ([^n]) est conservée telle quelle. - Retours à la ligne : Les retours à la ligne durs du fichier source anglais ne sont pas conservés en chinois (pas de retour à la ligne à l'intérieur des paragraphes chinois) ; les limites de paragraphes et les lignes vides sont conservées.
Flux de travail
Qu'il s'agisse d'un seul document ou d'un répertoire, la traduction est toujours déléguée à un sous-agent ; l'agent principal ne traduit pas lui-même.
- Localiser la cible : Récupérer
$ARGUMENTS— il s'agit du chemin du fichier à traduire, du répertoire, ou du nom du skill (ex :superpowers:brainstorming→ localiser sonSKILL.md). Si$ARGUMENTSest vide, cela signifie que l'appel n'a pas de cible ; l'agent doit immédiatement signaler une erreur et quitter, sans deviner. - Déterminer les fichiers à traduire :
- Document unique → le fichier lui-même (1 seul).
- Répertoire → lister tous les fichiers
.mddu répertoire, en excluant ceux qui ont déjà un fichier-中文版.mdcorrespondant (sauter les existants, pas de retraduction).
- Déléguer en parallèle au sous-agent : Pour chaque fichier à traduire, déléguer la tâche à un sous-agent généraliste,
model : "haiku", avec le prompt ci-dessous contenant le chemin du fichier cible. Envoyer tous les sous-agents en une seule fois (plusieurs appels Agent en parallèle). - Vérifier et faire rapport : Après le retour des sous-agents, l'agent principal exécute une vérification
diffpour chaque production (en respectant les règles ci-dessus), afin de confirmer une traduction mot à mot sans omission. Il ne fait rapport à l'utilisateur que sur le résultat (succès / échec / liste des omissions), sans décrire le processus de traduction.
Modèle de prompt pour le sous-agent
Le sous-agent généraliste n'hérite pas des règles de cette compétence ; le prompt doit être auto-suffisant :
Vous êtes un agent de traduction de documents anglais. Traduisez le fichier Markdown anglais spécifié en chinois, en produisant un fichier du même nom suffixé par `-中文版.md` (`X.md` → `X-中文版.md`) dans le même répertoire que l'original.
Règles :
- Mot à mot : titres, paragraphes, listes, tableaux, blocs de code, diagrammes doivent correspondre exactement, sans ajout, suppression, fusion/division de paragraphes, ni reformulation interprétative.
- Frontmatter : name conserve l'anglais, description traduit en chinois.
- Après le frontmatter et avant le titre du corps, insérer une ligne de citation : > 📝 Ce document est la traduction chinoise du fichier `<nom du fichier original>`. La version anglaise fait foi ; en cas de divergence, se référer à l'original.
- Blocs de code non traduits : tout le contenu des blocs de code (y compris dot/mermaid) est conservé tel quel.
- Code en ligne conservé en anglais (nom de skill, chemin de fichier, commande, URL).
- Première occurrence des termes : utiliser la forme « chinois (English) ».
- Tableaux : traduire le texte, conserver le code ; liens : conserver l'URL, traduire le texte ; notes : conserver l'URL, traduire l'explication.
- Pas de retour à la ligne dur à l'intérieur des paragraphes chinois.
Fichier cible : <chemin absolu>
Traduisez uniquement ce fichier, puis renvoyez une ligne de résumé (nom du fichier + succès/échec).
Contraintes
- Le mot à mot est une exigence stricte : pas d'ajout ni de suppression de contenu, pas de fusion/division de paragraphes, pas de reformulation interprétative.
- Les blocs de code ne sont jamais traduits (y compris les diagrammes dot/mermaid ; les labels des nœuds dans les diagrammes restent en anglais).
- Les noms de fichiers / chemins / noms de skills / commandes en anglais sont toujours conservés.
- Le processus de traduction est toujours effectué dans un sous-agent ; l'agent principal ne lit pas le document original et ne traduit pas lui-même.
- L'objet de la traduction provient de
$ARGUMENTS; s'il s'agit d'un nom de skill (ex :superpowers:brainstorming), l'agent localise lui-même le chemin du fichierSKILL.mdde ce skill, sans présupposer un chemin absolu local. - Par défaut, le mode répertoire saute les fichiers qui ont déjà un fichier
-中文版.mdcorrespondant ; la retraduction n'a lieu que si l'utilisateur le demande explicitement.