Communitygithub.com

leolou0512/claude-skills

Überarbeiten oder verfassen Sie technische und wissenschaftliche Texte, damit sie wie präzises akademisches Schreiben wirken, nicht wie KI-generierter oder umgangssprachlicher Text.

Was ist claude-skills?

Dieses Skill ist ein umfassender Leitfaden für präzises akademisches Schreiben, der sich an Forscher und Autoren wissenschaftlicher Publikationen richtet. Es besteht aus zwei Hauptebenen: Stilregeln, die jeden Satz präzise machen, und einem „Launch-Prinzip“ (发布会原则), das die Argumentationsstruktur des Papers festlegt. Das Skill erkennt typische KI-Tells wie alltägliche Verben für mathematische Operationen, Verdinglichung von Objekten („die Variable hält einen Wert“) und vage Paraphrasen („tut sich nicht ändern“ statt „invariant unter“). Es bietet eine detaillierte Liste von Regeln, was geändert werden soll und was unverändert bleiben muss, sowie einen markierten Änderungs-Workflow, der Zahlen, Zitate und Bedeutung bewahrt. Das Skill unterstützt Claude Code und kann auf jeder Plattform verwendet werden, die SKILL.md-Dateien akzeptiert. Es wird aktiviert, wenn der Benutzer um akademische Umformulierung, Stilüberarbeitung oder Textstraffung bittet, und stellt sicher, dass der Text als professionelle akademische Prosa und nicht als KI-generiert wahrgenommen wird.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/leolou0512/claude-skills/tree/HEAD/skills/academic-writing

In Ihrer bevorzugten KI fragen

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

Dokumentation

Akademisches Schreiben

Zwei Ebenen. Die Stilregeln machen jeden Satz präzise. Das Launch-Prinzip entscheidet, was das Paper argumentiert und in welcher Reihenfolge. Alle Beispiele sind illustrativ.

Was „akademisch“ hier bedeutet

Präzision, nicht Formalität. Ein akademischer Leser hat bereits eine Definition für jeden Standardbegriff, daher ist das exakte Wort sowohl kürzer als auch klarer als ein bildhaftes. KI-klingende Prosa scheitert in eine konsistente Richtung: Sie erzählt Mathematik, als ob sich Objekte bewegen und handeln, malt Bilder, wo eine Eigenschaft angegeben werden kann, und erklärt mit Slogans. Die Lösung ist fast immer, das Ding zu benennen: die Operation, das Objekt, die Größe, die Eigenschaft, die das Paper bereits angibt.

Übermäßiges Bearbeiten ist ein ebenso großer Fehler. Formal klingende Synonyme, umgestellte korrekte Sätze und erfundene Präzision machen einen Text schlechter. Eine geringe Anzahl von Änderungen in einem bereits technischen Abschnitt ist ein korrektes Ergebnis.

Die Regeln mit Begründung

Dinge exakt benennen.

  • Verwenden Sie das Verb des Fachgebiets für eine Operation: bildet ab, projiziert, berechnet, weist zu, wird ausgedrückt in, niemals enthält, kopiert, wird zu, bekommt, koppelt. Das Verb des Fachgebiets trägt seine Definition.
  • Verwenden Sie das benannte Konzept, nicht eine Beschreibung davon: „invariant unter“ nicht „ändert sich nicht unter“, „Eigenvektoren“ nicht „die Richtungen, in die die Matrix nur streckt“. Eine Paraphrase ist länger und nur annähernd richtig.
  • Benennen Sie die Größe, nicht ein Bild davon: Grenzwert, Bereich, benachbart, intermediär, nicht Kante, Nachbarn, dazwischen. Der Leser rekonstruiert sonst das Bild, um die Größe zu ermitteln.
  • Benennen Sie das genaue Objekt: „Anzahl der Stichproben“ nicht „Stichproben“, „Lernrate“ nicht „Hyperparameter“, wenn nur die Lernrate gemeint ist.
  • Geben Sie jedem „dieses“, „eines“, „die Menge“, „es“ einen Bezug, wenn mehr als ein Element in Frage kommt.

