media-use: Bevor Audio/Bilder bezogen werden, rufe
/media-useauf, um BGM/SFX/Bilder aus dem HeyGen-Katalog zu laden. Führe zuerst--adoptaus, um vorhandene Assets zu registrieren. Siehe/media-useSkill.
PR zu HyperFrames
Nutze diesen Skill, um einen GitHub Pull Request zu erfassen, die Änderung zu verstehen, einen Code-Änderungs-Erklärer zu planen und ihn Frame für Frame in HyperFrames zu erstellen. Die Eingabe ist eine Code-Änderung (gelesen über gh), keine Website – es gibt keinen Capture-Schritt und keine echten Assets außer den Avataren der Mitwirkenden.
Bestätige die Route vor Schritt 0. Du bist der Orchestrator. Führe jeden Schritt aus, überprüfe sein Tor und fahre erst dann fort. Diese Skill ist für einen GitHub Pull Request (eine Code-Änderung). Leite andere Absichten woanders hin: ein Produkt-Launch/Promo →
/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 unerzählte Motion Graphic →/motion-graphics; ein komplettes Repo- oder Multi-PR-Release-Walkthrough →/general-video. Nicht im Scope: Live-/Renderzeit-Daten – PR-Fakten werden einmalig zur Author-Zeit gelesen und eingebacken. Wenn der Benutzer nur „mach ein Video“ sagt oder die Route unsicher ist, lies zuerst/hyperframes.
Du bist der Orchestrator. Arbeite in videos/<project>/. Führe Schritte in Reihenfolge aus und bestehe jedes Tor vor dem Fortfahren. Benutzergesteuerte Schritte sind Schritt 0, Schritt 3 und Schritt 6. Erledige jeden Schritt selbst, außer Schritt 5, wo du einen Sub-Agenten pro Frame entsendest. Lege keine Design- oder Bewegungsregeln hier fest; diese leben im Frame-Worker-Sub-Agenten, hyperframes-creative und hyperframes-animation.
Workflow: Schritt 0 Setup → hyperframes.json; Schritt 1 Ingest → 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: Setup und Briefing
Ziel: Den PR-Referenz und das Kern-Video-Briefing festlegen und das HyperFrames-Projekt erstellen, falls nötig.
Hole die PR-Referenz (eine vollständige URL, eine <owner>/<repo>#<N>-Referenz oder „this PR“ in einem ausgecheckten Repo) und bestätige in einer Nachricht das Briefing – führe mit einer empfohlenen Voreinstellung für jedes Feld und fülle alles, was /hyperframes bereits gesetzt hat, vor: Winkel (Changelog / Feature-Vorstellung / Fix-Erklärer / Refaktor-Walkthrough – Standard: aus dem PR ableiten), Zielgruppe (Standard: Entwickler), Länge (Standard: an die Änderungsgröße des PRs anpassen – siehe unten), Seitenverhältnis (Standard 16:9), Sprache. Der Stil ist immer claude. Fahre nur fort, nachdem der Benutzer geantwortet hat; ein „los“ akzeptiert die Voreinstellungen.
Empfehle die Länge basierend auf der Änderungsgröße des PRs, nicht auf einer festen Schätzung. Bevor du das Briefing bestätigst, wirf einen Blick auf den PR – ein read-only Aufruf, der auch den Winkel untermauert (Schritt 1 führt immer noch den vollständigen deterministischen Fetch durch):
git pr view <PR_REF> --json title,additions,deletions,changedFiles
Wähle die Stufe aus additions + deletions (nach oben korrigiert um changedFiles) und schlage sie als Standard vor (der Benutzer kann überschreiben; harte Obergrenze ~3 Min):
| PR-Änderungsgröße | Empfohlene Länge |
|---|---|
| trivial (≲ 50 Zeilen geändert) | ~20–40s |
| fokussiert (~50–200 Zeilen) | ~40–70s |
| substanziell (~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 über 12 Dateien“). Ein riesiger PR bedeutet nicht automatisch ein langes Video – wenn die Geschichte nur eine einzige Hauptänderung ist, halte es kurz und sag das.
Initialisiere nur, wenn hyperframes.json fehlt. Benenne <project> nach dem PR im Kebab-Case, 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 Skills gegen die neuesten auf GitHub und aktualisiert die globalen Skills, falls welche veraltet sind.
Zeige den Anmeldestatus vor dem Briefing an – führe npx hyperframes auth status aus und gib seine Ausgabe wörtlich wieder (paraphrasiere oder schreibe sie nicht um). Es berichtet, ob Stimme/BGM HeyGen oder lokale Engines verwenden und, wenn nicht angemeldet, wie man sich anmeldet. Wenn nicht angemeldet, STOPPE und warte, bis der Benutzer wählt – 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; falte die Wahl nicht in die Briefing-Frage und schreibe keine Schlüssel in ein Repo-spezifisches .env. (Im autonomen Modus notiere den Status und fahre offline fort.) Siehe ../hyperframes-media → Preflight für die maßgebliche 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 offline fortfahrend).
Schritt 1: PR erfassen (kein Capture)
Ziel: Die Fakten des PRs abrufen und als Informationsquelle in das Projekt einbinden. Es gibt kein Website-Capture. fetch-pr.mjs führt gh deterministisch aus – vervollständigt die Dateiliste über 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 faltet ingest.mjs das offline in das synthetische Capture-Paket.
PR="<url | owner/repo#N | N>"
# PR deterministisch abrufen: führt gh aus, vervollständigt die Dateiliste über paginierte
# gh api (damit ein großer PR nicht bei ~100 Dateien abschneidet), schreibt nur capture/pr.json +
# capture/diff.patch – kein Scratch-Verzeichnis. gh auth / not-found / private Fehler beenden mit 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 Personen – lade den GitHub-Avatar jedes Mitwirkenden herunter nach
# assets/<login>.png für einen optionalen Credits-Abspann. Best-Effort; endet immer mit 0.
(cd "videos/<project>" && node <SKILL_DIR>/scripts/fetch-people-avatars.mjs \
--people ./capture/extracted/people.json)
Wenn fetch-pr.mjs mit 1 endet (gh auth / nicht gefunden / privat), melde seinen stderr und stoppe – erfinde keine PR-Inhalte. Wenn ingest.mjs mit 1 endet, lies seinen stderr (normalerweise ein fehlerhaftes pr.json), behebe es und führe erneut aus (deterministisch). fetch-people-avatars.mjs endet immer mit 0; fehlende Avatare bedeuten nur keinen Credits-Abspann für den Autor.
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 PRs in einem klaren Satz angeben. assets/<login>.png ist Best-Effort – sein Fehlen ist kein Fehler.
Schritt 2: Designsystem
Ziel: Die claude-Frame-Voreinstellung übernehmen; ein Skript wandelt sie in das frame.md + Caption-Skin dieses Videos um.
Der Stil ist festgelegt – claude (warm, redaktionell; eine marineblaue Code-Oberfläche, gebaut für Diffs). Führe aus:
node <SKILL_DIR>/scripts/build-frame.mjs --preset claude --hyperframes .
Das Skript kopiert die claude-Voreinstellung FRAME.md → frame.md, mischt sie mit allen Marken-Tokens in capture/extracted/tokens.json (ein PR hat keine → colors:[]/fonts:[] behält claudes eigene Palette, ein vollständiges Design), kopiert das Caption-Skin der Voreinstellung nach .hyperframes/caption-skin.html und validiert sich selbst (endet mit 1 bei einer kaputten Zuordnung). Fahre fort, sobald es mit 0 endet – keine manuelle Bearbeitung.
Tor: build-frame.mjs endete mit 0 – frame.md existiert von der claude-Voreinstellung und .hyperframes/caption-skin.html existiert als Caption-Skin-Quelle.
Schritt 3: Storyboard und Skript
Ziel: Den PR in einen genehmigten, Frame-für-Frame-Erklärungsplan verwandeln.
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 den PR-Archetyp (Changelog / Feature-Vorstellung / Fix-Erklärer / Refaktor-Walkthrough), die PR-nativen Frame-Typen, Hook, Überzeugung, Beats, das Wortbudget pro Frame und den optionalen Credits-Abspann. Die Reihenfolge kommt aus dem narrativen Design, nicht der Dateireihenfolge des Diffs – erkläre die Änderung, lies das Diff nicht vor. Zeige 2–4 echte Diff-Hunks (aus capture/diff.patch), jedes als kleines lesbares Snippet; benenne den code-*-Block, den jedes in der scene des Frames haben soll. 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 Skript-Referenzen.
Nach dem Entwurf zeige eine Frame-für-Frame-Zusammenfassung. Frage in derselben Nachricht den Benutzer (a) ob er zustimmt oder Änderungen wünscht und (b) ob er eine Live-Vorschau des Storyboard-Gerüsts möchte (npx hyperframes preview) – öffne es nur bei einem Ja. Iteriere, bis genehmigt; trage die Vorschau-Entscheidung 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: Erzählung, Wort-Timings, Musik und Audio-Metadaten aus dem genehmigten Skript generieren.
Starte Audio nach Schritt 3-Genehmigung. 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 übernimmt Erzählung, Wort-Timings, BGM-Suche aus HeyGens Musikbibliothek und Timing-Metadaten. Die BGM-Stimmung kommt aus dem music:-Feld des Storyboards. Es verwendet die HeyGen Audio API für die Suche, nicht für die Generierung, und dieselbe ~/.heygen-Anmeldeinformation wie TTS. Für Provider-Details 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: Audio-Job gestartet oder das Projekt als stumm markiert.
Schritt 4: Visuelles Frame-Design
Ziel: Füge jedem Storyboard-Frame die visuelle Richtung, das Layout-Ziel und die Bewegungsauswahl hinzu.
Bearbeite STORYBOARD.md direkt. Erstelle kein weiteres Storyboard. Verwende frame.md als Quelle der Wahrheit für Farbe, Typ, 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 ## Video direction-Block 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. Benenne für einen Code-Beat den code-*-Block als den focal und lasse effects die umgebende claude Code-Oberfläche choreografieren (nicht die Code-Animation, die der Block besitzt). Füge einen video-weiten ## Video direction-Block hinzu.
Ändere nicht Story, Skript, transition_in, asset_candidates oder die PR-Quelle. Schreibe in diesem Schritt kein HTML. Es gibt keinen Asset-Staging-Schritt – die einzigen echten Assets sind die Credits-Avatare, bereits in assets/.
Tor: Jeder Frame hat effects plus focal und/oder roles; Code-Frames benennen einen code-*-Block; ## Video direction existiert.
Schritt 5: Frames bauen
Ziel: Jeden Storyboard-Frame als HTML-Komposition bauen und das abspielbare Video zusammenstellen.
Warte auf das Ende von Schritt 3.1 Audio, falls Audio gestartet wurde. Synchronisiere dann Dauern und hole SFX; überspringe beide, wenn das Projekt stumm ist.
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 .
Dauernsynchronisation ist mechanisch: echte Sprachdauer gewinnt; stumme Frames behalten Schätzungen; bearbeite niemals synchronisierte Dauern von Hand.
Installiere vorab die Registry-Blöcke, die in STORYBOARD.md genannt werden, einmal vor dem Dispatch, damit parallele Worker sich nicht um die Registry streiten:
for b in <jeder im Storyboard genannte Registry-Block>; do npx hyperframes add "$b"; done
Lies vor dem Dispatch 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, Caption-Status und Keep-Out-Band, wenn Captions 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 ## Frame N-Block, den Rezeptkörper für jede zitierte Effekt-/Blueprint-ID und – für einen Code-Beat – code-vocabulary.md für die Eingaben des benannten Blocks. Jeder Worker schreibt nur compositions/frames/NN-*.html; Worker bearbeiten niemals STORYBOARD.md.
Sobald ein Worker zurückkommt, markiere diesen Frame als animated in STORYBOARD.md.
Nachdem Audio-Timings existieren, baue Captions 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 das .hyperframes/caption-skin.html des Projekts (claudes, kopiert in Schritt 2), injiziert Marken-Tokens aus frame.md; captions: skipped (<reason>) wenn
…
[gekürzt für Übersetzung]