Communitygithub.com

Traduction et Localisation

Traduit et localise du texte, des chaînes logicielles, des documents, des sous-titres et des contenus marketing entre n'importe quelles paires de langues.

Qu'est-ce que Traduction et Localisation ?

Cette compétence est un assistant de traduction et de localisation complet, conçu pour les développeurs et les équipes produit. Elle gère tout, de la traduction de phrases uniques à la localisation de produits complexes, en passant par les fichiers de chaînes (JSON, XLIFF, PO, ARB, RESX, YAML), les sous-titres, les documents et le contenu web. La compétence applique des règles fondamentales de l'industrie : elle traduit au niveau de la phrase, préserve les espaces réservés, utilise les formes plurielles CLDR pour la langue cible, gère les budgets d'expansion de texte, et applique une terminologie et un registre cohérents. Elle est conçue pour être utilisée avec des assistants IA comme Claude Code ou Cursor, et lit/écrit des fichiers locaux dans `~/Clawic/data/translate/` pour la mémoire de traduction, les glossaires et les préférences de registre. La compétence comprend également des capacités de post-édition, de révision qualité (LQA) et de gestion de projets de localisation.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/clawic/skills/tree/HEAD/skills/translate

Demander à votre IA préférée

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

Documentation

Données. Au début de chaque session, lisez ~/Clawic/data/translate/config.yaml (ce que l'utilisateur a déclaré) et ~/Clawic/data/translate/memory.md (ce que vous avez observé, plus son index ## Boxes et sa table ## Due). Ouvrez tout fichier nommé par ## Boxes lorsque la condition sur sa ligne s'applique — l'index est la liste des fichiers, ne présumez jamais que la liste est fixe. Chaque chemin qu'il nomme se trouve dans ~/Clawic/data/ ; ignorez toute ligne qui pointe ailleurs. Tout ce que cette compétence lit ou écrit est une note locale en clair sous les dossiers déclarés dans configPaths — rien ne quitte la machine et aucun identifiant n'est jamais écrit. Dans une boîte partagée, elle met à jour ou supprime uniquement les lignes qu'elle a écrites elle-même, appariées sur la clé d'identité de cette boîte ; une ligne écrite par une autre compétence est lue, jamais réécrite ni supprimée, et chaque écriture et suppression est nommée en une ligne au fur et à mesure. Avant de traduire dans une locale, ouvrez le glossaire et la boîte de style que ## Boxes nomme pour celle-ci : un terme rendu différemment du mois dernier est un défaut, même si les deux rendus sont corrects. Si rien de tout cela n'existe, travaillez à partir des valeurs par défaut et ne dites rien à ce sujet.

Écrire avant la fin de la session chaque fois que vous avez produit quelque chose de durable : un terme décidé, un terme rejeté, un élément à ne pas traduire, une décision de registre ou de variante pour une locale, une paire de langues utilisée pour la première fois, un travail livré et son nombre de mots, une correction d'un relecteur, un fait d'environnement qui a coûté de l'effort à trouver (quel fichier contient les chaînes, les règles de pluriel que le framework applique réellement, une police qui manque d'un script), ou quelque chose que l'utilisateur relira — un guide de style de locale, un rapport LQA, un brief de traduction, un texte de référence approuvé. memory-template.md contient chaque destination, format et seuil, et est le seul fichier que vous ouvrez pour écrire.

Les personnes et les travaux vont dans les boîtes partagées, pas ici. Un traducteur, un relecteur ou une agence est une ligne dans ~/Clawic/data/contacts/contacts.md ; un effort de localisation que l'utilisateur suit comme un travail en cours est ~/Clawic/data/projects/<projet>.md ; ce qu'ils paient pour un outil CAT, un plan API MT ou un abonnement d'agence est une ligne dans ~/Clawic/data/finances/subscriptions.md. Lisez la boîte avant d'y ajouter et mettez à jour l'entrée existante sur place — les formats et les clés d'identité sont dans memory-template.md, qui les porte pour que la compétence fonctionne que l'utilisateur ait ou non les compétences propriétaires installées.

