humanize

Que fait humanize ?

Révisez la prose d'un article LaTeX pour qu'elle soit plus facile à lire et ressemble à celle d'un auteur humain attentif, et livrez le résultat sous forme d'une copie séparée du fichier .tex.

Le but n'est pas de « camoufler » quoi que ce soit. Les brouillons assistés par IA ont tendance à partager une texture reconnaissable – sur-structurée, enflée, rythmiquement uniforme, alourdie par des phrases qui n'apportent aucune information. Les relecteurs le remarquent et cela rend les articles plus difficiles à lire. Un bon éditeur humain supprime cette texture en faisant en sorte que chaque phrase dise quelque chose de spécifique, dans la forme la plus simple qui convienne encore au registre d'un article académique.

Ce que vous ne devez pas modifier

Un article est un enregistrement d'affirmations. Une modification de lisibilité qui change une affirmation est un bogue, pas un choix de style. Donc :

• Laissez le préambule intact (tout ce qui se trouve avant \begin{document}).
• Ne modifiez jamais les maths : les formules inline $…$, \(…\), les mathématiques d'affichage et les environnements mathématiques (equation, align, …) restent identiques octet par octet.
• Conservez chaque \cite…, \ref/\eqref/\cref, \label, \includegraphics, \input et chaque délimiteur d'environnement. Vous pouvez déplacer une citation à l'intérieur d'une phrase que vous restructurez, mais les mêmes clefs doivent toujours soutenir la même affirmation.
• Conservez chaque nombre dans la prose (statistiques, p-values, tailles d'échantillon, plages) et son lien avec la bonne quantité.
• Conservez la force des affirmations. Ne transformez pas « suggère » en « montre » ni « ne différait pas de manière cohérente » en « étaient équivalents ». Les nuances calibrées font partie de la science ; ne retirez que les précautions qui sont empilées ou vides (« pourrait potentiellement », « on pourrait soutenir que peut-être »).
• Conservez les termes techniques de l'auteur. Si l'article définit des « régimes opérationnels », une « zone de sécurité », « MRP », utilisez exactement ces termes. Ne remplacez pas des mots techniques par des synonymes – « robuste », « significatif », « novateur » sont acceptables lorsqu'ils sont techniques, ils ne deviennent des tics d'IA que lorsqu'ils sont utilisés comme décoration.
• Conservez la langue et la variante orthographique (l'anglais britannique « behaviour/penalises » reste britannique ; le portugais reste portugais).
• Ne touchez pas au contenu des tableaux, aux commentaires %, aux marqueurs \todo{}, ni à la bibliographie.

Si une phrase n'est pas claire d'une manière que vous ne pouvez corriger qu'en devinant ce que les auteurs voulaient dire, laissez-la et listez-la dans votre rapport au lieu de la réécrire.

Procédure

1. Identifier la cible

Prenez le fichier à partir du message de l'utilisateur ou de l'argument de la commande slash. Si aucun n'est donné, déduisez-le de la conversation (l'article en cours de travail, ou le fichier actif de l'éditeur – get_editor_state si les outils GilzaCode sont disponibles) ; si plusieurs fichiers .tex sont candidats (par exemple, main6.tex et main7.tex), choisissez le brouillon le plus récent et dites lequel vous avez choisi. Si l'utilisateur n'a demandé que des sections spécifiques, révisez uniquement celles-ci.

Si le fichier principal inclut du contenu avec \input/\include, humanisez chaque fichier de prose inclus en son propre <nom>_humanized.tex et faites pointer les lignes \input de la copie principale vers eux.

2. Créer la copie

Copiez le fichier en <base>_humanized.tex dans le même répertoire (afin que les figures, .bib et fichiers de classe restent accessibles). Si ce fichier existe déjà, demandez avant d'écraser, ou utilisez <base>_humanized2.tex si vous ne pouvez pas demander. Toutes les modifications vont dans la copie. N'écrivez jamais sur l'original.

3. Obtenir une carte des problèmes

Exécutez le scanner sur l'original pour voir où les motifs de style IA se concentrent :

python <chemin-du-skill>/scripts/ai_scan.py chemin/vers/article.tex

Il signale les phrases signalées avec les numéros de ligne, la densité de tirets cadratins et les statistiques de longueur de phrases par section. Traitez-le comme une carte de chaleur, pas comme une liste de tâches : un signalement est un endroit à regarder, et de nombreux signalements sont normaux dans leur contexte. Supprimer chaque mot signalé tout en conservant la structure de la phrase produit un texte tout aussi mécanique. Lisez references/patterns.md pour le catalogue complet des motifs (anglais et portugais) et pour savoir comment corriger chaque type – lisez-le avant de commencer à éditer.

4. Réviser, section par section

Lisez une section (ou quelques paragraphes) à la fois et éditez la copie avec des appels Edit ciblés sur la prose. Travailler paragraphe par paragraphe préserve le LaTeX intact et vous permet de garder à l'esprit l'argument de la section.

Pour chaque paragraphe, demandez-vous : que prétend ce paragraphe, et quelle est la manière la plus courte et la plus claire qu'un auteur compétent dans ce domaine dirait cela ? Ensuite :

• Supprimez ce qui n'apporte aucune information : méta-commentaires (« Il convient de noter que », « Dans cette section, nous allons discuter »), résumés redondants en fin de paragraphes, amorces de phrases vides, intensificateurs décoratifs.
• Préférez le concret : remplacez une abstraction vague par la chose spécifique (« améliore les performances » → « survit 48 étapes de plus », si l'article le dit quelque part à proximité ; sinon, restez simple).
• Améliorez la structure des phrases pour la lisibilité : rapprochez le sujet et le verbe et placez-les près du début ; scindez les phrases qui portent trois idées ; reliez les fragments hachés qui vont ensemble ; placez les informations familières au début d'une phrase et les nouvelles informations à la fin ; transformez les nominalisations en verbes (« effectuer une analyse de » → « analyser »).
• Variez le rythme comme le ferait une personne – quelques phrases courtes, quelques-unes longues – au lieu d'une cadence uniforme ou de formes de paragraphes identiques.
• Brisez les structures formulaires : triades forcées, « non seulement X mais aussi Y », contrastes « X, pas Y » utilisés pour l'effet, révélations après deux-points (« La réponse est simple : … »), chaînes de tirets cadratins, et paragraphes qui commencent tous par un mot de transition.
• Conservez ce qui fonctionne déjà. De nombreuses phrases dans un brouillon correct sont bien. Toucher à chaque phrase est lui-même une signature d'IA et augmente le risque de modifier le sens. Un bon passage typique réécrit entre un cinquième et la moitié des phrases, concentrées là où le scanner et votre lecture trouvent des problèmes.

Les titres de sections, les légendes et le résumé sont de la prose et peuvent être édités avec le même soin ; gardez les titres courts et le contenu des légendes complet (ce qui est tracé, ce que signifient les symboles).

5. Vérifier l'intégrité

Exécutez le vérificateur comparant l'original et la copie :

python <chemin-du-skill>/scripts/check_integrity.py chemin/vers/article.tex chemin/vers/article_humanized.tex

Il compare le préambule, les segments mathématiques, les clefs de citation, les références, les étiquettes, les environnements, les chemins d'images, l'équilibre des accolades et les nombres dans la prose. Corrigez chaque ERREUR avant de terminer. Examinez chaque AVERTISSEMENT (généralement un nombre ou une citation qui a bougé ou disparu) et soit restaurez-le, soit confirmez que le changement est inoffensif. Ensuite, réexécutez ai_scan.py sur la copie pour confirmer que les points chauds se sont refroidis.

Si un compilateur LaTeX est disponible (compile_latex de GilzaCode, tectonic, latexmk, pdflatex), compilez la copie pour vous assurer qu'elle se construit. Ne passez pas trop de temps là-dessus si l'environnement n'a pas de compilateur – la vérification d'intégrité couvre déjà les cassures habituelles.

6. Rapporter

Terminez par un court rapport dans la conversation, dans la langue de l'utilisateur :

• Chemin de la copie humanisée (l'original n'est pas modifié).
• Types de modifications que vous avez apportées, avec 3 à 5 paires avant/après représentatives (une ligne chacune, tronquées).
• Chiffres du scanner avant vs après (phrases signalées, tirets cadratins, longueur moyenne des phrases) – brièvement.
• Résultat de la vérification d'intégrité.
• Tout ce que vous avez délibérément laissé de côté et pourquoi : passages qui semblent peu clairs ou potentiellement erronés sur le fond, affirmations qui paraissent plus fortes que les preuves, terminologie incohérente. Signalez-les ; ne les corrigez pas en silence.

Si l'utilisateur prépare une révision pour une revue, proposez de produire un latexdiff entre l'original et la copie (si latexdiff est installé) afin qu'il puisse examiner visuellement les changements.