CommunityRédaction et éditiongithub.com

Gyanesh5/plain-zh

Spécification de sortie en chinois clair. Deux modes d'utilisation : façonner l'écriture (prévention) et réviser un texte finalisé (nettoyage). Couvre la discipline terminologique, le calibrage du lectorat, les signaux de structure et les limites stylistiques, avec des règles classées par niveau de preuve.

Qu'est-ce que plain-zh ?

Ce skill, `plain-zh`, est une spécification complète pour produire un chinois technique clair et lisible, destiné aux rédacteurs techniques, formateurs et assistants IA. Il propose deux modes opératoires : un mode génératif, pour structurer le texte dès sa rédaction, et un mode révision, pour analyser et corriger un texte existant. Ses 22 règles sont organisées en cinq sections : discipline terminologique (définir avant d'utiliser, terme unique par concept, éviter les traductions maison), calibrage du lectorat (connaître son public, limiter les abréviations non définies), signaux de structure (éliminer le langage rhétorique superflu, assurer la cohérence inter-paragraphes), limites stylistiques (seuils pour métaphores, formules choc), et discipline de réécriture (modifications minimales, conservation des faits). Chaque règle est annotée par une note de confiance : testée, cognitive, ou conventionnelle. Le skill est implémentable sur tout agent IA capable de suivre des instructions markdown (Claude Code, Cursor). Il s'intègre via des fichiers `AGENTS.md`, `CLAUDE.md` ou `SOUL.md` pour une utilisation persistante.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Gyanesh5/plain-zh/tree/HEAD

Installed? Explore more Rédaction et édition skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Demander à votre IA préférée

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

Documentation

plain-zh 平实中文

Écrire en chinois pour les humains : définir les termes avant de les utiliser, un seul nom par concept, pas de métaphores dans les titres, structure simple.

Chaque règle est accompagnée d'une note de niveau de confiance :

  • 〔Testé〕Issu du corpus de 270 paires du projet lieflat-less-ai-tone, validé dans deux directions
  • 〔Cognitif〕Basé sur des preuves en sciences cognitives (malédiction de la connaissance de Pinker, capacité de la mémoire de travail de Cowan)
  • 〔Ingénierie〕Pratiques d'ingénierie matures (ASD-STE100 rédaction contrôlée, guide de typographie chinoise)
  • 〔Convention〕Conception propre au projet, sans preuve expérimentale, ajustable selon les besoins

Deux modes

Mode génératif (chargé avant la rédaction) : avant d'écrire, déterminez le public cible et le glossaire. Après la rédaction, vérifiez avec les règles P1-P7. POLICY.md est une version condensée en 8 lignes de ce mode, idéale pour une inclusion permanente dans AGENTS.md / CLAUDE.md / SOUL.md.

Mode révision (sur un texte existant) : suivez le « Workflow de révision » pour produire un rapport, attendre confirmation, puis réécrire.

Mécanisme de glossaire de projet

Avant de rédiger en mode génératif ou révision, consultez toujours les sources terminologiques du projet :

  1. Priorité des sources terminologiques : instruction directe de l'utilisateur > glossaire du projet (CONTEXT.md, GLOSSARY.md, table de correspondance terminologique) > valeurs par défaut de cette spécification. Utilisez les entrées du projet telles qu'elles sont définies, ne réécrivez pas les termes existants selon cette spécification.
  2. Coexistence avec des workflows tiers : si le projet utilise des skills comme mattpocock (wayfinder, to-spec, etc.), les entrées de CONTEXT.md, les commandes et les métaphores (wayfinder=carte des tâches, grill=interrogatoire décisionnel, to-tickets=découpage en tâches, arriver à la gare=objectif atteint, entrer dans le brouillard=en attente) sont traitées comme des conventions du projet. Les termes d'interface sont traités en mode double selon P3.
  3. Gouvernance incrémentale : les documents existants ne sont pas réécrits ; la chaîne de preuves du dossier de décision prime. Si le projet n'a pas de glossaire et que la révision identifie 3 termes non répertoriés ou plus, le rapport suggère de créer une table de correspondance terminologique. Les nouveaux documents suivront cette table.

R1 Discipline terminologique

P1 Définir avant d'utiliser 〔Cognitif〕

Tout terme, abréviation, nom de fichier, nom de champ, nom d'outil doit être défini ou accompagné d'une traduction chinois-anglais avant sa première apparition. Interdiction d'apparaître de nulle part. Méthode de jugement : le lecteur a-t-il déjà vu ce mot ? Non ? Alors expliquez-le en une phrase d'abord.

  • Avant : « Exécutez simplement build_assets.py »
  • Après : « Utilisez d'abord le script de compression des ressources build_assets.py fourni par le dépôt, puis exécutez » (les appositions s'écrivent directement, sans parenthèses ; si les parenthèses sont nécessaires, voir P18)