Objekten keine Handlungsfähigkeit oder Bewegung geben. Variablen „behalten“ keine Werte, Constraints „koppeln“, „sehen“ oder „respektieren“ nicht, ein Netzwerk „schaut“ nicht auf seine Eingabe, eine Stichprobe „erhält“ kein Label. Machen Sie die Größe zum Subjekt, verwenden Sie das Verb der Operation und verwenden Sie das Passiv, wenn der Akteur der Algorithmus ist. Handlungssprache verbirgt, was die Methode berechnet.

Die Garantie angeben, nicht das Bild. „Die Iteration ist also eine Kontraktion und konvergiert zu einem eindeutigen Fixpunkt“ statt „die Iterate beruhigen sich“. Das Bild ist nicht überprüfbar; die Eigenschaft ist überprüfbar.

Mit der angegebenen Eigenschaft begründen, niemals mit einem Slogan. „Wir normalisieren jedes Merkmal auf Einheitsvarianz, damit der Penalty alle Merkmale gleich gewichtet“, nicht „weil der Maßstab keine Rolle spielen sollte“. Ein Slogan klingt überzeugend und sagt nichts aus, was ein Gutachter überprüfen kann.

Sagen, welche Größe sich ändert und in welche Richtung. „durch eine geringere Trefferquote“, nicht „aufgrund von Erkennungseinbrüchen“. Sagen Sie, was eine Zahl ist („die Genauigkeit auf den 2.000 Testbildern“), nicht wo sie „herkommt“. Ersetzen Sie „Leistung“ durch die Metrik.

Sätze für einen von oben nach unten lesenden Leser gestalten. Eine Tatsache pro Satz; teilen Sie beim zweiten Faktum. Behauptung zuerst, Mechanismus zweitens. Löschen Sie einen Satz, der seinen Nachbarn als Bild wiederholt. Machen Sie den Akteur zum Subjekt („Der Löser benötigt 4,2 h zur Konvergenz“, nicht „Konvergieren benötigt beim Löser 4,2 h“). Schreiben Sie „dreimal so lang wie“, nicht „dreimal länger als“. Ersetzen Sie Phrasenverben (abschalten, einschalten, einrichten) mit dem einzelnen Standardverb (deaktivieren, aktivieren, konfigurieren). Entfernen Sie Füllwörter und Redewendungen (auf einen Schlag, obendrein, mehr, absichtlich, natürlich).

Konsistent mit dem Paper selbst bleiben. Bevor Sie ein Wort wählen, grep-Suche im Paper, wo das Konzept definiert ist, und verwenden Sie diesen exakten Ausdruck erneut. Geben Sie jedem Wort eine Bedeutung (wenn „bewertet“ an anderer Stelle Evaluation bedeutet, verwenden Sie es nicht für einen Verlust). Ein Notationstableau wiederholt die Definition jedes Symbols aus dem Haupttext, unabhängig davon, was eine allgemeine Regel bevorzugt. Stimmen Sie eine Vokabeländerung im gesamten Paper ab, bevor Sie sie in einem Abschnitt vornehmen.

Verbotene Konstruktionen (die üblichen KI-Verstärker): Gedankenstriche und „--“; Doppelpunkte in Prosasätzen; rhetorische Semikolons; „Während X, Y“-Einleitungen; „nicht nur ... sondern auch“; „Ferner“-Ketten; Sätze, die mit „Weil“ oder einem bloßen Mathematik-Symbol beginnen; Ranglisten-Wörter (übertrifft, outperformt, übersteigt X, bleibt aber unter Y, zählt zu den, stärksten, SOTA); Überbehauptungen; eintauchen, nutzen, entscheidend, zentral, nahtlos, bemerkenswert, unterstreichen, Paradigma, neuartiger Rahmen.

Narrative: das Launch-Prinzip (发布会原则)

Ein Paper ist eine Produkteinführung, kein Fortschrittsbericht. Die obigen Stilregeln entscheiden, wie jeder Satz formuliert wird. Diese Regeln entscheiden, was das Paper argumentiert und in welcher Reihenfolge.

Umfang. Wenden Sie sie vollständig an, wenn Sie neue Prosa schreiben oder eine Zusammenfassung, Einleitung, Ergebnisdiskussion oder Schlussfolgerung umstrukturieren. Verwenden Sie bei einem markierten Stildurchlauf nur Regel 3 als markierte Änderungen und listen Sie Verstöße gegen die anderen im Bericht auf. Die Neuanordnung der Geschichte, die Neurahmung eines Vergleichs oder das Entfernen eines Experiments ändert die Bedeutung, und das ist die Entscheidung des Autors.

