humanize

Was macht humanize?

Überarbeiten Sie die Prosa eines LaTeX-Artikels, sodass sie leichter zu lesen ist und wie von einem sorgfältigen menschlichen Autor klingt. Das Ergebnis wird als separate Kopie der .tex-Datei ausgegeben.

Es geht nicht darum, etwas zu «verschleiern». KI-gestützte Entwürfe haben oft eine erkennbare Textur – übermäßig verweisend, aufgebläht, rhythmisch gleichförmig, aufgefüllt mit Phrasen, die keine Information tragen. Gutachter bemerken das, und es erschwert das Lesen des Papers. Ein guter menschlicher Lektor entfernt diese Textur, indem er jeden Satz etwas Konkretes in der schlichtesten Form sagen lässt, die noch zum Register eines wissenschaftlichen Aufsatzes passt.

Was Sie nicht ändern dürfen

Ein Paper ist eine Aufzeichnung von Behauptungen. Eine Lesbarkeitsbearbeitung, die eine Behauptung verändert, ist ein Fehler, keine Stilentscheidung. Also:

• Lassen Sie die Präambel unberührt (alles vor \begin{document}).
• Bearbeiten Sie niemals Mathematik: Inline $…$, \(…\), abgesetzte Mathematik und Mathematik-Umgebungen (equation, align, …) bleiben bytegenau identisch.
• Behalten Sie jedes \cite…, \ref/\eqref/\cref, \label, \includegraphics, \input und jede Umgebungsgrenze. Sie dürfen ein Zitat innerhalb eines umstrukturierten Satzes verschieben, aber dieselben Schlüssel müssen weiterhin dieselbe Aussage stützen.
• Behalten Sie jede Zahl in der Prosa (Statistiken, p-Werte, Stichprobengrößen, Bereiche) und deren Zuordnung zur richtigen Größe.
• Behalten Sie die Stärke der Behauptungen. Verwandeln Sie „deutet an“ nicht in „zeigt“ oder „unterschied sich nicht konsistent“ in „waren äquivalent“. Kalibrierte Abschwächung ist Teil der Wissenschaft; entfernen Sie nur Abschwächungen, die gestapelt oder leer sind („kann möglicherweise“, „man könnte argumentieren, dass vielleicht“).
• Behalten Sie die Fachbegriffe des Autors. Wenn das Paper „operative Regime“, „Sicherheitszone“, „MRP“ definiert, verwenden Sie genau diese. Ersetzen Sie keine technischen Wörter durch Synonyme – „robust“, „signifikant“, „neuartig“ sind in Ordnung, wenn sie technisch gemeint sind; sie werden nur zu KI-Ticks, wenn sie als Dekoration verwendet werden.
• Behalten Sie die Sprache und Rechtschreibvariante (britisches „behaviour/penalises“ bleibt britisch; Portugiesisch bleibt Portugiesisch).
• Berühren Sie nicht Tabelleninhalte, %-Kommentare, \todo{}-Markierungen oder die Bibliographie.

Wenn ein Satz auf eine Weise unklar ist, dass Sie ihn nur durch Raten beheben können, was die Autoren meinten, lassen Sie ihn stehen und listen Sie ihn stattdessen in Ihrem Bericht auf.

Arbeitsablauf

1. Ziel identifizieren

Nehmen Sie die Datei aus der Nachricht des Benutzers oder dem Slash-Befehl-Argument. Wenn keine angegeben ist, leiten Sie sie aus dem Gespräch ab (das Paper, an dem gearbeitet wird, oder die aktive Datei des Editors – get_editor_state, falls die GilzaCode-Tools verfügbar sind); wenn mehrere .tex-Dateien in Frage kommen (z. B. main6.tex und main7.tex), wählen Sie den neuesten Entwurf und teilen Sie mit, welchen Sie gewählt haben. Wenn der Benutzer nur bestimmte Abschnitte angefragt hat, überarbeiten Sie nur diese.

Wenn die Hauptdatei Inhalte mit \input/\include einbindet, humanisieren Sie jede eingebundene Prosadatei in eine eigene <name>_humanized.tex und passen Sie die \input-Zeilen der Hauptkopie entsprechend an.

2. Kopie erstellen

Kopieren Sie die Datei nach <stamm>_humanized.tex im selben Verzeichnis (damit Abbildungen, .bib und Klasse-Dateien weiterhin aufgelöst werden). Wenn diese Datei bereits existiert, fragen Sie vor dem Überschreiben, oder verwenden Sie <stamm>_humanized2.tex, falls Sie nicht fragen können. Alle Bearbeitungen erfolgen an der Kopie. Schreiben Sie niemals in das Original.

3. Eine Karte der Probleme erstellen

Führen Sie den Scanner auf dem Original aus, um zu sehen, wo KI-ähnliche Muster gehäuft auftreten:

python <skill-verz>/skripte/ai_scan.py pfad/zum/paper.tex

Er meldet markierte Phrasen mit Zeilennummern, Em-Dash-Dichte und Satzlängenstatistiken pro Abschnitt. Behandeln Sie ihn als Heatmap, nicht als To-Do-Liste: Ein Treffer ist eine Stelle, die man sich ansehen sollte, und viele Treffer sind im Kontext in Ordnung. Jedes markierte Wort zu entfernen, während die Satzstruktur intakt bleibt, erzeugt einen ebenso mechanischen Text. Lesen Sie referenzen/muster.md für den vollständigen Musterkatalog (Englisch und Portugiesisch) und wie man jede Art behebt – lesen Sie ihn, bevor Sie mit der Bearbeitung beginnen.

