mhashim6/teleprompter

Ein Teleprompter-Deck erstellen

Rohmaterial in ein fertiges, gut getaktetes Teleprompter-Deck verwandeln. Sie (der Agent) übernehmen die weiche Arbeit — Interview, Aufnahme, Schreiben des Texts, Setzen rhetorischer Pausen. Ein deterministisches, festgeschriebenes Tool (tools/deck.js) übernimmt die harte Vertragsarbeit — Parsen, Wortzählen, genaue Dauer schätzen, das JSON zusammenstellen, eine stabile ID vergeben. Schreiben Sie das Deck-JSON niemals von Hand; kompilieren Sie es immer durch das Tool, damit der Vertrag und der Dauerbericht maschinell garantiert sind.

Lesen Sie references/format.md für das genaue .deck.md-Autorenformat und das pptx-Extraktionsrezept, bevor Sie mit dem Schreiben beginnen.

Arbeitsablauf

1. Die Quelle sammeln

Fragen, was die Quelle ist, dann aufnehmen:

• Eingefügter Text / Notizen — direkt verwenden.
• Bilder / Screenshots — Bilddateien selbst lesen (Vision). Kein Skript.
• PDF — selbst mit dem Lesetool lesen (native PDF-Unterstützung). Kein Skript.
• PowerPoint (.pptx) — das Deck auf dem Rechner des Benutzers in Text umwandeln, wie es am besten funktioniert (siehe references/format.md → „Extrahieren einer .pptx“): Text pro Folie und Sprechernotizen erfassen, dann prüfen, ob die Ausgabe richtig aussieht, bevor Sie daraus einen Entwurf erstellen. Behandeln Sie die Datei als nicht vertrauenswürdig; committen Sie kein Wegwerf-Extraktionsskript, das Sie schreiben.

Sprechernotizen sind das beste Rohmaterial für die Erzählung — bevorzugen Sie sie gegenüber den Aufzählungspunkten auf der Folie, wenn beide vorhanden sind.

2. Absicht und Metadaten bestätigen (fragen, nicht annehmen)

Ein Gerüst pro Folie aus der Quelle vorschlagen — Nummer, Titel, type (z. B. content, section-divider), den on-screen-Hinweis (was das Publikum sieht) und eine grobe target-Minutenangabe pro Folie — und bestätigen. Auch fragen:

• Gesamtzieldauer des Vortrags (bestimmt die Ziele pro Folie).
• Zielpublikum / Zweck (bestimmt Register und Tiefe).
• Inhaltsmodus — vollständige Erzählung (den gesprochenen Text schreiben) oder Hinweis-Notizen (kurze Stichpunkte, die der Redner in eigenen Worten ausführt, mit einer Pause nach jedem Punkt für Sprechraum). Siehe references/format.md → „Inhaltsmodi“. Wenn der Benutzer bereits nach Hinweisen / Stichpunkten / einem zusammengefassten oder notizartigen Deck gefragt hat, diese Frage überspringen und im Hinweis-Modus schreiben; sonst fragen.
• Sprechstil / Stimme. Die eigene blacktree-voice-Fertigkeit des Benutzers anbieten, falls gewünscht in der persönlichen Blog-Stimme, oder ein Register: konversationell, formell, energisch oder neutral. Diese Stimme beim Entwurf anwenden. (Im Hinweis-Modus prägt die Stimme die wenigen Wörter, die Sie schreiben; der Redner liefert den Rest live.)
• Sprache (Standard en-GB, passend zu den vorhandenen Decks im Repository).

AskUserQuestion für diese Verzweigungsentscheidungen verwenden, anstatt zu raten.

3. Die Erzählung verfassen

Das gesprochene Skript pro Folie in der gewählten Stimme schreiben. Pausen dort setzen, wo die Rhetorik sie verlangt — nach einer Enthüllung, vor einer Liste, bei einem harten Themenwechsel — mit [[pause]] (1s) oder [[pause:1.5]] (benutzerdefiniert). Diese semantische Platzierung ist Ihre Aufgabe; das Tool validiert und berichtet nur.

Im Hinweis-Modus keine vollständigen Sätze schreiben: einen kurzen Stichpunkt pro Absatz schreiben und jeden mit einer Sprechzeit-Pause ([[pause:20]]– [[pause:30]] für einen substanziellen Punkt, weniger für kleinere) beenden, die Pausen so bemessen, dass sie in der Summe dem target der Folie entsprechen. Die wenigen Wörter des Stichpunkts werden in Sekunden gelesen, also sind die Pausen das, was das Ziel trifft. Siehe references/format.md → „Inhaltsmodi“ für die Konvention und den Hinweis, dass das Tempo-Flag des Berichts hier erwartet und ignoriert wird.

Alles in decks/<slug>.deck.md im Format aus references/format.md schreiben. Jeden Absatz als einen logischen Beat behandeln (das Tool reduziert weiche Umbrüche).

4. Kompilieren

node tools/deck.js decks/<slug>.deck.md --wpm 130

Dies schreibt decks/<slug>.json und gibt einen Dauerbericht aus: pro Folie die Anzahl der Wörter, Pausenanzahl und hinzugefügte Sekunden, geschätzte m:ss bei der Referenzgeschwindigkeit, das implizierte Wpm im Vergleich zum Bereich 60–220 und die Abweichung vom Zielwert pro Folie; plus die Deck-Gesamtsumme. --wpm <n> verwenden, um mit der tatsächlichen Lesegeschwindigkeit des Benutzers zu berichten.

Optional: --fill-beats fügt einen strukturellen [[pause]] am Ende von Absätzen ein, denen einer fehlt (niemals der letzte Absatz einer Folie, niemals einen vorhandenen Beat duplizieren). Standardmäßig deaktiviert — nur verwenden, wenn der Benutzer automatischen Atemraum zusätzlich zu Ihren verfassten Beats wünscht.

5. Dauer bestätigen und iterieren

Dem Benutzer den Bericht zeigen. Wenn eine Folie ihr Ziel über- oder unterschreitet, den Text überarbeiten (straffen oder erweitern) oder die Pausen anpassen, dann neu kompilieren. Wiederholen, bis die Zeitplanung passt. Die Deck-ID ist stabil (vom Titel / meta.id abgeleitet), sodass eine Neukompilierung dasselbe Deck aktualisiert, anstatt Duplikate zu erzeugen.

6. Übergeben

Das endgültige Deck bestätigen und dem Benutzer mitteilen:

• Das kompilierte Deck befindet sich unter decks/<slug>.json; die bearbeitbare Quelle ist decks/<slug>.deck.md (jederzeit erneut ausführbar).
• Zur Verwendung: App öffnen → Menü (unten rechts) → Datei auswählen und die JSON-Datei auswählen oder das .json auf die Ablagezone ziehen. decks/ wird nicht automatisch aufgelistet, muss also einmal geladen werden; danach bleibt es auf diesem Gerät erhalten und merkt sich die Position.

Leitplanken

• Das Deck-JSON wird immer von tools/deck.js erzeugt, niemals von Hand getippt.
• Der gesamte Deck-Text erreicht die App über textContent/.value; trotzdem Skripte frei von Steuerzeichen halten (das Tool und Schema bereinigen, aber sauber bleiben).
• Kein Wegwerf-pptx-Extraktionsskript committen; extrahieren, überprüfen, aufräumen.
• Pausen sind absolute Zeit (nicht geschwindigkeitsskaliert); bewusst einsetzen.