Papierpolierer
Umfang und Referenzen
Verwenden Sie dieses Skill für TeX-sicheres akademisches Englisch-Polieren, Übersetzen, Korrekturlesen, Quell-zu-Ausgabe-Verifikation, Begriff- oder Notationsüberprüfung, numerische Konsistenzüberprüfung und explizit autorisierte Notationsnormalisierung.
Lesen Sie für vollständige Arbeiten, lange Abschnitte, Verifikation, Konsistenzaudits, Normalisierung oder strenge Stilrichtlinienarbeit references/tex_safe_polishing.md, bevor Sie handeln. Lesen Sie stattdessen references/tex_safe_polishing_zh.md, wenn eine chinesischsprachige Workflow-Anleitung sachdienlich ist; laden Sie nicht beide, um lediglich Kontext zu duplizieren. Verwenden Sie für ein kurzes lokales Polieren die unten stehenden Kernregeln und konsultieren Sie eine Referenz nur bei Bedarf.
Verwenden Sie dieses Skill nicht als Hauptwerkzeug für:
- Neuheits-, Beitragsverteidigungs-, Gefährliche-Baseline- oder Gutachterangriff-Audits; verwenden Sie
idea-novelty-auditor, falls verfügbar; - Literaturrecherche, Lückenformulierung, Referenzauswahl oder Zitierrollenzuweisung; verwenden Sie
problem-driven-literature-review, falls verfügbar; - breite Handlungsstrang-, Einleitungsstruktur- oder Experiment-zu-Behauptung-Neugestaltung; verwenden Sie
paper-argument-reconstructor, falls verfügbar.
Wenn eine Anfrage diese Aufgaben mit Polieren kombiniert, führen Sie zuerst die vorgelagerte Denkaufgabe durch und verwenden Sie dieses Skill nur für den finalen getreuen Sprach- und Konsistenzdurchlauf.
Modusauswahl und Vorrang
Folgen Sie der explizit angeforderten Aktion des Benutzers, bevor Sie berücksichtigen, wer die Eingabe produziert hat. Die Herkunft allein überschreibt niemals eine explizite Anfrage zum Polieren, Auditieren, Verifizieren oder Normalisieren. Wenn mehr als eine Aktion angefordert wird, halten Sie deren Artefakte und Berichte getrennt, es sei denn, der Benutzer bittet um ein kombiniertes Ergebnis.
Modusspezifische Ausgaberegeln haben Vorrang vor Ausgaberegeln basierend auf der Dokumentenlänge. Insbesondere bleibt eine Verifikation des vollständigen Manuskripts oder ein reines Konsistenzaudit ein reiner Bericht.
Wenn der Benutzer sowohl eine Notationsnormalisierung als auch eine Prosa-Polierung anfordert, führen Sie die Normalisierung zuerst durch und genehmigen Sie diese, behandeln Sie das normalisierte TeX als neue Baseline und polieren Sie dann gegen diese Baseline. Versuchen Sie nicht, eine kombinierte Prosa-und-Symbol-Änderung als einen Normalisierungsvergleich zu validieren.
Standard-Poliermodus
Polieren oder übersetzen Sie den bereitgestellten Text, während Sie jedes geschützte Element bewahren. Führen Sie für ein vollständiges Manuskript auch Begriff-, Notations- und quellinterne numerische Konsistenzaudits durch und melden Sie Quellprobleme, ohne diese stillschweigend zu korrigieren.
Verifikationsmodus
Verwenden Sie den Verifikationsmodus, wenn der Benutzer bittet, einen Kandidaten mit einem Original zu vergleichen oder qualitätszuprüfen.
- Fordern Sie sowohl das Original als auch den Kandidaten für jedes vergleichende Urteil über TeX, Mathematik, Zahlen, Einheiten, Zeichen, Zitate, technische Bedeutung oder Behauptungsstärke an.
- Wenn das Original nicht verfügbar ist, überprüfen Sie nur intrinsische Eigenschaften des Kandidaten und markieren Sie jede quellvergleichende Prüfung als
NOT ASSESSED; leiten Sie niemals die Bewahrung allein aus dem Kandidaten ab. - Schreiben Sie den Kandidaten im Verifikationsmodus niemals um oder reparieren Sie ihn, auch nicht bei Verstößen gegen harte Regeln. Melden Sie jede Abweichung und deren Ort. Wenden Sie Korrekturen nur in einem separaten, explizit angeforderten Bearbeitungsdurchlauf oder -modus an.
- Trennen Sie vom Kandidaten eingeführte Abweichungen von Begriff-, Notations- oder numerischen Konflikten, die bereits in der Quelle vorhanden sind.
Konsistenzaudit-Modus
Wenn der Benutzer nur nach Begriff-, Variablen-, Symbol-, Notations- oder numerischer Konsistenz fragt, schreiben Sie das Manuskript nicht um. Auditieren Sie den verfügbaren Umfang und melden Sie je nach Anwendbarkeit TERM-*-, SYM-*- und NUM-*-Befunde. Lassen Sie Quelltext, Symbole, Werte, Einheiten und Zeichen unverändert.
Modus für genehmigte Notationsnormalisierung
Verwenden Sie diesen Modus nur, wenn der Benutzer explizit eine Normalisierung anfordert und eine genaue Symbolabbildung genehmigt hat. Eine genehmigte Abbildung muss die mathematische Entität, alte und neue Symbole, den betroffenen Umfang oder die betroffenen Stellen sowie alle beabsichtigten Aliase oder Ausnahmen identifizieren.
- Wenden Sie nur die genehmigten Symbolsubstitutionen an. Interpretieren Sie Definitionen nicht neu oder wählen Sie ein kanonisches Symbol im Namen des Benutzers.
- Zeichnen Sie jede angewandte Substitution als
AUTHORIZED CHANGEauf; behandeln Sie jede nicht abgebildete mathematische, strukturelle, textuelle oder numerische Differenz als Fehler. - Lassen Sie alle Zahlen, Einheiten, Prozentsätze, Dimensionen, Stichprobengrößen, Reihenfolge numerischer Token und positive, negative oder Plus-Minus-Zeichen unverändert.
- Wenn ein betroffenes Symbol in einer nicht verfügbaren oder nicht bearbeitbaren Abbildungsressource, einer benutzerdefinierten Umgebung, einer generierten Datei oder einer nicht aufgelösten Makroerweiterung auftritt, melden Sie die nicht aufgelöste Stelle und behaupten Sie keine vollständige Normalisierung.
- Validieren Sie das normalisierte Ergebnis gegen die genehmigte Abbildung. Wenn ein abbildungsbewusster Vergleich nicht verfügbar ist, holen Sie die Genehmigung des normalisierten TeX als neue autorisierte Baseline ein und verwenden Sie dann einen strengen Vergleich gegen diese Baseline für alle nachfolgenden Polierarbeiten.
Verwenden Sie --allow-additions nicht, um Symboländerungen zu autorisieren. Ändern Sie in keinem Papierpolierer-Modus eine Zahl, Einheit oder ein numerisches Zeichen, selbst nachdem Sie einen NUM-*-Konflikt gemeldet haben. Bitten Sie den Benutzer, die Quelle außerhalb dieses Skills zu korrigieren und das korrigierte TeX als neue autorisierte Baseline bereitzustellen; leiten Sie niemals einen Ersatzwert ab oder wenden Sie ihn an.
Gemeinsamer Abdeckungs- und Ergebnisbericht
Melden Sie Abdeckung und Ergebnis getrennt für jedes Begriff-, Notations- und numerische Konsistenzaudit.
Coverage: FULL MANUSCRIPTbedeutet, dass die unten stehende Vollständigkeitsprüfung bestanden wurde.Coverage: PARTIALbedeutet, dass der angegebene lokale oder auflösbare Umfang auditiert wurde.Result: PASSbedeutet, dass innerhalb des bewerteten Umfangs kein Konflikt oder keine ungelöste Mehrdeutigkeit gefunden wurde.Result: ISSUE REPORTEDbedeutet, dass mindestens eine eindeutige Inkonsistenz gefunden wurde und kein Befund noch eine Autorenentscheidung erfordert.Result: AUTHOR DECISION REQUIREDbedeutet, dass mindestens ein plausibler Befund nicht allein aus dem Manuskript aufgelöst werden kann. Bestätigte Probleme bleiben einzeln alsISSUE REPORTEDgekennzeichnet.Result: NOT ASSESSEDbedeutet, dass dieses Audit oder dieser Vergleich überhaupt nicht durchgeführt werden konnte. Verwenden Sie es nicht nur, weil die Abdeckung partiell ist.
Weisen Sie deterministische Befundkennungen in wurzelrelativer Datei- und Quellreihenfolge zu: TERM-001, SYM-001 und NUM-001. Geben Sie jedem Befund eine genaue Datei-und-Zeilen-Position, wenn Dateien verfügbar sind; andernfalls verwenden Sie den stabilsten verfügbaren Abschnitt, Gleichung, Tabelle, Algorithmus, Bildunterschrift oder zitierten Textanker.
Verwenden Sie ISSUE REPORTED für eine bestätigte Inkonsistenz. Verwenden Sie AUTHOR DECISION REQUIRED, wenn die Beweise nicht feststellen können, ob die verglichenen Verwendungen sich auf dieselbe Entität, dasselbe Konzept, dieselbe Größe oder dieselbe Versuchsbedingung beziehen oder ob ihr Unterschied beabsichtigt ist. Halten Sie Konfliktsicherheit von Abhilfemaßnahmen getrennt: Ein bestätigter Konflikt bleibt ISSUE REPORTED, selbst wenn der Autor noch den Ersatzbegriff, das Ersatzsymbol oder den Ersatzwert wählen muss.
Vollständigkeitsprüfung für vollständige Manuskripte
Beanspruchen Sie die Abdeckung FULL MANUSCRIPT nur, nachdem alle folgenden Bedingungen erfüllt sind:
- Identifizieren Sie die maßgebliche root-TeX-Datei und lösen Sie jeden statisch erreichbaren
\input,\include,\subfile,\importund äquivalenten Include in der Dokumentenreihenfolge auf. - Berücksichtigen Sie fehlende, bedingte, makrogenerierte, generierte oder zyklische Includes und jeden notationsführenden Anhang oder jedes Supplement.
- Überprüfen Sie notationsproduzierende Benutzermakros und benutzerdefinierte Mathematik-Umgebungen; verlassen Sie sich nicht auf einen Bewahrungsskript-Durchlauf, um sie zu expandieren oder zu verstehen.
- Überprüfen Sie Notation und numerische Behauptungen in Prosa, Gleichungen, Algorithmen, Bildunterschriften, Tabellen und bereitgestellten Abbildungsressourcen. Wenn eine Ressource relevanten eingebetteten Text enthält, aber nicht überprüft werden kann, ist die Abdeckung partiell. Wenn die Normalisierung eine Abbildung betrifft, aber die bearbeitbare Quelle nicht verfügbar ist, ist die Normalisierung unvollständig.
- Behalten Sie die wurzelrelativen Datei- und Zeilenpositionen für Befunde bei und verifizieren Sie, dass kein angeforderter Umfang übersprungen wurde.
Wenn eine Bedingung fehlschlägt, geben Sie die Abdeckungslücke an und verwenden Sie Coverage: PARTIAL. Ein vollständiger Dateiupload allein begründet keine vollständige analytische Abdeckung.
Nicht verhandelbare Regeln
- Bewahren Sie TeX-Strukturen, Umgebungen, Zitate, Labels, Referenzen, Literaturverzeichnisschlüssel, Funktionsnamen, Modulnamen, Datensatznamen, Metriknamen und technische Bedeutung.
- Bewahren Sie genaue Argumente und Schlüssel innerhalb struktureller Befehle wie
\label{...},\ref{...},\eqref{...},\includegraphics{...}, Zitierbefehle,\bibitem{...}und BibTeX-Schlüssel. Benennen Sie sie nicht um, führen Sie sie nicht zusammen, löschen Sie sie nicht, ordnen Sie sie nicht neu oder normalisieren Sie sie nicht. - Behandeln Sie Kommentare und Literal- oder codeähnliche Quellen, einschließlich
comment,verbatim, Listing-Umgebungen und Inline-Literal-Befehle, in jedem Modus als exakte geschützte Quelle. Verschieben Sie keine Prosa in oder aus diesen Bereichen, ändern Sie einen Inline-Kommentar in einen Ganzzeilen-Kommentar oder verschieben Sie sie über geschützte Mathematik- oder TeX-Strukturen hinweg. - Bewahren Sie beim Polieren, Übersetzen, Hinzufügen von Prosa und Verifizieren jeden ursprünglichen mathematischen Bereich und seine Dokumentenreihenfolge. Die einzige Ausnahme ist eine exakte Substitution, die in einer autorgenehmigten Notationsabbildung aufgeführt ist.
- Bewahren Sie beim Polieren, Übersetzen, Hinzufügen von Prosa, Verifizieren, Konsistenzauditieren und Notationsnormalisieren jede Zahl, Einheit, jeden Prozentsatz, jede Dimension, jeden Parameter, jede Stichprobengröße, jeden Tabellenwert, jeden in einer Abbildung berichteten Wert, jede Signifikanzmarkierung, jede Reihenfolge numerischer Token und jedes positive, negative oder Plus-Minus-Zeichen. Dies schließt Ziffern in Bezeichnern und numerische Token innerhalb von Kommentaren, Literalbeispielen, URLs oder geschützten Befehlsargumenten ein. Es gibt keine numerische Bearbeitungsausnahme in diesem Skill, und
--allow-additionslockert diese Regel nicht. - Behandeln Sie Quell-zu-Ausgabe-Bewahrung und quellinterne Konsistenz als separate Prüfungen. Quellinterne Begriffs-, Symbol-, Wert-, Einheiten- oder Zeichenkonflikte sind Befunde, keine Genehmigung zum Bearbeiten.
- Korrigieren Sie in diesem Skill niemals einen verdächtigen Wert. Bitten Sie den Benutzer nach der Meldung eines
NUM-*-Befundes, die Quelle extern zu überarbeiten und eine autorgenehmigte Baseline zurückzugeben. - Ändern Sie keine mathematischen Definitionen, Theorembedingungen, Beweislogik, Algorithmusschritte, Versuchseinstellungen, berichteten Ergebnisse, Baseline oder Datensätze.
- Ändern Sie in diesem Skill keine Literaturverzeichniseinträge oder -kennungen. Eine Referenzbereinigungsanfrage darf nur nicht-numerische, nicht-kennungsbezogene Metadatenänderungen autorisieren, die nicht mit einer anderen geschützten Regel in Konflikt stehen; Jahre, Seiten, Bände, Heftnummern, DOI/URL/arXiv-Kennungen und jeder andere numerische Token müssen außerhalb des Papierpolierers korrigiert und als autorgenehmigte Baseline zurückgegeben werden.
- Erfinden Sie keine Behauptungen, Experimente, Garantien, Bereitstellungswerte, Einschränkungen oder Schlussfolgerungen.
- Variieren Sie technische Begriffe nicht nur aus stilistischen Gründen. Verwenden Sie kanonische Begriffe nur, wenn ihre Entitätszuordnung unterstützt wird.
- Vermeiden Sie mechanische Wiederholungen in Satzanfängen, Satzgliedstellung, Diathese, Übergängen und Absatzstruktur, ohne geschützte Inhalte zu ändern.
- Verwenden Sie in autorenverfasster Manuskriptprosa keine Bindestrich-Interpunktion. Bewahren Sie lexikalische Bindestriche, mathematische Minuszeichen, vorzeichenbehaftete Werte, geschützte Schlüssel, URLs, DOI-Strings, Dateinamen, Zitierschlüssel und Literaturverzeichnismetadaten exakt.
Wenn eine angeforderte Bearbeitung gegen diese Regeln verstoßen würde und nicht durch eine genaue genehmigte Abbildung abgedeckt ist, stoppen Sie diese Bearbeitung und melden Sie, welche Autorisierung oder Quellinformation fehlt. Wenn Ihr eigener Entwurf gegen eine Regel verstößt, überarbeiten Sie ihn, bevor Sie ihn zurückgeben.
Workflow
- Wählen Sie den Modus aus der expliziten Absicht des Benutzers und identifizieren Sie den bereitgestellten Umfang.
- Wenden Sie für vollständige Manuskripte die Vollständigkeitsprüfung an und bewahren Sie die aufgelöste Dokumentenreihenfolge.
- Erstellen Sie die relevanten Tabellen:
- Begriffe: Entität, kanonischer Begriff, zulässige kontextuelle Formen, Definitionen und Positionen;
- Notation: mathematische Entität, Symbol, Definitionen und Verwendungen, Umfang, Typ oder Dimensionen, Rahmen und Aliase;
- Numerisch: gemessene oder konfigurierte Größe, Wert, Einheit, Zeichen, Bedingung, Quellposition und übereinstimmende Prosa-/Tabellen-/Abbildungsverwendungen.
- Überarbeiten Sie im Poliermodus die Prosa, während Sie geschützte Mathematik und numerische Token-Reihenfolge fix halten. Ordnen Sie Klauseln oder Sätze nur um, wenn dies nicht dazu führt, dass geschützte Mathematik, Zahlen, Einheiten oder Zeichen umgeordnet werden.
- Führen Sie bidirektionale Konsistenzprüfungen durch: Entität zu Begriff oder Symbol, Begriff oder Symbol zu Entität sowie Größe oder Versuchsbedingung zu berichtetem Wert, Einheit und Zeichen.
- Führen Sie Satzarchitektur-, bindestrichfreie Prosa-, objektive Ton- und Behauptungsgrenzenprüfungen über den bewerteten Umfang durch.
- Wenn Original- und Kandidatendateien verfügbar sind, führen Sie die Bewahrungsprüfung durch. Verwenden Sie den Projektmodus für ein mehrteiliges Manuskript.
- Geben Sie die modusspezifische Ausgabe zurück und unterscheiden Sie autorisierte Änderungen, Quellbefunde, vom Kandidaten eingeführte Abweichungen und nicht bewertete Prüfungen.
Bewahrungsprüfer
Führen Sie für eine Original- und eine Kandidaten-TeX-Datei einen strengen Vergleich durch:
python3 paper-polisher/scripts/check_preservation.py original.tex candidate.tex
Verwenden Sie --allow-additions nur, wenn der Benutzer gewöhnliche Prosazusätze autorisiert hat:
python3 paper-polisher/scripts/check_preservation.py original.tex candidate.tex --allow-additions
Diese Option erlaubt keine neuen, gelöschten, geänderten oder neu angeordneten strukturellen Schlüssel, Mathematikbereiche, numerischen Token, Einheiten oder Zeichen. Erkannte Kommentare und Literal- oder codeähnliche Bereiche bleiben exakte geschützte Quelle, einschließlich ihrer Inline- versus Ganzzeilen-Kommentargrenze und ihrer Reihenfolge relativ zu geschützter Mathematik und TeX. Vergleichen Sie jedes benutzerdefinierte oder nicht erkannte Literalmakro manuell. Sie autorisiert keine neuen Abbildungen, Tabellen, Gleichungen, Referenzen, Bildressourcen oder Symbolabbildungen. Richten Sie eine autorgenehmigte Baseline für beabsichtigte geschützte strukturelle Änderungen ein oder verwenden Sie extern korrigiertes und autorgenehmigtes TeX als neue Baseline, wenn numerische Inhalte außerhalb des Papierpolierers korrigiert werden mussten.
Für ein mehrteiliges Manuskript übergeben Sie die beiden maßgeblichen root-TeX-Dateien und aktivieren Sie die Projektnavigation:
python3 paper-polisher/scripts/check_preservation.py original/main.tex candidate/main.tex --project
Der Projektmodus löst statisch erreichbare \input-, \include-, \subfile-, \subfileinclude-, \import-, \subimport-, \inputfrom-, \subinputfrom-, \includefrom- und \subincludefrom-Direktiven von jeder Wurzel aus auf, einschließlich des aktuellen und vorherigen Verzeichnispfads für \import-Stil-Direktiven. Die Auflösung folgt der Dokumentenreihenfolge und behandelt alle restlichen Include-Typen als statische Inline-Kopie der enthaltenen Datei, selbst wenn die Mechanik des Quellformatierers diese Annahme verletzt.