Communitygithub.com

USTC-Astro/coffee_break_poster

Erstelle ein einseitiges Astro-Kaffeepausenposter aus einem MinerU-artigen Paper-Verzeichnis, einer PDF, arXiv-URL oder direkten PDF-URL. Verwende die deterministischen Werkzeuge unter tools/ für Aufnahme, Inspektion, Layout-Prüfung und Rendering; nutze den Agenten für Zusammenfassung, Figurenauswahl, narrativen Aufbau und HTML-Bearbeitungen.

Was ist coffee_break_poster?

Diese Skill ermöglicht die Erstellung eines prägnanten, figurenzentrierten Kaffeepausenposters für astronomische Paper. Sie ist ideal für den schnellen Austausch in Kaffeepausen, Journal Clubs, Seminaren oder Flurdiskussionen. Das Ziel ist nicht, das Paper im Miniaturformat zu reproduzieren, sondern die Kernbotschaft so aufzubereiten, dass Leser in 15 bis 30 Sekunden verstehen, warum das Paper interessant ist, was es behauptet und was die zentrale Botschaft ist. Der Skill unterstützt die Arbeit mit Verzeichnissen im MinerU-Stil, PDFs, arXiv-URLs sowie direkten PDF-URLs. Die Workflow-Tools (ingest, inspect, scaffold, check, render, diagnose) sind deterministisch und unter tools/ verfügbar, während der Agent für die Zusammenfassung des Papers, die Auswahl der aussagekräftigsten Abbildungen, den narrativen Aufbau und die HTML-Bearbeitung des Posters zuständig ist. Das Standard-Layout ist eine 16:9 HTML-Seite mit Text auf der linken und Abbildungen auf der rechten Seite. Optional kann ein 9:16 Telefon-Sharing-Kärtchen erstellt werden. Die Skill betont klare redaktionelle Regeln für Headline, Subtitle, Background, Knowledge Gap, What this paper is selling und Key results to remember sowie eine strenge Figurenauswahl, die die wissenschaftliche Geschichte unterstützt, ohne methodische Details überzubetonen. Ein eingebauter Selbst-Check vor dem Rendern stellt sicher, dass das Poster interessant, kohärent und visuell ansprechend ist.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add USTC-Astro/coffee_break_poster

In Ihrer bevorzugten KI fragen

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

Dokumentation

Coffee Break Poster

Erstelle ein einseitiges, figurenzentriertes Astro-Kaffeepausenposter.

Diese Skill ist für das schnelle Teilen von arXiv-Papern während einer Kaffeepause, im Journal Club, Seminar oder in Flurdiskussionen gedacht. Das Ziel ist nicht, das Paper im Miniaturformat zu reproduzieren. Das Ziel ist es, Menschen zum Stehenbleiben, Anschauen und Erinnern zu bewegen, warum das Paper interessant ist, was es behauptet und was die Kernbotschaft ist.

Standardzielgruppe: breite Astronomie-Leserschaft. Wenn der Benutzer nicht explizit etwas anderes sagt, optimiere nicht nur für Spezialisten.

Hauptproduktziel

Das Poster sollte als schneller visueller Pitch für das Paper funktionieren:

  • Ein Leser sollte den Hauptpunkt in 15-30 Sekunden verstehen.
  • Das Poster sollte interessant sein, bevor es erschöpfend ist.
  • Die geistige Hauptarbeit besteht darin, das Verkaufsargument / die Kernbotschaft / warum dies wichtig ist herauszuarbeiten, nicht methodische Details zu wiederholen.
  • Abbildungen sollten die meiste Information tragen; Text soll die Aufmerksamkeit lenken und interpretieren.

Verwandle das Poster nicht in:

  • eine technische Rezension
  • eine abschnittsweise Zusammenfassung des Papers
  • eine methodenlastige Notiz
  • eine Textwand mit dekorativ eingefügten Abbildungen