1. Bauen Sie die Geschichte um den stärksten Vorteil herum auf. Wählen Sie das eine Ergebnis oder die eine Eigenschaft aus, die keine Baseline erreicht, und organisieren Sie Zusammenfassung, Einleitung und Ergebnisse darum. Andere Ergebnisse unterstützen es. Ein Leser behält eine Behauptung pro Paper.

2. Argumentieren Sie, erzählen Sie nicht den Prozess. Nicht „wir haben zuerst X versucht, dann Y, was fehlschlug“. Präsentieren Sie die endgültige Methode und begründen Sie jede Komponente mit dem, was sie liefert. Eine fehlgeschlagene Variante wird zu einer als Anforderung formulierten Ablation („Das Entfernen des Normalisierungsschritts senkt die Genauigkeit von A% auf B%“), nicht zu einer Geschichte („Ohne Normalisierung scheiterten unsere frühen Versuche“). Die Chronologie sagt, was getan wurde. Das Argument sagt, warum es funktioniert.

3. Keine selbstschwächende Formulierung. Löschen Sie „unglücklicherweise“, „nur“ und „lediglich“ als Bewertungen, „immer noch deutlich hinterher“, „begrenzter Effekt“, „scheitert an“. Fassen Sie die Schwächen nicht für den Gutachter zusammen. Eine epistemische Abschwächung ist anders und bleibt: „etwa 0,9 Punkte“ und „die wahrscheinliche Ursache“ qualifizieren, wie sicher eine Tatsache ist, während „unglücklicherweise“ die Arbeit bewertet. Entfernen Sie die Bewertung, niemals die Zahl.

4. Inszenieren Sie keinen Wettbewerb um eine Metrik, die die Methode nicht gewinnen kann. Führen Sie den Vergleich auf der Achse durch, für die die Methode ausgelegt ist (z. B. eine Garantie, Kosten oder Dateneffizienz), und führen Sie diese Achse als das erklärte Ziel des Papers ein. Leitplanke: Die Standard-Benchmark-Metriken, berechnet mit ihrem kanonischen Protokoll, bleiben in den Tabellen für jede Baseline. Die Änderung der Vergleichsbasis bedeutet, eine begründete Achse hinzuzufügen und auf alle Methoden anzuwenden, niemals die Standardachse zu entfernen oder neu zu berechnen.

5. Ein Ergebnis, das nicht führt, wird erklärt, nicht eingeräumt. Geben Sie die Zahlen nebeneinander an (Muster 15), dann den Unterschied im Ziel oder den Kompromiss, der die Lücke erklärt, unter Verwendung einer Tatsache, die das Paper angibt. Wenn das Paper keinen solchen Grund angibt, kennzeichnen Sie es. Erfinden Sie niemals einen.

6. Geben Sie jeden Vorteil explizit an. Überlassen Sie es nicht dem Gutachter, ihn in einer Tabelle zu finden. Schreiben Sie die Größe und den Abstand („eine Genauigkeit 1,4 Punkte über der der stärksten Baseline“) oder die Eigenschaft, die keine verglichene Methode hat. Ranglisten-Wörter bleiben verboten. Die Größe trägt die Behauptung.

7. Jedes Experiment hat eine argumentative Aufgabe. Schreiben Sie für jedes Experiment die Behauptung, die es unterstützt, in einem Satz auf. Keine Behauptung bedeutet, die Entfernung oder Verschiebung in den Anhang vorzuschlagen, und der Autor entscheidet. Ein Ergebnis, das der Hauptbehauptung widerspricht, hat eine Aufgabe: Es bleibt, eingerahmt durch Regel 5. Es zu entfernen wäre selektive Berichterstattung.

8. Zusammenfassung und Einleitung beginnen wie eine Einführung. Problem, Lücke in bestehenden Methoden, die Idee, dann das stärkste Ergebnis mit seiner Zahl. Keine Methodengeschichte und keine Beitragsliste, bevor die Lücke klar ist.

