product-launch-video - Dispatch-Eintrag
Bestätigen Sie die Route vor Schritt 0. Diese Fähigkeit erstellt ein Video für ein Produkt, das vermarktet / eingeführt / beworben wird. Handelt es sich um eine allgemeine (Nicht-Einführungs-)Website → Video (Site-Tour / Vorstellung, kein Produktverkauf) →
/website-to-video; ein Thema / Konzept ohne Produkt →/faceless-explainer; einen GitHub-PR →/pr-to-video; ein vorhandenes Video zum Untertiteln / Verpacken →/embedded-captions·/graphic-overlays. Nicht im Rahmen (ablehnen, nicht vortäuschen): Live-Daten zum Renderzeitpunkt (alle Werte werden zur Autorenzeit festgelegt) oder Filmmaterial / Screenshots / ein Avatar, der noch nicht existiert (HyperFrames kann nicht aufnehmen oder erfassen). Bei einer vagen „Video erstellen“-Anfrage oder Unsicherheit Produkt-vs.-Thema / Einführungs-vs.-allgemeine-Website? Lesen Sie zuerst/hyperframes.
Alle Artefakte werden in PROJECT_DIR = videos/<projektname>/ geschrieben (in Schritt 0 erstellt). Pfade unten sind relativ zu PROJECT_DIR. Sie (der Orchestrator) führen die Bash-Schritte aus und dispatchen die Unteragenten; phasenspezifische Details befinden sich in den verlinkten Anleitungen/Agenten/Skripten – erweitern Sie diese nicht hier. Dispatch ist Harness-portabel: Lesen Sie vor dem ersten Subagenten-Dispatch einmal <SKILL_DIR>/../hyperframes-core/references/subagent-dispatch.md – es bildet die Dispatch-Verben (paralleles Fan-out / Hintergrund / Warten) auf die Primitive Ihres Harness ab; ein Parallelitätslimit unter N bedeutet Wellen der Größe des Limits, niemals weniger Szenen. Diese Datei ist ein verbindliches Runbook, keine Hintergrundlektüre: Führen Sie die Schritte der Reihe nach aus und erstellen Sie jedes Phasenartefakt mit dem dafür vorgesehenen Skript oder der Agentenrolle – ersetzen Sie keine Freestyle-Pipeline (handgeschriebene Erzählung, Ad-hoc-TTS-Aufrufe, eine handverfasste Komposition) und überspringen Sie keinen Pausenschritt, weil die Anfrage klar erscheint. Ein Schritt, den Sie nicht ausführen können → anhalten und melden; improvisieren darüber hinaus bricht jeden nachgelagerten Vertrag.
| Phase | Ausführung | Primäres Artefakt | Detaillierter Ablauf |
|---|---|---|---|
| init | Bash direkt | hyperframes.json | Schritt 0 (diese Datei) |
| capture | Bash direkt (hyperframes capture) | capture/extracted/tokens.json | phases/capture/guide.md |
| design-system | Subagent | design-system/design.html + chunks/ | agents/design-system.md |
| story-design | Subagent | narrator_scripts.json | agents/story-design.md |
| audio | Bash direkt (audio.mjs) | audio_meta.json | phases/audio/guide.md |
| visual-design | Subagent | section_plan.md | agents/visual-design.md |
| prep | Bash direkt (prep.mjs) | group_spec.json | scripts/prep.mjs Kopf |
| captions | Bash direkt (captions.mjs group -> html) | caption_groups.json + compositions/captions.html | scripts/captions.mjs Kopf |
| scenes | N x Subagent (parallel, eine Szene pro Subagent) | compositions/scene_*.html | agents/hyperframes-scene.md |
| finalize | Bash-Prelude (wait-bgm + assemble + transitions + hoist + sfx-verify) -> finalize Subagent | renders/video.mp4 | Schritt 7 / agents/hyperframes-finalize.md |
Voraussetzungen (vor dem ersten Lauf installieren)
macOS Apple Silicon oder Linux x64:
brew install [email protected] node ffmpeg # Unter Linux das apt/dnf-Äquivalent verwenden
npx hyperframes doctor # Einmaliger Check, ob Chrome / Abhängigkeiten bereit sind
[email protected]— Homebrew Python, nicht systemweit/usr/bin/python3(PEP 668 blockiert sonstpip install); wird vom MusicGen-Fallback verwendetnode >= 18+ffmpeg(audio.mjsverwendetffprobe)- Chrome wird beim ersten
npx hyperframes captureautomatisch heruntergeladen.hoist-videos.mjs(Schritt 7, läuft nur, wenn eine Szene Filmmaterial deklariert) verwendet dieses zwischengespeicherte Chrome erneut; wenn fehlende Abhängigkeiten gemeldet werden, führen Sienode <SKILL_DIR>/scripts/hoist-videos.mjs --ensure-depseinmal aus (~5s)
Optionale API-Schlüssel (nicht gesetzt → lokale Fallbacks; Injektion in Schritt 0.5; GEMINI_API_KEY ≡ GOOGLE_API_KEY):
| Schlüssel | Verwendung | Standardstimme / Fallback |
|---|---|---|
HEYGEN_API_KEY (oder hyperframes auth login) | TTS (Cloud, mit Wort-Zeitstempeln) | Stimme: auto (erste englische Seestern-Stimme; Überschreiben mit --voice) |
ELEVENLABS_API_KEY | TTS (Cloud; erfordert pip install elevenlabs) | Stimme 21m00Tcm4TlvDq8ikWAM (Rachel) |
| Weder noch, und nicht eingeloggt | TTS | Lokal Kokoro, Stimme am_michael (für Nicht-Englisch, --voice übergeben) |
GEMINI_API_KEY (ein Schlüssel für beide Zwecke) | Capture-Vision-Beschriftung + Lyria BGM | nicht gesetzt → Beschriftungen verwenden nur DOM-Kontext; BGM verwendet lokales MusicGen (erster Lauf lädt ~300 MB herunter) |
Ablauf
Schritt 0.0 – Das Briefing bestätigen (eine Runde, dann bauen)
Bestätigen Sie vor Schritt 0 in einer Nachricht nur das, was das Launch-Video maßgeblich formt und was Sie nicht ableiten können – führen Sie mit einer empfohlenen Voreinstellung, überspringen Sie alles, was der Benutzer bereits angegeben hat: den Winkel / Fokus (das Produkt insgesamt, eine Hauptfunktion, ein Angebot / CTA), die Länge (Standard ~30-90s; bis zu ~3 min) und – falls /hyperframes sie nicht bereits gesetzt hat – das Seitenverhältnis (Standard 16:9; 9:16 für vertikal / sozial) und die Sprache. Die Voreinstellung wird aus dem Brand-Capture abgeleitet, nicht abgefragt. Bei einer vollständig spezifizierten Anfrage überspringen Sie dies und bauen.
Schritt 0 – Das Videoprojekt initialisieren
Das aktuelle Arbeitsverzeichnis ist das Agent-Workspace-Root; alle Video-Artefakte gehen in PROJECT_DIR = videos/<projektname>/.
Benennung <projektname>: Ein expliziter, vom Benutzer angegebener Verzeichnisname gewinnt; andernfalls wählen Sie einen kurzen Kebab-Case-Namen wie <marke>-promo (niemals den Workspace-Basisnamen oder einen Zeitstempel). Bei einer URL leiten Sie ihn aus der Domain / dem Seitentitel ab; der Name ist festgelegt, sobald capture/ geschrieben ist.
Initialisierung (nur wenn $PROJECT_DIR/hyperframes.json nicht existiert):
PROJECT_DIR="${LAUNCH_VIDEO_DIR:-videos/<projektname>}"
mkdir -p "$(dirname "$PROJECT_DIR")"
npx hyperframes init "$PROJECT_DIR" --non-interactive --skip-skills --example=blank
hyperframes initlegt eine generischeAGENTS.md/CLAUDE.mdin$PROJECT_DIRab; lassen Sie sie an Ort und Stelle, behandeln Sie ihre generischen Anweisungen jedoch nicht als Laufzeitbeschränkungen – diese Fähigkeit ist die Quelle der Wahrheit.
Einschränkungen (jede Verletzung bricht spätere Phasen):
- Führen Sie
hyperframes init(oder generieren SieAGENTS.md/CLAUDE.md) nicht im Workspace-Root aus; erstellen Sie keinhyperframes/-Unterprojekt innerhalb vonPROJECT_DIR. - Jeder Subagenten-Dispatch-Kontext enthält eine Zeile
PROJECT_DIR: <pfad>; der Subagent behandelt sie als Projekt-Root. - cwd-Disziplin (auch Master): Jeder Bash-Befehl wird als
(cd "$PROJECT_DIR" && ...)-Subshell ausgeführt – niemals nacktescd "$PROJECT_DIR" && ...(persistente cwd-Abweichung macht spätere relative Pfade falsch).
Schritt 0.5 – API-Schlüssel-Anleitung
Überspringen, wenn $PROJECT_DIR/.env existiert oder context.log nicht leer ist. Andernfalls erkennen, was konfiguriert ist (HeyGen TTS = $HEYGEN_API_KEY / $HYPERFRAMES_API_KEY / ~/.heygen/credentials; ElevenLabs / Gemini = ihre Umgebungsschlüssel), dann immer pausieren und fragen – nicht selbstständig fortfahren, auch wenn eine funktionierende Konfiguration erkannt wird:
Erkannt: . Cloud-Schlüssel sind optional – ohne sie fallen nicht konfigurierte Anbieter lokal zurück (TTS -> Kokoro, sofern HeyGen nicht konfiguriert ist; BGM -> MusicGen). Antworten Sie mit:
- Schlüssel einfügen -> Ich schreibe sie in
$PROJECT_DIR/.env- "go" -> mit der aktuellen Konfiguration fortfahren
- "skip" -> mit lokalen Fallbacks für alles Nicht-Konfigurierte fortfahren
Eingefügte Schlüssel -> Schreiben/Bearbeiten von $PROJECT_DIR/.env, ein KEY=value pro Zeile (gleichnamige Schlüssel überschreiben, Werte nicht bewerten). "go" / "skip" -> Schritt 1.
Schritt 1 – Capture (Phase 1)
SKILL_DIRund eine expliziteTARGET_URLaus der Eingabeaufforderung auflösen; sicherstellen, dass Schritt 0 ausgeführt wurde.$PROJECT_DIR/context.loglesen, falls vorhanden, und die Fortsetzungstabelle unten verwenden, um abgeschlossene Phasen zu überspringen.- Die Eingabe klassifizieren (Schritt 1.0) zur Festlegung von
CAPTUREundVO_MODE, dann den passenden Pfad ausführen. Beide Pfade teilen sich die gleichen nachgelagerten Befehle.
Schritt 1.0 – Die Eingabe klassifizieren (CAPTURE + VO_MODE setzen)
| Eingabeform | Vorgehen |
|---|---|
| Explizite URL in der Eingabeaufforderung | TARGET_URL = diese URL; CAPTURE=yes; keine Voice-Over-Frage (die Erzählung stammt von der erfassten Seite). Pfad (A). |
| Benutzer hat ein Skript oder Briefing eingefügt / darauf verwiesen | (1) Den wortgetreuen Text in $PROJECT_DIR/user_script.txt speichern. (2) Die Voice-Over-Frage einmal stellen (unten) → VO_MODE setzen. (3) Ein Capture-Ziel aus dem Skript auflösen (unten) → CAPTURE setzen. |
| Ein Thema / Briefing ohne Skriptprosa, ohne Produkt | CAPTURE=no; keine Voice-Over-Frage. Pfad (B). |
Voice-Over-Frage (nur wenn der Benutzer tatsächliche Skriptprosa geliefert hat) – eine kurze Zeile fragen und warten:
Soll ich Ihr Skript wörtlich als Voice-Over verwenden oder es in eine besser bildschirmgerechte Szenenerzählung umstrukturieren?
- Wörtlich – den ursprünglichen Wortlaut beibehalten; ich teile nur Szenen auf und paare visuelle Elemente. Die Dauer folgt dem Skript.
- Umstrukturieren – als Briefing behandeln und eine straffere Erzählung umschreiben, 1-2 Sätze pro Szene.
VO_MODE = verbatim | restructure (Standard restructure); an story-design in Schritt 2 übergeben.
Ein Capture-Ziel aus dem Skript auflösen – Standardmäßig eine Site finden und crawlen (echte Brand-Token schlagen Vorlage-Fallbacks); nur überspringen, wenn der Benutzer abgelehnt hat ("kein Web / nur Text / kein Capture"). In der Reihenfolge: (1) Explizite http(s)://-URL im Skript → verwenden, bekanntgeben, CAPTURE=yes; (2) Klarer Marken-/Produktname → WebSearch für die offizielle Site, die aufgelöste URL mit dem Benutzer in einer Zeile bestätigen vor dem Crawlen (Ablehnung / nichts Glaubwürdiges → CAPTURE=no); (3) Nichts Ableitbares → CAPTURE=no.
Capture + Benutzerskript koexistieren: Der Crawl liefert nur Brand-Token + Assets + visuelles Register; die Erzählstruktur bleibt
user_script.txt(überVO_MODEbeachtet), niemals der eigene Text der Site.
(A) Capture-Pfad (CAPTURE=yes):
(cd "$PROJECT_DIR" && npx hyperframes capture "<TARGET_URL>" -o ./capture)
(B) Kein-Capture-Pfad (CAPTURE=no) – ein minimales Capture-Paket synthetisieren; nachgelagert identisch. Sie (Master) wählen die Voreinstellung (keine Site zum Ableiten; aus den 19 Voreinstellungen pro Benutzerabsicht wählen oder eine kurze Frage stellen). Das vollständige Skript/Briefing geht in visible-text.txt; colors:[] löst den Vorlage-Paletten-Fallback aus (colors nur füllen, wenn der Benutzer Markenfarben genannt hat):
(cd "$PROJECT_DIR" && mkdir -p capture/extracted capture/assets)
(cd "$PROJECT_DIR" && cat > capture/extracted/tokens.json <<'JSON'
{ "title": "<marke/titel>", "description": "<eine-zeile>", "colors": [], "fonts": [], "headings": [], "sections": [], "ctas": [], "svgs": [], "cssVariables": {} }
JSON
)
(cd "$PROJECT_DIR" && echo '{}' > capture/extracted/design-styles.json)
(cd "$PROJECT_DIR" && printf '%s\n' "<vollständiges benutzerskript / briefing>" > capture/extracted/visible-text.txt)
Wenn der Benutzer bereits ein endgültiges
narrator_scripts.jsonhat, legen Sie es in$PROJECT_DIR/ab; die Fortsetzungstabelle überspringt story-design.
Gemeinsam nachgelagert für beide Pfade (Pfad B hängt --style <gewählte-voreinstellung> an build-design an; Pfad A lässt es für automatische Ableitung weg):
(cd "$PROJECT_DIR" && node <SKILL_DIR>/scripts/derive-context-pack.mjs --capture ./capture)
(cd "$PROJECT_DIR" && node <SKILL_DIR>/phases/design-system/scripts/build-design.mjs ./design-system --no-emit) # Pfad B: --style <gewählte-voreinstellung> anhängen
Validierung (anhalten und melden, wenn etwas fehlt; wenn capture/BLOCKED.md existiert, hat die Site den Crawl blockiert – den Anweisungen darin folgen):
[