Arbeitsverzeichnis

  • Wenn der Benutzer ein Arbeitsverzeichnis angibt, verwende es.
  • Ansonsten verwende /Users/chensj/repository/coffee_break_poster/work/<paper_slug>/.
  • Schreibe generierte Poster nicht in ein installiertes Skill-Verzeichnis.

Voraussetzung

Diese Skill setzt voraus, dass die cbp CLI über PATH verfügbar ist, entweder durch eine normale Paketinstallation oder eine editierbare Installation dieses Repositories.

Erwartete Ausgabe

Erstelle ein einseitiges 16:9 HTML-Poster, das überprüft und in PNG/PDF gerendert werden kann.

Für das Teilen per WeChat/iPhone erstelle stattdessen eine Begleitkarte im 9:16 Telefonformat:

cbp scaffold PAPER_DIR --format phone --figure-count 1
cbp check PAPER_DIR/poster.html --format phone --json-out PAPER_DIR/layout.json
cbp render PAPER_DIR/poster.html --format phone --png --pdf

Das Telefonformat ist ein komprimierter Pitch, keine vollständige Zusammenfassung des Papers. Bevorzuge eine Helden-Abbildung plus 1-2 unterstützende Abbildungen und schreibe den Text zu einem kurzen Haken, Warum es wichtig ist, Was dieses Paper zeigt und Merken um. Gieße den 16:9 Text nicht in die vertikale Karte.

Die Standard-Textstruktur des Posters besteht aus genau diesen Blöcken:

  1. Hintergrund
  2. Wissenslücke
  3. Was dieses Paper verkauft
  4. Wichtige Ergebnisse, die man sich merken sollte

plus 2-4 Abbildungen mit kurzen Bildunterschriften.

Wenn eine arXiv-ID abgeleitet werden kann, enthält die rechte/Kopf-Metadaten einen klickbaren arXiv-Link, die kanonische arXiv-DOI und einen QR-Code zur arXiv-Abstract-Seite.

In der Praxis sollte die linke Textspalte wie ein kompaktes Argument gelesen werden:

  1. Warum sollten die Leute sich dafür interessieren?
  2. Was fehlte vor diesem Paper?
  3. Was behauptet dieses Paper hinzuzufügen?
  4. Welche Beweise machen diese Behauptung merkenswert?

Arbeitsablauf

1. Eingabe normalisieren

cbp ingest INPUT --workdir work

2. Deterministisches Paper-Inventar inspizieren

cbp inspect PAPER_DIR --json

Verwende dies, um Abschnitte, Bilddateien, Abmessungen und mögliche Bildunterschriften zu inspizieren. Dieser Befehl fasst das Paper nicht für dich zusammen.

3. Nur das Nötigste lesen, dann die wissenschaftlich/redaktionellen Entscheidungen treffen

Lies paper.md selektiv. Gib nicht das gesamte Paper aus oder paraphrasiere es. Konzentriere dich auf:

  • das Abstract und die Schlussfolgerung
  • die wenigen Absätze, die nötig sind, um die zentrale Behauptung zu verstehen
  • den lokalen Kontext um die Abbildungen, die du verwenden könntest

Triff dann die Entscheidungen auf Posterebene:

  • Schreibe eine Headline, die angibt, was wir aus dem Paper lernen, nicht nur das Thema.
  • Schreibe einen Subtitle, der den interessanten astrophysikalischen Einsatz oder Haken einrahmt.
  • Fülle die Textblöcke so, dass sie eine kohärente Geschichte ergeben.
  • Wähle 2-4 Abbildungen, normalerweise 2-3 starke, anstatt Slots mechanisch zu füllen.
  • Halte Methoden kurz, es sei denn, sie sind für die Glaubwürdigkeit unerlässlich.

4. Gerüst erstellen und bearbeiten

cbp scaffold PAPER_DIR

Bearbeite poster.html direkt. Die Standardvorlage ist 16:9, mit Text auf der linken und Abbildungen auf der rechten Seite.

