Browser-Demo-Video
Du schreibst das Video als Code, daher sind Takes wiederholbar: Ein Stimmenwechsel oder ein korrigiertes Label führt zu einem automatischen Neudurchlauf, nicht zu einer manuellen Neuaufnahme. Die Pipeline:
script.cjs ──tts.cjs──▶ audio/*.wav + durations.json
│ │
└──────────record.cjs◀───────────┘ Chrome + Overlay, CDP Screencast → takes/<target>/frames + timeline.json
│
post.py ──▶ MP4 (Cuts entfernt, Narration + Klickgeräusche, −16 LUFS, Kapitel)
│
review.py ──▶ Kontaktbögen + Lautstärke-/Kapitelprüfung → du prüfst, dann ausliefern
Engine: scripts/ in diesem Skill. Pro-Video-Projekt: ~/Movies/Demos/<slug>/ (niemals /tmp, das geleert wird), enthält video.config.cjs, script.cjs, audio/ und takes/. Ausführbares Beispiel: examples/hello-orders/ (eine kleine Seite, eingebettet in eine Host-Shell; verwende es, um dein Setup zu prüfen). Lies references/lessons.md vor dem ersten Take.
Voraussetzungen: Chrome, Node mit Playwright (record.cjs findet es, oder setze playwright in der Konfiguration), ffmpeg/ffprobe, Python 3 und die AWS CLI für Polly.
1. Das Video abstimmen (vor jeglichem Code)
Bestätige und schlage eine Gliederung vor, auf die der Benutzer reagieren kann:
- Zielgruppe. Interne Videos behandeln Rollen, Berechtigungen, Steuerungen und bekannte Einschränkungen und enden mit einem Kapitel „Wissenswertes“. Führungs- und Kunden-Videos behandeln nur Ergebnisse und den Happy Path.
- Der Ablauf von Anfang bis Ende, als Kapitel, und die angestrebte Länge. Etwa 10–12 Minuten waren für einen tiefgehenden internen Einblick geeignet.
- Wo aufgenommen wird (Entscheidung). Der Walkthrough klickt echte Buttons und schreibt echten Zustand, daher läuft er niemals auf echten, gemeinsam genutzten Daten. Empfehle eine Kopie, einen Test-Workspace oder eine Entwicklungsumgebung mit realistischen Daten, plus eine Möglichkeit, sie zwischen Takes zurückzusetzen. Wenn das Erstellen dieser Kopie in die Produktion schreibt, benötigt es eine explizite Zustimmung.
- Identitäten (Entscheidung). Wenn der Ablauf zwei Personen benötigt (Ersteller und Prüfer), meldet sich entweder ein echtes Teammitglied in einem zweiten Fenster an, oder eine Person spielt beide Rollen und das Video sagt dies auf dem Bildschirm. Erstelle niemals Benutzer oder verwalte Passwörter; wenn ein Testkonto benötigt wird, erstellt der Benutzer es.
- Stimme (Entscheidung). Der Standard ist Polly generativ „Amy“ (en-GB), die bei echten Zuschauern gut ankam. Biete eine ~30 s Hörprobe jeder Kandidatenstimme an, bevor alles generiert wird:
aws polly synthesize-speech --profile <dev profile> --region eu-west-2 --engine generative --voice-id Amy --output-format mp3 --text "<Text mit dem Fachjargon des Produkts>" sample-Amy.mp3Verwende ein Nicht-Produktions-AWS-Konto. macOSsayfunktioniert offline, klingt aber synthetisch. Die eigene Stimme des Benutzers ist die natürlichste Option. - Bildausschnitt. Nur das Produkt ist im Bild: keine Host-Seitenleisten, Listen oder Banner. Richte dies im
setup-Hook der Konfiguration ein.
2. Projekt einrichten
P=~/Movies/Demos/<slug>; K=~/.claude/skills/browser-demo-video
mkdir -p "$P" && cp $K/templates/video.config.cjs $K/templates/script.cjs "$P"/
Fülle in video.config.cjs aus: die URL der Wegwerf-Umgebung, frame, falls das Produkt in einem Iframe läuft, ready, setup (Bildausschnitt), theme (Produkt-Akzentfarbe und Footer), voice und helpers.waitLoaded (das Ladesignal des Produkts).
Kartiere die UI, bevor du Schritte schreibst. Öffne sie, liste stabile Selektoren auf (IDs, Rollen, data-*, sichtbarer Text) und notiere langsame Ladevorgänge. Bevorzuge Selektoren, die auf angezeigtem Text basieren (tr:has-text("-1.250,00") [data-resolve]) gegenüber generierten Schlüsseln.
3. Das Szenenskript schreiben
Jeder Schritt hat { id, chapter?, pre?, say?, act?, gap? }. Die h-API wird oben in templates/script.cjs dokumentiert.
- Die Narration bestimmt das Timing.
actläuft während der Clip abgespielt wird, undh.at(0.6)bringt eine zweite Aktion mit den Worten in Einklang. Halte jedessayauf ein oder zwei gesprochene Sätze. - Schreibe Zahlen so, wie sie gesprochen werden („siebenundneunzig Prozent“, „der vierzehnte September“).
- Verwende echte Entscheidungen von echten Benutzern, wo sie existieren, damit die Zahlen auf dem Bildschirm dem entsprechen, was das Team kennt.
- Setze vor jedes Kapitel eine Kapitelkarte (
h.card) und füge Ringe mit 3–6-Wort-Labels hinzu. Verwendenote()nur dort, wo ein Punkt hervorgehoben werden muss, z. B. eine Sicherheitseigenschaft, ein Vorbehalt oder „in der echten Nutzung…“. - Verpacke jeden langsamen Ladevorgang in
h.cut(() => h.waitLoaded(), 'Lade …'). Dieser Abschnitt wird in der Nachbearbeitung entfernt. - Sage jede Vereinfachung auf dem Bildschirm und in der Narration. Zum Beispiel, eine Person spielt zwei Rollen: Zeige die Steuerung, die es blockiert, zeige die Einstellung, die „für diese Aufnahme nur“ geändert wird, und erkläre dann, was in der echten Nutzung passiert.
- Zeige auf Downloads; klicke sie nicht an (siehe Lektionen).
4. Die Sprachausgabe generieren
node $K/scripts/tts.cjs "$P". Nur geänderte Zeilen werden neu generiert. Claude kann das Ergebnis nicht anhören, daher benenne die riskanten Wörter (Akronyme, Namen) und bitte den Benutzer, sie zu überprüfen. Bei macOS say buchstabiere Akronyme als Buchstaben („S A P“).
5. Probelauf, dann anmelden, dann aufnehmen
- Probelauf. Setze
TARGET=previewmitpreviewUrlauf einen lokalen Build, falls vorhanden. Andernfalls führe kurze Segmente auf der Wegwerf-Umgebung aus:ONLY='^(c1|load0|where1)$' node $K/scripts/record.cjs "$P" record. Überprüfe einige Einzelbilder mit dem Read-Tool (takes/prod/frames/*.jpg,failure.pngbei Fehlern) und überprüfe mit ffprobe, dass die Bilder 1920×1080 sind. Setze die Umgebung danach zurück. - Anmelden. Führe
node $K/scripts/record.cjs "$P" loginmitrun_in_backgroundaus. Der Benutzer meldet sich im sich öffnenden Fenster an und schließt es dann. Wenn er sagt, er sei fertig, das Fenster aber noch offen ist,pkill -INT -f "record.cjs.* login". - Vollständiger Take. Setze die Umgebung zurück und führe dann
node $K/scripts/record.cjs "$P" recordmitrun_in_backgroundaus. Sage dem Benutzer vor dem Start, dass es etwa die Länge der Narration plus ein Drittel dauert, in einem sichtbaren Chrome-Fenster, das er nicht anklicken darf. Warte auf die Fertigstellungsbenachrichtigung; frage nicht mitsleepab. Überprüfe das Log auf jedenok-Schritt und keineFAILED- oderCRASHED-Zeile.
6. Zusammenbauen und überprüfen
python3 $K/scripts/post.py "$P/takes/prod" "$P/takes/prod/walkthrough.mp4" # run_in_background; ~10 min für ein 10-min-Video
python3 $K/scripts/review.py "$P/takes/prod" "$P/takes/prod/walkthrough.mp4" "$P/review" # optional: step_id:0.8 picks
Lies jedes review/s*.jpg-Blatt. Achte auf abgeschnittene oder überlappende Labels, Ringe auf dem falschen Element, Ladezustände, die nicht herausgeschnitten wurden, und übrig gebliebene Overlays. Die Lautstärke sollte etwa −16 LUFS betragen, und die Anzahl der Kapitel sollte mit dem Skript übereinstimmen. Korrigiere Probleme im Skript, setze die Umgebung zurück und nimm einen neuen Take auf. Neue Takes sind günstig.
7. Ausliefern und aufräumen
- Ausliefern. Kopiere das Video nach
$P/<slug>.mp4undopenes. Wenn eine frühere Version existiert, behalte sie umbenannt (z. B.old-<voice>-<slug>.mp4), nicht überschrieben. - Berichten. Gib die Länge, Auflösung, Kapitel, die Stimme, den Aufnahmeort, jede gezeigte Vereinfachung, was du nicht überprüfen konntest (das Audio) und verbleibende visuelle Mängel an.
- Vor dem Aufräumen fragen. Hole die Zustimmung des Benutzers ein, bevor du die Wegwerf-Kopie oder -Umgebung entfernst, und bevor du
takes/löschst (Einzelbilder belegen GBs). Behaltescript.cjs, die Konfiguration undaudio/, damit das Video später neu aufgenommen werden kann. - Dokumentieren. Wenn die Arbeit zu einem Ticket oder einer Notizdatei gehört, notiere dort den Speicherort des Videos und dass das Löschen der Kopie aussteht. Committe nur diese Datei.