media-use: Bevor Audio/Bilder beschafft werden, rufe
/media-useauf, um BGM/SFX/Bilder aus dem HeyGen-Katalog zu verwenden. Führe zuerst--adoptaus, um vorhandene Assets zu registrieren. Siehe Fähigkeit/media-use.
PR zu HyperFrames
Nutze diese Fähigkeit, um einen GitHub-Pull-Request zu erfassen, die Änderung zu verstehen, einen Code-Änderungs-Erklärplan zu erstellen und ihn Frame für Frame in HyperFrames aufzubauen. Die Eingabe ist eine Code-Änderung (gelesen über gh), keine Website – es gibt keinen Erfassungsschritt und keine echten Assets außer den Avataren der Mitwirkenden.
Bestätige den Weg vor Schritt 0. Du bist der Orchestrator. Führe jeden Schritt aus, überprüfe sein Tor und fahre erst dann fort. Diese Fähigkeit ist für einen GitHub-Pull-Request (eine Codeänderung). Leite andere Absichten anderswo hin: eine Produkteinführung/Werbung →
/product-launch-video; eine allgemeine Website-Tour →/website-to-video; ein Themen-Erklärer ohne PR →/faceless-explainer; Untertitel auf vorhandenem Filmmaterial →/embedded-captions; eine kurze unkommentierte Bewegtgrafik →/motion-graphics; eine gesamt-Repo oder Multi-PR Release-Durchlauf →/general-video. Nicht im Lieferumfang enthalten: Live-/Zur-Renderzeit-Daten – PR-Fakten werden einmalig zur Autorenzeit gelesen und fest eingebaut. Wenn der Benutzer nur „Erstelle ein Video“ sagt oder der Weg unsicher ist, lies zuerst/hyperframes.
Du bist der Orchestrator. Arbeite in videos/<project>/. Führe die Schritte der Reihe nach aus und bestehe jedes Tor, 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 Sub-Agenten pro Frame entsendest. Platziere keine Design- oder Bewegungsregeln hier; diese leben im Frame-Worker-Sub-Agenten, hyperframes-creative und hyperframes-animation.
Workflow: Schritt 0 Einrichtung → hyperframes.json; Schritt 1 Erfassung → capture/extracted/ + assets/<login>.png; 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 Finaler Render → renders/video.mp4.
Schritt 0: Einrichtung und Briefing
Ziel: Lege die PR-Referenz und das Kern-Video-Briefing fest und erstelle bei Bedarf das HyperFrames-Projekt.
Hole die PR-Referenz (eine vollständige URL, eine <owner>/<repo>#<N>-Referenz oder „diesen PR“ in einem ausgecheckten Repo) und bestätige in einer Nachricht das Briefing – führe für jedes eine empfohlene Voreinstellung an und fülle alles vor, was /hyperframes bereits gesetzt hat: Winkel (Changelog / Feature-Enthüllung / Fehler-Erklärung / Refactoring-Durchlauf – Standard: aus dem PR ableiten), Zielgruppe (Standard: Entwickler), Länge (Standard: an die Änderungsgröße des PR anpassen – siehe unten), Seitenverhältnis (Standard 16:9), Sprache. Der Stil ist immer claude. Fahre erst fort, nachdem der Benutzer geantwortet hat; ein „Los“ akzeptiert die Voreinstellungen.
Empfehle die Länge basierend auf der Änderungsgröße des PR, nicht auf einer festen Schätzung. Bevor du das Briefing bestätigst, wirf einen ersten Blick auf den PR – ein schreibgeschützter Aufruf, der auch den Winkel begründet (Schritt 1 führt immer noch den vollständigen deterministischen Abruf durch):
gh pr view <PR_REF> --json title,additions,deletions,changedFiles
Wähle die Stufe aus additions + deletions (aufgerundet durch changedFiles) und schlage sie als Standard vor (der Benutzer kann sie überschreiben; harte Obergrenze ~3 min):
| PR-Änderungsgröße | Empfohlene Länge |
|---|---|
| trivial (≲ 50 geänderte Zeilen) | ~20–40s |
| fokussiert (~50–200 Zeilen) | ~40–70s |
| wesentlich (~200–600 Zeilen) | ~70–110s |
| groß (≳ 600 Zeilen oder 25+ Dateien) | ~110–180s |
Gib die Grundlage in einem Satz an, wenn du sie vorschlägst (z. B. „~40s – kleine Änderung, +44/−13 in 12 Dateien“). Ein riesiger PR bedeutet nicht unbedingt ein langes Video – wenn die Geschichte eine einzige Hauptänderung ist, halte es kurz und sage das.
Initialisiere nur, wenn hyperframes.json fehlt. Benenne <project> aus dem PR in Kebab-Schreibweise, z. B. acme-sdk-pr-1842; verwende niemals den Arbeitsbereichsnamen oder einen Zeitstempel.
npx hyperframes init "videos/<project>" --non-interactive --example=blank – init prüft die installierten Fähigkeiten auf die neuesten auf GitHub und aktualisiert die globalen, wenn welche veraltet sind.
Zeige den Anmeldestatus vor dem Briefing an – führe npx hyperframes auth status aus und gib seine Ausgabe wortwörtlich wieder (paraphrasiere oder schreibe sie nicht um). Es meldet, ob Stimme/Hintergrundmusik HeyGen oder lokale Engines verwendet und, wenn nicht angemeldet, wie man sich anmeldet. Wenn nicht angemeldet, HALT und warte, bis der Benutzer wählt – anmelden oder „Los“/„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 eine repo-spezifische .env. (Im autonomen Modus notiere den Status und fahre offline fort.) Siehe ../hyperframes-media → Preflight für die kanonische Anleitung.
Tor: hyperframes.json existiert; die PR-Referenz ist erfasst; Winkel, Länge, Seitenverhältnis und Sprache sind festgelegt; der Anmeldestatus wurde angezeigt (angemeldet oder Fortsetzung offline).
Schritt 1: Erfasse den PR (keine Erfassung)
Ziel: Rufe die Fakten des PR ab und füge sie in das Projekt als Informationsquelle ein. Es gibt keine Website-Erfassung. fetch-pr.mjs führt gh deterministisch aus – vervollständigt die Dateiliste durch paginierte gh api, sodass ein großer PR nicht bei ~100 Dateien abgeschnitten wird, und schreibt nur capture/pr.json + capture/diff.patch (kein Scratch-Verzeichnis). Dann fügt ingest.mjs das offline in das synthetische Erfassungspaket ein.
PR="<url | owner/repo#N | N>"
# Ruft den PR deterministisch ab: führt gh aus, vervollständigt die Dateiliste über paginierte
# gh api (damit ein großer PR nicht bei ~100 Dateien abgeschnitten wird), schreibt nur capture/pr.json +
# capture/diff.patch – kein Scratch-Verzeichnis. gh auth / Not-found / Private-Fehler beenden mit Exit-Code 1 hier.
(cd "videos/<project>" && node <SKILL_DIR>/scripts/fetch-pr.mjs --pr "$PR" --out-dir ./capture)
# Offline-Transformation → capture/extracted/{tokens.json (colors:[] → claude palette),
# visible-text.txt (das Briefing), people.json (Mitwirkende, bot-gefiltert, avatarFile=assets/<login>.png)}.
(cd "videos/<project>" && node <SKILL_DIR>/scripts/ingest.mjs \
--pr-json ./capture/pr.json --diff ./capture/diff.patch --out-dir ./capture/extracted)
# Der einzige Netzwerkschritt für die Personen – lade den GitHub-Avatar jedes Mitwirkenden nach
# assets/<login>.png herunter für einen optionalen Credits-Abspann. Best-Effort; beendet immer mit 0.
(cd "videos/<project>" && node <SKILL_DIR>/scripts/fetch-people-avatars.mjs \
--people ./capture/extracted/people.json)
Wenn fetch-pr.mjs mit Exit-Code 1 endet (gh auth / nicht gefunden / privat), melde seinen stderr und höre auf – erfinde keine PR-Inhalte. Wenn ingest.mjs mit Exit-Code 1 endet, lies seinen stderr (normalerweise eine fehlerhafte pr.json), behebe und führe erneut aus (deterministisch). fetch-people-avatars.mjs endet immer mit 0; fehlende Avatare bedeuten nur, dass es keinen Credits-Abspann für den Autor gibt.
Tor: capture/pr.json, capture/diff.patch, capture/extracted/tokens.json, capture/extracted/visible-text.txt und capture/extracted/people.json existieren; du kannst die Änderung des PR in einem klaren Satz angeben. assets/<login>.png ist Best-Effort – sein Fehlen ist kein Fehler.
Schritt 2: Designsystem
Ziel: Übernehme die claude-Frame-Voreinstellung; ein Skript wandelt sie in die frame.md dieses Videos + Untertitel-Skin um.
Der Stil ist festgelegt – claude (warm, redaktionell; eine marineblaue Code-Oberfläche, die für Diffs gemacht ist). Führe aus:
node <SKILL_DIR>/scripts/build-frame.mjs --preset claude --hyperframes .
Das Skript kopiert die FRAME.md der claude-Voreinstellung → frame.md, mischt sie auf alle Markentoken in capture/extracted/tokens.json (ein PR hat keine → colors:[]/fonts:[] behält claudes eigene Palette, ein vollständiges Design), kopiert den Untertitel-Skin der Voreinstellung nach .hyperframes/caption-skin.html und validiert sich selbst (Exit-Code 1 bei einer fehlerhaften Zuordnung). Fahre fort, sobald es mit Exit-Code 0 endet – keine manuelle Bearbeitung.
Tor: build-frame.mjs endete mit Exit-Code 0 – frame.md existiert aus der claude-Voreinstellung, und .hyperframes/caption-skin.html existiert als die Untertitel-Skin-Quelle.
Schritt 3: Storyboard und Skript
Ziel: Verwandle den PR in einen genehmigten Frame-für-Frame-Erklärplan.
Lies references/story-design.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 das PR-Archetyp (Changelog / Feature-Enthüllung / Fehler-Erklärung / Refactoring-Durchlauf), die PR-nativen Frame-Typen, den Aufhänger, die Überzeugung, die Beats, das Wortbudget pro Frame und den optionalen Credits-Abspann. Die Reihenfolge ergibt sich aus dem narrativen Design, nicht aus der Dateireihenfolge des Diffs – erkläre die Änderung, lies den Diff nicht vor. Zeige 2–4 echte Diff-Ausschnitte (aus capture/diff.patch), jeder ein kleiner lesbarer Schnipsel; nenne den code-*-Block, den jeder in der scene des Frames möchte. Frames tragen keine asset_candidates außer einem optionalen credits-Abspann (2–6 assets/<login>.png-Avatare). Verwende die genauen erforderlichen Felder aus den Storyboard- und Skriptreferenzen.
Nach dem Entwurf zeige eine Frame-für-Frame-Zusammenfassung. Frage in derselben Nachricht den Benutzer (a) nach Genehmigung oder Änderungswünschen und (b) ob er eine Live-Vorschau des Storyboard-Gerüsts möchte (npx hyperframes preview) – öffne es nur bei einem Ja. Iteriere bis zur Genehmigung; nimm die Vorschauwahl mit zu Schritt 6.
Tor: STORYBOARD.md existiert, jeder Frame hat die erforderlichen narrativen Felder, SCRIPT.md existiert, wenn eine Erzählung benötigt wird, und der Benutzer hat den Plan genehmigt.
Schritt 3.1: Audio
Ziel: Generiere Erzählung, Wortzeiten, Musik und Audio-Metadaten aus dem genehmigten Skript.
Starte Audio nach der Genehmigung von Schritt 3. Führe es im Hintergrund aus und 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, Wortzeiten, BGM-Suche in Heygens Musikbibliothek und Timing-Metadaten. Die BGM-Stimmung stammt aus dem Feld music: des Storyboards. Dies verwendet die HeyGen Audio API für den Abruf, nicht für die Generierung, und 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.
Tor: Der Audio-Job wurde gestartet oder das Projekt ist als stumm markiert.
Schritt 4: Visuelles Framedesign
Ziel: Füge jedem Storyboard-Frame die visuelle Anleitung, Layout-Absicht und Bewegungsoptionen 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.
Lies references/visual-design.md, references/composition.md, references/motion-language.md, references/code-vocabulary.md und ../hyperframes-animation/. Verwende visual-design.md für die erforderlichen Frame-Felder und den erforderlichen Block ## Video direction und dafür, wie ein Code-Beat einen code-*-Block als seinen focal benennt. Verwende code-vocabulary.md, um den richtigen Block pro Beat auszuwählen (diff = code-diff, refactor = code-morph, new code = code-typing, …). Verwende composition.md für Layout/Hierarchie/Blickpunkte und motion-language.md + ../hyperframes-animation/ für gültige Effekt- und Blueprint-IDs. Erfinde keine Effektnamen oder Block-/Blueprint-IDs.
Füge für jeden Frame die erforderlichen visuellen und Bewegungsfelder hinzu, einschließlich effects und focal und/oder roles. Für einen Code-Beat nenne den code-*-Block als den focal und lasse effects die umgebende claude Code Surface choreografieren (nicht die Code-Animation, die der Block besitzt). Füge einen video-weiten Block ## Video direction hinzu.
Ändere nicht die Geschichte, das Skript, transition_in, asset_candidates oder die PR-Quelle. Schreibe in diesem Schritt kein HTML. Es gibt keinen Asset-Bereitstellungsschritt – die einzigen echten Assets sind die Credits-Avatare, die bereits in assets/ sind.
Tor: Jeder Frame hat effects plus focal und/oder roles; Code-Frames nennen einen code-*-Block; ## Video direction existiert.
Schritt 5: Frames erstellen
Ziel: Erstelle jeden Storyboard-Frame als HTML-Komposition und setze das abspielbare Video zusammen.
Warte auf Schritt 3.1 Audio, um zu beenden, wenn Audio gestartet wurde. Synchronisiere dann die Dauern und rufe SFX ab; ü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 Dauersynchronisation ist mechanisch: echte Sprachdauer gewinnt; stumme Frames behalten Schätzungen; bearbeite synchronisierte Dauern niemals manuell.
Installiere vorab die Registry-Blöcke, die im gesamten STORYBOARD.md genannt sind, einmal, vor der Entsendung, damit parallele Worker nicht um die Registry konkurrieren:
for b in <jeder im Storyboard genannte Registry-Block>; do npx hyperframes add "$b"; done
Lies vor der Entsendung sub-agents/frame-worker.md und ../hyperframes-core/references/subagent-dispatch.md. Entsende einen Sub-Agenten pro Frame, wenn möglich parallel; ansonsten führe Worker in Wellen aus. Jeder Worker bekommt genau einen Frame. Der Kontext jedes Workers muss PROJECT_DIR, frame_id, Leinwandgröße, Untertitelstatus und Sperrband, wenn Untertitel aktiviert sind, ANIM_DIR (absoluter Pfad zu ../hyperframes-animation/) und den absoluten Pfad zu references/code-vocabulary.md enthalten. Jeder Worker liest frame.md, seinen eigenen Block ## Frame N, den Rezepttext für jede zitierte Effekt-/Blueprint-ID und – für einen Code-Beat – code-vocabulary.md für die Eingaben des genannten Blocks. Jeder Worker schreibt nur compositions/frames/NN-*.html; Worker bearbeiten niemals STORYBOARD.md.
Sobald ein Worker zurückkehrt, markiere diesen Frame als animated in STORYBOARD.md.
Nachdem die Audio-Timings existieren, erstelle Untertitel im Hintergrund und setze 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 das .hyperframes/caption-skin.html des Projekts (claudes, kopiert in Schritt 2) und injiziert Markentoken aus frame.md; captions: skipped (<reason>) i
…
[abgeschnitten für Übersetzung]