Plugin-Installation: Befolgen Sie vor Setup- oder Aktualisierungsbefehlen die Plugin-Ausführungsregeln, wenn dieses Skill innerhalb eines HyperFrames-Plugins verwendet wird. Bei eigenständigen Installationen behalten Sie die folgenden Update-Anweisungen bei.
Zuerst: Halten Sie dieses Skill aktuell – bestätigen Sie mit dem Benutzer vor der Ausführung:
npx hyperframes skills update pr-to-video. Ein schneller No-Op, wenn alles auf dem neuesten Stand ist; andernfalls wird dieses Skill zusammen mit den Kern-Domain-Skills, von denen es abhängt, aktualisiert, bevor Sie darauf vertrauen.
media-use: Bevor Sie Audio/Bilder/Logos beschaffen, 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.
PR zu HyperFrames
Verwenden Sie dieses Skill, um einen GitHub Pull Request zu verarbeiten, die Änderung zu verstehen, einen Erklärplan für die Code-Änderung zu erstellen und ihn Bild für Bild 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.
Die Eingangstür ist
/hyperframes. Sie sind der Orchestrator. Führen Sie jeden Schritt aus, überprüfen Sie sein Gate, und fahren Sie erst danach fort. Dieses Skill ist für einen GitHub Pull Request (eine Code-Änderung). Bei jeder anderen Absicht, einem bloßen „Video erstellen“ oder bei Unsicherheit → lesen Sie zuerst/hyperframes– die Intent-Schicht entscheidet über jede Routenentscheidung, und eine neue Erstellung, die hier ohneBRIEF.mdankommt, durchläuft sie ohnehin (Setups Startregel).
Sie sind der Orchestrator. Arbeiten Sie im aufgelösten externen PROJECT_DIR, niemals standardmäßig im Aufrufer-Repository. Führen Sie die Schritte der Reihe nach aus und passieren Sie jedes Gate, 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 Gatestypen und wie flow/storyboard aus der BRIEF.md den Modus ableiten, der die Gates in Schritt 3/4/6 steuert. Führen Sie jeden Schritt selbst aus, außer Schritt 5, bei dem Sie einen begrenzten Pool von Frame-Workern einsetzen. Fügen Sie hier keine Design- oder Bewegungsregeln ein; diese leben im Frame-Worker-Subagenten, in den lokalen ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/ des 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/Skript → STORYBOARD.md und SCRIPT.md; Schritt 3.1 Audio → audio_meta.json; Schritt 4 Visuelles Design → angereicherte STORYBOARD.md; Schritt 5 Frames → compositions/frames/NN-*.html und index.html; Schritt 6 Finaler Render → renders/video.mp4.
Schritt 0: Setup
Ziel: Starten Sie mit einem bestätigten Brief – einschließlich des PR-Verweises (eine vollständige URL, ein <owner>/<repo>#<N>-Verweis oder „diesen PR“ in einem ausgecheckten Repository) – erstellen Sie das HyperFrames-Projekt und machen Sie den Brief dauerhaft. Der Stil ist immer code-editorial (in Schritt 2 festgelegt, niemals abgefragt).
Der Brief wird von der Intent-Schicht bestätigt, nicht durch hier gestellte Fragen. Startregel, in dieser Reihenfolge: (1) BRIEF.md existiert → lesen Sie ihn und fragen Sie nichts – der Brief ist abgeschlossen, und sein flow/storyboard leiten den Modus ab (Briefvertrag § 1). (2) Keine BRIEF.md, aber das Projekt existiert (hyperframes.json / STORYBOARD.md auf der Festplatte) → setzen Sie die Arbeit mit dem Frontmatter des Storyboards und den aufgezeichneten Präferenzen fort; befragen Sie ein halbfertiges Projekt nicht erneut. (3) Weder noch – eine frische Erstellungsanfrage, die direkt hier ankam → lesen Sie /hyperframes und führen Sie seine Intent-Schicht aus (references/intent-interview.md): sie prüft Rezepte und gespeicherte Standardeinstellungen und führt die Fragen dieser Route durch – einschließlich der PR-Größe-zu-Länge-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 – führen Sie die Bearbeitung durch.
Lösen Sie das Projektverzeichnis auf, bevor Sie andere Arbeiten ausführen. Bewahren Sie ein vom Benutzer angegebenes Projektverzeichnis; verwenden Sie andernfalls den dauerhaften externen Cache-Speicherort, der vom Resolver ausgegeben wird. 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ähigkeitsprüfung (Preflight) läuft vor dem Abruf, der Story-Arbeit, dem Audio oder dem Frame-Versand. Wenn die installierte CLI den für dieses Skill erforderlichen Validierungsbefehl nicht ausführen kann, halten Sie mit der Upgrade-Anweisung an, anstatt zuerst den Kontext des Laufs zu verbrauchen.
Initialisieren Sie nur, wenn $PROJECT_DIR/hyperframes.json fehlt. Sein Basisname kommt vom PR, z. B. acme-sdk-pr-1842; verwenden Sie 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 mit den neuesten 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" && …); ändern Sie niemals den Arbeitsbaum des Aufrufer-Repositorys.
Schreiben Sie BRIEF.md sofort nach der Initialisierung (niemals davor – init verweigert ein nicht leeres Verzeichnis): den gesperrten Brief der Intent-Schicht, in der 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äferenzgestützte Antwort mit node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes . auf (brief-format.md benennt die Teilmenge). Wenn die Intent-Schicht ein Rezept übernommen hat, führen Sie node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes . --name <name> aus; es kopiert seine frame.md in das Projekt (Schritt 2 wird dann übersprungen) und gibt die Gerüste zurück, von denen Schritt 3 Entwürfe erstellt. Ein Rezept füllt Antworten, nicht Genehmigungen; die Überprüfungsgates laufen dennoch.
Zeigen Sie den Anmeldestatus vor dem Fortfahren nach Setup an – führen Sie npx hyperframes auth status aus und geben Sie seine Ausgabe wörtlich weiter. Es meldet, ob Sprache/BGM HeyGen oder lokale Engines verwendet und, falls abgemeldet, wie man sich anmeldet. Wenden Sie einen Zweig an:
- Kollaborativ: Warten Sie, bis der Benutzer sich anmeldet oder explizit
offline/gowählt. - Autonom: Geben Sie den Status an und fahren Sie mit den verfügbaren lokalen Engines fort.
Übergehen Sie nicht stillschweigend eine erforderliche Fähigkeit, wenn kein Offline-Anbieter vorhanden ist; machen Sie den Blocker sichtbar. Falten Sie diese Entscheidung nicht in eine andere Frage und schreiben Sie keine Schlüssel in ein per-Repo .env. Auth-Besitz und Offline-Fallbacks: /media-use references/setup-providers.md § Anbieter.
Gate: hyperframes.json und BRIEF.md existieren; der PR-Verweis 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: Rufen Sie die Fakten des PR ab und integrieren Sie sie in das Projekt als Informationsquelle. Es gibt keine Website-Erfassung. fetch-pr.mjs führt gh deterministisch aus – vervollständigt die Dateiliste über paginiertes 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 GEMERGED PRs wird auch eine bestmögliche shipped_version (+ version_source) in pr.json aufgelöst, sodass die Endkarte eine echte Version anstelle einer erfundenen nennen kann. Dann integriert ingest.mjs das offline in das synthetische Erfassungspaket.
PR="<url | owner/repo#N | N>"
# PR deterministisch abrufen: führt gh aus, vervollständigt die Dateiliste über paginiertes
# 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 führen hier zu exit 1.
(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 – laden Sie den GitHub-Avatar jedes Mitwirkenden
# nach assets/<login>.png für den Credits-Abspann herunter. Best-Effort; endet immer mit 0.
(cd "$PROJECT_DIR" && node <SKILL_DIR>/scripts/fetch-people-avatars.mjs \
--people ./capture/extracted/people.json)
Wenn fetch-pr.mjs mit exit 1 endet (gh auth / not found / private), melden Sie seinen stderr und halten Sie an – erfinden Sie keine PR-Inhalte. Wenn ingest.mjs mit exit 1 endet, lesen Sie seinen stderr (normalerweise ein fehlerhaftes pr.json), beheben Sie es und führen Sie es erneut aus (deterministisch). fetch-people-avatars.mjs endet immer mit 0; fehlende Avatare bedeuten lediglich, dass kein Credits-Abspann für den Autor erfolgt.
people.json enthält einen name für diejenigen Mitwirkenden, die gh bereits benannt hat (der PR-Autor, Commit-Autoren, mergedBy) – null für den Rest (Reviewer/Kommentatoren/Zugewiesene, welche gh pr view nur als bloßen login liefert). Lösen Sie vor dem Schreiben des Credits-Abspanns in Schritt 3 jeden null-Namen für die 1-6 Personen auf, die tatsächlich auf diesem Frame erscheinen werden: gh api users/<login> --jq .name (Sie haben bereits gh – kein Skript dafür nötig). Wenn GitHub auch für diesen Benutzer keinen öffentlichen Namen hat, fallen Sie auf dem Bildschirm auf den Login zurück und lassen Sie diese Person aus der gesprochenen Zeile weg (siehe den Credits-Abschnitt in storry-design.md – der Voiceover muss dennoch Namen sagen, niemals rohe Handles).
Gate: 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 – sein Fehlen ist kein Fehler.
Schritt 2: Designsystem
Ziel: Übernehmen Sie die Code-Editorial-Frame-Voreinstellung; ein Skript wandelt sie in die frame.md + Caption-Skin dieses Videos um.
Der Stil ist festgelegt – code-editorial (warm, editorial; eine marineblaue Code-Oberfläche, gebaut für Diffs). 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 allen Marken-Token in capture/extracted/tokens.json (ein PR hat keine → colors:[]/fonts:[] behält die eigene Palette der code-editorial-Voreinstellung, ein vollständiges Design), kopiert den Caption-Skin der Voreinstellung nach .hyperframes/caption-skin.html und validiert sich selbst (exit 1 bei einer defekten Zuordnung). Fahren Sie fort, sobald es mit exit 0 endet – keine manuelle Bearbeitung.
Gate: build-frame.mjs endete mit exit 0 – frame.md existiert von der code-editorial-Voreinstellung, und .hyperframes/caption-skin.html existiert als Caption-Skin-Quelle.
Schritt 3: Storyboard und Skript
Ziel: Verwenden Sie den PR in einen genehmigten Frame-für-Frame-Erklärplan.
Lesen Sie ../hyperframes-creative/references/story-spine.md (Hook-Sprache, Wert-vor-Beweis, Storyboard-als-Vorschlag, quellnachvollziehbare 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 Briefs – eine grobe Erwartung; der Zusammenbau meldet, wo der Schnitt dagegen landet.
Verwenden Sie story-design.md für den PR-Archetyp (Changelog / Feature-Enthüllung / Fix-Erklärung / Refaktor-Walkthrough), die PR-nativen Frame-Typen, Hook, Überzeugungskraft, Beats, das Wortbudget pro Frame und den Credits-Abspann. Die Reihenfolge ergibt sich aus dem narrativen Design, nicht der Dateireihenfolge des Diffs – erklären Sie die Änderung, lesen Sie den Diff nicht vor. Als weiche Richtlinie konsultieren Sie die Rolle→Blueprint-Menü in ../hyperframes-animation/blueprints-index.md: Schreiben Sie für jeden Beat den Voiceover in der Form, die sein Kandidaten-Blueprint impliziert, und taggen Sie diese Kandidaten-ID blueprint:, wenn eine 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), jeweils ein kleines lesbares Snippet; nennen Sie den code-*-Block, den jeder in der scene des Frames haben soll. 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 Review-Durchlauf des Plan-Passes durch – ../hyperframes/references/review-loop.md § 1: Präsentieren Sie den Plan als Vorschlag und stellen Sie die beiden Fragen – genehmigen oder ändern, und zuerst Skizzen (empfohlen) oder überspringen. Feedback kommt als Chat-Antwort; Schleife bis zur Genehmigung. Dies ist ein Kontrollpunkt-Gate (Briefvertrag § 1): Im autonomen Modus gibt es nichts zu fragen – posten Sie dieselbe Zusammenfassung als Vorankündigung und fahren Sie fort; Skizzen werden in den Build integriert, und die endgültige Vorschau mit ihrer einen Frage kommt bei Schritt 6.
Gate: 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: Generieren Sie Erzählung, Wortzeitsteuerung, Musik und Audio-Metadaten aus dem genehmigten Skript.
Starten Sie Audio nach der Genehmigung von Schritt 3. Führen Sie es im Hintergrund aus und fahren Sie dann mit Schritt 4 fort.
Wählen Sie die Erzählstimme basierend auf der Anfrage des Benutzers aus, bevor Sie aufrufen. Wenn die Anfrage eine Stimme, ein Geschlecht oder einen Ton benannt 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 anbieterabhängig; 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 der Benutzer keine Präferenz geäußert hat, fallen Sie auf die gespeicherte Stimme zurück (Briefvertrag § 2), bevor Sie die Pipeline-Standardeinstellung verwenden.