Plugin-Installation: Vor der Einrichtung oder Aktualisierung folgen Sie den Plugin-Ausführungsregeln, wenn dieser Skill in einem HyperFrames-Plugin enthalten ist. Eigenständige Installationen behalten die folgenden Update-Anweisungen bei.
Halten Sie diesen Skill zunächst frisch – bestätigen Sie mit dem Benutzer vor der Ausführung:
npx hyperframes skills update pr-to-video. Ein schneller No-Op, wenn alles aktuell ist; ansonsten aktualisiert es diesen Skill sowie die Kern-Skills, von denen er abhängt, bevor Sie sie verwenden.
media-use: Bevor Sie Audio/Bilder/Logos beziehen, rufen Sie
/media-useauf, um BGM/SFX/Bilder aus dem HeyGen-Katalog und Markenlogos aus offiziellen Quellen zu beziehen. Führen Sie zuerst--adoptaus, um vorhandene Assets zu registrieren. Siehe/media-useSkill. Wenn die Host-App eigene Musik- oder Soundeffekt-Tools bereitstellt, verwenden Sie diese für Musik und Soundeffekte.
PR zu HyperFrames
Verwenden Sie diesen Skill, um einen GitHub-Pull-Request zu erfassen, die Änderung zu verstehen, einen Erklärplan zu erstellen und diesen 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 Beitragenden.
Die Eingangstür ist
/hyperframes. Sie sind der Orchestrator. Führen Sie jeden Schritt aus, überprüfen Sie dessen Tor, und fahren Sie nur dann fort. Dieser Skill ist für einen GitHub-Pull-Request (eine Code-Änderung). Jede andere Absicht, ein bloßes „Video erstellen“ oder Unsicherheit → lesen Sie zuerst/hyperframes– die Intentionsebene besitzt alle Routenentscheidungen, und eine neue Erstellung, die hier ohneBRIEF.mdankommt, durchläuft sie trotzdem (Eröffnungsregel der Einrichtung).
Sie sind der Orchestrator. Arbeiten Sie im aufgelösten externen PROJECT_DIR, niemals standardmäßig im Aufrufer-Repository. Führen Sie die Schritte in Reihenfolge aus und bestehen Sie jedes Tor, bevor Sie fortfahren. Benutzergesteuerte Schritte sind Schritt 0, Schritt 3 und Schritt 6. Lesen Sie ../hyperframes/references/brief-contract.md vor Schritt 0 – es definiert die Tortypen und wie flow/storyboard in BRIEF.md den Modus ableiten, der die Tore der Schritte 3/4/6 bestimmt. Führen Sie jeden Schritt selbst aus, außer Schritt 5, wo Sie einen begrenzten Pool von Frame-Arbeitern entsenden. Fügen Sie hier keine Design- oder Bewegungsregeln ein; diese leben im Frame-Worker-Sub-Agenten, in den lokalen ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/ und hyperframes-creative dieses Skills.
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
Ziel: Mit einem bestätigten Brief einsteigen – einschließlich der PR-Referenz (eine vollständige URL, eine <owner>/<repo>#<N>-Referenz oder „dieser PR“ in einem ausgecheckten Repository) – das HyperFrames-Projekt erstellen und den Brief dauerhaft machen. Der Stil ist immer Code-redaktionell (festgelegt in Schritt 2, nie gefragt).
Der Brief wird von der Intentionsebene bestätigt, nicht durch hier gestellte Fragen. Öffnungsregel, in der Reihenfolge: (1) BRIEF.md existiert → lesen und nichts fragen – der Brief ist festgelegt, und sein flow/storyboard leiten den Modus ab (Briefvertrag § 1). (2) Kein BRIEF.md, aber das Projekt existiert (hyperframes.json / STORYBOARD.md auf Disk) → fortsetzen vom Frontmatter des Storyboards und den aufgezeichneten Präferenzen; ein halbfertiges Projekt nie erneut befragen. (3) Weder – eine frische Erstellungsanfrage, die direkt hier angekommen ist → /hyperframes lesen und dessen Intentionsebene (references/intent-interview.md) ausführen: es überprüft Rezepte und gespeicherte Standardwerte 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 dies vollständig – gehen Sie zur Bearbeitung.
Lösen Sie das Projektverzeichnis auf, bevor Sie andere Arbeiten ausführen. Bewahren Sie ein vom Benutzer bereitgestelltes Projektverzeichnis; verwenden Sie andernfalls den dauerhaften externen Cachespeicherort, den der Auflöser ausgibt. Erstellen Sie 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-Projekt: $PROJECT_DIR"
node <SKILL_DIR>/scripts/preflight.mjs
Die Fähigkeitsvorprüfung läuft vor dem Abrufen, der Story-Arbeit, dem Audio oder der Frame-Verteilung. Wenn die installierte CLI den für diesen Skill erforderlichen Validierungsbefehl nicht ausführen kann, stoppen Sie mit der Upgrade-Anweisung, anstatt den Kontext dieser Ausführung zuerst zu verbrauchen.
Nur initialisieren, wenn $PROJECT_DIR/hyperframes.json fehlt. Sein Basisname stammt von der PR, z. B. acme-sdk-pr-1842; niemals den Arbeitsbereichsnamen oder einen Zeitstempel verwenden.
npx hyperframes init "$PROJECT_DIR" --non-interactive --example=blank --skill=pr-to-video – init überprüft die installierten Skills gegen die neuesten auf GitHub und aktualisiert den globalen Satz, falls welche veraltet sind.
Jeder relative Pfadbefehl unten wird mit $PROJECT_DIR als Arbeitsverzeichnis ausgeführt. Beispiele ohne explizite Subshell bedeuten (cd "$PROJECT_DIR" && …); ändern Sie niemals den Arbeitsbaum des Aufrufer-Repositorys.
Schreiben Sie BRIEF.md sofort nach der Initialisierung (niemals davor – init lehnt ein nicht leeres Verzeichnis ab): den gesperrten Brief der Intentionsebene, Form gemäß ../hyperframes/references/brief-format.md. Lösen Sie <MEDIA_DIR> als das installierte /media-use Skill-Verzeichnis auf. Zeichnen Sie dann jede präferenzgesicherte Antwort mit node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes . auf (brief-format.md nennt die Teilmenge). Wenn die Intentionsebene ein Rezept übernommen hat, führen Sie 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 Skelettentwürfe zurück, die Schritt 3 erstellt. Ein Rezept füllt Antworten, keine Genehmigungen; die Überprüfungstore laufen trotzdem.
Zeigen Sie den Anmeldestatus an, bevor Sie die Einrichtung verlassen – führen Sie npx hyperframes auth status aus und geben Sie seine Ausgabe wörtlich weiter. Es meldet, ob Sprach/BGM HeyGen oder lokale Engines verwendet, und, wenn abgemeldet, wie man sich anmeldet. Wenden Sie einen Zweig an:
- Kollaborativ: Warten Sie, bis der Benutzer sich anmeldet oder explizit
offline/gowählt. - Autonom: Teilen Sie den Status mit und fahren Sie über die verfügbaren lokalen Engines fort.
Übergehen Sie nicht stillschweigend eine erforderliche Fähigkeit, wenn kein Offline-Anbieter existiert; machen Sie den Blockierer sichtbar. Falten Sie diese Entscheidung nicht in eine andere Frage oder schreiben Sie Schlüssel in ein Pro-Repo .env. Auth-Eigentum und Offline-Fallback: /media-use references/setup-providers.md § Anbieter.
Tor: hyperframes.json und BRIEF.md existieren; die PR-Referenz ist im Brief erfasst; die präferenzgesicherten Antworten wurden aufgezeichnet (Briefvertrag § 2); der Anmeldestatus wurde angezeigt (angemeldet oder Offline-Fortsetzung).
Schritt 1: Erfassen des PR (keine Aufnahme)
Ziel: Die Fakten des PR abrufen und als Informationsquelle in das Projekt einbinden. Es gibt keine Website-Aufnahme. fetch-pr.mjs führt gh deterministisch aus – vervollständigt die Dateiliste über paginierte gh api, damit 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 wird auch eine Best-Effort-shipped_version (+ version_source) in pr.json aufgelöst, damit die Endkarte eine echte Version zitieren kann, anstatt eine zu erfinden. Dann faltet ingest.mjs dies offline in das synthetische Erfassungspaket.
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 abgeschnitten wird), schreibt nur capture/pr.json +
# capture/diff.patch – kein Scratch-Verzeichnis. gh auth / not-found / private Fehler beenden mit Exit 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 (Beitragende, 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 der Personenfront – lade den GitHub-Avatar jedes Beitragenden herunter zu
# assets/<login>.png für den Credits-Abspann. Best-Effort; immer Exit 0.
(cd "$PROJECT_DIR" && node <SKILL_DIR>/scripts/fetch-people-avatars.mjs \
--people ./capture/extracted/people.json)
Wenn fetch-pr.mjs mit Exit 1 beendet (gh auth / not found / private), melden Sie seinen stderr und stoppen Sie – fälschen Sie keine PR-Inhalte. Wenn ingest.mjs mit Exit 1 beendet, lesen Sie seinen stderr (normalerweise eine fehlerhafte pr.json), beheben Sie es und führen Sie es erneut aus (deterministisch). fetch-people-avatars.mjs endet immer mit Exit 0; fehlende Avatare bedeuten nur keinen Credits-Abspann zum Autor.
people.json führt einen name für die Beitragenden, die gh bereits benannt hat (PR-Autor, Commit-Autoren, mergedBy) – null für den Rest (Reviewer/Kommentatoren/Zugewiesene, die gh pr view nur als bloßen login liefert). Bevor Sie den Credits-Abspann in Schritt 3 schreiben, lösen Sie selbst null-Namen für die 1-6 Personen auf, die tatsächlich auf diesem Frame erscheinen: gh api users/<login> --jq .name (Sie haben bereits gh – kein Skript erforderlich). Wenn GitHub auch keinen öffentlichen Namen für diesen Benutzer hat, fallen Sie auf den Login auf dem Bildschirm zurück und lassen Sie diese Person aus der gesprochenen Zeile fallen (siehe story-design.md Abschnitt Credits – der Voiceover muss dennoch 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; Sie können die Änderung des PR in einem klaren Satz angeben. assets/<login>.png ist Best-Effort – seine Abwesenheit ist kein Fehler.
Schritt 2: Designsystem
Ziel: Die Code-editorial-Frame-Voreinstellung übernehmen; ein Skript wandelt sie in das frame.md + Caption-Skin dieses Videos um.
Der Stil ist festgelegt – Code-editorial (warm redaktionell; eine marineblaue Code-Oberfläche für Diffs gebaut). Führen Sie aus:
node <SKILL_DIR>/scripts/build-frame.mjs --preset code-editorial --hyperframes .
Das Skript kopiert die FRAME.md der Code-editorial-Voreinstellung → frame.md, vermischt sie mit etwaigen Markentoken in capture/extracted/tokens.json (ein PR hat keine → colors:[]/fonts:[] behält die eigene Palette der Code-editorial-Einstellung, ein vollständiges Design), kopiert das Caption-Skin der Voreinstellung nach .hyperframes/caption-skin.html und validiert sich selbst (Exit 1 bei einer fehlerhaften Zuordnung). Fahren Sie fort, sobald es mit Exit 0 beendet – keine manuelle Bearbeitung.
Tor: build-frame.mjs wurde mit Exit 0 beendet – frame.md existiert von der Code-editorial-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ärplan verwandeln.
Lesen Sie ../hyperframes-creative/references/story-spine.md (Hooks-Sprache, Wert-vor-Beweis, Storyboard-als-Vorschlag, quellennachvollziehbare Visuals), references/story-design.md, ../hyperframes-animation/blueprints-index.md, ../hyperframes/references/storyboard-format.md und ../hyperframes/references/script-format.md. Verwenden Sie sie, um STORYBOARD.md und, wenn eine Erzählung benötigt wird, SCRIPT.md zu schreiben. Setzen Sie das Frontmatter duration: aus der length des Briefes – eine grobe Erwartung; der Zusammenbau berichtet, wo der Schnitt dagegen landet.
Verwenden Sie story-design.md für den PR-Archetyp (Changelog / Feature-Enthüllung / Fix-Erklärung / Refaktorisierungs-Walkthrough), die PR-nativen Frame-Typen, Hook, persuasion, Beats, das Pro-Frame-Wortbudget und den Credits-Abspann. Die Reihenfolge kommt aus dem narrativen Design, nicht der Dateireihenfolge des Diffs – erklären Sie die Änderung, lesen Sie das Diff nicht laut vor. Als weiche Richtlinie konsultieren Sie die Rollen→Blueprint-Menü in ../hyperframes-animation/blueprints-index.md: Schreiben Sie für jeden Beat den Voiceover in der Form, die sein Kandidat-Blueprint impliziert, und taggen Sie diesen Kandidaten mit blueprint: id, wenn einer passt (die Story-Wahrheit entscheidet dennoch, welche Beats existieren – erzwingen Sie niemals einen Beat, um in eine Form zu passen). Zeigen Sie 2–4 echte Diff-Hunks (aus capture/diff.patch), jedes ein kleines lesbares Snippet; nennen Sie den code-*-Block, den jeder im scene des Frames möchte. Frames tragen keine asset_candidates außer dem credits-Abspann (1–6 assets/<login>.png-Avatare). Verwenden Sie die genauen erforderlichen Felder aus den Storyboard- und Skript-Referenzen.
Nach dem Entwurf führen Sie den Plan-Durchlauf der Überprüfungsschleife – ../hyperframes/references/review-loop.md § 1: präsentieren Sie den Plan als Vorschlag und stellen Sie die zwei Fragen – genehmigen oder ändern, und Skizzen zuerst (empfohlen) oder überspringen. Feedback kommt als Chat-Antwort; wiederholen Sie die Schleife bis zur Genehmigung. Dies ist ein Kontrollpunkt-Tor (Briefvertrag § 1): im autonomen Modus gibt es nichts zu fragen – posten Sie dieselbe Zusammenfassung als Vorabinformation und fahren Sie fort; Skizzen werden in den Bau integriert, und die endgültige Vorschau mit ihrer einen Frage kommt in 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 Vorabinformation gepostet).
Schritt 3.1: Audio
Ziel: Erzählung, Wort-Zeitsteuerung, Musik und Audio-Metadaten aus dem genehmigten Skript generieren.
Starte Audio nach der Genehmigung von Schritt 3. Führe es im Hintergrund aus und fahre dann mit Schritt 4 fort.
Wählen Sie die Erzählstimme aus der Anfrage des Benutzers vor dem Aufruf. Wenn die Anfrage eine Stimme, ein Geschlecht oder einen Tonfall genannt hat, wählen Sie eine passende Stimmen-ID und übergeben Sie sie mit --voice <id>. Der Pipeline-Standard ist ansonsten Marcia (weiblich) auf HeyGen / am_michael auf Kokoro – eine Anfrage wie „eine männliche Stimme“ wird also stillschweigend ignoriert, es sei denn, Sie übergeben das Flag. Stimmen-IDs sind anbieterspezifisch; lösen Sie sie gegen den Anbieter auf, den der Anmeldestatus von Schritt 0 ausgewählt hat: 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