Communitygithub.com

crowdin/skills

Répond à la question « comment faire X dans Crowdin » en mappant une difficulté de localisation à la solution la moins coûteuse que Crowdin propose déjà — une fonctionnalité intégrée, quelques actions via le connecteur Crowdin ou l'API, une app du Crowdin Store ou une application personnalisée — et transmet le mode d'emploi exact à la compétence qui en est propriétaire. À utiliser quand quelqu'un décrit un problème Crowdin ou de localisation sans nommer un outil (« les traducteurs ne respectent pas notre terminologie », « trouver les chaînes modifiées depuis la dernière version », « la QA passe mais l'allemand est faux »), demande si Crowdin peut faire quelque chose, demande quelle app Crowdin utiliser, ou nomme une app du store et veut savoir ce qu'elle fait ou si elle est nécessaire. Ne pas utiliser pour une commande CLI crowdin ou un crowdin.yml (crowdin-cli), une expression CroQL déjà en main (croql), une requête GraphQL ou une erreur Playground (graphql), du code contre le client API (crowdin-api-client), la construction d'une app (create-app), ou l'internationalisation d'une base de code (i18n-setup).

Qu'est-ce que skills ?

Cette compétence agit comme un **trieur de problèmes** pour Crowdin : elle aide à trouver la solution la plus simple et la moins coûteuse à tout problème de localisation exprimé par un utilisateur. Elle se différencie des autres compétences en ce qu'elle ne cherche pas à exécuter elle-même des requêtes complexes ou des scripts, mais à orienter l'utilisateur vers la bonne ressource : une fonctionnalité native de Crowdin, une série d'actions via le connecteur ou l'API (décrites au niveau des objets Crowdin comme les chaînes, les tâches ou les rapports), une application du Crowdin Store, ou, en dernier recours, la construction d'une application personnalisée. Elle est conçue pour être utilisée par des assistants IA dans Claude, Cowork, ChatGPT ou un terminal, et s'appuie sur un « ladder » (échelle) qui teste les options de la moins chère à la plus chère : fonctionnalité native, actions du connecteur, app du store, app personnalisée. Elle inclut des garde-fous pour éviter les modifications en masse non confirmées, ne nomme que les applications confirmées par le catalogue, et distingue clairement les fonctionnalités réservées à Crowdin Enterprise.

Compatible avec✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/crowdin/skills/tree/HEAD/skills/how-to-crowdin

Demander à votre IA préférée

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

Documentation

Comment Crowdin

Crowdin propose généralement plusieurs façons de résoudre un même problème de localisation : un paramètre que l'utilisateur n'a jamais trouvé, quelques actions sur ses chaînes, une application du Crowdin Store, ou quelque chose construit sur mesure. Lorsque quelqu'un demande "comment faire X dans Crowdin", il veut l'itinéraire le plus court et le plus honnête pour atteindre X, et connaître cet itinéraire exige de connaître les quatre options. Cette compétence est cette connaissance, organisée comme une carte du problème vers sa solution.

Vous êtes une couche de triage, pas une couche d'exécution. Vous décidez quelle est la bonne chose à faire dans Crowdin pour cette difficulté, et vous transmettez le mode d'emploi exact à celui qui en est propriétaire : les outils du connecteur Crowdin quand l'utilisateur en dispose, les compétences croql, graphql, crowdin-api-client et crowdin-cli quand le comment faire est une requête, un script ou une commande, la compétence create-app quand rien ne convient. Vous n'improvisez jamais d'appels API ou de syntaxe de filtre qui appartiennent à l'une de ces compétences.

Qui demande

Habituellement un responsable de localisation travaillant avec un assistant IA via le connecteur Crowdin, dans Cowork, Claude.ai ou ChatGPT. Parfois un développeur dans un terminal. Supposez qu'aucun shell n'existe jusqu'à ce que vous en voyiez un. Lorsqu'une réponse implique une action, décrivez-la d'abord comme des actions du connecteur sur des objets Crowdin, et ne mentionnez le chemin du terminal qu'en alternative.

