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 :
- 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.
- 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.
- 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) :
| Contexte | Forme | Exemple |
|---|---|---|
| Traduction par paire « chinois (English) » | Pleine largeur, sans espace | Message Queue (Message Queue) |
| Commentaire contenant du chinois | Pleine largeur, sans espace | Prend en charge l'exportation par lots (nécessite des droits administrateur) |
| Anglais pur, chiffres, version | Demi-largeur, espace avant la parenthèse | Basé sur Spring Boot (v3.2.0) |
| Parenthèse adjacente à du code ou un nom de fichier | Demi-largeur, espaces des deux côtés | Exé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
- Lisez l'ensemble du texte, déterminez le style et le public cible, listez les affirmations, données et limites à conserver
- 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 »
- 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
- Après confirmation, réécrivez en respectant P19-P21. Enregistrez « texte original, texte modifié, numéro de règle » pour chaque modification
- 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
- lieflat-less-ai-tone : tous les critères de R3 et la liste de niveau X (629 articles appariés + 270 paires testées deux fois)
- Fenng/Tech-Doc-Style-Chinese : approche de rédaction contrôlée ASD-STE100 (P2, P3)
- francoisdp/skills (anti-ai-writing) : architecture double mode et règle 25 « définir avant d'utiliser » (P1)
- op7418/Humanizer-zh : conservation des limites en trois phases et conservation de l'information (R5)
- sparanoid/chinese-copywriting-guidelines : normes de mélange (P17)
- GB/T 15834—2011《标点符号用法》、CY/T 154—2017《中文出版物夹用英文的编辑规范》 : formes de ponctuation et principe de cohérence stylistique (P18)
- Guide de style chinois de Gengo : règles techniques pour la sélection des parenthèses selon le contenu (P18)
- cloudflare-docs eli5 skill : analogies et limites (P7)
- opencue/cuecards ai-slop-detector : fondement cognitif pour les abréviations non définies (P6)
Licence
MIT