Demovideo
Ein Demovideo zeigt den tatsächlichen Nutzungsprozess eines Dienstes aus Verbrauchersicht. Maximal 5 Minuten. Ein einziger Satz wie „Nimm diesen Prozess als Video auf und füge eine einfache Erklärung hinzu“ reicht aus, um mit den untenstehenden Standardwerten alles zu erstellen.
Standardwerte: Playwright-Aufnahme (1280×720) · Erzählung als Untertitel (SRT + eingebrannt), Sprachausgabe nur auf Anfrage · Ergebnis als MP4 + SRT.
Die Art, den Dienst zu starten, Testkonten und der Videostil richten sich nach der Projektdatei CLAUDE.md.
Ablauf
-
Szenen unterteilen — Die Anfrage in einen Benutzerablauf mit 3–6 Szenen aufschlüsseln. Pro Szene: „Was zu sehen ist“ und „Erklärung in ein bis zwei Sätzen“.
-
Tatsächlich durchspielen und aufnehmen — Den Dienst starten und mit Playwright
recordVideo(gleiche Größe wie Viewport) von Anfang bis Ende real bedienen. In menschlichem Tempo (slowMo um die 300 ms), nach jedem Klick warten, bis das Ergebnis auf dem Bildschirm sichtbar ist. Die Videodatei wird erst beim Schließen des Kontexts fertiggestellt. Nur fehlgeschlagene Szenen neu aufnehmen. Für jede Szene die Referenzzeit der Aufnahme (Start, Ergebnis sichtbar, Ende) notieren. -
Untertitel schreiben — Keine internen Fachbegriffe oder Codenamen verwenden. Stattdessen erklären, „was dadurch besser wird“. Ein bis zwei Sätze pro Szene, nachdem das Ergebnis sichtbar ist.
- Schlecht: „Erstelle einen PR, der die Hit-Policy der DMN-Regel 3 auf FIRST ändert.“
- Gut: „Die sich überschneidenden Regeln werden bereinigt, sodass bei derselben Bestellung kein Rabatt doppelt gewährt wird.“
-
Auf unter 5 Minuten kürzen — Lade- und Wartezeiten herausschneiden oder beschleunigen. Die 2–3 Sekunden für den Bedienmoment und das Lesen des Ergebnisses bleiben erhalten. Falls die Zeit trotzdem überschritten wird, Szenen zusammenlegen. Die in der Anfrage genannten Kernschritte dürfen nicht entfernt werden.
-
Synthese — Mit ffmpeg die Abschnitte aneinanderhängen und auf Basis der Zeitstempel des finalen Schnitts die SRT neu berechnen und einbrennen. Unter Windows ins Arbeitsverzeichnis wechseln und mit relativen Pfaden arbeiten (Problem des Escape von
:im Pfad). Schriftart: WindowsMalgun Gothic, Linux: installierte koreanische Schriftart (z. B.Noto Sans CJK KR).ffmpeg -i edited.mp4 -vf "subtitles=demo.srt:force_style='FontName=Malgun Gothic,FontSize=22'" -c:a copy demo.mp4 -
Prüfung — Mit
ffprobe -v error -show_entries format=duration -of csv=p=0 demo.mp4prüfen, ob das Video ≤300 Sekunden ist. Aus einigen Untertiteln Frames extrahieren (ffmpeg -ss <Sekunde> -i demo.mp4 -frames:v 1 f_<Sekunde>.png), die Bilder direkt öffnen und überprüfen, ob der Untertitel das auf dem Bildschirm Sichtbare beschreibt und koreanische Schriftzeichen nicht verzerrt sind.
Was zu beachten ist
- Keine simulierten Bildschirme, Mock-Antworten, DOM-Wert-Injektionen oder per Force-Klick erzeugte Szenen verwenden. Falls ein vollständiger Durchlauf nicht möglich ist, wird dies gemeldet.
- Schwierig rückgängig zu machende Aktionen (wie echte PR-Merges, Änderungen an Produktionsdaten, Versand oder Zahlungen) nur in der vom Projekt festgelegten Testumgebung durchführen. Falls eine solche Umgebung nicht existiert, den Benutzer unmittelbar vor dieser Szene fragen. Passwörter und Tokens dürfen weder auf dem Bildschirm noch in Untertiteln sichtbar sein.
- Meldung: Pfade zur MP4 und SRT, tatsächliche Länge, Beschreibung pro Szene, visuell geprüfte Frames, nicht geprüfte Aspekte. Veröffentlichung und Versand erfolgen nur auf gesonderte Anfrage.