Conserver : les mots déjà définis dans le texte ci-dessus ; les mots de connaissance courante pour le lecteur cible.

P2 Même concept, même terme 〔Testé〕

Un seul nom pour un concept du début à la fin. Pas de synonymes alternés, pas de nouvelles appellations en cours de route.

Preuve : les IA renomment avec des synonymes 0,83-0,86 fois par paragraphe, les humains 0,49 ; les paragraphes avec plus de 2 occurrences d'un même concept sont 20,6-22,5% chez les IA, 8,4% chez les humains.

  • Avant : dans un même paragraphe, « optimisation / amélioration / renforcement » alternés pour la même chose
  • Après : utiliser uniformément « optimisation » dans tout le texte

Conserver : les variations littéraires de désignation ; les « également connu sous le nom de X » lors de l'introduction formelle d'un terme.

P3 Première occurrence avec traduction, pas de traduction maison 〔Ingénierie〕

Utilisez la traduction courante si elle existe ; sinon, écrivez « chinois (English) » à la première occurrence, puis utilisez le chinois. Interdiction des traductions argotiques maison et des statistiques argotiques.

  • Avant : « le modèle chrome cinq pièces » « régression modale » « écart modal »
  • Après : « éléments d'interface modélisés (chrome) : titre, chaîne méta-information, balise tiret » « régression vers la moyenne »

Conserver : les termes anglais fixes dans le secteur (API, CI/CD) ; les mots que l'équipe a convenu de garder en anglais (voir glossaire du projet).

Mode double pour les termes d'interface : les commandes slash, les étiquettes (Label, Status, Type), les clés de configuration sont des interfaces d'appel de l'agent, conservez-les en anglais sans traduction ; mais lorsqu'elles apparaissent dans le corps du texte humain, donnez la traduction à la première occurrence.

  • Avant : « pour le ticket 05, griller d'abord avec l'utilisateur »
  • Après : « pour le ticket 05, grill (interrogatoire décisionnel) d'abord avec l'utilisateur »

Les lignes de métadonnées machine (Label, Status, Blocked by, etc.) sont concentrées dans la zone d'en-tête du fichier, pas dispersées dans le texte ; les titres de paragraphe sont en chinois, ou bilingues chinois-anglais, pas entièrement en anglais.

P4 Quota de métaphores 〔Convention〕

Maximum une métaphore par concept. La métaphore n'apparaît que dans l'explication, pas dans le titre, pas utilisée de manière répétée comme terme. Les modèles ne peuvent pas évaluer la pertinence d'une métaphore (consensus entre modèles 0-40%), donc le filtrage a posteriori n'est pas fiable ; limitez à la source.

  • Avant : titre « 1. Origine et le problème qu'elle résout » ; « trois piliers / pilier un / pilier deux » comme cadre de chapitre
  • Après : titre « 1. Origine : quel problème elle résout » ; « trois principes / principe un »

Conserver : le style explicitement demandé par l'utilisateur ; les métaphores validées efficaces dans un contexte pédagogique (une par concept).

R2 Calibrage du lectorat

P5 Liste du public cible et des connaissances préalables 〔Cognitif〕

Avant d'écrire, déterminez deux choses : à qui on s'adresse et ce qu'ils savent déjà. N'utilisez que des concepts déjà établis chez le lecteur. La malédiction de la connaissance (curse of knowledge) : l'auteur sait ce que le lecteur ne sait pas, et l'auteur a tendance à sous-estimer cet écart.

P6 Quota d'abréviations non définies 〔Cognitif〕

Maximum 1 abréviation non développée par 100 caractères. La mémoire de travail ne peut gérer qu'environ 4 éléments inconnus à la fois. Les abréviations consécutives forcent le lecteur à « s'arrêter pour vérifier ». Au-delà du quota, développez ou supprimez.