L'échelle

Chaque réponse se situe sur un échelon, et vous les essayez du moins cher au plus cher :

  1. Fonctionnalité native que l'utilisateur ne connaissait pas. Étiquettes plus un filtre, une vérification QA, une étape de workflow, un rapport, un paramètre.
  2. Actions du connecteur. Une courte séquence que vous effectuez à la demande via le connecteur Crowdin ou l'API, décrite au niveau des objets Crowdin : filtrer les chaînes, ajouter une étiquette, créer une tâche, pré-traduire un ensemble, extraire un rapport. La même séquence s'exécute sous forme d'appels REST dans un terminal, donc il n'y a jamais de deuxième version à écrire.
  3. Application du Store. Installée depuis store.crowdin.com.
  4. Application personnalisée. Rien ne convient ; transmettez à create-app.

Le test de l'échelon 2 tranche la plupart des différends. Un travail est à l'échelon 2 quand il s'agit d'une lecture, d'un filtre, d'une modification en masse ou d'un rapport sur les propres données de Crowdin, effectué à la demande de l'utilisateur. Il cesse d'être à l'échelon 2 lorsqu'il nécessite une surveillance continue (webhooks, plannings), un système externe (un CMS, un hébergeur de dépôt, un outil de chat, un outil de design), un analyseur de fichier, une connexion MT ou fournisseur IA, une interface utilisateur dans l'éditeur Crowdin, ou un passage de modèle sur des milliers de chaînes que l'utilisateur devra refaire la semaine prochaine. Soyez honnête dans les deux sens : surestimer l'échelon 2 envoie les gens faire à la main ce qu'une application fait mieux, le sous-estimer pousse à une installation là où un filtre ferait l'affaire.

Lorsque l'échelon 3 ou 4 l'emporte, dites en une ligne chacun pourquoi les échelons moins chers ont été écartés. Cette ligne indique à l'utilisateur que la réponse a été pesée plutôt que devinée, et c'est ce qui rend une installation digne d'être payée quand une installation est véritablement la réponse.

Le flux

  1. Reformulez la difficulté en termes Crowdin. Les utilisateurs décrivent des symptômes : "l'allemand est faux", "les traducteurs ignorent nos termes". Nommez les objets Crowdin sous-jacents avant de répondre : chaînes, traductions, MT, glossaire, étape de workflow, vérification QA, tâche, rapport, intégration. Terminé quand vous pouvez dire la difficulté en une phrase qui utilise ces noms. Ne posez qu'une question de clarification seulement quand deux lectures mèneraient à des échelons différents ; autrement, choisissez la lecture la plus probable, dites laquelle vous avez choisie, et répondez.
  2. Cherchez la difficulté dans la carte ci-dessous. Un résultat vous donne l'échelon et la transmission. Terminé quand vous avez un échelon et une transmission, ou un échec confirmé.
  3. En cas d'échec, parcourez l'échelle vous-même, du moins cher au plus cher, en utilisant le test de l'échelon 2 ci-dessus.
  4. Consultez les catalogues en direct uniquement pour l'échelon qui en a besoin. references/catalogs.md explique comment. Échelon 1 en cas d'échec : l'index de la documentation Crowdin. Échelon 3 : l'index du store, réduit à la catégorie correspondante, puis un ou deux fichiers d'articles lus en entier. Un slogan présélectionne une application ; seul le fichier de l'article la recommande. Terminé quand ce que vous êtes sur le point de nommer est confirmé comme existant et comme faisant ce que vous allez prétendre.
  5. Transmettez le mode d'emploi. Les actions du connecteur restent au niveau des objets. Tout ce qui nécessite une expression CroQL, une requête GraphQL, un script ou une commande CLI est transmis à la compétence propriétaire par son nom, afin qu'elle soit invoquée plutôt que réinventée ici.
  6. Répondez selon le format ci-dessous.

Format de réponse

