Ein Video erstellen – Die Anfänger-zu-Fertigem-MP4-Fähigkeit
Zwei Phasen, acht aufeinanderfolgende Gates. Jedes Gate erzeugt ein konkretes Artefakt, das das nächste Gate verbraucht. Überspringe keine Gates.
Wann diese Fähigkeit verwendet werden sollte – und wann sie abgegeben werden sollte
Diese Fähigkeit verwenden, wenn:
- Der Nutzer neu bei HyperFrames ist und mit einem Konzept, Skript oder einer Gliederung beginnt
- Sie einen vollständigen Arbeitsablauf wünschen, kein Referenzmaterial zum Framework
- Sie sich noch nicht für ein Format entschieden haben
Abgeben, wenn:
- Der Nutzer eine URL einfügt und ein Video von dieser Website möchte →
/website-to-hyperframesaufrufen - Der Nutzer explizit einen vertikalen 9:16 Talking-Head mit Face-Cam und Szenenüberlagerungen möchte → Gates 1–4 hier ausführen, dann ab Gate 5
/short-form-videoaufrufen - Der Nutzer nach Framework-Regeln fragt, nicht nach einem Video →
/hyperframesaufrufen
Routing-Hinweis (AI Edit Video-Pipeline): Wenn diese Fähigkeit aus einer Projektkurzbeschreibung ausgeführt wird, überschreiben die Abschnitte STYLE DESIGN und PHONG CÁCH DỰNG (Videostil) des Bearbeitungsprompts die unten stehenden Vorgaben aus dem Interview – stelle keine Stilfragen, die die Kurzbeschreibung bereits beantwortet.
Die zwei Phasen
- Phase 1 – INTERVIEW (Gates 1–4): Ein einziger Gesprächsdurchlauf, um alles zu sammeln, bevor Code angefasst wird. Absicht, Format, Drehbuch, Stimme, Stil, Assets, Tempo. Synthetisiert zu einer
BRIEF.mdund warte auf explizite Zustimmung. - Phase 2 – BAU (Gates 5–8): Gerüst → Storyboard → Kompositionen → Lint → Studio-Vorschau → Entwurfs-Render → visuelle Prüfung → MP4-Vorschau → finaler Render.
Gate 1 · Absicht & Format
Stelle jeweils eine Frage über AskUserQuestion, wo möglich als Multiple-Choice.
- Wofür ist dieses Video? (Werbung · Social-Ad · Launch-Teaser · Produktdemo · Tutorial · Erklärvideo · Intro/Outro-Karte · Sonstiges)
- Wer ist die Zielgruppe? (offene Frage)
- Gewünschte Dauer? (10–20s kurz · 20–45s Werbung · 45–90s Erklärvideo · 1,5–3 Min. Lektion · benutzerdefiniert)
- Seitenverhältnis? (16:9 1920×1080 · 9:16 1080×1920 · 1:1 1080×1080)
- Bildrate? (30 Standard · 60 für scharfe UI · 24 filmisch)
- Plattform-/Auslieferungsbeschränkungen? (Dateigröße · Frist · Wo es abgespielt wird)
Gate: Alle sechs erfasst. Wenn die Antwort 9:16 + Face-Cam ist, plane die Abgabe an /short-form-video bei Gate 5.
Vollständiger Fragenkatalog: Read: references/interview-questions.md
Gate 2 · Drehbuch & Stimme
- Drehbuchquelle? (einfügen · Gliederung → ich erstelle Entwurf · ich nehme auf · TTS aus Text · keine Erzählung)
- Falls TTS: Stimme-Präferenz. biete Optionen aus
npx hyperframes tts --helpan. Erfasse auch das Tempo.hyperframes tts(Kokoro) ist nur auf Englisch – Vietnamesische Erzählung erfolgt über das systemweite/api/ttsstattdessen (Gemini TTS oder VieNeu). - Falls Face-Cam: Aufnahmepfad · Vollbild oder Eckplatzierung · Transkription nötig? (
npx hyperframes transcribe <file> --model small.en --json– nur Englisch; für Vietnamesisch verwende faster-whisper gemäß dem noti-tiktok-vn-Skill) - Untertitel? (aus · Hype · Corporate · Karaoke-Wort-für-Wort · minimal)
Gate: Drehbuch erfasst (oder entworfen), Audio-Plan erfasst, Untertitel-Plan erfasst.
Gate 3 · Stil-Erfassung
Bevor du den Nutzer etwas fragst, inventarisiere vorhandene Assets. Überprüfe <workspace-root>/assets/ und alle Projekt-assets/-Ordner. Frage nicht nach dem, was bereits da ist.
Dann frage fortschreitend – sie müssen nicht alle beantworten:
- Styleguide oder Markendokument? (einfügen/Pfad · nein)
- Farbpalette? (Hex-Codes · keine – MOTION_PHILOSOPHY-Standardwerte verwenden)
- Schriftarten? (Google Fonts-Name(n) · Dateipfade · keine – Inter + JetBrains Mono-Standardwerte verwenden)
- Logo-Datei? (Pfad · keine). Wenn eine Marke genannt wird, aber keine Datei angegeben ist: in
assets/brand-logos/suchen oder mitPOST /api/brand-logos {"name":"..."}abrufen – ein Text-Wordmark ist NUR nach einem404 BRAND_LOGO_NOT_FOUNDerlaubt. Zeichne oder generiere niemals ein Logo. - Referenzvideos für den Vibe? (URLs/Pfade · keine)
- Andere Assets? (Screenshots · Produktfotos · B-Roll · Musik – Pfade auflisten)
- MOTION_PHILOSOPHY-Ästhetik (schwarze Leinwand · Chrom-Schrift · perspektivisches Raster · Peitschen-Übergänge) oder ein anderes Gefühl?
- Tempo? (kinetisch 1–2s · ausgewogen 2–3s · entspannt 3–5s)
- Musik? (keine · Ambient-Pad 0,15 · Musikbett 0,4 · voll 0,8 – Dateipfad, falls vorhanden)
- Outro / Call-to-Action-Text?
Dränge dem Nutzer niemals eine Marke auf. Fallback auf MOTION_PHILOSOPHY-Standardwerte NUR, wenn sie explizit die Angabe eines Stils ablehnen.
Vollständiger Stil-Ablauf + MOTION_PHILOSOPHY-Standardwerte: Read: references/style-intake.md
Gate 4 · Kurzbeschreibungssynthese (HARTES GATE vor dem Bau)
- Lies
MOTION_PHILOSOPHY.md, falls es im Arbeitsbereichsstamm existiert – zwingend, falls vorhanden. Falls fehlend, fahre mit den Standardwerten inreferences/style-intake.mdfort und vermerke das Fehlen in der Kurzbeschreibung. - Frage, wo Projekte leben, falls es nicht offensichtlich ist:
- Wenn
video-projects/existiert → verwendevideo-projects/<slug>/ - Andernfalls → frage den Nutzer
- Wenn
- Schreibe
<project-folder>/BRIEF.md:- slug · Absicht · Zielgruppe · Abmessungen · fps · Dauer
- Drehbuch (vollständig oder Gliederung)
- Stimmenauswahl · Untertitel-Plan · Face-Cam-Plan
- Stilprofil: Palette (Hex), Schriftarten, Logo-Pfad, Referenzvideos
- Tempo
- Asset-Inventar mit Pfaden
- Outro / CTA-Text
- Zeige die Kurzbeschreibung. WARTE auf explizite Zustimmung. Fahre nicht zu Gate 5 ohne ein klares „Ja, bau es.“
Gate 5 · Gerüst & Storyboard
Zuerst Übergabe-Check
Wenn die Kurzbeschreibung einen vertikalen 9:16 Talking-Head mit Face-Cam + Szenenüberlagerungen beschreibt, rufe /short-form-video JETZT auf und übergebe die Kurzbeschreibung. Sein 4-schichtiges Gerüst ist für dieses Format optimiert.
Ansonsten fortfahren:
Gerüst
mkdir <project-folder>- Wenn ein Schwesterprojekt mit ähnlichem Format existiert, biete an, dessen
hyperframes.json+meta.jsonals Vorlage zu kopieren. Andernfalls von innerhalb des Ordners:npx hyperframes init - Bearbeite
meta.jsonmit dem slug, den Abmessungen und der fps des Nutzers. - Kopiere bereitgestellte Assets in
<project-folder>/assets/. - Erstelle
<project-folder>/assets/style-profile.mdaus Gate 3 – einzige Quelle der Wahrheit für Palette/Schriftarten/Logo.
Storyboard
Generiere <project-folder>/STORYBOARD.md mit der Vorlage in references/storyboard-template.md. Jeder Beat erhält:
Beat N – TITEL (Start–Ende, Dauer) – Konzept in einem Satz
Visuelle Elemente: [jedes Element, Größe, Animation, Timing]
Bewegungssprache: [Art der Bewegung]
Verwendete Eases: [3–4 verschiedene GSAP-Eases]
Ausgang: [Übergang zum nächsten Beat]
Audio: [VO-Zeile / SFX / Musik-Ebene]
Oben in der Datei: eine Zeittabelle mit Szene · Start · Dauer · Kompositionsdatei.
Schlage eine Dreierstruktur vor:
- Akt 1 (Aufhänger) ≈ 20 % der Dauer
- Akt 2 (Hauptteil) ≈ 55 %
- Akt 3 (Auflösung + Outro mit 4–6 Sekunden Halten) ≈ 25 %
(MOTION_PHILOSOPHY §0 Gesetz 9, §1.)
Ordne Nutzerabsichten Katalogblöcken zu: Read: references/catalog-intent-map.md
Gate: Zeige Storyboard + Zeittabelle. Wiederhole, bis der Nutzer zustimmt.
Gate 6 · Kompositionen bauen
Rufe /hyperframes für Framework-Regeln auf. Diese Fähigkeit besitzt das Gerüst und die Disziplin; /hyperframes setzt die Regeln durch.
Jede Unterkomposition grundieren
<div data-composition-id="szenen-name" data-start="..." data-duration="...">
<style>[data-composition-id="szenen-name"] { /* begrenzt */ }</style>
<!-- DOM -->
<script>
(function(){
const SLOT_DURATION = ...;
const tl = gsap.timeline({ paused: true });
// ... Tweens ...
tl.to({}, { duration: SLOT_DURATION }, 0); // Anker – MOTION_PHILOSOPHY Gesetz 11
window.__timelines["szenen-name"] = tl;
})();
</script>
</div>
Vollständiger Boilerplate + Untertitel-Muster + Ambient-BG-Muster: Read: references/composition-scaffold.md
Bauregeln
- Ambient-Hintergrund auf
data-track-index="0"für die gesamte Kompositionsdauer. - Kinetische Schrift-Öffner: Pro-Wort-Staffelung 0,06–0,10 s.
- Untertitel als Geschwisterelemente der Stammkomposition auf Körperebene in
index.html, jedes mitdata-track-index ≥ 20. Niemals innerhalb von Szenen-Zeitachsen (MOTION_PHILOSOPHY §3.13). - Katalogblöcke installiert über
npx hyperframes add <name>. Begrenze sofort das CSS des Blocks auf[data-composition-id="..."]– Katalogblöcke werden mithtml, body { ... }-Regeln ausgeliefert, die in das übergeordnete Dokument bluten, wenn sie als Unterkompositionen geladen werden. - Vertikal + Face-Cam: Umhülle natives 1920×1080 Face in eine Transformation (
translate+scale) für den unteren Bildschirmhälften- oder Vollbildmodus. (Wenn du hier statt bei/short-form-videolandest, erwäge dringend die Übergabe.) - Wende NUR an, was der Nutzer bereitgestellt hat. Seine Palette, seine Schriftarten, sein Logo. Füge nichts anderes hinzu. Wenn sie sich für MOTION_PHILOSOPHY-Standardwerte entschieden haben, ziehe die Palette + Schriftarten-Kombination aus
references/style-intake.md.
Determinismus
Kein Math.random(), kein Date.now(), kein Render-Zeit-fetch(). Verwende gesäte PRNGs oder harmonische-Sinus-Hashes (MOTION_PHILOSOPHY §3.10).
Gate 7 · Lint → Studio-Vorschau (VORSCHAU-GATE 1 – ZWINGEND)
npx hyperframes lint– behebe alle Fehler, priorisiere Warnungen.npx hyperframes previewim Hintergrund.- Warte auf „Studio läuft“ unter
http://localhost:3002. - Gib dem Nutzer die URL plus einzelne Kompositions-URLs (
http://localhost:3002/?comp=<id>). Wenn das Projekt WebGL-Shader-Blöcke hat, führe mit den einzelnen URLs – der Software-WebGL-Fallback kann die Hauptkomposition aufhängen. - WARTE auf explizites „sieht gut aus, rendere einen Entwurf“, bevor du fortfährst. Schweigen ist keine Zustimmung.
Hot-Reload ist aktiv – Bearbeitungen werden live angezeigt.
Gate 8 · Entwurfs-Render → visuelle Prüfung → MP4-Vorschau → Finale
Entwurfs-Render
npx hyperframes render --quality draft --output renders/<slug>-draft.mp4
Visuelle Prüfung (ZWINGEND vor Auslieferung)
Lint bestanden ≠ Design funktioniert. Extrahiere Frames und betrachte sie.
mkdir -p renders/frames- Für jeden Beat-Höhepunkt UND jeden Übergang:
ffmpeg -y -ss <t> -i renders/<slug>-draft.mp4 -frames:v 1 -q:v 2 renders/frames/t<t>.png - Rufe das
Read-Tool für jedes PNG auf. Das Read-Tool lädt das Bild in den Kontext – liste nicht nur Dateinamen auf. - Bestätige pro Frame: keine abgeschnittenen Gesichter, korrekter Face-Modus pro Szene, Text lesbar und auf Palette, kein Überlauf, Übergänge landen auf den gewünschten Wörtern, keine leeren Frames.
- Wenn etwas falsch ist: korrigieren → erneut rendern → erneut prüfen. Versende niemals einen fehlerhaften Entwurf.
MP4-Vorschau (VORSCHAU-GATE 2 – ZWINGEND)
npx serve renders -p 8080 -n
Verwende NICHT Pythons http.server – es unterstützt keine HTTP-Range-Anfragen, daher bricht das Vor-/Zurückspulen.
Übergebe dem Nutzer http://localhost:8080/<slug>-draft.mp4. WARTE auf explizite Freigabe für Wiedergabe und Audio-Synchronisation.
Finaler Render
npx hyperframes render --quality standard --output renders/<slug>-final.mp4
In der AI Edit Video-Pipeline ist dies NICHT das Ende: Fahre mit der video-pipeline-Fähigkeit fort (QC → Finale über die Render-Warteschlange zusammenstellen → outputs/<id>-v<N>.mp4 → meta.json aktualisieren → Thumbnail/veröffentlichen). Eigenständige Nutzung außerhalb der Pipeline: Melde den Ausgabepfad. Fertig.
Vollständige Preflight- + Vorauslieferungs-Checkliste: Read: references/build-checklist.md
Unverhandelbar (tragend – nicht abschwächen)
- ÜBERSPRINGE NICHT VORSCHAU-GATE 1 (Studio) oder VORSCHAU-GATE 2 (gerendertes MP4). Zwei Gates pro Bau, immer.
- BEHAUPTE NICHT, ein Render sei fertig, bis Frames extrahiert UND über das Read-Tool gelesen wurden.
- BAUE NIEMALS außerhalb eines dedizierten Projektordners. Lege
index.htmlniemals im Arbeitsbereichsstamm ab. - FRAGE DEN NUTZER NICHT NACH ASSETS, bevor du seinen Arbeitsbereich inventarisiert hast.
- ÜBERSPRINGE NICHT den
tl.to({}, { duration: SLOT_DURATION }, 0)-Anker-Tween am Ende jeder Unterkompositions-Zeitachse. MOTION_PHILOSOPHY Gesetz 11. - VERWENDE NICHT
Math.random()/Date.now()innerhalb der Render-Logik. Nur gesäte Hashes. - FÜGE KEIN
class="clip"zu<video>-Tags hinzu. Es zerstört sie. - DRÄNGE DEM NUTZER KEINE MARKE AUF. Frage zuerst; falle auf MOTION_PHILOSOPHY-Standardwerte zurück, NUR wenn sie explizit ablehnen.
Referenzen
references/interview-questions.md– vollständiger Fragenkatalog nach Gatereferences/style-intake.md– Stil-Interview + MOTION_PHILOSOPHY-Standardwertereferences/catalog-intent-map.md– „Nutzer sagt X → installiere Y“references/storyboard-template.md– Beat-für-Beat-Vorlage + ausgearbeitetes Beispielreferences/composition-scaffold.md– bereichsbezogene Styles + IIFE GSAP-Boilerplatereferences/build-checklist.md– Preflight- + Vorauslieferungs-Gates
Extern (Arbeitsbereichsebene):
MOTION_PHILOSOPHY.md– die eine externe Referenz, von der diese Fähigkeit ausgeht, dass sie existiert. Ästhetische Basis. Fallback befindet sich inreferences/style-intake.md, wenn die Datei fehlt.
Verwandte Fähigkeiten
/hyperframes– Framework-Regeln, rufe bei Gate 6 auf/hyperframes-cli– init · lint · preview · render · transcribe · tts/hyperframes-registry– Installieren von Katalogblöcken/gsap– GSAP-Animationsreferenz/short-form-video– Gib bei Gate 5 für 9:16-Talking-Head-Format ab/website-to-hyperframes– Gib bei Gate 1 ab, wenn die Eingabe eine URL ist