Verwende nur die Abbildungen, die die Geschichte tragen. Fülle Slots nicht mit schwachen Abbildungen. Wenn das Poster weniger als vier Abbildungen benötigt, erstelle oder überarbeite das Abbildungsfeld als bewusstes Layout mit niedriger Anzahl, nicht als 2x2-Gitter mit leeren oder schwachen Slots:

cbp scaffold PAPER_DIR --figure-count 1
cbp scaffold PAPER_DIR --figure-count 2
cbp scaffold PAPER_DIR --figure-count 3

Die 1-Abbildungs-Vorlage verwendet einen großen visuellen Helden. Die 2-Abbildungs-Vorlage verwendet eine Hauptabbildung plus ein unterstützendes Feld. Die 3-Abbildungs-Vorlage verwendet eine große Helden-Abbildung plus zwei unterstützende Abbildungen. Verwende diese Modi, wenn die ausgewählten Abbildungen wissenschaftlich stärker sind als ein volles Vier-Slot-Gitter.

Wähle für eine Telefon-Sharing-Karte explizit die vertikale Vorlage:

cbp scaffold PAPER_DIR --format phone --figure-count 2

Verwende --figure-count 4 für Telefonausgaben nur, wenn der Benutzer explizit nach vier Abbildungen fragt; normalerweise ist dies zu dicht für ein komprimiertes Teilen-Bild.

5. Überprüfen und iterieren

cbp check PAPER_DIR/poster.html --json-out PAPER_DIR/layout.json

Für Telefonausgaben verwende den formatbewussten Viewport:

cbp check PAPER_DIR/poster.html --format phone --json-out PAPER_DIR/layout.json

Dies ist eine harte Hürde. Wenn die Überprüfung Überlauf, abgeschnittene Nachkommen, winzige Abbildungen, defekte Bilder, leere Abbildungsflächen oder einen kollabierten Layoutbereich meldet, bearbeite poster.html und führe sie erneut aus. Die Werkzeuge messen das Layout; der Agent muss Inhalt, Abbildungsauswahl, Bildunterschriften und CSS anpassen.

Für eine kompakte Erklärung, was zu ändern ist, führe aus:

cbp diagnose PAPER_DIR/poster.html

Reihenfolge der Layoutanpassung:

  1. Kürze Prosa und Bildunterschriften.
  2. Wenn eine oder mehrere Abbildungen sekundär sind, wechsle zu einem Layout mit 1, 2 oder 3 Abbildungen, anstatt leere Slots zu füllen.
  3. Stimme CSS-Variablen wie Textskala, Bildunterschriftenskala, Kopfhöhe, Abbildungsabstand oder Text-/Abbildungsverhältnis ab.
  4. Ändere das strukturelle Layout nur, wenn die vorherigen Schritte das gemessene Problem nicht lösen.

6. Rendern

cbp render PAPER_DIR/poster.html --png --pdf

Für Telefonausgaben:

cbp render PAPER_DIR/poster.html --format phone --png --pdf

render führt zuerst die Layout-Überprüfung durch und verweigert die Überschreibung von Vorschauausgaben, wenn das Poster nicht besteht. Verwende --force nur zum Debuggen eines defekten Layouts, niemals für die endgültige Auslieferung.

Redaktionelle Regeln

Headline

Die Headline sollte sagen, was das Paper uns lehrt.

Eigenschaften einer guten Headline:

  • eher behauptungsartig als themenartig
  • kurz genug zum schnellen Überfliegen
  • einprägsam für einen nicht-spezialisierten Astronomie-Leser
  • im stärksten Wissenszuwachs des Papers verankert

Vermeide Headlines, die nur sind:

  • der umgeschriebene Paper-Titel
  • ein vages Themenetikett
  • eine methodenzentrierte Rahmung, wenn der eigentliche Punkt ein wissenschaftliches Ergebnis ist

Subtitle

Der Subtitle sollte ein kurzer Haken sein, normalerweise ein Satz.