Solution en premier, en une ou deux phrases. Ensuite, ce que cela coûte à l'utilisateur : rien, une installation ou une construction. Ensuite, les étapes, ou la transmission. Quand l'échelon 3 ou 4 a gagné, une ligne par échelon moins cher rejeté. Quand la réponse dépend de l'édition, du plan ou de ce qui est déjà activé dans le projet de l'utilisateur, dites-le plutôt que de deviner ; les catalogues ne peuvent pas voir son compte, et vous non plus sans le connecteur.

Garde-fous

  • Les modifications en masse nécessitent un décompte et un oui d'abord. Ajouter une étiquette à de nombreuses chaînes, approuver en masse, nettoyer une MT, supprimer quoi que ce soit : nommez combien d'objets sont concernés et attendez la confirmation. Un filtre qui a correspondu à plus que ce que l'utilisateur imaginait est la façon courante dont un assistant endommage un projet.
  • Ne nommez que ce que le catalogue confirme. Lorsque le store n'a rien pour une difficulté, dites-le et passez à l'échelon 4 ou à "pas possible actuellement". Une application qui n'existe pas est pire que pas de réponse.
  • Enterprise-only reste étiqueté. Les workflows, les fournisseurs, les équipes et les groupes n'existent que dans Crowdin Enterprise. Dites-le quand ils sont la réponse, afin qu'un utilisateur de crowdin.com ne soit pas envoyé chercher un menu qu'il n'a pas.

La carte

Chaque ligne est une famille de problèmes : la difficulté dans les termes de l'utilisateur, l'échelon le moins cher qui y répond, et quoi faire. "Connecteur" signifie des actions via le connecteur Crowdin ou l'API, décrites au niveau des objets. Une ligne qui nomme une application du store a déjà pesé ses échelons moins chers, alors confirmez l'application dans le catalogue et dites ce qu'elle ajoute. Une ligne qui dit que quelque chose "est une application" marque l'endroit où l'échelon moins cher cesse d'être suffisant.

Recherche, édition et organisation des chaînes

DifficultéÉchelonFaites ceci
Quelles chaînes ont été modifiées, ou sont nouvelles, depuis une date ou une version1Filtre de l'éditeur ou CroQL sur les dates des chaînes ; étiquetez le résultat s'il doit être réutilisé
Étiqueter de nombreuses chaînes à la fois2Filtrez avec CroQL, ajoutez l'étiquette en masse ; petits ensembles : sélection multiple dans l'éditeur
Le texte source est bâclé avant d'atteindre les traducteurs1Enterprise : étape de workflow de révision du texte source ; ailleurs, Remplacement dans les sources avec Conserver les traductions ; une révision ML récurrente est une application
Corriger ou ajouter des chaînes sources sans perdre leurs traductions2Modification en masse des chaînes avec l'option de conservation des traductions ; une chaîne : modifiez-la dans l'éditeur
Les chaînes en double ne sont pas détectées1Stratégie de gestion des doublons du projet ; les trouver dans tous les fichiers est une action du connecteur
Les nouveaux fichiers doivent être traduits dans seulement certaines langues2Mettez à jour les langues cibles exclues de chaque fichier ; un fichier : paramètres du fichier
Où cette chaîne ou ce terme est-il utilisé dans tous nos projets2Recherche à l'échelle de l'organisation, pas de liste par projet ; segments MT par MT
Confier un sous-ensemble spécifique de chaînes à quelqu'un sous forme de tâche2Filtrez, étiquetez, créez une tâche filtrée par cette étiquette
Les parties prenantes ont besoin d'un sous-ensemble sous forme de feuille de calcul ou de document bilingue2Filtrez, listez les traductions par langue, écrivez le fichier localement ; fichier entier : téléchargez les traductions
Des données personnelles se sont glissées dans les fichiers envoyés pour traduction2CroQL sur le texte source pour les motifs d'email et de téléphone, étiquetez les correspondances ; bloquer à l'importation est une application
Les phrases segmentées de manière incorrecte lors de l'importation1Option d'importation de segmentation personnalisée (SRX) ; réimporter les fichiers existants est une action du connecteur ; la création de règles est une application
Les fichiers ne s'importent ou ne s'exportent pas correctement1Configuration de l'analyseur et options d'importation d'abord ; la réécriture de contenu dans le pipeline est une application
Les clés diffèrent uniquement par la convention de nommage selon les plateformes3Store : Convertisseur pour les conventions de clés ; rien de natif ne normalise les clés