4. Abschnitt für Abschnitt überarbeiten

Lesen Sie jeweils einen Abschnitt (oder ein paar Absätze) und bearbeiten Sie die Kopie mit gezielten Edit-Aufrufen an der Prosa. Wenn Sie Absatz für Absatz vorgehen, bleibt das LaTeX intakt und Sie können das Argument des Abschnitts im Kopf behalten.

Fragen Sie sich bei jedem Absatz: Was behauptet dieser Absatz, und was ist der kürzeste klare Weg, den ein kompetenter Autor in diesem Fachgebiet sagen würde? Dann:

• Streichen Sie, was keine Information trägt: Metakommentare („Es ist erwähnenswert, dass“, „In diesem Abschnitt werden wir diskutieren“), zusammenfassende Wiederholungen am Ende von Absätzen, einleitende Floskeln, dekorative Verstärker.
• Bevorzugen Sie das Konkrete: Ersetzen Sie eine vage Abstraktion durch die spezifische Sache („verbessert die Leistung“ → „überlebt 48 Schritte länger“, wenn das Paper dies irgendwo in der Nähe sagt; andernfalls lassen Sie es einfach schlicht).
• Verbessern Sie die Satzstruktur für die Lesbarkeit: Setzen Sie Subjekt und Verb nahe beieinander und nahe am Satzanfang; teilen Sie Sätze, die drei Ideen tragen; verbinden Sie abgehackte Fragmente, die zusammengehören; verschieben Sie bekannte Informationen an den Satzanfang und neue Informationen ans Ende; verwandeln Sie Nominalisierungen wieder in Verben („eine Analyse durchführen“ → „analysieren“).
• Variieren Sie den Rhythmus wie ein Mensch – mal kurze Sätze, mal lange – statt einer gleichmäßigen Kadenz oder gleichmäßigen Absatzformen.
• Durchbrechen Sie formelhafte Strukturen: erzwungene Dreierlisten, „nicht nur X, sondern auch Y“, „X, nicht Y“-Kontraste, die nur zur Wirkung dienen, Doppelpunkt-Enthüllungen („Die Antwort ist einfach: …“), Ketten von Em-Dashes und Absätze, die alle mit einem Überleitungswort beginnen.
• Behalten Sie, was bereits funktioniert. Viele Sätze in einem anständigen Entwurf sind in Ordnung. Jeden Satz zu bearbeiten ist selbst ein KI-Merkmal und erhöht das Risiko, die Bedeutung zu verändern. Ein typischer guter Durchgang schreibt zwischen einem Fünftel und der Hälfte der Sätze um, konzentriert auf die Stellen, an denen der Scanner und Ihre Lektüre Probleme finden.

Abschnittsüberschriften, Bildunterschriften und die Zusammenfassung sind Prosa und können mit der gleichen Sorgfalt bearbeitet werden; halten Sie Überschriften kurz und den Inhalt der Bildunterschriften (was dargestellt wird, was die Symbole bedeuten) vollständig.

5. Integrität prüfen

Führen Sie den Prüfer aus, der Original und Kopie vergleicht:

python <skill-verz>/skripte/check_integrity.py pfad/zum/paper.tex pfad/zum/paper_humanized.tex

Er vergleicht die Präambel, Mathematiksegmente, Zitierschlüssel, Referenzen, Labels, Umgebungen, Grafikpfade, Klammerbalance und Zahlen in der Prosa. Beheben Sie jeden ERROR, bevor Sie fertig sind. Sehen Sie sich jede WARN an (normalerweise eine Zahl oder ein Zitat, das verschoben oder verschwunden ist) und stellen Sie sie entweder wieder her oder bestätigen Sie, dass die Änderung harmlos ist. Führen Sie dann ai_scan.py erneut auf der Kopie aus, um zu bestätigen, dass die Hotspots abgekühlt sind.

Wenn ein LaTeX-Compiler verfügbar ist (GilzaCodes compile_latex, tectonic, latexmk, pdflatex), kompilieren Sie die Kopie, um sicherzustellen, dass sie baut. Verwenden Sie dafür nicht viel Zeit, wenn die Umgebung keinen Compiler hat – der Integritätscheck deckt bereits die üblichen Bruchstellen ab.

6. Bericht

Schließen Sie mit einem kurzen Bericht im Gespräch, in der Sprache des Benutzers:

• Pfad der humanisierten Kopie (das Original ist unverändert).
• Welche Arten von Änderungen Sie vorgenommen haben, mit 3–5 repräsentativen Vorher/Nachher-Paaren (jeweils eine Zeile, gekürzt).
• Scanner-Zahlen vorher vs. nachher (markierte Phrasen, Em-Dashes, mittlere Satzlänge) – kurz.
• Ergebnis des Integritätschecks.
• Alles, was Sie bewusst unverändert gelassen haben und warum: Passagen, die unklar oder möglicherweise inhaltlich falsch erscheinen, Behauptungen, die stärker wirken als die Beweislage, inkonsistente Terminologie. Markieren Sie diese; beheben Sie sie nicht stillschweigend.

Wenn der Benutzer eine Überarbeitung für eine Zeitschrift vorbereitet, bieten Sie an, einen latexdiff zwischen dem Original und der Kopie zu erstellen (falls latexdiff installiert ist), damit er die Änderungen visuell überprüfen kann.