P7 Analogie pour concepts transversaux 〔Cognitif〕

Lorsque vous introduisez un concept étranger au domaine du lecteur, donnez une analogie dans son domaine, et expliquez les limites de l'analogie. L'analogie sert à l'introduction, les limites à la justesse.

  • Exemple : « Un registre est comme une place de stationnement : une seule valeur par place. Mais un registre n'a pas de notion de « plein » : écrire écrase. »

R3 Signaux de structure

Classés par force de preuve. Un indicateur n'est pas une accusation, c'est une suggestion ; revenez au contexte pour chaque occurrence.

P8 Langage antithétique 〔Testé 3,4 fois〕

« Ce n'est pas X, mais Y », « Vous pensez que… en fait… », « Apparemment… mais en réalité… », « Plutôt que de dire… il serait plus juste de dire… ». Dans la plupart des cas, énoncez directement le jugement.

  • Avant : « Le modèle ne copie pas, il fait une régression vers la moyenne »
  • Après : « Le modèle ne copie pas qui que ce soit, il produit le style statistiquement le plus courant »

Conserver : la correction d'une idée fausse réelle (« L'erreur se produit lors de la sauvegarde, pas lors du téléchargement »).

P9 Deux-points indicatifs 〔Testé 3,8 fois〕

« Pour résumer en une phrase : », « Le point essentiel : », « La clé est : », « Raison : ». Si la phrase indicative n'apporte pas d'information, supprimez-la et écrivez directement la conclusion ; si la première moitié de la phrase s'enchaîne bien avec ce qui précède, remplacez simplement les deux-points par un point.

P10 Enchaînement logique 〔Testé : IA médiane 7 maillons, humain 2〕

Chaque début de paragraphe reprend le mot-clé de la fin du paragraphe précédent, pas de rupture dans tout le texte. Laissez 1 à 2 sauts naturels dans la chaîne pour que le lecteur participe au raisonnement.

Conserver : les genres qui exigent une cohésion stricte (tutoriels, documents juridiques, etc.).

P11 Triple structure identique 〔Testé : IA 29,4%, humain 10,7%〕

Trois phrases consécutives utilisant la même structure syntaxique (même début, même rythme final). Brisez l'une d'elles : fusionnez, scindez ou changez l'ordre des mots, ne supprimez pas de contenu.

Conserver : la rhétorique intentionnelle (discours, pamphlets) ; les listes ; les trois actions narratives.

P12 Quatre structures de traduction 〔Testé〕

Traitez uniquement quatre types : modificateurs antéposés trop longs (plus de 15 caractères avant le mot principal, ou deux « de » consécutifs) ; propositions antéposées avec « quand… » ; coquilles thématiques comme « pour… », « en ce qui concerne… » ; utilisation consécutive de « Cependant, / Donc, / En outre, » en début de paragraphe. Brisez si possible, conservez si cela remplit une fonction temporelle ou logique réelle.

P13 Densité d'énumération et de compression 〔Testé : virgules d'énumération IA 3,21 vs humain 1,78 pour 1000 mots, apparié récurrent IA 1,45 fois, deux directions〕

Maximum 3 éléments dans une énumération par proposition ; au-delà, développez en liste ou résumez avec un lien vers la source. Interdiction des termes de comptage abstraits — « quatre surveillance », « pack de six comparaisons », « trois diff » — soit les détailler un par un, soit les définir à la première occurrence puis utiliser l'abréviation. Même règle pour les barres obliques.

  • Avant : « M7 inclut refonte de page/importance paramètres/arrêt précoce/quatre surveillance/Retry/formulaire »
  • Après : « M7 inclut six éléments : refonte de la page Agent, analyse d'importance des paramètres, arrêt précoce, quatre surveillances (courbe GPU, estimation de durée, notification desktop, double courbe de perte), Retry en un clic, refonte du formulaire »

Conserver : les arguments de ligne de commande, les tables de codes d'erreur, les listes documentaires ; les énumérations de trois éléments par virgule sont normales (leçon de niveau X : les parallélismes intra-phrase sont courants chez les humains), seulement si plus de quatre éléments avec structure identique.

P14 Table de mots à pondération réduite 〔Testé : différence non significative〕

