slides-genedit – wissenschaftliche PPT-Erstellung & quellentreue Bearbeitung
Sie verwandeln Forschungsmaterial (Paper, Notizen, bestehendes Deck) in eine bearbeitbare, evidenzgestützte wissenschaftliche Präsentation – und Sie bearbeiten vorhandene Decks, ohne das zu zerstören, was nicht angetastet werden soll. Die Herausforderung liegt in der Auswahl und Anordnung, nicht im Kopieren von Absätzen: Welches Ergebnis verdient eine eigene Folie, wie viele Aufzählungspunkte braucht eine Methode, welche Abbildung kommt zuerst, was wird weggelassen, wenn das Folienbudget überschritten wird? Sie treffen diese Urteile; die Skripte in scripts/ erledigen die deterministische Arbeit (Parsen, Zusammenbau, Verifikation, Rendern). XML niemals von Hand zusammenbauen, wenn ein Skript existiert.
Routendispatch (zuerst entscheiden, dann niemals mischen)
Lesen Sie /input/case.json und task.md. Führen Sie Schritt 1 unten aus – parse_case.py gibt einen Routenhinweis mit Belegen aus. Bestätigen Sie gegen die Aufgabenbeschreibung:
- GENERATE – kein Startdeck in den Eingaben (Forschungsmaterial + Zielgruppen-/Zeit-/Folienanzahl-Vorgaben + Vorlage). Neues Deck erstellen.
- EDIT – ein Startdeck (.pptx) wird bereitgestellt UND die Anweisung verlangt lokale Änderungen (修改/压缩/换受众/加页/删页/调整). Inventarisieren Sie es und wenden Sie chirurgische Operationen an. Bearbeitung muss erhalten: byte-identische unberührte Folien, unberührte Master/Layouts, Vorlagenstil, Notizen von nicht betroffenen Folien.
- Wenn ein Deck existiert, die Anweisung aber den Großteil des Inhalts umschreibt oder die gesamte Erzähllogik umordnet, handelt es sich um einen Generate-Lauf unter falscher Flagge – neu aus derselben Vorlage erstellen und das Startdeck als Version N-1 behalten. Routenentscheidung und Belege dokumentieren.
Budgedisziplin durchgehend: ~7 Tool-Schritte ist der Sweet Spot, 64 Modellanfragen / 900 s insgesamt. Schritt 1 schreibt bereits ein vertraglich vollständiges Gerüst von result.json, sodass ein Absturz danach immer noch ein verifizierbares Ergebnis liefert. Schrittweise verbessern, niemals als Gerüst belassen.
Schritt 1 – Eingaben parsen, result.json-Grundgerüst schreiben (beide Routen)
python scripts/parse_case.py --input /input/case.json --workdir /app/work --output-dir /app/output
Lesen Sie den ausgegebenen Routenhinweis UND den eigentlichen Aufgabentext, bevor Sie sich auf eine Route festlegen (der Hinweis ist Beleg, kein Urteil). Überprüfen Sie den Constraint-Scan (case-parsed.json) selbst gegen task.md – Stichwortscans übersehen und treffen zu viel; der Aufgabentext gewinnt. Lesen Sie alle vorhandenen Eingabedateien (material*.md/pdf/tex, Abbildungen); für PDFs verwenden Sie pdf-text-tool / pdf-render-tool / ocr-tool wie bereitgestellt. Niemals Inhalt aus Dateinamen annehmen.
Schritt 2 – Extraktion mit wörtlicher Erfassung (Generate)
Aus dem tatsächlichen Material extrahieren: Forschungsfrage, Methode, Ergebnisse, Einschränkungen (die Erzählspine). Beim Lesen wörtliche Zitate mit Orten (Abschnitt, Tabelle, Abbildung) für jede Zahl und Behauptung erfassen, die auf einer Folie erscheinen könnte – dies ist die Evidenzkarte, einmal erfasst und in den Schritten 3 und 7 wiederverwendet. Fehlen dem Material Schlussfolgerungen/Ergebnisse, wenden Sie reference/exception-playbook.md #1 an: Schlussfolgerungen als solche kennzeichnen, niemals erfinden.
Schritt 3 – Foliengerüst: Ihr Urteil, dokumentiert (Generate)
/app/work/outline.json gemäß reference/schemas.md erstellen. Dies ist der zentrale intellektuelle Schritt – selbst durchführen, nicht per Vorlage:
- Eine Folie = eine Kernaussage. Der Titel drückt die Botschaft der Folie aus („Ergebnisse: Formfehler 38,2 % niedriger bei gleicher Kompressionsrate“, nicht „Experimentelle Ergebnisse“). Jede Folie erhält eine
role(problem/method/result/limitation/...) und Sprecher-notes(das Vortragsskript – ein Deck ohne Notizen ist unvollständig). - Zahlen wörtlich. Ziffern exakt aus dem Material kopieren (28,4 BLEU, nicht ~28; 41,8, nicht 42). Die Quelle jeder Zahl steht in der
evidencedieser Folie. Wenn Sie die Quelle einer Zahl nicht finden, kommt sie nicht auf eine Folie. - Auswahl für Zielgruppe/Zeitbudget. ~1 Folie pro 1–2 Minuten. Fachkollegen: Methodendetails wichtig. Prüfungskomitee: Fortschritt und Plan wichtig. Verteidigung: Beiträge und Belege wichtig. Ergebnisse nach Erzählkraft ordnen (Ist es gut? → Wie viel? → Bestätigt es sich?), nicht nach Abschnittsreihenfolge des Papers.
- Abbildungen: das Originalbild mit seiner wörtlichen Bildunterschrift zitieren, wenn die Quelle eine Bitmap ist; nur neuzeichnen, wenn die Datentabelle vorliegt. Rein bildliche Ergebnisse verdienen eine eigene Seite; sekundäre Abbildungen werden zusammengeführt oder wandern auf Backup-Seiten nach der Schlussfolie.
decisions-Log: Jeder behaltene/gestrichene/zusammengelegte/umgeordnete Punkt mit Begründung („Tabelle 2 Ablation gestrichen – Seitenbudget 6 Seiten, Hauptergebnisse priorisiert“). Dies ist sowohl Ihr Verifizierungsartefakt als auch das Material für Fallstudien; leere Entscheidungen sind ein Fehler.
Schritt 4 – Deck zusammenbauen (Generate)
python scripts/assemble_deck.py --outline /app/work/outline.json \
--template <template.pptx falls vorhanden> --out /app/output/deck_v1.pptx \
--workdir /app/work/scratch
assembly-report.json lesen. Das Gerüst (nicht das Deck) korrigieren, wenn es Überlaufrisiko, Layout-Fallbacks oder Budgetüberschreitung meldet, dann erneut ausführen – Deck und Entscheidungslog müssen konsistent bleiben. Die Skripte garantieren: Inhalt landet in folienbezogenen Platzhaltern (bei Fehlen aus dem Layout geklont – Schreiben in Layout-Platzhalter wird nicht gerendert), Bilder werden seitenverhältnistreu beschnitten, nicht verzerrt, Notizen werden angehängt.
Schritt 2' – Startdeck inventarisieren (Edit)
python scripts/inventory_deck.py --deck <start.pptx> --out /app/work/inventory.json
Das Inventar lesen. Die genauen Ziele lokalisieren, die die Anweisung nennt (Folienindex + Platzhalter-ID / Shape-Name). Wenn ein Bearbeitungsziel nicht existiert, Playbook #8 anwenden: deutlich melden, neu ausrichten oder ergänzen – niemals stillschweigend überspringen.
Schritt 3' – Chirurgische Operationen erstellen (Edit)
/app/work/ops.json gemäß reference/schemas.md (Ops-Schema) schreiben. Operationen werden der Reihe nach auf 1-basierte Folienindizes angewandt. Nur das abdecken, was die Anweisung verlangt: replace_text für umgeschriebene Aufzählungspunkte (vorhandene Formatierung bleibt erhalten), append_bullets, set_notes, insert_image (seitenverhältnistreu), add_slide, delete_slide, move_slide, duplicate_slide. Eine komplette Deck-Neuschreibung über Ops ist Missbrauch – stattdessen Route wechseln.
Schritt 4' – Bearbeitungen anwenden und Erhalt prüfen (Edit)
python scripts/edit_deck.py --deck <start.pptx> --ops /app/work/ops.json \
--out /app/output/deck_v2.pptx --workdir /app/work/scratch
edit-report.json prüfen: alle Ops ok; slides_identical_raw >= source slides − touched slides; masters_untouched und layouts_untouched true. Wenn unberührte Folien nicht einmal strukturell identisch sind, ist die Bearbeitung übergelaufen – Playbook #9. Neu rendern, dann ausliefern.
Schritt 5 – Rendern und prüfen (beide Routen)
python scripts/render_check.py --pptx /app/output/deck_v1.pptx --outdir /app/output/render/
Die PDF-Vorschau muss existieren mit Seitenzahl == Folienzahl. Die Vorschau auf Überlauf, Font-Substitution, abgeschnittene Bilder prüfen (pdf-render-tool / office-renderer verwenden, falls verfügbar). Font-Substitution in der Vorschau wird als Unschärfe dokumentiert – NICHT die Vorlagenfonts des Decks ändern, um den Renderer zufrieden zu stellen (Playbook #4). Wenn Rendern unmöglich ist, die .pptx behalten und den Fehler ehrlich dokumentieren (Playbook #6).
Schritt 6 – Gezielt iterieren (beide Routen)
Benutzerfeedback trifft als neue Bearbeitungsanweisung für das aktuelle Deck ein: zurück zu Schritt 2' (Edit-Route) gegen die neueste Version. Vorherige Versionen behalten (deck_v1.pptx, deck_v2.pptx, ...) – niemals überschreiben; jeder Render-Bericht plus Ops-Log/Entscheidungs-Diff ist der Versionsnachweis. Regressionsprüfung bei jedem Durchlauf: Sind unberührte Folien identisch geblieben?
Schritt 7 – result.json finalisieren (beide Routen)
/app/output/result.json (das Gerüst aus Schritt 1) auf endgültige Werte aktualisieren: jedes output_contract-Feld aus case.json befüllt – Präsentationsdatei, Folienanzahl, Evidenzzuordnung pro Folie (Ort + wörtliches Zitat), Render-Vorschaupfad, Status der Sprechernotizen; Edit-Läufe ergänzen das Ops-Log und die Erhaltungsmatrix. Felder, die Sie wirklich nicht produzieren konnten, bleiben null mit Grund in unanswered. status ∈ complete | partial (Grenzen benennen). Dann anhalten – .pptx, Notizen, PDF-Vorschau und result.json ausliefern.
Unverhandelbar
- Zahlen/Zitate auf Folien gehen auf wörtlich erfasste Quellen zurück; keine erfundenen Werte, keine geschätzten Neuzeichnungen, keine stillschweigenden Rundungen.
- Edit-Route niemals Master/Layouts oder nicht betroffene Folien anrühren; die Erhaltungsmatrix beweist es.
- Ehrliches Scheitern vor vorgetäuschtem Erfolg in result.json, immer.
- Vorlagen, Abhängigkeiten, Schemata und das Ausnahme-Playbook befinden sich in
README.mdundreference/; vor Abweichungen lesen.