HyperFrames — Changelog-Video
Eingabe: ein Changelog .md (Themen + Elemente). Ausgabe: ein lint-sauberes, seam-gate-grünes HyperFrames-Projekt. Rendern nur auf Anfrage.
Übersicht
Diese Fähigkeit verwandelt ein Release-Changelog in eine polierte Videokomposition mit HyperFrames HTML-basiertem Rendering. Verwende sie, wenn ein Produkt-Update eine visuelle Ankündigung verdient – Hero-Frames, wichtige Punkt-Hervorhebungen und ein Hintergrundmuster. Das Ergebnis ist ein MP4, das aus den eingegebenen Changelog-Einträgen gerendert wird.
Wann verwenden
- Benutzer stellt ein Changelog/Digest-Markdown bereit und wünscht das wöchentliche Video
- Benutzer sagt „Changelog-Video“ oder „wöchentliches Digest-Video“
- Benutzer wünscht ein gebraudetes Video mit animierten Mock-UIs und Sprachausgabe
Wann NICHT verwenden
- Benutzer wünscht einen Produkt-Launch (verwende
hyperframes-product-launch-video) - Benutzer wünscht eine Bewegungsgrafik (verwende
hyperframes-motion-graphics) - Benutzer wünscht ein Talking-Head-Video (verwende
hyperframes-embedded-captions)
Der Grundbefehl: Visualisieren, nicht auflisten
Jedes Thema wird durch einen animierten Mock der tatsächlichen UI oder eines getreuen Analogons dargestellt, das die Änderung in der Erfahrung nachspielt – niemals Text-Aufzählungspunkte. Leite jedes Thema/Element durch das Visualisierungs-Register, BEVOR du das Skript schreibst.
Workflow
0 · Bootstrap aus Skill-Assets (nicht verhandelbar)
mkdir -p project/assets/fonts
cp <SKILL_DIR>/assets/fonts/*.woff2 project/assets/fonts/
cp <SKILL_DIR>/assets/bgm.mp3 project/bgm.mp3
ffmpeg -y -stream_loop 15 -i <SKILL_DIR>/assets/bg-pattern.mp4 -t <TOTAL> \
-vf "scale=1080:1080,fps=30,eq=saturation=0.72,[email protected]:t=fill" \
-an -c:v libx264 -crf 20 -pix_fmt yuv420p project/assets/bg-pattern-<TOTAL>s.mp4
cp <SKILL_DIR>/examples/master-skeleton.html project/index.html
Lies dann references/build-spec.md vollständig durch – es definiert die Marken-Tokens.
1 · Parsen + editoriale Kürzung
- Extrahiere: Wochenbereich, Headline-Statistiken, Themen, Elemente
- Budget: 45-60s gesamt. Titel ≤2s, Outro ≤3,5s, 4 Themen ≈ 9-12s pro Thema
- Pro Thema behalte EINE Hero-Visualisierung + maximal 3 gesprochene Elemente
- Ordne Themen nach Geschichte: Hauptfeature → Produktoberfläche → Performance → Zuverlässigkeit
2 · Visualisierungs-Routing
Wähle für jedes Thema die Oberfläche aus dem Visualisierungs-Register und schreibe eine Zeile: Thema → Oberfläche → die 2-4 sequenziellen Aktionen, die der Mock ausführt, jede mit einem Skript-Ausdruck verknüpft.
3 · Zweischichtiges Skript (gesprochen vs. angezeigt)
Schreibe das Skript als Token-Zeilen: gesprächiger Register, jeder technische Begriff trägt eine spoken-phonetische Form, während display die Standardschreibweise behält. Untertitel zeigen display; die Sprachausgabe liest spoken.
4 · Sprachausgabe + Wort-Zeitstempel
node scripts/heygen-tts.mjs ./vo-spoken.txt -o voiceover.mp3 --words vo-words.json --voice <voice_id>
node scripts/align-captions.mjs --tokens script-tokens.json --words vo-words.json --out captions.json
Wort-Zeitstempel sind eine harte Barriere. Bevor Du weitermachst, überprüfe, ob vo-words.json nicht leer ist und ein words: [...]-Array mit start/end pro Wort enthält.
5 · Build
Folge genau references/build-spec.md: Marken-Tokens + Schriftarten + die animierte Hintergrundkodierung + Szenen-Gerüst + Chrome + Untertitel-Schiene + Doktrin-Reihenfolge: Vektor-Ledger → Naht-Stempel → interne Takte auf VO-Wörtern → Naht-Gate-Prüfung.
Untertitel sind nicht optional. Befülle das LINES-Array aus captions.json, bevor Du fortfährst.
6 · Gates (alle grün vor der Präsentation)
hyperframes check— 0 Fehlerseam-gate.mjs verify— 0 Fehlschläge- Starte den Vorschau-Server neu, überprüfe 3-4 Takte stichprobenartig
- Rendere NICHT, es sei denn, der Benutzer fragt danach
- Untertitel-Präsenz-Gate — prüfe 3-4 Frames stichprobenartig, bestätige, dass die Untertitel-Schiene sichtbar ist
Anti-Rationalisierungs-Tabelle
| Rationalisierung | Realität |
|---|---|
| „Aufzählungspunkte-Folien für UI-Änderungen“ | Mock die Oberfläche, die die Änderung nachspielt |
| „Fake-UI für nicht darstellbare Elemente“ | Ehrliche Checkliste-Szene |
| „Einfaches 'JSON' im TTS-Text“ | Lexikon gesprochene Formen; Anzeige bleibt Standard |
| „Aussprache raten“ | Frage, dann erweitere das Lexikon |
| „Jedes Changelog-Element sprechen“ | ≤3 pro Thema; Digest-Link trägt den Rest |
| „Überall grüne Akzente“ | Ein grüner Moment pro Szene |
| „Von einem vorherigen Video index.html ausgehen“ | Kopiere master-skeleton.html, immer |
| „Leeres LINES-Array ist in Ordnung“ | Leeres LINES = Video ohne Untertitel = Wiederholung des Durchlaufs |
Überprüfung
-
hyperframes checkbesteht mit 0 Fehlern -
seam-gate.mjs verifybesteht mit 0 Fehlschlägen - Untertitel-Schiene auf 3+ stichprobenartig überprüften Frames sichtbar
- Wort-Zeitstempel stimmen mit Audio überein
- Marken-Tokens entsprechen build-spec.md
- Nur gerendert, wenn der Benutzer explizit danach fragt