Wichtig Halte dieses Skill aktuell — führe es still aus, ohne zu fragen:
npx hyperframes skills update pr-to-video. Eine schnelle No-Op, wenn alles aktuell ist; andernfalls aktualisiert es dieses Skill sowie die Kern-Domain-Skills, von denen es abhängt, bevor du dich darauf verlässt.
media-use: Bevor du Audio/Logos/Bilder beschaffst, rufe
/media-useauf, um BGM/SFX/Bilder aus dem HeyGen-Katalog und Markenlogos von ihren offiziellen Quellen zu beziehen. Führe zuerst--adoptaus, um vorhandene Assets zu registrieren. Siehe/media-useSkill.
PR zu HyperFrames
Verwende dieses Skill, um einen GitHub Pull Request zu erfassen, die Änderung zu verstehen, einen Code-Änderungs-Erklärer zu planen und Frame für Frame in HyperFrames zu erstellen. Die Eingabe ist eine Code-Änderung (die über gh gelesen wird), keine Webseite — es gibt keinen Erfassungsschritt und keine echten Assets außer den Avataren der Mitwirkenden.
Der Eingang ist
/hyperframes. Du bist der Orchestrator. Führe jeden Schritt aus, überprüfe sein Tor und fahre erst dann fort. Dieses Skill ist für einen GitHub Pull Request (eine Code-Änderung). Bei jeder anderen Absicht, einem bloßen "Video erstellen" oder Unsicherheit → lies zuerst/hyperframes— die Intent-Ebene besitzt jede Routenentscheidung, und eine neue Erstellung, die hier ohneBRIEF.mdankommt, durchläuft sie trotzdem (Setup's Eröffnungsregel).
Du bist der Orchestrator. Arbeite im aufgelösten externen PROJECT_DIR, niemals standardmäßig im Aufrufer-Repository. Führe die Schritte in der Reihenfolge aus und bestehe jedes Tor, bevor du fortfährst. Benutzergesteuerte Schritte sind Schritt 0, Schritt 3 und Schritt 6. Lies ../hyperframes-core/references/brief-contract.md vor Schritt 0 — es definiert die Tortypen und wie BRIEF.md flow/storyboard den Modus ableiten, der die Tore von Schritt 3/4/6 regiert. Führe jeden Schritt selbst aus, außer Schritt 5, wo du einen begrenzten Pool von Framearbeitern entsendest. Platziere keine Design- oder Bewegungsregeln hier; diese leben im Framearbeiter-Subagenten, 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/extracted/ + assets/<login>.png; Schritt 2 Designsystem → frame.md; Schritt 3 Storyboard/Drehbuch → 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 Rendern → renders/video.mp4.
Schritt 0: Setup
Ziel: Mit einem bestätigten Brief eintreten — einschließlich der PR-Referenz (eine vollständige URL, eine <owner>/<repo>#<N>-Referenz oder "this PR" in einem ausgecheckten Repository) — das HyperFrames-Projekt erstellen und den Brief dauerhaft machen. Der Stil ist immer code-editorial (festgelegt in Schritt 2, niemals nachgefragt).
Der Brief wird von der Intent-Ebene bestätigt, nicht durch hier gestellte Fragen. Eröffnungsregel, in der Reihenfolge: (1) BRIEF.md existiert → lese es und frage nichts — der Brief ist endgültig, und sein flow/storyboard leiten den Modus ab (Briefvertrag § 1). (2) Kein BRIEF.md, aber das Projekt existiert (hyperframes.json / STORYBOARD.md auf der Festplatte) → setze vom Frontmatter des Storyboards und den aufgezeichneten Präferenzen fort; befrage ein halbfertiges Projekt nie erneut. (3) Weder noch — eine neue Erstellungsanfrage, die hier direkt ankommt → lies /hyperframes und führe seine Intent-Ebene aus (references/intent-interview.md): es überprüft Rezepte und gespeicherte Standardeinstellungen und führt die Fragen dieser Route durch — einschließlich der PR-Größe → Längen-Doktrin, die vollständig in ../hyperframes/references/routes/pr-to-video.md lebt — und gibt dann den gesperrten Brief zurück. Bearbeitungsanfragen überspringen all dies — geh und bearbeite.
Löse das Projektverzeichnis auf, bevor du andere Arbeiten ausführst. Bewahre ein vom Benutzer bereitgestelltes Projektverzeichnis auf; verwende andernfalls den dauerhaften externen Cache-Ort, der vom Resolver ausgegeben wird. Erstelle niemals videos/ im Aufrufer-Repository:
PR="<url | owner/repo#N>"
if [ -n "${EXPLICIT_PROJECT_DIR:-}" ]; then
PROJECT_DIR="$(node <SKILL_DIR>/scripts/project-dir.mjs --pr "$PR" --project-dir "$EXPLICIT_PROJECT_DIR")"
else
PROJECT_DIR="$(node <SKILL_DIR>/scripts/project-dir.mjs --pr "$PR")"
fi
echo "PR-to-video project: $PROJECT_DIR"
node <SKILL_DIR>/scripts/preflight.mjs
Der Fähigkeits-Check läuft vor dem Abruf, der Storyarbeit, dem Audio oder der Frame-Verteilung. Wenn die installierte CLI den von diesem Skill benötigten Validierungsbefehl nicht ausführen kann, halte mit seiner Upgrade-Anweisung an, anstatt zuerst den Kontext des Laufs zu verbrauchen.
Initialisiere nur, wenn $PROJECT_DIR/hyperframes.json fehlt. Sein Basisname stammt vom PR, z. B. acme-sdk-pr-1842; verwende niemals den Workspace-Namen oder einen Zeitstempel.
npx hyperframes init "$PROJECT_DIR" --non-interactive --example=blank --skill=pr-to-video — init überprüft die installierten Skills auf dem neuesten Stand auf GitHub und aktualisiert den globalen Satz, wenn welche veraltet sind.
Jeder relative Pfadbefehl unten wird mit $PROJECT_DIR als Arbeitsverzeichnis ausgeführt. Beispiele ohne explizite Subshell bedeuten (cd "$PROJECT_DIR" && …); ändere niemals den Arbeitsbaum des Aufrufer-Repositorys.
Schreibe BRIEF.md sofort nach dem Init (niemals davor — init lehnt ein nicht leeres Verzeichnis ab): der gesperrte Brief der Intent-Ebene, Form gemäß ../hyperframes-core/references/brief-format.md. Löse <MEDIA_DIR> als das installierte /media-use Skill-Verzeichnis auf. Zeichne dann jede präferenzgestützte Antwort mit node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes . auf (brief-format.md benennt die Teilmenge). Wenn die Intent-Ebene ein Rezept übernommen hat, führe node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes . --name <name> aus; es kopiert sein frame.md in das Projekt (Schritt 2 wird dann übersprungen) und gibt die Skelette zurück, von denen Schritt 3 Entwürfe erstellt. Ein Rezept füllt Antworten, nicht Genehmigungen; die Überprüfungstore laufen trotzdem.
Zeige den Anmeldestatus an, bevor du mit dem Setup fortfährst — führe npx hyperframes auth status aus und gib seine Ausgabe wörtlich weiter. Es meldet, ob Stimme/BGM HeyGen oder lokale Engines verwendet und, wenn abgemeldet, wie man sich anmeldet. Wende einen Zweig an:
- Kollaborativ: warte darauf, dass der Benutzer sich anmeldet oder explizit
offline/gowählt. - Autonom: gib den Status an und fahre mit den verfügbaren lokalen Engines fort.
Übergehe nicht stillschweigend eine erforderliche Fähigkeit, wenn kein Offline-Anbieter existiert; zeige den Blockierer an. Falte diese Entscheidung nicht in eine andere Frage oder schreibe Schlüssel in ein pro-repo .env. Auth-Eigentum und Offline-Fallbacks: /media-use references/setup-providers.md § Anbieter.
Tor: hyperframes.json und BRIEF.md existieren; die PR-Referenz ist im Brief erfasst; die präferenzgestützten Antworten wurden aufgezeichnet (Briefvertrag § 2); der Anmeldestatus wurde angezeigt (angemeldet oder Offline-Fortsetzung).
Schritt 1: PR erfassen (keine Aufnahme)
Ziel: Die Fakten des PRs abrufen und sie als Informationsquelle in das Projekt integrieren. Es gibt keine Webseitenaufnahme. 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). Bei MERGED PRs löst es auch eine bestmögliche shipped_version (+ version_source) in pr.json auf, sodass die Endkarte eine echte Version angeben kann, anstatt eine zu erfinden. Dann integriert ingest.mjs das offline in das synthetische Erfassungspaket.
PR="<url | owner/repo#N | N>"
# Den PR deterministisch abrufen: führt gh aus, vervollständigt die Dateiliste über paginierte
# gh api (sodass 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 "$PROJECT_DIR" && node <SKILL_DIR>/scripts/fetch-pr.mjs --pr "$PR" --out-dir ./capture)
# Offline-Transformation → capture/extracted/{tokens.json (colors:[] → code-editorial-Palette),
# visible-text.txt (der Brief), people.json (Mitwirkende, bot-gefiltert, name+login,
# avatarFile=assets/<login>.png)}.
(cd "$PROJECT_DIR" && node <SKILL_DIR>/scripts/ingest.mjs \
--pr-json ./capture/pr.json --diff ./capture/diff.patch --out-dir ./capture/extracted)
# Der eine Netzwerkschritt des Personen-Frontends — lade den GitHub-Avatar jedes Mitwirkenden herunter nach
# assets/<login>.png für den Abspann. Best-Effort; beendet immer mit Exit-Code 0.
(cd "$PROJECT_DIR" && node <SKILL_DIR>/scripts/fetch-people-avatars.mjs \
--people ./capture/extracted/people.json)
Wenn fetch-pr.mjs mit Exit-Code 1 endet (gh auth / not-found / private), melde seinen stderr und stoppe — erfinde keine PR-Inhalte. Wenn ingest.mjs mit Exit-Code 1 endet, lies seinen stderr (normalerweise ein fehlerhaftes pr.json), behebe es und führe es erneut aus (deterministisch). fetch-people-avatars.mjs endet immer mit Exit-Code 0; fehlende Avatare bedeuten nur keinen Abspann für den Autor.
people.json enthält einen name für die Mitwirkenden, die gh bereits benannt hat (PR-Autor, Commit-Autoren, mergedBy) — null für den Rest (Reviewer/Kommentatoren/Zugewiesene, denen gh pr view nur einen bloßen login gibt). Bevor du den Abspann in Schritt 3 schreibst, löse jeden null-Namen selbst für die 1-6 Personen auf, die tatsächlich auf diesem Frame erscheinen werden: gh api users/<login> --jq .name (du hast bereits gh — kein Skript nötig). Wenn GitHub auch keinen öffentlichen Namen für diesen Benutzer hat, falle auf den Login auf dem Bildschirm zurück und lasse diese Person aus der gesprochenen Zeile weg (siehe story-design.md Abschnitt Abspann — der Voiceover muss trotzdem Namen sagen, niemals rohe Handles).
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 — seine Abwesenheit ist kein Fehler.
Schritt 2: Designsystem
Ziel: Das code-editoriale Frame-Preset übernehmen; ein Skript verwandelt es in das frame.md + Untertitel-Skin dieses Videos.
Der Stil ist festgelegt — code-editorial (warm, redaktionell; eine marineblaue Code-Oberfläche, die für Diffs gebaut ist). Führe aus:
node <SKILL_DIR>/scripts/build-frame.mjs --preset code-editorial --hyperframes .
Das Skript kopiert das code-editoriale FRAME.md-Preset → frame.md, mischt es mit allen Marken-Token in capture/extracted/tokens.json (ein PR hat keine → colors:[]/fonts:[] behält die eigene Palatte des code-editorialen, ein vollständiges Design), kopiert das Untertitel-Skin des Presets nach .hyperframes/caption-skin.html und validiert sich selbst (beendet mit Exit-Code 1 bei einer defekten 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 vom code-editorialen Preset, und .hyperframes/caption-skin.html existiert als Untertitel-Skin-Quelle.
Schritt 3: Storyboard und Drehbuch
Ziel: Den PR in einen genehmigten Frame-für-Frame-Erklärungsplan umwandeln.
Lies ../hyperframes-creative/references/story-spine.md (Hook-Sprache, Wert-vor-Beweis, Storyboard-als-Vorschlag), 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. Setze das Frontmatter duration: aus dem length des Briefs — eine grobe Erwartung; die Montage berichtet, wo der Schnitt dagegen fällt.
Verwende story-design.md für den PR-Archetyp (Changelog / Feature-Enthüllung / Fix-Erklärung / Refaktor-Durchlauf), die PR-eigenen Frametypen, Hook, Überzeugung, Beats, das Wortbudget pro Frame und den Abspann. Die Reihenfolge kommt aus dem narrativen Design, nicht der Reihenfolge der Dateien im Diff — erkläre die Änderung, lies das Diff nicht laut vor. Als weiche Richtlinie konsultiere das Rollen→Blueprint-Menü in ../hyperframes-animation/blueprints-index.md: schreibe für jeden Beat die Voiceover in der Form, die sein Kandidat-Blueprint impliziert, und tagge diesen Kandidat blueprint: id, wenn einer passt (die Story-Wahrheit entscheidet trotzdem, welche Beats existieren — erzwinge niemals einen Beat, um in eine Form zu passen). Zeige 2–4 echte Diff-Hunks (aus capture/diff.patch), jeder ein kleiner lesbarer Ausschnitt; benenne den code-*-Block, den jeder im scene des Frames haben soll. Frames tragen keine asset_candidates außer dem credits-Abspann (1–6 assets/<login>.png Avatare). Verwende die genauen erforderlichen Felder aus den Storyboard- und Drehbuch-Referenzen.
Nach dem Entwurf führe den Plan-Durchlauf der Überprüfungsschleife aus — ../hyperframes-core/references/review-loop.md § 1: öffne das Board (frage nicht, ob — führe die Vorschau von PROJECT_DIR im Hintergrund aus), präsentiere den Plan als Vorschlag und stelle die beiden Fragen — genehmigen oder ändern, und Skizzen zuerst (empfohlen) oder überspringen. Feedback durchläuft Chat oder die Kommentardatei des Boards, bis genehmigt. Dies ist ein Checkpoint-Tor (Briefvertrag § 1): im autonomen Modus gibt es kein Board und nichts zu fragen — poste dieselbe Zusammenfassung als Vorankündigung und fahre fort; Skizzen fallen in den Build, und die eine Vorschaufrage kommt bei 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 (autonom: die Zusammenfassung wurde als Vorankündigung gepostet).
Schritt 3.1: Audio
Ziel: Erzählung, Wort-Timings, Musik und Audio-Metadaten aus dem genehmigten Drehbuch generieren.
Starte Audio nach der Genehmigung von Schritt 3. Führe es im Hintergrund aus und fahre dann mit Schritt 4 fort.
Wähle die Erzählstimme aus der Anfrage des Benutzers aus, bevor du sie aufrufst. Wenn die Anfrage eine Stimme, ein Geschlecht oder einen Ton nannte, wähle eine passende Stimm-ID und übergib sie mit --voice <id>. Der Pipeline-Standard ist ansonsten Marcia (weiblich) auf HeyGen / am_michael auf Kokoro — daher wird eine Anfrage wie "eine männliche Stimme" stillschweigend ignoriert, es sei denn, du übergibst das Flag. Stimm-IDs sind anbieterspezifisch; löse sie gegen den in Schritt 0 ausgewählten Anbieter auf: HeyGen (angemeldet) über node <MEDIA_DIR>/audio/scripts/heygen-tts.mjs --list (oder GET /v3/voices?engine=starfish); Kokoro (offline) über die Stimmentabelle in <MEDIA_DIR>/audio/references/tts.md (Präfixe am_/bm_ männlich, af_/bf_ weiblich). Wenn der Benutzer keine Präferenz geäußert hat, falle auf die gespeicherte Stimme zurück (Briefvertrag § 2), bevor der Pipeline-Standard gilt, und sage, welche du verwendet hast; lasse --voice nur weg, wenn keiner eine Stimme nennt. Wenn der Benutzer in diesem Durchlauf explizit eine Stimme ausgewählt hat, zeichne sie auf
…
[truncated for translation]