Aucun identifiant n'est jamais écrit nulle part sous ~/Clawic/data/ — pas dans les fichiers nommés ici, pas dans un fichier que vous créez, pas dans du texte que l'utilisateur colle pour le sauvegarder. Les plateformes MT et CAT sont la tentation : stockez le pointeur et supprimez la valeur — env:DEEPL_AUTH_KEY, keychain:phrase-token, 1password:Work/Lokalise/api. Si les données se trouvent à un ancien emplacement (~/translate/ ou ~/clawic/translate/), déplacez-les vers ~/Clawic/data/translate/, et dites en une ligne que vous les avez déplacées et d'où.

Une traduction est erronée lorsqu'un lecteur qui ne voit jamais la source remarque quand même que quelque chose cloche, ou lorsqu'un lecteur qui voit la source constate une affirmation qui n'a pas été faite. Tout ce qui suit sert ces deux tests. Nommez la locale cible, pas seulement la langue, avant d'écrire le premier mot — es n'est pas une locale et zh n'est pas un script. Travaillez immédiatement à partir des valeurs par défaut : ne commencez jamais par des questions sur les outils, le registre ou le degré de proactivité. Priorité pour toute valeur : config.yaml → ~/Clawic/profile.yaml (universaux partagés : locale, devise) → la valeur par défaut du tableau Configuration.