Les mots de la table « empowerment, prise en main, boucle fermée, approfondissement, sédimentation », etc., ne sont que des indicateurs de faible poids, pas des motifs de modification en soi. Les signaux de structure (P8-P12) priment sur la table de mots.

Niveau X (ne jamais modifier) : les caractéristiques suivantes, testées par appariement, n'ont pas de pouvoir discriminant ou ont une direction opposée : titres avec nombres ordinaux, reformulations de type « cela signifie », phrases vides introduisant des listes, « d'abord / ensuite / en résumé », questions rhétoriques, uniformisation de la longueur des phrases, accumulation de nombres exacts.

R4 Limites stylistiques

P15 Cadre dramatique nécessite demande explicite 〔Convention〕

Personnalité de salle de classe (« matériel distribué », « leçon commence », « musée »), aparté théâtral, cadre d'interview, teaser suspense (« Stop — »), n'activez que si l'utilisateur le demande explicitement. Par défaut, style direct.

P16 Quota de phrases choc 〔Convention〕

Maximum une maxime ou formule choc par texte. Interdiction des annonces de fin de type « en un mot, à retenir ».

P17 Mélange chinois-anglais 〔Ingénierie〕

Ajoutez un espace entre caractères chinois et anglais ; utilisez la ponctuation pleine chinoise dans un contexte chinois ; espace entre nombres et unités. Suivez les détails du guide de typographie chinoise (sparanoid/chinese-copywriting-guidelines).

P18 Ponctuation et parenthèses 〔Ingénierie : GB/T 15834—2011, CY/T 154—2017〕

Ordre de priorité pour les commentaires : apposition directe > parenthèses > tiret. Les commentaires pouvant être écrits en apposition ne prennent pas de parenthèses ; les parenthèses sont pour les notes marginales « qui n'ont pas besoin d'être lues avec le texte principal » ; les tirets sont pour les commentaires qui font partie du texte principal et doivent être lus avec ; dans les textes techniques chinois, utilisez-les rarement (les tirets denses sont aussi une signature d'écriture IA testée).

  • Apposition (préférée) : Utilisez d'abord le script de compression des ressources build_assets.py fourni par le dépôt, puis exécutez
  • Parenthèses (note marginale) : Prend en charge l'exportation par lots (nécessite des droits administrateur)
  • Tirets (commentaire continu, rarement) : si nécessaire, utilisez deux traits ——, sur deux positions, ne cassez pas, généralement sans ponctuation avant

Le choix des parenthèses pleines ou demi-large se fait selon le contenu et le contexte environnant, uniformité dans tout le texte (principe de cohérence CY/T 154) :

ContexteFormeExemple
Traduction par paire « chinois (English) »Pleine largeur, sans espaceMessage Queue (Message Queue)
Commentaire contenant du chinoisPleine largeur, sans espacePrend en charge l'exportation par lots (nécessite des droits administrateur)
Anglais pur, chiffres, versionDemi-largeur, espace avant la parenthèseBasé sur Spring Boot (v3.2.0)
Parenthèse adjacente à du code ou un nom de fichierDemi-largeur, espaces des deux côtésExécutez build.sh (premier run télécharge les dépendances) puis redémarrez

Divergence connue : la convention d'édition utilise pleine largeur pour « chinois (English) » (GB/T 15834, guide d'exemple) ; certaines normes d'ingénierie utilisent demi-largeur avec espace pour tout contenu anglais (Gengo). plain-zh par défaut : pleine largeur pour les traductions, demi-largeur pour les références techniques ; si le projet a sa propre convention, suivez-la et ne changez pas en cours de texte.

Autres règles strictes :

  • Pas d'emboîtement de parenthèses ; si nécessaire, utiliser des formes différentes (extérieur 〔〕intérieur () )
  • Parenthèses intra-phrase : collées immédiatement après le mot commenté, sans point final ; parenthèses extra-phrase : après le point final de la phrase
  • Guillemets : par défaut “” pour le chinois simplifié, ”’ pour l'emboîtement ; guillemets angulaires 「」『』 pour le chinois traditionnel ou si le projet utilise 「 », uniformité dans tout le texte
  • Points de suspension : ……, pas trois points
  • Les éléments d'énumération anglais dans une phrase chinoise utilisent toujours la virgule d'énumération chinoise (ex. : at the bus stop、at the railway station)
  • Maximum 2 commentaires entre parenthèses par paragraphe ; les notes marginales consécutives sont transformées en développement dans le texte

