CommunitySchreiben & Editierengithub.com

Wissenschaftliches Schreiben in den Naturwissenschaften

Hilft beim Verfassen, Überarbeiten oder Prüfen eines Abschnitts eines wissenschaftlichen Zeitschriftenartikels – von der Überschrift bis zur Schlussfolgerung. Auch für Beiträge, die für eine bestimmte Zeitschrift bestimmt sind (das Modell wird aus Beispielartikeln abgeleitet) und zur Pflege des Autorenstilprofils.

Was ist Wissenschaftliches Schreiben in den Naturwissenschaften?

Diese Fähigkeit unterstützt Autor:innen beim Verfassen, Überarbeiten oder Prüfen einzelner Abschnitte eines wissenschaftlichen Zeitschriftenartikels – von der Überschrift bis zur Schlussfolgerung. Sie richtet sich an englische Muttersprachler:innen und Nicht-Muttersprachler:innen gleichermaßen und ist nicht für Anträge, Begleitschreiben, Erwiderungen, Abschlussarbeiten oder Übersichtsartikel gedacht. Die Fähigkeit nutzt eine Schritt-für-Schritt-Engine (`scripts/engine.py`), die den Arbeitsablauf steuert: die Reihenfolge der Schritte, die jeweils zu lesenden Dateien, die Integritätsprüfung und die Ausgabevorlage. Sie wird durch den Befehl `python3 <skill folder>/scripts/engine.py start --agent claude|codex|other --input FILE` gestartet, wobei optional Modus, Abschnitt, Beispielartikel und Präferenzen angegeben werden können. Die Engine arbeitet interaktiv: Sie gibt eine Anweisung aus, der Agent führt sie aus und reicht das Ergebnis ein, bis der Schritt `done` erreicht ist. Die Fähigkeit wird auf Claude Code, Codex oder anderen Agenten ausgeführt und erfordert Python 3 und eine Shell. Unterstützte Plattformen: Claude Code, Codex. Die Engine validiert die Integrität anhand von Regeln, die über anderen Anweisungen stehen (z. B. nie Ergebnisse, Zahlen, Zitationen oder Methodendetails erfinden; die Formatierung beibehalten). Der Stil des Autors wird über ein Profil (`user-style.md`) berücksichtigt, und die Engine kann Beispielartikel aus der Zielzeitschrift für die Modellierung verwenden.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/SJ2050cn/science-research-writing/tree/master

Installed? Explore more Schreiben & Editieren skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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.

  1. Ü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; start hat 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 --mode weg.
    • --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 Sie other fü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 Sie whole-paper fü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 --samples weg.
    • --agent claude|codex|other: der Agent, in dem Sie laufen, immer. Mit codex bietet die Engine an, den Codex-Wächter-Hook zu installieren (ein setup-Schritt); other bedeutet 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 --input der Schreibprobe) und --task study-profile starten stattdessen die beiden Profilaufgaben. Bevor Sie eine Präferenz speichern, scannen, studieren oder einen Konflikt behandeln, lesen Sie references/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 einen ask-Schritt zurück (id clarify). Klären Sie das nie selbst.
  2. 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).
  3. Jede Antwort ist ein Schritt. Lesen Sie jede Datei in read vollstä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, was instruction sagt, und schreiben Sie Ihr Ergebnis als das JSON in expect. Langer Text kommt in eine Datei; geben Sie ihren Pfad an. Ein ask-Schritt ist eine Frage an den Autor: geben Sie context.question wörtlich an ihn weiter, warten Sie auf die Antwort und reichen Sie sie als {"answer": ...} mit einer der context.options ein. Beantworten Sie es nie selbst.
  4. 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 einem error bedeutet, dass derselbe Schritt zurückgegeben wird: korrigieren und erneut einreichen.
  5. Wiederholen Sie, bis step.kind done ist. Zeigen Sie dann output dem 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

  1. 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.
  2. 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.
  3. Nennen Sie den Wert früh. Bedeutung, Lücke und Beitrag sind Teil der Konvention; Untertreibung liest sich so, als gäbe es keinen.
  4. Passen Sie die Sicherheit an die Evidenz an. Tempus, Verben und Abschwächungen sagen dem Leser, wie weit er einer Behauptung vertrauen kann.
  5. 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.md sagt, 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.

Verwandte Skills