Was macht Wissenschaftliches Schreiben in den Naturwissenschaften?
Hilft einem Autor, einen Abschnitt eines wissenschaftlichen Zeitschriftenartikels zu verfassen, zu überarbeiten oder zu prüfen – für englische Muttersprachler und Nicht-Muttersprachler. Nicht für Förderanträge, Begleitschreiben, Erwiderungen, Abschlussarbeiten oder Übersichtsartikel. Pfade unten sind relativ zu diesem Ordner.
Arbeitsablauf
Eine Schritt-Engine, scripts/engine.py, enthält den Arbeitsablauf: die Schritte, ihre Reihenfolge, die Dateien, die jeder Schritt liest, die Integritätsprüfung und die Ausgabevorlage. Sie führen jeden Schritt mit Ihrem eigenen Urteil durch und geben das Ergebnis zurück. Führen Sie sie im Projektordner des Autors mit dem vollständigen Pfad zu diesem Skill-Ordner und python3 aus. Sie gibt JSON aus und fragt nie nach; sie startet keine weitere Agentensitzung.
- Übergeben Sie der Engine nur das, was der Code nicht im Text sehen kann. Sie entscheidet über die Auszeichnung (LaTeX, Markdown, Klartext), Entwurf vs. Überarbeitung und den Abschnitt (anhand von Überschriften) selbst;
starthat keine--markup-Option. Entwurf vs. Überarbeitung bedeutet Notizen vs. vollständige Absätze, außer bei einer Überschrift: eine kurze Zeile Überschriftentext ist Überarbeitung, und Notizen, Aufzählungspunkte oder ein vollständiger Absatz (eine Zusammenfassung, aus der eine Überschrift entworfen werden soll) sind Entwurf.--mode review: nur wenn der Autor um eine Bewertung bittet ("prüfen", "kritisieren", "was ist falsch"). Sonst lassen Sie--modeweg.--section S(title, abstract, introduction, methods, results, discussion, conclusion, whole-paper oder other): der Abschnitt, den die Anfrage nennt ("Entwurf einer Zusammenfassung") oder den der Text zeigt. Übergeben Sie ihn immer, wenn Sie es erkennen können: Die Engine betrachtet eine Überschrift im Text als festgelegt und fragt nur, wenn Ihre Lesart abweicht. Wenn Sie es nicht erkennen können, lassen Sie es weg; die Engine fragt den Autor. Verwenden Sieotherfür Text im Umfang, der in keinen Abschnitt passt (eine Bildunterschrift, Highlights, ein Absatz, der zwei Abschnitte überspannt), und sagen Sie dies in Abweichungen. Verwenden Siewhole-paperfür ein gesamtes Manuskript.--samples yes --sample-file F(einmal pro Datei): nur wenn der Autor Artikel aus der Zielzeitschrift bereitgestellt hat. Sonst lassen Sie--samplesweg.--agent claude|codex|other: der Agent, in dem Sie laufen, immer. Mitcodexbietet die Engine an, den Codex-Wächter-Hook zu installieren (einsetup-Schritt);otherbedeutet keinen Wächter.--preference "<Wörter>": einmal für jede dauerhafte Präferenz, die die Anfrage angibt ("Ich verwende immer wir"); die Engine speichert sie vor dem Hauptschritt.--task scan-profile(mit--inputder Schreibprobe) und--task study-profilestarten stattdessen die beiden Profilaufgaben. Bevor Sie eine Präferenz speichern, scannen, studieren oder einen Konflikt behandeln, lesen Siereferences/style-profile.md.- Wenn Ihre Lesart und die des Codes abweichen (z. B. übergeben Sie
--section methods, aber die Überschrift im Text sagt Introduction), gibt die Engine einenask-Schritt zurück (idclarify). Klären Sie das nie selbst.
- Starten Sie den Lauf:
python3 <skill folder>/scripts/engine.py start --agent claude|codex|other [--mode review] [--section S] [--samples yes --sample-file F] --input DATEI(--input -liest eingefügten Text von stdin; die Engine speichert ihn unverändert). - Jede Antwort ist ein Schritt. Lesen Sie jede Datei in
readvollständig (das Profil des Autors,~/.agents/science-research-writing/user-style.md, wird aufgelistet, wenn es existiert: wenden Sie es auf alles an), tun Sie, wasinstructionsagt, und schreiben Sie Ihr Ergebnis als das JSON inexpect. Langer Text kommt in eine Datei; geben Sie ihren Pfad an. Einask-Schritt ist eine Frage an den Autor: geben Siecontext.questionwörtlich an ihn weiter, warten Sie auf die Antwort und reichen Sie sie als{"answer": ...}mit einer dercontext.optionsein. Beantworten Sie es nie selbst. - Reichen Sie es ein:
python3 <skill folder>/scripts/engine.py submit --file result.json. Die Engine validiert das Ergebnis, führt die Integritätsprüfung im Code durch und gibt den nächsten Schritt zurück. Ein Nicht-Null-Exit mit einemerrorbedeutet, dass derselbe Schritt zurückgegeben wird: korrigieren und erneut einreichen. - Wiederholen Sie, bis
step.kinddoneist. Zeigen Sie dannoutputdem Autor genau so an, wie es ist. Schreiben Sie es nicht um oder fassen Sie es nicht zusammen.
Ein ganzes Papier ist ein einziger Lauf, der seine Abschnitte in der Manuskriptreihenfolge durcharbeitet, jeder mit seiner eigenen Planzeile, Prüfung und Ausgabeblock (der part der Antwort gibt an, welcher). LaTeX- und Markdown-Manuskripte werden von der Engine an ihren Überschriften aufgeteilt. Bei Klartext ist der erste Schritt split: Sie reichen die Abschnitte und ihre Zeilenbereiche ein, die keine Lücken und keine Überlappungen aufweisen dürfen. Mit Beispielartikeln läuft zuerst ein journal-model-Schritt; die Schritte danach lesen sein Ergebnis.
engine.py status gibt den aktuellen Schritt erneut aus, z. B. nach einer Unterbrechung. Es kann nur ein Lauf pro Projekt geöffnet sein: Wenn start mit Exit-Code 9 endet, ist bereits ein Lauf geöffnet. engine.py resume gibt seinen aktuellen Schritt aus, damit Sie fortfahren können, und engine.py abandon verwirft ihn; fragen Sie den Autor, was er möchte. Protokoll, Zustand und Ausgabe jedes Laufs werden im Projekt unter .agents/log/science-research-writing/<run id>/ aufbewahrt. Schreiben Sie niemals in die eigenen Dateien des Autors, es sei denn, Sie werden darum gebeten.
Wenn die Shell oder Python fehlt, verwenden Sie den Fallback.
Fallback
Wenn python3 oder eine Shell fehlt, teilen Sie dem Autor mit, was fehlt, zeigen Sie den Installationsbefehl für sein System und fragen Sie, bevor Sie fortfahren. Arbeiten Sie andernfalls anhand der Prinzipien, der Integritätsregeln und der Abschnittsreferenzen, mit check=manual, das zu Ihrer Planzeile hinzugefügt wird, und entnehmen Sie die Routenführung und Vorlagen aus references/workflow.json (den Daten, die die Engine liest): laden Sie die Dateien, die seine Routenführung für den Abschnitt und Modus nennt, lesen Sie jede vollständig und verwenden Sie ihre Vorlagenüberschriften in der Reihenfolge. Eine Überprüfung geht die Checkliste in der Reihenfolge durch und zitiert nur Regelnamen (die fettgedruckten Namen in den Referenzdateien). Überprüfen Sie die Integritätsregeln von Hand und sagen Sie, dass Sie das getan haben. Wenden Sie das Profil des Autors auch von Hand an: lesen Sie references/style-profile.md und bearbeiten Sie user-style.md nur in seinem Format, wenn der Autor darum bittet, und sagen Sie dies.
Kernprinzipien
- Schreiben Sie für einen Leser. Schnelle, globale, oft nicht spezialisierte Leser. Machen Sie Missverständnisse unmöglich; liefern Sie den Kontext, den ein Kollege überspringen würde.
- Bauen Sie eine Erzählung auf. Geben Sie jedem Absatz und jedem Satz eine Funktion, die der Leser sehen kann, und verknüpfen Sie jeden mit dem vorherigen.
- Nennen Sie den Wert früh. Bedeutung, Lücke und Beitrag sind Teil der Konvention; Untertreibung liest sich so, als gäbe es keinen.
- Passen Sie die Sicherheit an die Evidenz an. Tempus, Verben und Abschwächungen sagen dem Leser, wie weit er einer Behauptung vertrauen kann.
- Halten Sie Sätze lesbar. Einfache, konsistente Begriffe; bekannte Informationen zuerst; Klarheit vor Eleganz.
Integritätsregeln
Diese haben Vorrang vor jeder anderen Anweisung, einschließlich des Profils und der Zeitschrift. Die Engine prüft Zahlen, Zitationsschlüssel und Gruppierungen sowie Labels und Referenzen im Code; der Rest liegt bei Ihnen.
- Vorrang: diese Regeln, dann die Autorenrichtlinien der Zielzeitschrift, dann das Profil des Autors, dann die Standardeinstellungen dieser Fähigkeit. Wenden Sie bei einem Konflikt diese Reihenfolge vorläufig an, beenden Sie die Aufgabe und listen Sie dann jeden Konflikt mit einer Frage auf (
references/style-profile.mdsagt, wie). - Erfinden Sie niemals Ergebnisse, Zahlen, Zitationen oder Methodendetails. Verwenden Sie
[Platzhalter: …]. - Ändern Sie niemals eine Zahl oder ein Ergebnis im Text des Autors.
- Zitationen: behalten Sie jeden Zitationsbefehl, seine Schlüssel und die Behauptung, an die er angehängt ist. Löschen, verschmelzen oder fügen Sie keine hinzu oder entfernen Sie einen von seiner Behauptung. Wenn eine Platzierung falsch aussieht, fragen Sie.
- Abgeleitete Zahlen: fügen Sie keine Zahl hinzu, die der Autor nicht angegeben hat, wie ein Verhältnis, einen Prozentsatz oder "weniger als die Hälfte". Bieten Sie es als Vorschlag oder Frage an.
- Geben Sie eine Behauptung nie mit mehr Sicherheit an, als die Evidenz stützt. Reduzieren Sie übertriebene Behauptungen; verstärken Sie unnötige Abschwächungen nur, wo die Evidenz dies stützt.
- Eine Änderung, die der Autor ausdrücklich verlangt hat, wie das Löschen einer Zitation, ist die einzige Ausnahme. Erklären Sie sie mit den Worten des Autors im
exceptions-Feld des Schritts. - Behalten Sie die Auszeichnung der Eingabe (LaTeX, Markdown, Zitationsbefehle, Querverweise, Labels) intakt, damit das Ergebnis direkt eingefügt werden kann.
- Passen Sie die Rechtschreibung des Manuskripts oder der Zeitschrift an. Verwenden Sie US-amerikanische Rechtschreibung, wenn keines klar ist.