Verwende ihn, um eine dieser Fragen zu beantworten:

  • warum dieses Ergebnis überraschend ist
  • mit welchem größeren Problem es verbunden ist
  • welche Art von Beweisen das Paper interessant macht

Verwende den Subtitle nicht für eine lange abstractähnliche Zusammenfassung.

Hintergrund

Hintergrund beantwortet:

  • warum sollte ein breites Astronomie-Publikum sich dafür interessieren?
  • mit welcher größeren astrophysikalischen Frage ist dies verbunden?

Beginne nicht mit Umfragenamen, Stichprobengrößen, Instrumentendetails oder einer Kette technischer Einschränkungen, es sei denn, diese sind der eigentliche Haken.

Wissenslücke

Wissenslücke sollte das präzise fehlende Stück sein, das das Paper motiviert.

Sie muss eng mit dem Hintergrund verbunden sein. Eine gute Lücke schärft die Geschichte von „dieser Bereich ist wichtig“ zu „das ist, was wir vor diesem Paper noch nicht erklären oder etablieren konnten“.

Die Lücke sollte normalerweise mit dem tatsächlichen Beitragsumfang des Papers übereinstimmen:

  • Fallstudien-Paper -> Fallidentifikations-/Interpretationslücke
  • Populations-Paper -> demografische / Trend-/Vergleichslücke
  • Theorie-Paper -> Mechanismus-/Konsistenz-/Vorhersagelücke

Stelle keine Frage auf Bevölkerungsebene, wenn das Paper nur Evidenz für ein Objekt liefert, es sei denn, das Poster rahmt das Paper explizit als Existenznachweis oder Methodenanker.

Was dieses Paper verkauft

Dieser Abschnitt sollte 2-3 Sätze umfassen.

Er sollte beantworten:

  • was versucht das Paper uns zu überzeugen?
  • was ist der stärkste Wissenszuwachs hier?
  • warum lohnt es sich, dieses Paper in einer Kaffeepause zu teilen?

Dies ist kein Rezensionsbericht. Falls nötig, kannst du eine milde Einschränkung einfügen, aber die Hauptaufgabe ist es, das stärkste Verkaufsargument des Papers zu identifizieren.

Wichtige Ergebnisse, die man sich merken sollte

Verwende 3-4 kurze Aufzählungspunkte.

Jeder Punkt sollte sein:

  • evidenzzentriert
  • konkret genug zum Merken
  • klar mit dem Verkaufsargument verbunden
  • von unwesentlichen Methodendetails befreit

Bevorzuge Aufzählungspunkte, die wie „Take-Aways für vielbeschäftigte Leser“ klingen, nicht wie Notizbuchfragmente.

Erzähllogik: Abschnitte müssen zusammenhängen

Das Poster sollte als ein Argument gelesen werden, nicht als vier unabhängige Zusammenfassungen.

Erforderliche logische Kette:

  1. Hintergrund erklärt, warum die Frage wichtig ist.
  2. Wissenslücke gibt an, was vor diesem Paper fehlte.
  3. Was dieses Paper verkauft sagt, was das Paper hinzuzufügen oder zu klären behauptet.
  4. Wichtige Ergebnisse, die man sich merken sollte liefern die Beweise oder einprägsamen Konsequenzen, die diese Behauptung stützen.

Wenn die Geschichte nicht in dieser Reihenfolge fließt, schreibe sie um.

Häufige Fehlermodi, die vermieden werden sollten:

  • Hintergrund ist breit, aber Wissenslücke handelt von etwas anderem.
  • Verkauft ist allgemein und beantwortet nicht die angegebene Lücke.
  • Wichtige Ergebnisse sind wahre Fakten aus dem Paper, unterstützen aber nicht das Verkaufsargument.
  • Das Poster stellt eine Frage, beantwortet aber eine andere.
  • Der Text klingt technisch korrekt, aber nicht interessant.

Regeln zur Figurenauswahl

Wähle Abbildungen aus, die einem Leser helfen, die Geschichte schnell zu verstehen.