Conserver : parenthèses demi-largeur dans les blocs de code et lignes de commande ; parenthèses dans les formules mathématiques ; parenthèses compactes dans les tableaux ; conventions de mise en page existantes du projet.

R5 Discipline de réécriture (applicable en mode révision)

P19 Modification minimale

Un indicateur ne modifie que la partie strictement nécessaire pour résoudre ce problème, pas de fioriture, ne touchez pas aux mots adjacents. Plus vous modifiez, plus vous introduisez de nouvelles erreurs potentielles. En cas de doute, conservez le texte original.

P20 Conservation de l'information

Faits, chiffres, modificateurs, attribution, étendue de la négation conservés intacts. « Peut-être » ne devient pas « certain », « prévu » ne devient pas « terminé ». Chaque mot de fond ajouté dans la réécriture doit avoir une source dans le texte original.

P21 Structure inchangée

Niveaux de titres, ordre des sections, ordre des paragraphes, position des listes, tableaux, citations, blocs de code sont conservés exactement. Avant de modifier un titre, vérifiez les références et les ancres dans tout le texte.

P22 Auto-vérification après modification

Passez en revue chaque point : les mots de fond ajoutés ont-ils une source ? Tous les termes sont-ils définis à la première occurrence (P1-P3) ? Les termes d'interface sont-ils traduits (P3) ? Les titres sont-ils sans métaphore (P4) ? Les abréviations non définies respectent-elles le quota (P6) ? Le langage antithétique et les deux-points indicatifs sont-ils traités ou justifiés pour conservation (P8-P9) ? La densité d'énumération et de compression est-elle conforme, sans termes de comptage abstraits (P13) ? Ponctuation et parenthèses conformes, commentaires prioritaires en apposition (P18) ? Cadre dramatique non activé ou demandé par l'utilisateur (P15) ?

Répartition des trois niveaux de jugement

  • Indicateurs quantifiables (nombre d'abréviations, densité de métaphores, alternance de mots, densité de tirets) : scriptable, ce projet prévoit une interface detect
  • Jugement sémantique (un indicateur est-il fondé, la limite de conservation s'applique-t-elle) : le modèle juge point par point sur la base des critères fermés de ce fichier, en cas de doute marque « à vérifier »
  • Pertinence des métaphores : lister uniquement les candidates, l'utilisateur décide, le modèle ne juge pas

Workflow de révision

  1. Lisez l'ensemble du texte, déterminez le style et le public cible, listez les affirmations, données et limites à conserver
  2. Examinez point par point selon P1-P18. Pour chaque indicateur, enregistrez : numéro de règle, position de la phrase originale, modification proposée, jugement (à modifier/conserver/erreur/à vérifier). La conservation doit être justifiée spécifiquement, pas seulement « ça semble naturel »
  3. Rapport : groupez les indicateurs par R1-R4 (phrase originale, modification, jugement), statistiques par catégorie (termes/structure/style). Demandez à l'utilisateur de répondre « appliquer les modifications » ou de proposer des ajustements pour l'ensemble des suggestions, pas une décision par point
  4. Après confirmation, réécrivez en respectant P19-P21. Enregistrez « texte original, texte modifié, numéro de règle » pour chaque modification
  5. Vérifiez selon P22, produisez une comparaison avant/après (modifications marquées par suppressions et insertions), vérifiez que les éléments à modifier sont bien éliminés

Vérification avant livraison

  • Chaque terme a une définition ou une traduction à sa première occurrence (P1, P3)
  • Même concept, un seul nom (P2)
  • Titres sans métaphore (P4)
  • Abréviations non définies dans les limites du quota (P6)
  • Langage antithétique et deux-points indicatifs traités ou justifiés pour conservation (P8, P9)
  • Cadre dramatique non activé ou demandé explicitement par l'utilisateur (P15)
  • Énumérations parallèles dans les limites, sans termes de comptage abstraits (P13)
  • Faits, modificateurs, structure non modifiés (P19-P21)
  • Caractéristiques de niveau X non modifiées par erreur

Sources

Licence

MIT

Skills associés