Web Video Präsentation
Verwandle einen Artikel oder ein Skript Schritt für Schritt in eine „als Video getarnte Webseite“, die aufgenommen werden kann. Optional mit Sprachsynthese. Das Ergebnis ist ein Vite + React + TS Projekt + nach Kapiteln getrennte Audiodateien.
Anwendungsbereiche
- „Ich habe ein Skript/einen Artikel – mach daraus ein Video“ – inhaltsgetriebene Präsentationen
- Dynamische „PowerPoint auf jedem Bildschirm“ erstellen
- 16:9 Breitbildaufnahme (große Schrift, viel Weißraum, Animationen auf jeder Folie)
- Lehrinhalte / Produktdemos / Keynotes mit filmischem Look
- Bilibili / YouTube / TikTok Video-Inhalte
Dieses Skill konzentriert sich auf Methodik und Kollaborationsworkflow. Das Scaffold-Template bietet Tokens und Grundbausteine, aber jede ästhetische Entscheidung (Farbpalette, Schriftart, Animationsstil) sollte für dein spezifisches Thema neu gestaltet werden – nicht blind kopiert.
Workflow Übersicht
Phase 1 Inhaltserstellung
1.1 Benutzereingabe identifizieren
1.2 Einmalige Ausgabe von script.md + outline.md
(Voiceover-Skript + Entwicklungsplan)
▼
[Checkpoint Plan] ← Muss anhalten. 5 Dinge auf einmal abstimmen:
Skript / Outline / Thema / Assets / Entwicklungsmodus
▼
Phase 2 Webentwicklung
2.1 Scaffold (nach gewähltem Thema)
2.2 Kapitel 1 = Haupt-Thread + vollständige Version (obligatorischer Ankerpunkt)
▼
[Harter Knoten] Benutzer akzeptiert Kapitel 1 ← Nicht überspringbar
▼
2.3 Kapitel 2~N (nach gewähltem Modus: A Kapitel für Kapitel / B Sequentiell / C Parallel)
▼
[Checkpoint Audio] ← Muss anhalten. Audio-Synthese oder nicht
▼
Phase 3 Audio-Synthese (optional)
▼
Phase 4 Bildschirmaufnahme + Postproduktion
Arbeitsverzeichnis Konvention (Agent erstellt/bearbeitet im aktuellen Verzeichnis des Benutzers):
my-video/
├── article.md # Vorhanden, wenn Benutzer Originaltext liefert – nicht löschen! Informationsquelle für die visuelle Entwicklung
├── script.md # Vorhanden: Plattformtaugliches Voiceover-Skript (bestimmt die Taktung)
├── outline.md # Vorhanden: Entwicklungsplan (Kapitelaufteilung + Schritte + Informationspool)
└── presentation/ # Vite + React + TS Projekt (vom Scaffold erzeugt)
├── src/chapters/<NN>-<id>/
│ ├── <Chapter>.tsx # Visuelle Implementierung
│ ├── <Chapter>.css
│ └── narrations.ts # ★ Einzige Quelle der Wahrheit für Schrittanzahl und Voiceover-Text
├── scripts/
│ ├── extract-narrations.ts # Scannt alle narrations.ts → audio-segments.json
│ ├── synthesize-audio.sh # Provider-unabhängiger Runner (durchläuft Segmente)
│ └── tts-providers/ # Ein .sh pro Provider (2 integriert)
│ ├── README.md # Drei-Funktionen-Vertrag + 5 fertige Code-Snippets (11labs / edge-tts / say / azure / gcloud)
│ ├── minimax.sh # Standard-Provider, nutzt mmx-cli
│ └── openai.sh # Integrierter OpenAI TTS (curl + OPENAI_API_KEY)
├── audio-segments.json # output von extract (vor Synthese prüfbar)
└── public/audio/<id>/<N>.mp3 # Optional: Synthetisierte Audiodateien
Wichtig:
narrations.tsist die einzige Quelle der Wahrheit für Schrittanzahl und Audio-Synthese. Das maximale N + 1 inif (step === N)im Kapitel.tsxmuss gleichnarrations.lengthsein. Dadurch wird sichergestellt, dass die 5 Stellen (script / outline / Kapitelcode / chapters.ts / Audiodateien) niemals auseinanderdriften.
Harte Selbstprüfprotokolle (durchgängig im gesamten Skill)
Für die folgenden drei Ergebnisse MUSS nach Fertigstellung eine Selbstprüfung → Reparatur → erneute Meldung/Fortsetzung erfolgen:
| Ergebnis | Quelle der Prüfliste |
|---|---|
script.md | SCRIPT-STYLE.md Drei-Ebenen-Prüfung (Form / Stimme / Vorlesen) |
outline.md | OUTLINE-FORMAT.md Selbstprüfung |
| Kapitelimplementierung abgeschlossen | CHAPTER-CRAFT.md Fertigstellungs-Selbstprüfung |
Ausführungsmethode (nach Fähigkeiten absteigend, bevorzuge isoliertere Methoden):
- Agent Teams (Optimal): Starte einen unabhängigen Reviewer-Agenten, gib ihm "Pfad zur Ausgabedatei + entsprechende Liste + Kontext", lass ihn Punkt für Punkt prüfen und streng Schlussfolgerungen melden (welche bestanden / welche durchgefallen + Beweise + Verbesserungsvorschläge).
- subAgent (Sekundär): Wenn keine Teams-Fähigkeit vorhanden, aber subAgent möglich ist, verwende denselben Prozess mit subAgent.
- Selbstprüfung (Fallback): Wenn der aktuelle Agent keine der obigen Fähigkeiten hat, prüfe selbst streng Punkt für Punkt – ein flüchtiger Blick und Freigabe ist nicht erlaubt.
Eiserne Regel: Nach Erhalt der Schlussfolgerungen repariere zuerst alle fehlgeschlagenen Punkte, dann melde dem Benutzer "fertig + Prüfergebnis + was geändert wurde". Direktes Melden der rohen Ergebnisse ohne Korrektur = Regelverstoß.
Dateileseführer für jede Phase
Verschiedene Phasen lesen verschiedene Dateien. In langen Sitzungen vergisst der Agent leicht Prinzipien, besonders in Phase 2.4 "Kapitel implementieren", die N-mal wiederholt wird – jedes Mal müssen die Kernbeschränkungen erneut überprüft werden.
| Phase | Muss gelesen werden (jedes Mal) | Einmalig lesen / nach Bedarf nachschlagen |
|---|---|---|
| Phase 1.1-1.2 Inhaltserstellung | references/SCRIPT-STYLE.md + references/OUTLINE-FORMAT.md + article.md (Originaltext des Benutzers, falls vorhanden) | —— |
| Checkpoint Plan Thema wählen | —— | themes/*/theme.json (dynamisch alle lesen, Liste + bestFor Empfehlung + descriptionZh) auflisten; references/THEMES.md (wenn Benutzer das Themensystem verstehen möchte) |
| Phase 2.1 Scaffold | —— | SKILL.md diesen Abschnitt einmal lesen |
| Phase 2.4 Kapitel implementieren (×N mal, aufgerufen von 2.2 / 2.3) | references/CHAPTER-CRAFT.md Einzige Einstiegsseite – Teil 0 Zehn Prinzipien / Teil 1 5 Fragen vor Start / Teil 2 Beziehung→Aktion Entscheidungsbaum / Teil 3 Visuelles Toolkit / Teil 4 Zeitreferenzen / Teil 5 Anti-AI Anti-Patterns / Teil 6 Harte Code-Regeln (inkl. obligatorische narrations.ts Beschränkungen) / Teil 7 Fertigstellungs-Selbstprüfung / Teil 8 Feedback-Referenz + themes/<id>/theme.json des aktuellen Themas + Outline.md Absatz des aktuellen Kapitels + article.md entsprechender Abschnitt des Kapitels + Asset-Liste | references/EXAMPLES/ (Strukturreferenz, nicht zum Kopieren); references/THEMES.md Vollständiger Token-Vertrag |
| Phase 3 Audio-Synthese | references/AUDIO.md (enthält Workflow narrations.ts → segments.json → beliebiger Provider, inklusive minimax + openai) | templates/scripts/tts-providers/README.md (beim Wechseln/Hinzufügen von Providern / eigenem TTS) |
| Phase 4 Aufnahme + Postproduktion | references/RECORDING.md (enthält ?auto=1 für automatische Aufnahme) | —— |
| Thema wählen / erstellen / anpassen | —— | references/THEMES.md |
Beim Schreiben von Kapiteln nur
CHAPTER-CRAFT.mdlesen. Zehn Prinzipien / Start-Self-Prompting / Entscheidungsbaum / Anti-AI Anti-Patterns / Fertigstellungs-Selbstprüfung sind alle in diesem einen Einstiegspunkt zusammengefasst.EXAMPLES/ist nicht obligatorisch – zuerst nach Inhalt frei entwerfen, nur bei Stocken nachschlagen (nach Anker für "Form", nicht blind kopieren).
Phase 1 – Inhaltserstellung (einmalige Ausgabe)
1.1 Benutzereingabe identifizieren
| Vom Benutzer gegeben | Zu tun |
|---|---|
| Originaler Artikel (schriftliche Sprache / Blog / Paper / Blog) | Einmalige Ausgabe von script.md + outline.md (1.2), dann Checkpoint Plan |
| Direktes Voiceover-Skript / Video-Skript | Als script.md speichern, einmalige Ausgabe von outline.md (vereinfachte Version 1.2), dann Checkpoint Plan |
| Nichts außer "Mach mir ein Video zum Thema X" | Nachfragen: Erst Material oder Gliederung geben. Skill ersetzt nicht die Ideenfindung des Benutzers |
1.2 Einmalige Ausgabe von script.md + outline.md
Beide Ausgaben werden in einem Denkdurchlauf erstellt:
script.mdgenerieren: Nach den Regeln inreferences/SCRIPT-STYLE.mdden Artikel in ein plattformtaugliches Voiceover-Skript umwandeln.article.mdbehalten und nicht löschen – es ist die Detailquelle für den Informationspool und die visuelle Umsetzung im Outline (Zwei-Quellen-Prinzip).outline.mdgenerieren: Nach den Regeln inreferences/OUTLINE-FORMAT.mdKapitel teilen + Schritte teilen + pro Kapitel im ersten Absatz einen Informationspool extrahieren.
Grenzen des Outlines (Schlüssel):
| Outline muss schreiben | Outline darf nicht schreiben |
|---|---|
| Kapitelaufteilung / Schritte pro Kapitel / Zeitabschätzung | Spezifische Animationstypen (blur clear / wipe / spring) |
| Bildschirminhalt pro Schritt (Hero / Daten / Slogan / Listeneinträge) | CSS-Implementierungsmittel (filter / SVG / clip-path) |
| Kapitelweiser Informationspool: Aus dem Artikel extrahierte Zahlen / Zitate / Beispiele / Tags | Zeitwerte (nicht |
| Präfix für Beziehungsnamen auf Schritt-Ebene ("Kontrast & Vergleich" / "Progressive Liste" / "Kernaussage" etc. optionaler Hinweis) | Mikro-Rhythmen wie Dauermikrobewegung / Staffelung |
Grund für kein Schreiben von Animationen im Outline: Feste Animationen machen den Kapitel-Agenten zu einer Übersetzungsmaschine; der Freiraum erlaubt dem Kapitel-Agenten, bei jedem Schritt nach dem "inhaltsgetriebenen Entscheidungsbaum" in
CHAPTER-CRAFT.mdfrei zu gestalten – nur so entsteht echtes Video-Gefühl. SieheCHAPTER-CRAFT.mdTeil 0, Prinzip 7.
Nach dem Speichern muss zuerst die Selbstprüfung durchgeführt werden, bevor der Checkpoint Plan betreten wird: Führe für script.md / outline.md das oben genannte "Harte Selbstprüfprotokoll" durch (bevorzugt Agent Teams → subAgent → Selbstprüfung), behebe die Ergebnisse nach Anweisung, dann betrete den Checkpoint Plan.
Checkpoint Plan – 5 Dinge auf einmal abstimmen (Harter Knoten)
Nachdem script.md + outline.md erstellt wurden, muss angehalten werden. Der Benutzer bestätigt an diesem einen Knoten gleichzeitig 5 Dinge.
Vorbereitungsarbeit des Agenten zu diesem Zeitpunkt
- Alle
themes/*/theme.jsonlesen fürnameZh/descriptionZh/bestFor/mood– Liste nicht hartcodieren - Basierend auf Inhaltstyp / Schlüsselwörtern / Ton von
script.md, aktiv 2–3 am besten passende Empfehlungen aus den Themen auswählen (passend zumbestForFeld) - Den Abschnitt "Asset-Liste" am Ende von
outline.mdüberfliegen
Zusammenfassungsvorlage (Grundgerüst, Agent füllt nach Situation aus)
Inhaltsplan erstellt, Ausgabedateien:
📄 article.md {falls Benutzer Originaltext geliefert hat}
📄 script.md {X} Zeichen / ~{T} Minuten
📄 outline.md {N} Kapitel / {M} Schritte + Informationspool pro Kapitel + Asset-Liste am Ende
Kapitelübersicht:
1. <id> <Kapiteltitel> <S> Schritte ~<T>s
2. ...
Jetzt 5 Dinge auf einmal abstimmen:
1. Skript (script.md) bearbeiten?
Datei direkt editieren oder Änderungsrichtung mündlich mitteilen.
2. Entwicklungsplan (outline.md) bearbeiten? Wichtige Punkte:
- Ist die Kapitelaufteilung / Schrittanzahl / Zeitabschätzung sinnvoll? (Faustregel: 30–60s pro Kapitel)
- Sind die Bildschirminhalte pro Schritt klar?
- Hat der erste Absatz jedes Kapitels (Informationspool) genügend Details aus article.md für die visuelle Umsetzung?
- Ist die Asset-Liste am Ende vollständig?
3. Welches Thema wählen? Meine Empfehlung:
★ <Empfehlung 1: nameZh (id)> – weil <bestFor trifft zu>; <descriptionZh Zusammenfassung>
★ <Empfehlung 2 / Empfehlung 3>
Andere Optionen: <Restliche Themen, nameZh + ein Satz>
Kann auch ein neues Thema für dich erstellen (siehe references/THEMES.md).
4. Wie werden echte Assets vorbereitet? Grobe Liste benötigter Bilder: <Grobe Liste>
a) Ich suche aus <vorhandenem Asset-Pfad> aus b) Du lieferst selbst c) Alle Platzhalter
5. Welcher Entwicklungsmodus?
**Kapitel 1 muss in jedem Modus im Haupt-Thread fertiggestellt und vom Benutzer abgenommen werden** (obligatorischer Anker).
Der Unterschied liegt in Kapitel 2 und danach:
A) Standard · Kapitel für Kapitel bestätigen (empfohlen)
Nach jedem Kapitel anhalten und prüfen → Risiko kontrollierbar / stabilster Rhythmus
B) Sequentiell nach Kapitel 1 (nicht parallel)
Kapitel 2~N im Haupt-Thread nacheinander fertig, dann gemeinsam prüfen → mittlere Geschwindigkeit / geeignet wenn Agent keine Parallelaufgaben unterstützt
C) Parallel nach Kapitel 1 (subAgent)
Kapitel 2~N mit subAgent parallelisieren → am schnellsten / Benutzer kontrolliert Parallelität (wie viele Kapitel auf einmal)
⚠️ Stilistische Unterschiede zwischen Kapiteln sind zu erwarten (dies ist beabsichtigt, Absturzsicherung durch Thementoken)
Nach Erhalt des Feedbacks:
- Skript / Outline ändern: Datei direkt editieren, nach dem Editieren einmal ping (oder mündlich beschreiben, Agent ändert)
- Thema muss klar sein, bevor Phase 2 betreten wird. Benutzer sagt "Such du das Thema aus" → Nimm deine erste Empfehlung, sag dem Benutzer, was du gewählt hast und warum, gib Gelegenheit zum Umdenken
- Modus ausgewählt → Phase 2 betreten
Phase 2 – Webentwicklung
2.1 Scaffold
bash <path-to-web-video-presentation>/scripts/scaffold.sh \
./presentation \
--theme=<id des vom Benutzer gewählten Themas>
bash <path-to-web-video-presentation>/scripts/scaffold.sh --list-themes
Eigenes Thema → Zuerst nach Workflow in
references/THEMES.md"Neues Thema erstellen" einthemes/<my-theme>/machen, dann--theme=<my-theme>.
Das Scaffold bringt ein 01-example Demo. Vor dem Schreiben des ersten echten Kapitels löschen:
rm -rf presentation/src/chapters/01-example
Und den Import und Array-Eintrag von EXAMPLE_CHAPTER in presentation/src/registry/chapters.ts entfernen.
2.2 Kapitel 1 – Haupt-Thread + obligatorische Abnahme
Kern: Kapitel 1 = Vollständige Version auf einen Schlag (Rhythmus + visuell + echte Assets komplett). Kein "Skelett-Konzept" – das erste Kapitel muss eine vom Benutzer direkt abnahmefähige Vorlage sein.
Warum Kapitel 1 im Haupt-Thread sein muss:
- Es ist die erste Umsetzung der Anleitung aus
CHAPTER-CRAFT.mdfür das aktuelle Thema + aktuelles Material - Wenn die Anleitung blinde Flecken hat / die Themenfarben oder Schriftarten-Token nicht ausreichen, wird das in Kapitel 1 auffallen – dann kann mit menschlichem Feedback die Anleitung repariert / das Thema angepasst werden, je früher, desto günstiger
- Nachfolgende Kapitel (egal ob sequentiell oder parallel) müssen sich am Code-Muster von Kapitel 1 orientieren, also Kapitel 1 = "Stilanker" für das aktuelle Projekt (keine stilistische Einheitlichkeit zwischen Kapiteln erzwungen, aber das einzelne Kapitel muss in sich schlüssig und überzeugend sein)
Nach Fertigstellung von Kapitel 1 muss angehalten werden – warte auf Benutzerabnahme:
Kapitel 1 <id> fertig. Dev Server läuft auf localhost:5173.
Abnahmeschwerpunkte:
□ Stimmt die visuelle Stimmung? Entspricht sie den Erwartungen von <theme nameZh>?
□ Stimmt der Rhythmus? Sind bestimmte Schritte zu schnell / zu langsam / zu dünn?
□ Ist die inhaltsgetriebene Animation gelungen? Oder gibt es Schritte mit uninspirierten Eintrittsanimationen?
□ Zwei-Quellen-Prinzip: Enthält der Bildschirm Details, die "das Voiceover nicht nennt, aber article.md liefert"?
□ Anti-AI-Geruch-Check: Gibt es lila-rosa Farbverläufe / runde farbige Ränder / falsche Illustrationen / Emojis?
Sag mir, was geändert werden muss. Sag "Weiter", wenn OK, dann mache ich Kapitel 2 und folgende nach dem gewählten Modus.
2.3 Kapitel 2~N – nach gewähltem Modus
Gemeinsame Regel für alle Modi: Jedes Kapitel unabhängig nach CHAPTER-CRAFT.md entwickeln. Stilistische Einheitlichkeit zwischen Kapiteln wird nicht erzwungen – Themenfarben / Schriftarten-Token gewährleisten visuelle Einheit, aber Animation / Rhythmus / visuelle Demonstration werden frei vom Kapitel gestaltet, das ist beabsichtigt.
Modus A · Standard · Kapitel für Kapitel bestätigen
Kapitel 2 fertig → Anhalten zur Prüfung → OK → Kapitel 3 → Anhalten → … → Kapitel N. Jedes Kapitel einzeln prüfen, Probleme jederzeit beheben, geringstes Risiko, stabilster Rhythmus. Wenn Benutzer keinen Modus explizit wählt, wird standardmäßig dieser verwendet.
Modus B · Sequentiell nach Kapitel 1
Kapitel 2 → Kapitel 3 → … → Kapitel N nacheinander im Haupt-Thread fertigstellen, dann am Ende gemeinsam prüfen. Mittlere Geschwindigkeit, geeignet für Umgebungen, in denen der Agent keine parallelen Aufgaben unterstützt.
Modus C · Parallel nach Kapitel 1 (subAgent)
Mit subAgent Kapitel 2~N parallel fertigstellen, maximale Parallelität vom Benutzer kontrolliert ("einmal 4 Kapitel" / "einmal 2 Kapitel"). Am schnellsten, aber stilistische Unterschiede zwischen Kapiteln sind zu erwarten – das ist beabsichtigt, weil:
- Jeder subAgent sieht die Ergebnisse der anderen subAgenten nicht, kann sich nicht mechanisch angleichen
- Kapitelcode ist physisch getrennt (eigener Ordner / eigenes CSS-Präfix), beeinträchtigen sich nicht gegenseitig
- Thementoken gewährleisten visuelle Einheit (Farben / Schriftarten / Hero-Zahlen / Karten / Trennlinien / Dekoration), Stimmung driftet nicht ab
- Stilistische Uneinheitlichkeit = Atmung einer handgeschriebenen Video-Erzählung (mehrere Stimmen / Perspektiven)
Das Prompt für parallele subAgenten MUSS enthalten:
- Outline-Absatz des aktuellen Kapitels (mit Informationspool)
- Pfad zu
references/CHAPTER-CRAFT.md(Einziges Pflichtdokument – visuelle Anforderungen + schrittweise Enthüllung + Zwei-Quellen-Prinzip + Anti-AI-Geruch + Code-Rotlinien + Fertigstellungs-Selbstprüfung alles in einer Datei) descriptionZh/mood/bestForaustheme.jsondes aktuellen Themas (zur Stimmungsreferenz; Animation / Dauer / Schriftgröße / Emojis werden vom Kapitel-Agenten frei bestimmt)- Kapitel 1 Code als "Code-Stil" Referenz (nicht "visuelles Objekt zum Kopieren")
- Harte Regeln: Jedes Kapitel hat eigenes CSS-Präfix (
.cd-/.mg-/.pm-/ …);chapters.tsnicht ändern; nach Fertigstellungnpx tsc --noEmitausführen
Wichtig: Egal welcher Modus gewählt wurde, der Benutzer kann jederzeit mitten im Prozess den Modus wechseln. Wenn Kapitel 2 OK ist und der Benutzer sagt "Rest parallel" / "Rest einzeln" – beides möglich.
2.4 Kapitel implementieren (jedes Kapitel muss durchlaufen)
Detaillierte Anleitung in references/CHAPTER-CRAFT.md – einziges Pflichtdokument, das abdeckt: Anforderungen an visuelle Demonstration / schrittweise Enthüllung / Inhaltsauswahl / Zwei-Quellen-Prinzip / grundlegende Ästhetik von Video-Demos / Anti-AI-Geruch / Code-Rotlinien / Fertigstellungs-Selbstprüfung.
Kernpunkte (ausführlich in CHAPTER-CRAFT.md):
- Jedes Kapitel MUSS eine CSS / SVG / Canvas / JS visuelle Demonstration haben, reine Textkapitel verboten
- Schrittweise Enthüllung: Listen / Aufzählungen MÜSSEN 1 Eintrag = 1 Schritt sein, kein gleichzeitiges Zeigen mehrerer Einträge verboten
- Zwei-Quellen-Prinzip: Rhythmus folgt dem Voiceover (Reihenfolge darf nicht verändert werden), Details kommen aus dem Originalartikel (Informationspool + article.md Abschnitt des Kapitels)
- Fertigstellungs-Selbstprüfung Punkt für Punkt durchgehen, nicht bestandene Punkte zurückgehen und beheben – nach obigem "Hartes Selbstprüfprotokoll" (bevorzugt Agent Teams → subAgent → Selbstprüfung), erst nach Korrektur die Fertigstellung des Kapitels an den Benutzer melden
2.5 STORAGE_KEY nach größeren Änderungen erhöhen
Nach Änderungen an chapters.ts (Kapitel hinzufügen / löschen / umordnen oder Längenänderung von narrations.ts in einem Kapitel), erhöhe den STORAGE_KEY in presentation/src/hooks/useStepper.ts (z. B. v4 → v5), um zu vermeiden, dass ein persistierter Cursor auf einem nicht mehr existierenden Schritt landet.
Checkpoint Audio – Audio-Synthese oder nicht (Harter Knoten)
Nach Abschluss von Phase 2 muss angehalten werden, frage den Benutzer:
Webseite fertig, {N} Kapitel {M} Schritte, Dev Server läuft auf localhost:5173.
Audio für "Auto-Play-Aufnahme" synthetisieren?
✓ Synthese → Scanne alle narrations.ts aller Kapitel → audio-segments.json,
rufe TTS Provider auf → synthetisiere pro Schritt eine mp3 nach public/audio/.
Danach mit ?auto=1 Modus in einem Take aufnehmen (Audio und Video automatisch synchron).
Zwei integrierte Provider:
• minimax (mmx-cli) – Standard, stabile chinesische Sprachqualität
• openai (OPENAI_API_KEY) – curl-basiert, die meisten haben bereits einen Key
Andere Backends (ElevenLabs / edge-tts kostenlos / macOS say offline /
Azure / Google) siehe scripts/tts-providers/README.md mit fertigen Code-Snippets.
✗ Keine Synthese → Phase 3 überspringen, direkt Phase 4 mit manueller Aufnahme + nachträglicher Vertonung.
Bei Synthese → Phase 3. Keine Synthese → Direkt Phase 4.
Phase 3 – Audio-Synthese (optional)
Detaillierter Workflow in references/AUDIO.md. Kurzversion:
cd presentation
npm run extract-narrations # Scannt alle narrations.ts → audio-segments.json
# Benutzer lässt audio-segments.json gegenchecken, Text stimmt
npm run synthesize-audio # Standard: minimax Provider, inkrementell
# Oder mit integriertem openai (benötigt OPENAI_API_KEY):
PRESENTATION_TTS=openai npm run synthesize-audio
# Oder benutzerdefiniert: scripts/tts-providers/<name>.sh schreiben, siehe README.md in diesem Verzeichnis
Nach der Synthese dem Benutzer mitteilen: Ausgabepfad / Gesamtzahl Segmente / welche Segmente zeitlich auffällig sind (zu lang = Schritt aufteilen; zu kurz = Text zu dünn) – letzte Gelegenheit zur Rhythmusanpassung. Dann Phase 4 betreten.
Phase 4 – Bildschirmaufnahme + Postproduktion
Details in references/RECORDING.md. Zwei Pfade:
| Szenario | Empfohlener Pfad |
|---|---|
| Phase 3 Audio synthetisiert | Auto-Modus in einem Take: Browser öffnet localhost:5173/?auto=1 → SPACE drücken → gesamtes Video läuft automatisch → Aufnahme stoppen → Anfang und Ende trimmen → fertig, keine nachträgliche Synchronisation von Tonspuren nötig |
| Phase 3 übersprungen | Standard Manual-Modus, manuell klicken, fortschreiten → Nachträglich beliebiger Schnitt zum Vertonen |
Agent informiert Benutzer aktiv nach Phase 3 / Checkpoint Audio über den geeigneten Aufnahmepfad.
Zehn Prinzipien (Ein-Satz-Liste)
Vollständige Ausführung siehe references/CHAPTER-CRAFT.md Teil 0 – Beim Schreiben von Kapiteln dort nachschlagen, hier nur Index.
| # | Prinzip | Ein Satz |
|---|---|---|
| 1 | 16:9 fester Bildschirm | Inhalt 1920×1080 + transform scale, kein responsives Design |
| 2 | Globaler Schritt-Zähler | Kapitel sind reine Funktionen der Schritte, kein Timer |
| 3 | Jeder Schritt belegt gesamten Bildschirm | if (step === N) return <FullScene /> |
| 4 | Voiceover-Takt = Schritt | Ein Takt = ein Schritt = ein fokussierter Gedanke |
| 5 | Versteckte Randelemente | Fortschrittsbalken / Blätterer standardmäßig opacity 0 |
| 6 | Bühne ohne Chrome | Kein header / footer / Seitenzahl / Branding-Balken |
| 7 | Inhaltsgetriebene Animation | Zuerst innere Aktion finden, nur wenn nichts gefunden wird Eintrittsanimation als Fallback; Dauermikrobewegung sparsam einsetzen |
| 8 | Mehrere Punkte einzeln enthüllen | 1 Eintrag = 1 Schritt, gleichzeitiges Zeigen mehrerer Einträge verboten |
| 9 | Gleiches Thema für gesamtes Video | Kapitel wechseln nicht die Oberflächenfarbe; Farben / Schriftarten via Token, andere Skalen frei im Kapitel |
| 10 | Zwei-Quellen-Prinzip | script bestimmt Takt, article bestimmt visuelle Dichte (im Informationspool umgesetzt) |
Häufiges Benutzerfeedback Nachschlagewerk
Vereinfachte Tabelle in references/CHAPTER-CRAFT.md Teil 8 "Häufiges Feedback". Wichtig: Zuerst identifizieren, auf welcher Ebene das Problem liegt (Rhythmus / Visuell / Inhalt / Code), dann die kleinste Änderung vornehmen, das ganze Kapitel nicht neu machen.
Verwandte Ressourcen
Markiert nach "Wann lesen" um zu vermeiden, dass alles auf einmal gelesen wird:
| Datei | Wann lesen | Inhalt |
|---|---|---|
references/SCRIPT-STYLE.md | Phase 1.2 Pflichtlektüre | Artikel → Voiceover-Regeln, plattformspezifische Varianten |
references/OUTLINE-FORMAT.md | Phase 1.2 Pflichtlektüre | Feld-Spezifikation für outline.md, Namenskonventionen, Kapitelaufteilung, Informationspool |
references/CHAPTER-CRAFT.md | Phase 2.4 Einziges Pflichtdokument pro Kapitel | Teil 0 Zehn Prinzipien / Teil 1 5 Fragen vor Start / Teil 2 Beziehung→Aktion Entscheidungsbaum / Teil 3 Visuelles Toolkit / Teil 4 Zeitabschätzung / Teil 5 Anti-AI Anti-Patterns / Teil 6 Harte Code-Regeln / Teil 7 Fertigstellungs-Selbstprüfung / Teil 8 Feedback-Nachschlagen |
references/EXAMPLES/ | Optional – Struktur ansehen | Kapitel-Strukturbeispiele (hook / list-reveal / case-tech-review); Nicht zum Kopieren als Template |
references/THEMES.md | Bei Thema wählen / erstellen / anpassen | Vollständiger Token-Vertrag + Liste integrierter Themen + Erstellungs-Workflow |
references/AUDIO.md | Erst in Phase 3 lesen | Provider-unabhängiger Audio-Synthese-Workflow, integrierte minimax Nutzung, Provider wechseln, Fehlerbehebung |
templates/scripts/tts-providers/README.md | Beim Wechseln / Hinzufügen eines TTS-Providers | Drei-Funktionen-Vertrag + 2 integrierte (minimax / openai) + 5 fertige Code-Snippets (ElevenLabs / edge-tts / macOS say / Azure / Google) |
references/RECORDING.md | Erst in Phase 4 lesen | Bildschirmaufnahme-Tools + Postproduktion |
themes/ | Bei Checkpoint Plan / Phase 1.2 durchblättern | Integrierte Themen (jedes mit theme.json + tokens.css) |
scripts/scaffold.sh | Phase 2.1 einmal ausführen | One-Click-Projekt-Scaffold |