Communitygithub.com

zhcmeng/shared-skills

Utilisé lorsque l'utilisateur demande de traduire un document anglais en chinois, de générer un fichier chinois suffixé par `-中文版`, ou de réaliser une « traduction mot à mot / traduction complète / sinisation » d'un fichier Markdown anglais (en particulier SKILL.md, documentation technique). Mots déclencheurs : traduction, sinisation, version chinoise, zh-CN, translate, mot à mot.

Qu'est-ce que shared-skills ?

Cette compétence (skill) est un traducteur automatique de documents Markdown anglais vers le chinois, conçu pour les agents IA (Claude Code, Codex, etc.). Elle garantit une traduction stricte « mot à mot » : la structure des titres, les paragraphes, les listes, les tableaux, les blocs de code et les diagrammes sont intégralement conservés, sans ajout, fusion, division ou reformulation. Son originalité réside dans la délégation totale du processus de traduction à un sous-agent (généralement le modèle « haiku »), ce qui évite toute surcharge du contexte de l'agent principal et permet de traiter plusieurs fichiers en parallèle. La compétence vérifie ensuite la conformité des traductions (diff) et ne rapporte à l'utilisateur que le résultat final (succès/échec/omissions). Elle prend en charge la traduction de fichiers uniques, de dossiers entiers (en ignorant les fichiers déjà traduits par défaut), et même la localisation des fichiers SKILL.md d'autres compétences via leur nom (ex: `superpowers:brainstorming`). Les règles de traduction incluent la préservation des blocs de code, du code en ligne, des URL, et l'insertion d'une citation mentionnant l'origine et la version du document original.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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 :

  1. Production : Anglais X.md → X-中文版.md dans le même répertoire.
  2. Frontmatter : name: conserve l'original anglais ; description: traduit en chinois ; les autres champs (s'ils existent) sont traduits selon leur valeur.
  3. 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`.
  4. 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.
  5. Code en ligne conservé : Le contenu entre backticks (nom de skill, chemin de fichier, commande, identifiant, URL) est conservé en anglais.
  6. 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é.
  7. 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.
  8. Liens : L'URL est conservée, le texte du lien est traduit.
  9. 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.
  10. 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.

  1. 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 son SKILL.md). Si $ARGUMENTS est vide, cela signifie que l'appel n'a pas de cible ; l'agent doit immédiatement signaler une erreur et quitter, sans deviner.
  2. Déterminer les fichiers à traduire :
    • Document unique → le fichier lui-même (1 seul).
    • Répertoire → lister tous les fichiers .md du répertoire, en excluant ceux qui ont déjà un fichier -中文版.md correspondant (sauter les existants, pas de retraduction).
  3. 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).
  4. Vérifier et faire rapport : Après le retour des sous-agents, l'agent principal exécute une vérification diff pour 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 fichier SKILL.md de 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 -中文版.md correspondant ; la retraduction n'a lieu que si l'utilisateur le demande explicitement.

Skills associés