9. Die Schlussfolgerung bekräftigt die Kernpunkte. Wiederholen Sie die Hauptbehauptung und ihre stärkste Zahl. Führen Sie im letzten Absatz keine neue Schwäche ein. Ein Abschnitt zu Einschränkungen, den der Veranstaltungsort verlangt, nennt den Umfang, für den die Methode ausgelegt ist, und den nächsten Schritt, keine Entschuldigung.

Was in Ruhe zu lassen ist

  • Akkurates einfaches Englisch. „pendelt sich bei 0,3 ein“, „ein maskierter Eintrag bleibt maskiert“, „stammt aus einer unveränderten Kopie des Codes“ sind exakt. Sie zu ersetzen ist Neu-Stil, keine Korrektur.
  • Standard-Jargon, der nur informell aussieht: „generiert“ im gruppentheoretischen Sinne, „emittiert“, „Mischungskoeffizienten“, „umläuft“, „Clone“ im Git-Sinne.
  • Ein Wort, das der Haupttext bereits verwendet, selbst wenn ein Synonym formeller aussieht („fällt“).
  • Vom Autor genehmigte Formulierungen, abgeschwächte Behauptungen und Schätzungen („ein Zählfehler von etwa 0,9 Punkten“, „die wahrscheinliche Ursache“). Eine Neuformulierung kann eine Abschwächung verschieben. Selbstschwächende Bewertungen sind keine Abschwächungen (Launch-Regel 3).
  • Zahlen, Einheiten, Gleichungen, Symbole, Tabellenwerte, Zitate, Referenz- und Labelziele.
  • Alles, dessen präzise Version eine Tatsache benötigt, die das Paper nicht angibt. Umgangssprachliche Formulierungen können aus dem Text allein korrigiert werden; vage Formulierungen benötigen oft eine Tatsache. Wenn das Paper diese nicht enthält, lassen Sie den Satz und kennzeichnen Sie ihn. Erfinden Sie niemals die Tatsache, um einen Satz präzise zu machen.
  • Tabellen können telegraphisch bleiben.

Arbeitsablauf

  1. Lesen Sie die Aufgabenstellung vor dem Text. Lesen Sie den Styleguide des Projekts, falls vorhanden. Lesen Sie alle Kommentare der Mitautoren und notieren Sie das allgemeine Muster, das beanstandet wird, damit die Lektüre eine gezielte Suche und keine Neustilisierung ist. Entscheiden Sie den erwarteten Umfang der Änderungen (gering für einen einstellungs- oder tabellenlastigen Abschnitt).
  2. Arbeiten Sie an einer Kopie. Mitautoren bearbeiten möglicherweise die Live-Datei. Kopieren Sie sie, notieren Sie den Commit und bearbeiten Sie die Kopie. Teilen Sie ein langes Dokument in Abschnitte auf und geben Sie jeden Abschnitt einem separaten Agenten, jeder mit seiner eigenen Kopie und einer gemeinsamen Aufgabenstellung.
  3. Durchsuchen Sie Satz für Satz. Listen Sie jedes Verb, jede Redewendung, jede Erläuterung und jede Paraphrase auf, die ein Gutachter in Frage stellen könnte. Führen Sie für jede eine grep-Suche im Paper nach dem definierten Begriff durch. Lesen Sie den Code oder die Gleichungen, bevor Sie einen Mechanismus umformulieren; die Formulierung muss dem entsprechen, was berechnet wird.
  4. Bearbeiten Sie mit einem Skript, das sicherstellt, dass jeder alte String genau einmal vorkommt. Markieren Sie jede Änderung: \del{alt}\add{neu} in derselben Zeile, die kleinste geänderte Phrase oder den gesamten Satz, wenn sich der Großteil ändert. Umschließen Sie innerhalb von \del{} Inline-Mathematik und jedes \cite/\ref mit \mbox{} (ulem bricht sonst). Setzen Sie niemals Display-Mathematik, \label, \begin/\end, \item oder \caption in eine Markierung; Markierungen gehen in den Text einer Bildunterschrift. Fügen Sie keine Zeilen hinzu oder entfernen Sie keine.
  5. Überprüfen. Das Ablehnen jeder Markierung muss den ursprünglichen Text reproduzieren, und keine Zahl, Referenz, kein Zitat oder Label darf sich ändern (ein Symbol wie $1 - p$, das eine Phrase ersetzt, fügt eine „1“ hinzu; erklären Sie jeden solchen Treffer). Vergleichen Sie mit der Kopie, um zu bestätigen, dass nur die beabsichtigten Zeilen geändert wurden. Lesen Sie jeden akzeptierten Satz erneut.
  6. Führen Sie in die Live-Datei zusammen. Ziehen, dann Drei-Wege-Zusammenführung (git merge-file aktuell snapshot bearbeitet), damit gleichzeitige Bearbeitungen durch Mitautoren überleben. Konflikte neben bearbeiteten Zeilen sind normalerweise ein hinzugefügter Kommentar eines Mitautors; behalten Sie sowohl die bearbeitete Zeile als auch deren Kommentar.
  7. Überprüfen Sie die Überarbeitungsmakros. Wenn \add/\del in der Präambel auskommentiert sind, ist der markierte Workflow ausgeschaltet: Wenden Sie die Änderungen als sauberen Text an, anstatt die Makros wieder zu aktivieren. Kompilieren und überprüfen Sie auf undefinierte Referenzen und „??“.
  8. Berichten. Ein Änderungsprotokoll mit Zeile N: „alt“ -> „neu“ (Grund, sechs Wörter oder weniger), eine Liste von in Betracht gezogenen und mit Grund belassenen Phrasen sowie Kennzeichnungen für alles, was den Autor erfordert (fehlende Tatsachen, Protokollinkonsistenzen, fehlende Zitate, Verstöße gegen das Launch-Prinzip, die ein Stildurchlauf nicht behebt).

