Paper to Academic PPT (belegbar)
Was dieses Skill macht
Wandele eine Forschungspublikation in eine akademische Präsentation um, bei der:
- der narrative Kern (Problem / Methode / Ergebnisse / Einschränkungen) aus der Arbeit selbst extrahiert wird, nicht aus der Absatzreihenfolge;
- jede Folie eine Behauptung trägt, die durch einen Papierverweis (Abbildung / Tabelle / Abschnitt / Zitat + Seite) belegt wird;
- die Präsentation innerhalb der bereitgestellten Vorlage zusammengesetzt wird – Text wird in Master-/Layout-Platzhalter geschrieben, Vorlagenschriftarten und -design bleiben erhalten;
- Sprechernnotizen hinzufügen, was gesagt werden soll, keine Wiederholung des Folientexts;
- die Präsentation geprüft wird (Überlauf, Seitenverhältnis, Platzhalternutzung, Belegabdeckung) und als PDF zur Überprüfung gerendert wird;
- das Ergebnis ist maschinenüberprüfbar: result.json bildet jede Folie auf ihren Papierbeleg ab.
Die Skripte übernehmen das Parsen, Zusammenstellen und Prüfen. Sie (der Agent) treffen die Urteile: was die narrative Struktur ist, welche Behauptungen Seiten verdienen, was bei knappem Folienbudget weggelassen wird und welche Abbildungen welche Behauptung belegen. Delegieren Sie diese Entscheidungen nicht an die Skripte.
Eingaben
| Eingabe | Wo | Hinweise |
|---|---|---|
/input/case.json | fester Pfad | case_id, Papierpfad, Vorlagenpfad, Zielgruppe, Dauer, max_folien, ausgabe_vertrag |
| Papier-PDF | Pfad aus case.json | wird tatsächlich geparst; keine vorab extrahierte Antwortschicht |
| Vorlage .pptx | Pfad aus case.json | kann eine Vorlage (0 Folien) oder eine Startpräsentation (>0 Folien) sein |
Arbeiten Sie unter /app/work; Ergebnisse gehen nach /app/output.
Pipeline (7 Schritte)
Schritt 0 – Das Gerüst des Ausgabevertrags zuerst schreiben (vor allem anderen)
Erstelle sofort /app/output/result.json mit allen Feldern des Ausgabevertrags auf null + Grund, Status "partial". Dies garantiert ein gültiges Ergebnis, selbst wenn spätere Schritte fehlschlagen. Verwende:
python scripts/build_result.py --case /input/case.json --out /app/output/result.json --status partial --note "run gestartet"
Schritt 1 – Das Papier-Inventar extrahieren
python scripts/extract_paper.py --pdf <paper.pdf> \
--out /app/work/paper_pages.json \
--figdir /app/work/figs --extract-images
Gibt seitenweisen Text, einen Index der Abbildungs-/Tabellenbeschriftungen mit Seitenzahlen und eingebettete Abbildungsbilder (s{n}_img{i}.png) aus. Wenn es mit Code 3 beendet wird (kein Python-PDF-Backend), verwenden Sie stattdessen das Container-Tool pdf-text-tool / pdf-render-tool und schreiben dasselbe JSON-Format selbst – die nachfolgenden Schritte lesen nur dieses JSON.
Schritt 2 – Die Vorlage analysieren
python scripts/analyze_template.py --pptx <template.pptx> --out /app/work/template_map.json
Erzeugt das Layout-Inventar und eine rollen_map (Titel / Abschnitt / Inhalt / Zwei_Spalten / Abbildung). Lesen Sie es: Überprüfen Sie, ob die rollen_map Ihrer Interpretation der Vorlage entspricht (Namen können in lokalisierten Vorlagen irreführend sein); überschreiben Sie bei Bedarf die layout-Felder des Präsentationsplans pro Folie. Wenn die Vorlage eine Startpräsentation ist (slide_count > 0), werden vorhandene Folien über edit_slide_index im Plan bearbeitet.
Schritt 3 – Den narrativen Kern entwerfen (Agentenurteil)
Lesen Sie die extrahierten Seiten (Zusammenfassung, Einleitung, Ergebnistabellen, Fazit) und schreiben Sie die vier Elemente des narrative im Präsentationsplan:
- problem – was die Arbeit angreift, mit einem wörtlichen Zitat;
- methode – die Kernidee in einem Satz, mit Abbildungs-/Abschnittsverweisen;
- ergebnisse – die Schlagzahlen MIT Einheiten und der Tabelle, aus der sie stammen;
- einschränkungen – bevorzugen Sie den Abschnitt zu Einschränkungen der Arbeit; falls nicht vorhanden, geben Sie dies explizit an und kennzeichnen Sie vom Vortragenden abgeleitete Einschränkungen als solche.
Regeln für Zitate: kopieren Sie wörtlich aus paper_pages.json (korrigieren Sie nur PDF-Zeilenumbrüche); behalten Sie die Seitenzahl bei; paraphrasieren Sie niemals innerhalb eines quote-Felds.
Schritt 4 – Den seitenweisen Präsentationsplan schreiben (Agentenurteil)
Erstellen Sie /app/work/deck_plan.json gemäß references/deck-plan-schema.md. Wichtige Regeln:
- eine Behauptung pro Folie (ein vollständiger Satz, keine Themenüberschrift);
- 3–5 Aufzählungspunkte pro Inhaltsfolie, jeweils ≤ ~90 Zeichen, damit die automatische Schriftgrößenanpassung nicht unter 16pt fällt;
- jede Folie hat ≥1 Beleg-Eintrag (Verweis + Seite + Zitat);
- Abbildungen: verweisen Sie auf die extrahierte Bilddatei und die Abbildungsbezeichnung der Arbeit; überprüfen Sie, ob das Bild tatsächlich diese Abbildung zeigt, bevor Sie es einbetten;
- Notizen müssen Informationen hinzufügen (Übergänge, Betonung, Fragen&Absicherung), niemals Aufzählungspunkte wiederholen;
- Folienbudget: (Pflichtseiten) Titel, Problem, Methodenkern, Methodendetail, Hauptergebnisse, Einschränkungen/Erkenntnisse – dann optionale Seiten (Trainingsrezept, Generalisierung, Ablationen) bis max_folien erreicht ist. Wenn die Arbeit zu viele Abbildungen hat, bevorzugen Sie die, auf denen die Behauptungen basieren, und verweisen Sie auf die übrigen im Text.
Schritt 5 – Die Präsentation zusammenstellen
python scripts/assemble_deck.py --plan /app/work/deck_plan.json \
--map /app/work/template_map.json --out /app/output/<case_id>.pptx \
--max-slides <aus case.json>
Schreibt Text in Folienplatzhalter (niemals in die des Layouts), behält das Vorlagendesign, fügt Bilder in Bildplatzhalter mit seitenverhältnistreuem Zuschnitt ein, verkleinert Schriftarten in 2-PT-Schritten (Mindestgröße 12pt), um Platz zu schaffen, und schreibt Notizen. Wenn es mit einer Fehlermeldung zur Folienanzahl fehlschlägt, kürzen Sie den Plan – verwenden Sie nicht --allow-overflow, es sei denn, der Fall erlaubt dies explizit.
Schritt 6 – Prüfen und rendern
python scripts/check_deck.py --deck /app/output/<case_id>.pptx \
--plan /app/work/deck_plan.json --max-slides <N> --out /app/work/check_report.json
Beheben Sie jeden fail und die meisten warn-Einträge, indem Sie den Plan bearbeiten (nicht die pptx) und Schritt 5 erneut ausführen – der Plan ist die einzige Quelle der Wahrheit. Exportieren Sie dann die PDF-Vorschau mit dem Container office-renderer (lokal: soffice --headless --convert-to pdf) und überprüfen Sie: Seitenanzahl, vorhandene Titel, Bilder auf den richtigen Seiten.
Schritt 7 – result.json finalisieren
python scripts/build_result.py --case /input/case.json \
--plan /app/work/deck_plan.json --check /app/work/check_report.json \
--pptx /app/output/<case_id>.pptx --pdf /app/output/<case_id>_preview.pdf \
--render-info /app/work/render_info.json --changes /app/work/changes.json \
--out /app/output/result.json --status complete
Ausnahmebehandlung (reale Pfade)
| Situation | Erkennung | Aktion |
|---|---|---|
| Kein Python-PDF-Backend | extract exit 3 | Verwende pdf-text-tool / pdf-render-tool; gleiches JSON-Format |
| Verschlüsseltes/beschädigtes PDF | extract Warnungen/Ausnahme | Gebe Unsicherheit in result.json an; fahre mit den geparsten Seiten fort |
| Arbeit hat keine expliziten Einschränkungen | Narrativschritt | Sage dies auf der Folie; kennzeichne abgeleitete Einschränkungen mit [Lesart des Vortragenden] |
| Abbildung kann nicht extrahiert werden | figdir für diese Seite leer | Rendere den Abbildungsbereich mit pdf-render-tool oder verweise textuell darauf + Hinweis auf Unsicherheit |
| Extrahiertes Bild ist nicht die zitierte Abbildung | Bild↔Beschriftungs-Konflikt | Nicht einbetten; auf textuelle Referenz zurückfallen |
| Vorlage hat kein benötigtes Layout | rollen_map nulls | Nächstgelegenes Layout verwenden + Warnung in result.json |
| Folienanzahl überschreitet Limit | Assembler-Fehler 4 | Plan gemäß Prioritätenordnung aus Schritt 4 kürzen |
| Textüberlauf bei 12pt-Mindestgröße | check_deck fail/warn | Aufzählungspunkte kürzen (Agent bearbeitet Plan) |
| Notizen würden Folientext wiederholen | check_deck warn | Notizen umschreiben, um Übergänge/F&A-Informationen hinzuzufügen |
| PDF-Export nicht verfügbar | Renderer-Fehler | pptx liefern + expliziten null für Vorschau + Grund |
Ausgabevertrag
/app/output/result.json enthält: case_id, status, quelle, einschränkungen, ausgabe_vertrag (jedes Feld aus case.json, null + grund wenn nicht vorhanden), ergebnisse (pptx/pdf-Pfade), narrativ, folien_beleg_map (pro Folie Behauptung + Belege), zusammenfassung_qualitätsprüfungen, rendern informationen, änderungen und unsicherheit. Siehe das Beispiel in examples/example-deck-plan.md.
Umfang und Grenzen
Im Umfang: Narrativextraktion, Seitenstrukturierung, Belegzuordnung, Vorlagenanpassung, Notizenerstellung, Rendern-Prüfung. Außerhalb des Umfangs: Neuerstellung von Abbildungen, wissenschaftliche Qualitätsbewertung der Arbeit selbst, Textverfeinerung über die Größe von Folienhinaus. Das Skill nimmt eine englische ML-artige Arbeit an; Beschriftungs-Regexe decken Figure N: / Fig. N: / Table N: ab und lokalisierte Varianten benötigen manuelle Indexkorrekturen (in Änderungen festhalten).