media-use: Bevor Audio-/Bildquellen bezogen werden, rufe
/media-useauf, um BGM/SFX/Bilder aus dem HeyGen-Katalog zu beziehen. Führe zuerst--adoptaus, um vorhandene Assets zu registrieren. Siehe/media-useSkill.
Produkt-Launch zu HyperFrames
Verwende diesen Skill, um ein Produkt zu erfassen, seine Marke zu verstehen, ein Launch-Video zu planen und es Frame für Frame in HyperFrames zu erstellen.
Bestätige den Weg vor Schritt 0. Du bist der Orchestrator. Führe jeden Schritt aus, überprüfe sein Gate und fahre erst dann mit dem nächsten Schritt fort. Dieser Skill ist für ein Produkt, das vermarktet, gelauncht, beworben oder enthüllt wird, einschließlich Anfragen wie "Promo für unsere Seite", wenn der Zweck werblich ist. Leite andere Absichten anderswo hin: eine allgemeine, nicht-launchbezogene Website-Tour ->
/website-to-video; ein thematisches Erklärvideo ohne Produkt ->/faceless-explainer; ein GitHub-PR ->/pr-to-video; Untertitel auf vorhandenem Filmmaterial ->/embedded-captions; eine kurze unkommentierte Bewegungsgrafik ->/motion-graphics. Sagt der Benutzer nur "ein Video machen" oder ist der Weg unsicher, lies zuerst/hyperframes.
Du bist der Orchestrator. Arbeite in videos/<project>/. Führe die Schritte in der Reihenfolge aus und bestehe jedes Gate, bevor du fortfährst. Benutzergesteuerte Schritte sind Schritt 0, Schritt 3 und Schritt 6. Führe jeden Schritt selbst aus, außer Schritt 5, wo du einen Unter-Agenten pro Frame entsendest. Platziere keine Design- oder Bewegungsregeln hier; diese leben im Frame-Worker-Unter-Agenten, in den lokalen ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/ dieses Skills und in hyperframes-creative.
Workflow: Schritt 0 Setup -> hyperframes.json; Schritt 1 Erfassung -> capture/; Schritt 2 Designsystem -> frame.md; Schritt 3 Storyboard/Skript -> STORYBOARD.md und SCRIPT.md; Schritt 3.1 Audio -> audio_meta.json; Schritt 4 Visuelles Design -> angereichertes STORYBOARD.md; Schritt 5 Frames -> compositions/frames/NN-*.html und index.html; Schritt 6 Finales Rendering -> renders/video.mp4.
Schritt 0: Einrichtung und Briefing
Ziel: Lege das Kern-Video-Briefing fest und erstelle bei Bedarf das HyperFrames-Projekt.
Initialisiere nur, wenn hyperframes.json fehlt. Benenne <project> nach der Marke oder Domain im Kebab-Case, z.B. acme-promo; verwende niemals den Workspace-Namen oder Zeitstempel.
npx hyperframes init "videos/<project>" --non-interactive --example=blank — init prüft die installierten Skills auf dem neuesten Stand gegen die auf GitHub und aktualisiert die globalen Sets, falls welche veraltet sind.
Zeige den Anmeldestatus vor dem Briefing an — führe npx hyperframes auth status aus und gebe seine Ausgabe wörtlich wieder (paraphrasiere oder schreibe sie nicht um). Es wird berichtet, ob Sprachausgabe/BGM die HeyGen- oder lokale Engines verwenden werden und, falls nicht angemeldet, wie man sich anmeldet. Wenn nicht angemeldet, stoppe und warte auf die Wahl des Benutzers – anmelden oder "go"/"offline" sagen, um mit lokalen Engines fortzufahren – bevor du nach dem Briefing oder irgendetwas anderem fragst. Behandle es als echten Entscheidungspunkt, nicht als beiläufige Notiz; verpacke die Wahl nicht in die Briefing-Frage und schreibe keine Schlüssel in ein pro-Repo .env. (Im autonomen Modus notiere den Status und fahre offline fort.) Siehe ../hyperframes-media → Preflight für die kanonische Anleitung.
Gate: hyperframes.json existiert, und Winkel, Länge, Seitenverhältnis und Sprache sind festgelegt; der Anmeldestatus wurde angezeigt (angemeldet oder Fortsetzung offline).
Schritt 1: Assets erfassen
Ziel: Sammle das Quellmaterial, Markensignale und nutzbare Assets für das Video.
Klassifiziere die Eingabe und wähle den Pfad. Explizite URL -> erfasse sie und verwende die Website für Erzählung und Assets. Eingefügtes Skript/Briefing -> speichere wörtlich als user_script.txt, frage einmal "wörtlich verwenden oder umstrukturieren?", speichere die Antwort als VO_MODE, löse dann das Erfassungsziel auf: URL im Text -> verwende sie; nur Markenname -> WebSearch, bestätige URL in einer Zeile, dann crawlen; keine URL/Seite -> kein Erfassungspfad.
Führe die Erfassung aus mit: npx hyperframes capture "<URL>" -o ./capture
Wenn GEMINI_API_KEY, GOOGLE_API_KEY oder ein OpenRouter-Schlüssel existiert, verschlagwortet die Erfassung automatisch Assets in capture/extracted/asset-descriptions.md. Dies ist kein Überprüfungs-Gate. Ohne einen Vision-Schlüssel verwende den DOM-Kontext und fahre fort.
Kein Erfassungspfad: erstelle capture/extracted/tokens.json, capture/extracted/visible-text.txt, capture/extracted/asset-descriptions.md und capture/assets/ von Hand. tokens.json sollte { "title": "", "description": "", "colors": [], "fonts": [] } sein; fülle Titel/Beschreibung nach Möglichkeit aus dem Briefing. visible-text.txt enthält das vollständige Briefing oder Skript. asset-descriptions.md sollte angeben, dass keine Assets erfasst wurden, es sei denn, der Benutzer gab Asset-Notizen.
Gate: capture/extracted/tokens.json, capture/extracted/visible-text.txt, capture/extracted/asset-descriptions.md und capture/assets/ existieren; du kannst die Marke in einem klaren Satz angeben. Behandle asset-descriptions.md als das Haupt-Asset-Inventar. Fehlt es nach einer echten Erfassung, stoppe und melde die Erfassung als unvollständig. Wenn capture/BLOCKED.md existiert, folge ihm.
Schritt 2: Designsystem
Ziel: Wähle eine ausgelieferte Frame-Voreinstellung; ein Skript verwandelt sie in das frame.md + den Untertitel-Skin dieses Videos.
Du triffst die eine Beurteilung — welche Voreinstellung. Lese ../hyperframes-creative/references/design-spec.md und wähle die Voreinstellung, deren Look am besten zur Marke und zum Briefing passt. Führe dann aus:
node <SKILL_DIR>/scripts/build-frame.mjs --preset <name> --hyperframes .
Das Skript erledigt den Rest deterministisch: es kopiert FRAME.md der Voreinstellung → frame.md und remixt es auf die Marken-Token in capture/extracted/tokens.json (Markenfarben werden nach Rolle auf die Farbschlüssel der Voreinstellung abgebildet – Tinte, Leinwand, Akzente – wobei Schlüssel/Struktur/Komponenten erhalten bleiben; die Anzeige- und Textschriftarten der Voreinstellung werden gegen die der Marke getauscht), kopiert den Untertitel-Skin der Voreinstellung nach .hyperframes/caption-skin.html und validiert sich selbst (beendet mit Exit-Code 1 bei einer fehlerhaften Abbildung). Fahre mit dem nächsten Schritt fort, sobald das Skript mit Exit-Code 0 beendet wird – kein manuelles Bearbeiten der Spezifikation.
tokens.json ohne Markenfarben/Schriftarten (z.B. keine Erfassung) → das Skript behält die eigene Palette der Voreinstellung, ein vollständig auslieferbares Design. Wenn das Briefing Markenfarben/Schriftarten nennt, die die Erfassung übersehen hat, füge sie zu capture/extracted/tokens.json hinzu, bevor du das Skript ausführst (oder verwende das design.md des Benutzers, um es zu befüllen); passe frame.md danach nur von Hand an, wenn eine Abbildung es wirklich erfordert.
Gate: build-frame.mjs endete mit Exit-Code 0 — frame.md existiert von einer benannten Voreinstellung, und (wenn die Voreinstellung eine mitliefert) .hyperframes/caption-skin.html existiert als Untertitel-Skin-Quelle.
Schritt 3: Storyboard und Skript
Ziel: Verwandle das Briefing und das erfasste Material in einen genehmigten Frame-für-Frame-Geschichtenplan.
Lese references/story-design.md, ../hyperframes-animation/blueprints-index.md, ../hyperframes-core/references/storyboard-format.md und ../hyperframes-core/references/script-format.md. Verwende sie, um STORYBOARD.md und, wenn eine Erzählung benötigt wird, SCRIPT.md zu schreiben.
Verwende story-design.md für die Story-Blaupause, den Haken, die Überzeugungslogik, Beats, VO_MODE und Asset-Wahl. Als weichen Leitfaden konsultiere das Rollen→Blaupausen-Menü in ../hyperframes-animation/blueprints-index.md: notiere für jeden Beat einen Kandidaten-Blaupausen-ID, wenn eine passt. Die Story-Wahrheit entscheidet dennoch, welche Beats existieren – erzwinge niemals einen Beat, um in eine Blaupause zu passen, und erfinde niemals einen Beat nur, weil eine bewährte Form verfügbar ist. Wähle die asset_candidates jedes visuellen Frames aus capture/extracted/asset-descriptions.md (dem kanonischen Inventar) – durchsuche nicht rohes capture/assets/. Bitte den Benutzer nicht, Assets auszuwählen, es sei denn, dieses Inventar fehlt oder ist unbrauchbar. Verwende die genauen erforderlichen Felder aus den Storyboard- und Skript-Referenzen.
Nach dem Entwurf zeige eine Frame-für-Frame-Zusammenfassung. Frage den Benutzer in derselben Nachricht nach zwei Dingen: (a) Genehmigung oder Änderungswünsche, und (b) ob sie eine Live-Vorschau des Storyboard-Gerüsts wünschen (npx hyperframes preview) — öffne sie nur bei einem Ja. Iteriere, bis genehmigt, und trage die Vorschau-Wahl zu Schritt 6.
Gate: STORYBOARD.md existiert, jeder visuelle Frame hat asset_candidates, SCRIPT.md existiert, wenn eine Erzählung benötigt wird, und der Benutzer hat den Frame-für-Frame-Plan genehmigt.
Schritt 3.1: Audio
Ziel: Generiere Erzählung, Wortzeitsteuerungen, Musik und Audio-Metadaten aus dem genehmigten Skript.
Starte Audio nach der Genehmigung von Schritt 3. Führe es im Hintergrund aus, fahre dann mit Schritt 4 fort.
node <SKILL_DIR>/scripts/audio.mjs --script ./SCRIPT.md --storyboard ./STORYBOARD.md --hyperframes . --out ./audio_meta.json &
Das Audio-Skript kümmert sich um Erzählung, Wortzeitsteuerungen, BGM-Suche aus der HeyGen-Musikbibliothek und Zeitsteuerungs-Metadaten. Die BGM-Stimmung stammt aus dem music:-Feld des Storyboards. Dies verwendet die HeyGen-Audio-API für die Suche, nicht für die Generierung, und verwendet dieselbe ~/.heygen-Anmeldeinformation wie TTS. Für Anbieterdetails lies ../hyperframes-media/references/tts.md.
Wenn es keine Erzählung und kein SCRIPT.md gibt, überspringe die Sprachgenerierung. BGM kann trotzdem laufen, wenn das Storyboard eine Musikstimmung hat.
Gate: Der Audio-Job wurde gestartet, oder das Projekt ist als stumm markiert.
Schritt 4: Visuelles Frame-Design
Ziel: Füge jedem Storyboard-Frame die visuelle Richtung, Layout-Absicht und Bewegungswahl hinzu.
Bearbeite STORYBOARD.md direkt. Erstelle kein weiteres Storyboard. Verwende frame.md als Quelle der Wahrheit für Farbe, Typografie, Layout-Gefühl und Stil.
Lese references/visual-design.md, ../hyperframes-animation/blueprints-index.md, references/motion-language.md und ../hyperframes-animation/rules-index.md. Verwende visual-design.md für die Methode (die zeitcodierte Shot-Sequenz, das Inline-Layout-Vokabular und den erforderlichen Block ## Video direction). Verwende ../hyperframes-animation/blueprints-index.md, um die Shot-Form jedes Frames auszuwählen. Verwende motion-language.md (das Bewegung-Vokabular + die Bewegungsdoktrin) und ../hyperframes-animation/rules-index.md (gültige Regelnamen) für Bewegungen – erfinde keine Bewegungsnamen.
Schreibe für jeden visuellen Frame eine zeitcodierte Shot-Sequenz in STORYBOARD.md gemäß der Methode von visual-design.md: wähle die Blaupause des Frames (oder komponiere sie), instanziiere sie mit DEM Inhalt dieses Produkts und takte die Enthüllung jeder Szene auf den Voiceover, sodass sich der Frame über seine gesamte Dauer entwickelt, anstatt vorzuladen und dann einzufrieren. Gib Layout und Bewegung inline pro Szene an (Vokabulare in visual-design.md und motion-language.md). Füge einen videoweiten Block ## Video direction hinzu.
Ändere nicht Story, Skript, Asset-Wahl, asset_candidates, transition_in oder erfasstes Quellmaterial. Schreibe in diesem Schritt kein HTML.
Bereite benannte Assets vor, nachdem das visuelle Design festgelegt ist:
node <SKILL_DIR>/scripts/stage-assets.mjs --storyboard ./STORYBOARD.md --hyperframes .
Gate: Jeder visuelle Frame hat eine zeitcodierte Shot-Sequenz, deren Enthüllungen auf den Voiceover getaktet sind (kein Vorladen); ## Video direction existiert; assets/ enthält die benannten Assets.
Schritt 5: Frames erstellen
Ziel: Erstelle jeden Storyboard-Frame als HTML-Komposition und stelle das abspielbare Video zusammen.
Warte darauf, dass Schritt 3.1 Audio beendet ist, falls Audio gestartet wurde. Synchronisiere dann Dauern und hole SFX; überspringe beides, wenn stumm.
node <SKILL_DIR>/scripts/audio.mjs sync-durations --audio-meta ./audio_meta.json --storyboard ./STORYBOARD.md
node <SKILL_DIR>/scripts/audio.mjs fetch-sfx --storyboard ./STORYBOARD.md --hyperframes .
Die Dauernsynchronisation ist mechanisch: echte Sprachdauer gewinnt; stumme Frames behalten Schätzungen; bearbeite synchronisierte Dauern niemals von Hand.
Lese vor dem Versenden sub-agents/frame-worker.md und ../hyperframes-core/references/subagent-dispatch.md. Versende einen Unter-Agenten pro Frame, wenn möglich parallel; ansonsten führe die Worker in Wellen aus. Jeder Worker erhält genau einen Frame.
Jeder Worker-Kontext muss PROJECT_DIR, frame_id, Leinwandgröße, Untertitelstatus und Sperrbereich (keep-out band) enthalten, falls Untertitel aktiviert sind, sowie RULES_DIR als absoluten Pfad zu ../hyperframes-animation/rules/ dieses Skills. Jeder Worker liest frame.md, seinen eigenen ## Frame N-Block aus STORYBOARD.md, das lokale Regel-Rezept (../hyperframes-animation/rules/<id>.md) für jede zitierte Bewegung und die Blaupausen-Vorlage des Frames (../hyperframes-animation/blueprints/<id>.md). Jeder Worker schreibt nur compositions/frames/NN-*.html. Worker dürfen niemals STORYBOARD.md bearbeiten.
Sobald ein Worker zurückkehrt, markiert der Orchestrator diesen Frame als animated in STORYBOARD.md.
Nachdem die Audio-Zeitsteuerungen existieren, erstelle Untertitel im Hintergrund und stelle den Index zusammen:
node <SKILL_DIR>/scripts/captions.mjs build --storyboard ./STORYBOARD.md --audio-meta ./audio_meta.json --hyperframes . --out ./caption_groups.json &
node <SKILL_DIR>/scripts/assemble-index.mjs --storyboard ./STORYBOARD.md --hyperframes .
captions.mjs verwendet den .hyperframes/caption-skin.html des Projekts (kopiert in Schritt 2) als Untertitel-Look und injiziert Marken-Token aus frame.md; wenn kein Skin vorhanden ist, rendert es die eingebaute Standard-Pille. captions: skipped (<reason>) ist gültig. Fahre ohne Untertitel fort, wenn sie explizit übersprungen wurden.
Gate: Jeder Frame ist als animated markiert, index.html existiert, und Untertitel sind erstellt oder explizit übersprungen.
Schritt 6: Finalisieren
Ziel: Überprüfe das zusammengestellte Video, hole die Benutzerfreigabe ein und rendere das endgültige MP4.
Füge Übergänge ein, führe Prüfungen durch, pausiere für die Überprüfung, rendere dann.
node <SKILL_DIR>/scripts/transitions.mjs inject --storyboard ./STORYBOARD.md --hyperframes .
node <SKILL_DIR>/scripts/transitions.mjs verify --storyboard ./STORYBOARD.md --index ./index.html
npx hyperframes lint
npx hyperframes validate
npx hyperframes inspect
npx hyperframes snapshot --at <frame-midpoints>
snapshot setzt die erfassten Frames zu einem Kontaktbogen zusammen (snapshots/contact-sheet.jpg). Wirf einen Blick darauf; wenn nichts offensichtlich kaputt ist, fahre fort – verweile nicht hier.
Wenn ein Befehl fehlschlägt, zeige stderr und stoppe – häufe keine Wiederherstellungsbefehle an. Behebe es selbst: die billigste sichere Bearbeitung von compositions/frames/NN-*.html, führe dann die fehlgeschlagene Prüfung erneut aus.
Nach bestandenen Prüfungen pausiere für die Benutzerüberprüfung. Das Video ist zusammengestellt, betrachtbar und im Studio bearbeitbar. Verwalte die Vorschau nur einmal über Schritt 3 und Schritt 6 hinweg: öffne sie, wenn der Benutzer sie früher gewünscht hat, biete sie an, wenn er sie früher abgelehnt hat, und frage nicht erneut, wenn er bereits im Studio überprüft.
Vorschau: npx hyperframes preview
Rendern
... [für die Übersetzung gekürzt]