Priorisiere in dieser Reihenfolge:

  1. eine Abbildung, die das Objekt, die Stichprobe oder das Problem definiert
  2. eine Abbildung, die das Hauptergebnis zeigt
  3. eine Abbildung, die das Ergebnis in einen breiteren Kontext oder Vergleich stellt

Normalerweise behalte 2-3 starke Abbildungen. Verwende eine 4. nur, wenn sie eindeutig einen narrativen Mehrwert bietet.

Vermeide Abbildungen, die hauptsächlich sind:

  • Methodenablaufdiagramme
  • Parameter-Korrelations-Diagramme
  • interne Plausibilitätsprüfungen
  • spezialisierte Diagnostiken, die zu viel Einarbeitung erfordern

es sei denn, sie sind der einzige Weg, um die Kernbehauptung vertrauenswürdig zu machen.

Bildunterschriften

Jede Bildunterschrift sollte beantworten:

  • warum ist diese Abbildung hier?
  • was sollte ein vielbeschäftigter Leser daraus mitnehmen?

Bildunterschriften sollten interpretieren, nicht nur beschriften.

Schlechter Bildunterschriftenstil:

  • beschreibt die Achsen des Diagramms, ohne den Punkt zu nennen
  • wiederholt nur den Feldtitel
  • erklärt Verfahrensdetails, aber nicht die wissenschaftliche Bedeutung

Guter Bildunterschriftenstil:

  • sagt, was die Abbildung etabliert
  • sagt, warum es für die Hauptbehauptung des Papers wichtig ist
  • verwendet kurze, einprägsame Formulierungen

Methoden: Standardmäßige Zurückhaltung

Gib nicht viel Posterplatz für Methoden aus, es sei denn, das Vertrauen in die Methode ist zentral für die Behauptung.

Ein wenig Methode ist nur nützlich, wenn sie beantwortet:

  • warum sollten wir dieser Interpretation vertrauen?
  • was ist das Besondere an den Beweisen?
  • was bricht eine frühere Mehrdeutigkeit auf?

Wenn die Methode diese Last nicht trägt, kürze sie.

Stil

  • Schriftfamilie für Titel und Haupttext: Helvetica, Arial, sans-serif.
  • Subtitle: kursiv, nicht fett, im selben Helvetica-Stapel.
  • Wissenslücke / hervorgehobene Aufforderung kann "Gill Sans", "Gill Sans MT", Helvetica, Arial, sans-serif verwenden.
  • Vermeide lange Absätze.
  • Verwende Fettdruck sparsam, nur für die Wörter, an die sich die Leute tatsächlich erinnern sollen.
  • Abbildungen sollten die meiste Information tragen.
  • Das Poster muss auf ein gängiges Display passen, ohne zu scrollen.
  • Erzwinge keine Bildstreckung; erhalte die Seitenverhältnisse der Abbildungen.

Abschließende Selbstüberprüfung vor dem Rendern

Vor dem Rendern überprüfe:

  1. Ist das Poster für jemanden interessant, der das Paper nicht gelesen hat?
  2. Vermittelt die Headline eine echte Erkenntnis?
  3. Sind Hintergrund und Wissenslücke eng miteinander verbunden?
  4. Beantwortet Was dieses Paper verkauft klar diese Lücke?
  5. Unterstützen Wichtige Ergebnisse, die man sich merken sollte tatsächlich das Verkaufsargument?
  6. Unterstützt jede Abbildung einen bestimmten Teil der Geschichte?
  7. Könnte ein Leser den Hauptpunkt des Papers nach 15-30 Sekunden erklären?
  8. Hast du methodische Details entfernt, die das Vertrauen nicht verbessern?
  9. Tragen die Abbildungen den Großteil der Informationen visuell?
  10. Bleibt das Layout nach dem check sauber?

Wenn eine Antwort nein ist, überarbeite poster.html und führe check erneut aus.

Verwandte Skills