Contexte pour les traducteurs

DifficultéÉchelonFaites ceci
Les traducteurs ne peuvent pas voir l'écran sur lequel une chaîne se trouve1Captures d'écran avec auto-étiquetage ; télécharger et étiqueter en leur nom est une action du connecteur ; les intégrations de conception en direct sont des applications
Les traducteurs de pages Web ou de documents ne peuvent pas voir le résultat rendu1Localisation en contexte et aperçu du document dans l'éditeur ; le minutage vidéo est une application
Personne n'a écrit de contexte et les traducteurs devinent2Listez les chaînes avec un contexte vide, déduisez le sens de la base de code, modifiez le contexte en masse ; dans un terminal, crowdin-context-cli plus context-extraction
Quelles chaînes manquent de contexte suffisant pour être traduites correctement2Couverture : filtrez le contexte vide par fichier et rapportez ; la suffisance jugée par un modèle à grande échelle est une application
Le tableur a des colonnes de contexte que Crowdin ignore lors de l'importation2Après l'importation, modifiez en masse le contexte des chaînes à partir de la feuille originale ; à chaque importation est une application
Le matériel de référence se trouve dans d'autres outils1La description du projet et le contexte du fichier portent des liens ; afficher un tableau dans Crowdin est une application
Les pluriels ICU, JSON ou les entités dans les chaînes gênent1Les vérifications QA ICU et balises détectent les sorties cassées ; les aides par chaîne dans l'éditeur sont des applications

Qualité

DifficultéÉchelonFaites ceci
Les traductions sont bâclées : ponctuation, casse, espacement, orthographe1Activez les vérifications QA natives dans les paramètres du projet ; un nettoyage des traductions existantes est une action du connecteur
Les nombres, couleurs, raccourcis, emojis ou séquences d'échappement ont été supprimés ou modifiés1Vérifications natives Variables, Balises, Caractères spéciaux ; autres classes de jetons : un audit ponctuel est une action du connecteur, un signalement en direct est une vérification QA du store (Enterprise)
Les URL, e-mails, dates ou unités ont été copiés au lieu d'être localisés2Auditez et corrigez en masse les traductions d'une langue après révision ; l'application en direct par langue est une vérification QA du store
La traduction ne correspond pas à son élément d'interface utilisateur ou au minutage des sous-titres1Longueur maximale par chaîne et vérification Longueur ; un budget de caractères pour un fichier entier est une action du connecteur ; les caractères par seconde sont une vérification QA
Les problèmes QA s'accumulent et ne peuvent pas être triés2Listez les problèmes QA par langue, regroupez par type, ajoutez les faux positifs au dictionnaire du projet en un seul lot
La même source est traduite différemment dans tout le projet2Rapportez les groupes de même source, cible différente par langue ; les indices de cohérence de l'éditeur existent nativement pour un ensemble limité de langues
Des erreurs d'orthographe ou de grammaire spécifiques à une locale passent inaperçues1Vérification orthographique native, ou un fournisseur de vérification orthographique sous les paramètres de l'organisation ; la QA de conventions locales au fur et à mesure est une application
Des formulations offensantes ou contraires à la politique dans les traductions1Vérification QA personnalisée avec une liste de mots (Enterprise) ; un modèle jugeant chaque nouvelle traduction est une application
Je ne peux pas vérifier une langue que je ne parle pas2Retraduisez ou expliquez un échantillon limité à la demande ; chaque export retraduit est une application
La relecture humaine est le goulot d'étranglement1Étape de workflow de relecture et tâches ; un lot de révision limité est une action du connecteur ; réviser chaque nouvelle traduction avec l'IA est une application
Je ne peux pas voir ce que les relecteurs ont modifié1Rapport de précision du traducteur par traducteur ; un avant-après par chaîne est une action du connecteur ; les suppressions sont dans l'activité du projet
Noter la qualité de la traduction par rapport à un modèle LQA3Store : Assurance qualité linguistique (Enterprise) ; les annotations vivent dans l'éditeur
Des traductions suspectes ont été collées à partir d'un outil IA3Rapports de détection IA du store ; la provenance (qui ou quel moteur a produit une traduction) est une action du connecteur
Vérifier les traductions par rapport à nos propres règles ou ton2Vérifiez ponctuellement un fichier ou une langue par rapport à la règle à la demande ; à l'échelle du projet et répétable est une application
Quelles traductions MT ou IA peuvent être livrées sans intervention humaine3Applications d'estimation de qualité du store ; un tri grossier (tâche pour les traductions uniquement MT) est une action du connecteur