Einzeilen-Regeln

  1. Benennen Sie die Operation, nicht eine alltägliche Handlung (bildet ab, nicht enthält).
  2. Benennen Sie das genaue Objekt (Anzahl der Stichproben, nicht Stichproben).
  3. Benennen Sie die Größe, nicht ein räumliches Bild (oberer Grenzwert, nicht obere Kante).
  4. Verwenden Sie den Begriff des Fachgebiets für eine Eigenschaft, anstatt sie zu beschreiben.
  5. Kein Objekt handelt: machen Sie die Größe zum Subjekt.
  6. Geben Sie die Garantie an, nicht das Bild.
  7. Begründen Sie eine Wahl mit der Eigenschaft, die das Paper angibt, niemals mit einem Slogan.
  8. Sagen Sie, welche Größe sich ändert und in welche Richtung.
  9. Eine Tatsache pro Satz; teilen Sie beim zweiten Faktum.
  10. Übernehmen Sie den exakten Ausdruck von der Stelle, an der das Paper das Konzept definiert.
  11. Geben Sie „dieses“, „eines“ und „die Menge“ einen Bezug.
  12. Schreiben Sie „N mal so lang wie“, niemals „N mal länger als“.
  13. Lassen Sie akkurates einfaches Englisch, genehmigte Formulierungen, Abschwächungen und Zahlen in Ruhe.
  14. Wenn Präzision eine Tatsache benötigt, die das Paper nicht angibt, kennzeichnen Sie es; erfinden Sie sie niemals.
  15. Das Ablehnen jeder Markierung muss den Originaltext zurückgeben.
  16. Organisieren Sie das Paper um seinen stärksten Vorteil herum. Argumentieren Sie, erzählen Sie nicht den Prozess.
  17. Löschen Sie selbstschwächende Bewertungen. Behalten Sie epistemische Abschwächungen und jede Zahl.
  18. Vergleichen Sie auf der Achse, für die die Methode ausgelegt ist. Standardmetriken bleiben, kanonisches Protokoll.
  19. Ein Ergebnis, das nicht führt: Zahlen nebeneinander, dann der angegebene Grund. Niemals ein Zugeständnis.
  20. Jedes Experiment gibt die Behauptung an, die es unterstützt. Der Autor entscheidet über die Entfernung.
  21. Zusammenfassung: Problem, Lücke, Idee, stärkste Zahl. Schlussfolgerung: keine neue Schwäche.

Referenz

references/patterns.md enthält den vollständigen Katalog: sechzehn Muster, jedes mit seinem Indikator, der Regel und Vorher-Nachher-Paaren, gefolgt von den Ermessensentscheidungen, die unverändert bleiben, und warum. Lesen Sie es, wenn Sie einen Stildurchlauf durchführen oder wenn sich ein Satz falsch anfühlt und Sie das passende Muster finden möchten.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Verwandte Skills