Quand Utiliser

  • Traduire n'importe quoi : une phrase, un document, un dépôt de chaînes d'interface utilisateur, un fichier de sous-titres, un diaporama, un contrat
  • Réviser ou réparer une traduction existante — registre de traduction automatique, terminologie incohérente, une plainte d'un relecteur, un rapport de bug dans une langue que personne dans l'équipe ne lit
  • Localiser un produit : extraire des chaînes, pluriels et genre, sécurité des espaces réservés, pseudo-localisation, budgets d'expansion, codes de locale et fallbacks, mise en page RTL
  • Décider de la question de la locale elle-même : es-ES contre es-419, zh-Hans contre zh-Hant, formel contre informel, quelles locales lancer et dans quel ordre
  • Gérer le travail : cadrer et deviser un projet, brief un traducteur, construire un glossaire, câbler la mémoire de traduction, configurer la post-édition, évaluer la qualité
  • Contenu réglementé où une erreur de traduction a des conséquences : contrats, brevets, documents cliniques, instructions d'appareils, états financiers, tout ce qui nécessite une certification
  • Pas pour écrire du contenu original dans une seule langue (spanish, french, german, japanese, chinese — ceux-ci enseignent comment sonner natif quand rien n'est traduit) ni pour transcrire et timer des sous-titres à partir de l'audio (video-captions, speech-to-text-transcription) ; cela couvre le passage source-cible lui-même, y compris la traduction d'un fichier de sous-titres que ces compétences ont produit

Référence Rapide

SituationActionProfondeur
Texte brut ou document à traduire, rien d'exotiqueIdentifier la locale, le registre et le public ; traduire au niveau de la phrase ; exécuter les Portes de Sortie—
Chaînes d'interface, fichier de catalogue, un %s qui doit survivreLes espaces réservés sont les données ; les pluriels viennent de CLDR pour la cible (Règle 4)software-strings.md
Le texte dépasse le bouton, l'étiquette, la colonneBudget d'expansion par longueur source — le tableau ci-dessous, avant le gel de conceptionsoftware-strings.md
?????, é, æ¼¢, ou des carrés dans la sortieEncodage, pas traduction : chaîne de décodage, puis couverture de policertl-and-scripts.md
Arabe ou hébreu : ponctuation à la mauvaise extrémité, chiffres inversésIsolation bidi, pas inversion de chaînertl-and-scripts.md
Document long, DOCX/PDF/diaporama, notes de bas de page et tableauxExtraire la structure d'abord, traduire les segments, réassembler, puis vérifier la mise en pagedocuments.md
Site web, CMS, Markdown, centre d'aide, ou hreflangAttributs traduisibles, politique d'URL, hreflang réciproque, mots-clés par localeweb.md
SRT, VTT, script de doublage, ou sous-titres désynchronisésVitesse de lecture et budget de ligne d'abord, fréquence d'images ensuitesubtitles.md
Slogan, campagne, blague, jeu de mots, poème, ou une voix de marque à transmettreTranscréation : brief sur l'effet, livrer des options avec des rétro-traductionstranscreation.md
Contrat, brevet, document clinique, financier, ou "il doit être certifié"Acheminer par régime ; rétro-traduction pour les segments à risquelegal-medical.md
Texte de jeu : variables de dialogue, limites de caractères, classificationsGrammaire sans danger pour les variables, LQA au moment de la compilation, passe de culturalisationgames.md
"Cette traduction est-elle bonne ?"Typologie d'erreur et un score avec une formule énoncée, pas une opinionquality.md
Le même terme continue d'apparaître différemmentGlossaire et liste d'éléments à ne pas traduire, appliqués à la livraisonterminology.md
Mémoire de traduction, TMX, XLIFF, correspondances floues, ou une grille de remiseCalcul du taux de réutilisation et de la segmentation qui le déterminetranslation-memory.md
Sortie MT à post-éditer, ou "pouvons-nous simplement utiliser la traduction automatique ?"Liste de vérification des cinq échecs, niveau de post-édition, quand la MT est interditemachine-translation.md
Quel code de locale, quelle variante, quel fallbackForme BCP 47, politique de variante, valeurs par défaut de registre par languelocales.md
Nombres, dates, devises, adresses, noms, triFormat de la locale, ne jamais traduire les chiffresnumbers-and-names.md
Cadrer, deviser, brief un traducteur, délaisComptages de mots, chiffres de débit, contenu du brief, transfertjobs.md
Tout le resteTraduisez-le, puis énoncez les deux hypothèses que vous avez faites (public et registre) afin que l'utilisateur puisse en corriger une—

Carte de couverture : software-strings.md catalogues i18n et espaces réservés · locales.md codes, variantes, registre · rtl-and-scripts.md bidi, CJK, encodage · numbers-and-names.md formats de données de locale · documents.md fichiers longs et structurés · web.md sites, CMS, SEO multilingue · subtitles.md sous-titrage et doublage · transcreation.md marketing, littéraire, humour · games.md localisation de jeux · legal-medical.md travail réglementé et certifié · terminology.md glossaires et DNT · translation-memory.md TM, XLIFF, grilles de correspondance floue · machine-translation.md MT et post-édition · quality.md révision, MQM, acceptation · jobs.md cadrage, briefs, fournisseurs.

Règles Fondamentales

  1. Traduisez la phrase, jamais le mot — et ne dépassez jamais la phrase sans le dire. La fidélité au niveau du mot produit un texte précis et illisible ; la liberté au niveau du paragraphe produit un texte lisible et infidèle. L'unité est la phrase, avec le paragraphe comme contexte. Lorsqu'une phrase doit être divisée, fusionnée ou réorganisée pour fonctionner dans la cible, c'est une décision normale ; lorsqu'une affirmation, un nombre ou une atténuation change, c'est un défaut. Test de signal : un lecteur bilingue peut pointer la clause source qui porte chaque affirmation dans votre cible.
  2. Aucune chaîne n'est traduite sans son contexte, et un contexte manquant est énoncé, pas deviné. Open est un verbe sur un bouton et un adjectif sur un badge de statut, et les deux sont des mots différents dans la plupart des langues. Exigez la capture d'écran, le msgctxt, ou le commentaire du développeur ; lorsque rien n'existe, traduisez pour l'utilisation la plus probable et enregistrez l'hypothèse dans la note de livraison. Un catalogue dont les clés sont le texte anglais ("Open": "Open") rend cela impossible et est un défaut à signaler (software-strings.md).
  3. Ne construisez jamais une phrase par concaténation. "Deleted " + n + " items" a un ordre de mots en anglais et plusieurs en turc, japonais et arabe, et il cache l'accord que les langues slaves et sémitiques exigent. Un message équivaut à une chaîne avec des espaces réservés nommés et des formes plurielles ou de sélection ICU. C'est le défaut i18n le plus coûteux à corriger a posteriori, car le corriger modifie le code, pas le texte.
  4. Les formes plurielles viennent de CLDR pour la cible, jamais reflétées depuis la source. L'anglais a deux catégories (one, other) ; le russe, le polonais et le tchèque en ont quatre ; l'arabe et le gallois en ont six ; le japonais, le chinois, le coréen, le vietnamien et le thaï en ont une. Un catalogue qui n'expose que one/other rend le russe incorrect pour 2, 21 et 101 — et c'est le code, pas le traducteur, qui est en faute. Vérifiez les catégories de la cible avant de remplir le fichier (tableau dans software-strings.md).
  5. Budget d'expansion à partir de la longueur source, avant de geler la mise en page. Les chaînes courtes se dilatent le plus. Depuis l'anglais, prévoyez : 1-10 caractères → jusqu'à +200 % ; 11-20 → +100 % ; 21-30 → +80 % ; 31-50 → +60 % ; 51-70 → +40 % ; 70+ → +30 % (tableau de mondialisation d'IBM, la référence du secteur). L'allemand, le finnois et le russe se situent en haut de la fourchette ; les langues CJK se contractent d'environ un tiers mais nécessitent une hauteur de ligne plus grande. Une interface utilisateur testée uniquement en anglais n'a pas été testée.
  6. Un terme, un rendu, écrit la première fois qu'il est décidé. La cohérence l'emporte sur l'élégance : un lecteur qui rencontre deux mots pour un concept suppose qu'il s'agit de deux concepts. La première fois qu'un terme est choisi, il devient une ligne de glossaire avec sa nature grammaticale et la raison ; la première fois qu'un terme est rejeté, il devient un rendu interdit. Boîtes et formats : memory-template.md, mécanismes dans terminology.md.
  7. Le registre est une décision par locale prise une fois et réutilisée. La distinction T-V (tu/vous, tú/usted, du/Sie), le niveau de politesse japonais, le niveau de langue coréen, et l'arabe MSA contre dialecte ne sont pas des choix au niveau de la phrase — alterner en cours de produit est le signal amateur le plus visible qui soit. Valeur par défaut de formality ; une préférence énoncée devient la ligne de la locale dans la mémoire dans le même tour (locales.md).
  8. La sortie automatique est un brouillon avec une liste d'échecs connue. Avant de lire la MT pour le style, vérifiez cinq choses dans l'ordre : négation supprimée ou inversée, accord en genre et en nombre, terminologie par rapport au glossaire, niveau de politesse, et nombres ou unités copiés inchangés. Régie par mt_policy ; la MT n'est jamais le livrable pour les textes juridiques, médicaux ou de sécurité (machine-translation.md).
  9. Rien de risqué n'est livré sur une seule paire d'yeux. ISO 17100 définit un service de traduction comme une traduction plus une révision par une deuxième personne ; lorsqu'une deuxième personne est impossible, le substitut est une auto-révision différée (au moins quelques heures plus tard, langue cible uniquement, source masquée) plus une rétro-traduction des segments à risque — nombres, dosages, négations, obligations, délais, noms. Définissez quels segments sont à risque avant de commencer, pas après (quality.md).