Terminologie, MT et style

DifficultéÉchelonFaites ceci
Le glossaire est vide ou mince2glossary-generation depuis un terminal ; via le connecteur, proposez des termes à partir des chaînes sources et ajoutez après révision
Les développeurs veulent que les chaînes qu'ils viennent d'ajouter soient traduites maintenant, de manière cohérente avec notre glossaire et notre MT2translate depuis un terminal : brouillons dans les fichiers de ressources locaux, téléchargés comme suggestions non approuvées ; le travail en masse est une pré-traduction (crowdin-cli)
Le glossaire a des termes sources mais pas de traductions2Exportez le glossaire, téléchargez-le comme fichier source à traduire, importez-le en retour
Des termes doivent être ajoutés ou corrigés pendant la traduction2Trouvez le concept, ajoutez ou mettez à jour le terme ; les traducteurs le faisant en ligne ont besoin de l'application de l'éditeur
Pas de guide de style, donc le ton et le formatage dérivent2Déduisez les règles des traductions approuvées, rédigez le guide de style natif avec des instructions IA
Les traductions sont devenues obsolètes après un changement de glossaire ou de guide de style1Renommage de terme connu : Remplacement dans les traductions, ou CroQL plus une étiquette quand chacune nécessite une révision ; une règle de style ou une surveillance continue est une application
La MT ou l'IA ignorent notre glossaire et notre MT1Les invites IA natives reçoivent déjà le glossaire, la MT et les chaînes frères ; DeepL honore les glossaires côté DeepL ; la synchronisation des termes dans DeepL est une application
Chaque projet génère sa propre MT et son propre glossaire1Attribuez la MT et le glossaire partagés dans les paramètres du projet ; la fusion des égarés est une action du connecteur ; automatique à la création du projet est une application
La MT est gonflée de doublons3Store : Nettoyeur de MT (conserve une sauvegarde) ; une petite MT peut être dédoublonnée par le connecteur après un export
J'ai besoin d'une tranche filtrée de la MT, pas de l'export entier2CroQL sur les enregistrements MT (dates, utilisation, auteur), écrivez en CSV ; non filtré : téléchargement natif de la MT
Les traductions terminées ne sont pas dans une MT qu'un autre projet peut utiliser1Une MT affectée à plusieurs projets ; une MT à partir d'un sous-ensemble de fichiers est une action du connecteur
Des documents traduits hérités ou des TMX ne sont pas dans la MT intacts1Téléchargement natif de la MT pour TMX, XLSX, CSV ; l'alignement de paires de documents ou la conservation du contexte précédent/suivant est une application
Les traducteurs veulent des dictionnaires externes dans l'éditeur1Importez la base terminologique comme glossaire et elle s'affiche nativement ; les corpus externes en direct sont des applications
L'IA répète les erreurs que les traducteurs ont déjà corrigées1Enterprise : Alignement IA rédige des termes de glossaire à partir des traductions humaines ; ailleurs, comparez la sortie IA avec les versions approuvées

...

[suite tronquée pour la traduction]

Skills associés