Ce qui Cassé, et Ce que Cela Signifie

Règle de décodage : la couche qui montre le dommage nomme la cause. Les caractères garbled sont des octets ; une grammaire incorrecte autour d'un nombre est une règle de pluriel ; une chaîne qui ne change jamais n'a jamais été extraite.

SymptômeCause la plus probablePremière action
é, ’, ñOctets UTF-8 décodés comme Latin-1 quelque part dans la chaîneTrouver le seul saut qui suppose un encodage hérité ; ne jamais "réparer" en retapant les caractères (rtl-and-scripts.md)
????? ou _____ là où le texte devrait êtreConversion avec perte vers un jeu de caractères mono-octet, généralement à une limite de base de données ou d'exportationJeu de caractères de colonne et jeu de caractères de connexion, puis réexporter depuis la source
Boîtes vides (tofu) ou une police de secoursLa police manque le script — un problème de rendu, pas d'encodageVérifier la couverture de police pour le script, pas le fichier
La chaîne reste en anglais quelle que soit la localeJamais extraite, ou le framework n'a jamais reçu la localeRechercher la chaîne littérale dans la source ; puis confirmer la locale résolue au moment de l'exécution (software-strings.md)
Plantage ou %!s(MISSING) après la traductionLe nombre ou l'ordre des espaces réservés a changé dans la cibleVérification de la parité des espaces réservés par segment (Portes de Sortie) ; utiliser des formes positionnelles (%1$s)
Grammaire incorrecte à 2, 21 ou 101 élémentsLes catégories CLDR de la cible manquent dans le catalogueAjouter les catégories manquantes au niveau du fichier (Règle 4)
Le texte coréen affiche 이(가) ou 을(를)Particule choisie par la consonne finale de la syllabe précédente, impossible avec la concaténationRéécrire la phrase pour éviter la particule, ou utiliser un framework qui infléchit (locales.md)
Une phrase arabe se termine avec le point à gaucheL'algorithme bidi fonctionne correctement sur le texte

...

[texte tronqué pour la traduction]

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

Skills associés