Plugin-Installation: Befolgen Sie vor der Einrichtung oder Aktualisierung die Plugin-Ausführungsregeln, wenn dieser Skill innerhalb eines HyperFrames-Plugins ausgeführt wird. Bei eigenständigen Installationen gelten die unten stehenden Aktualisierungshinweise.
Halten Sie diesen Skill zunächst aktuell – bestätigen Sie mit dem Benutzer vor der Ausführung:
npx hyperframes skills update pr-to-video. Eine schnelle Operation ohne Änderungen, wenn alles auf dem neuesten Stand ist; andernfalls wird dieser Skill und die Kern-Domain-Skills, von denen er abhängt, aktualisiert, bevor Sie sich auf sie verlassen.
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 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 Erfassungsschritt und keine echten Assets außer den Avataren der Mitwirkenden.
Der Einstiegspunkt ist
/hyperframes. Sie sind der Orchestrator. Führen Sie jeden Schritt aus, überprüfen Sie sein Tor, und fahren Sie dann fort. Dieser Skill ist für einen GitHub Pull Request (eine Code-Änderung) gedacht. Bei jeder anderen Absicht, einem bloßen „Video erstellen“ oder bei Unsicherheit → lesen Sie zuerst/hyperframes– die Absichts-Ebene besitzt jede Routenentscheidung, und eine frische Erstellung, die hier ohneBRIEF.mdankommt, durchläuft sie trotzdem (Einrichtungs-Regel).
Sie sind der Orchestrator. Arbeiten Sie im aufgelösten externen PROJECT_DIR, niemals standardmäßig im Aufrufer-Repository. Führen Sie die Schritte in der Reihenfolge aus und passieren 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 BRIEF.md's flow/storyboard den Modus ableiten, der die Tore von Schritt 3/4/6 steuert. Führen Sie jeden Schritt selbst aus, außer Schritt 5, wo Sie einen begrenzten Pool von Frame-Workern entsenden. Platzieren Sie keine Design- oder Bewegungsregeln hier; diese leben im Frame-Worker-Sub-Agenten, den lokalen ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/ und hyperframes-creative des 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 beginnen – einschließlich des PR-Verweises (eine vollständige URL, ein <Besitzer>/<Repository>#<N>-Verweis oder „diesen PR“ in einem ausgecheckten Repository) – das HyperFrames-Projekt erstellen und den Brief dauerhaft machen. Der Stil ist immer Code-Redaktionell (in Schritt 2 festgelegt, niemals abgefragt).
Der Brief wird von der Absichts-Ebene bestätigt, nicht durch Fragen hier. Öffnungsregel, in der Reihenfolge: (1) BRIEF.md existiert → lesen und nichts fragen – der Brief ist abgeschlossen, und sein flow/storyboard leiten den Modus ab (Brief-Vertrag § 1). (2) Keine BRIEF.md, aber das Projekt existiert (hyperframes.json / STORYBOARD.md auf Diskette) → fortsetzen vom Frontmatter des Storyboards und den aufgezeichneten Präferenzen; niemals ein halbfertiges Projekt erneut befragen. (3) Weder noch – eine frische Erstellungsanfrage, die direkt hier ankommt → /hyperframes lesen und die Absichts-Ebene ausführen (references/intent-interview.md): sie ü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 – gehen Sie zur Bearbeitung.
Lösen Sie das Projektverzeichnis auf, bevor Sie andere Arbeiten durchführen. Behalten Sie ein vom Benutzer angegebenes Projektverzeichnis bei; andernfalls verwenden Sie 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 project: $PROJECT_DIR"
node <SKILL_DIR>/scripts/preflight.mjs
Die Fähigkeitsvorabprüfung läuft vor dem Abruf, 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 der Ausführung zu verbrauchen.
Initialisieren Sie nur, wenn $PROJECT_DIR/hyperframes.json fehlt. Sein Basisname stammt vom PR, z. B. acme-sdk-pr-1842; verwenden Sie niemals den Arbeitsbereichsnamen oder einen Zeitstempel.
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 einer veraltet ist.
Jeder relative Pfadbefehl unten wird mit $PROJECT_DIR als seinem Arbeitsverzeichnis ausgeführt. Beispiele ohne explizite Subshell bedeuten (cd "$PROJECT_DIR" && …); ändern Sie niemals den Arbeitsbaum des Aufrufer-Repositories.
Schreiben Sie BRIEF.md sofort nach der Initialisierung (niemals davor – init lehnt ein nicht leeres Verzeichnis ab): den gesperrten Brief der Absichts-Ebene, Form nach ../hyperframes/references/brief-format.md. Lösen Sie <MEDIA_DIR> als das installierte /media-use-Skillverzeichnis auf. Zeichnen Sie dann jede präferenzgestützte Antwort mit node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes . auf (brief-format.md nennt die Teilmenge). Wenn die Absichts-Ebene 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 Skelett-Entwürfe zurück, aus denen Schritt 3 erstellt. Ein Rezept füllt Antworten, nicht Genehmigungen; die Überprüfungstore laufen trotzdem.
Zeigen Sie den Anmeldestatus an, bevor Sie die Einrichtung fortsetzen – führen Sie npx hyperframes auth status aus und geben Sie die Ausgabe wörtlich weiter. Es meldet, ob Sprachausgabe/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: 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 existiert; zeigen Sie das Hindernis an. Falten Sie diese Entscheidung nicht in eine andere Frage oder schreiben Sie Schlüssel in eine pro-Repo .env. Authentifizierungsinhaberschaft und Offline-Fallback: /media-use references/setup-providers.md § Anbieter.
Tor: hyperframes.json und BRIEF.md existieren; der PR-Verweis ist im Brief erfasst; die präferenzgestützten Antworten wurden aufgezeichnet (Brief-Vertrag § 2); der Anmeldestatus wurde angezeigt (angemeldet oder Fortsetzung offline).
Schritt 1: PR erfassen (keine Aufnahme)
Ziel: Die Fakten des PR abrufen und als Informationsquelle in das Projekt einfließen lassen. Es gibt keine Website-Aufnahme. 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 temporäres Verzeichnis). Bei ZUSAMMENGEFÜHRTEN PRs wird auch eine bestmögliche shipped_version (+ version_source) in pr.json aufgelöst, damit die Endkarte eine echte Version angeben 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 paginiertes
# gh api (damit ein großer PR nicht bei ~100 Dateien abgeschnitten wird), schreibt nur capture/pr.json +
# capture/diff.patch — kein temporäres Verzeichnis. gh auth / not-found / private-Fehler beenden mit 1 hier.
(cd "$PROJECT_DIR" && node <SKILL_DIR>/scripts/fetch-pr.mjs --pr "$PR" --out-dir ./capture)
# Offline-Transformation → capture/extracted/{tokens.json (Farben:[] → Code-Redaktionelle 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 Personen-Teil – ein Netzwerkschritt – laden Sie den GitHub-Avatar jedes Mitwirkenden herunter zu
# assets/<login>.png für den Credits-Abspann. Best-Effort; beendet immer mit 0.
(cd "$PROJECT_DIR" && node <SKILL_DIR>/scripts/fetch-people-avatars.mjs \
--people ./capture/extracted/people.json)
Wenn fetch-pr.mjs mit 1 beendet (gh auth / not found / private), melden Sie seinen stderr und stoppen Sie – erfinden Sie keine PR-Inhalte. Wenn ingest.mjs mit 1 beendet, lesen Sie seinen stderr (normalerweise eine fehlerhafte pr.json), beheben Sie den Fehler und führen Sie es erneut aus (deterministisch). fetch-people-avatars.mjs beendet immer mit 0; fehlende Avatare bedeuten nur keinen Credits-Abspann für den Autor.
people.json trägt einen name für die Mitwirkenden, die gh bereits benannt hat (der PR-Autor, Commit-Autoren, mergedBy) – null für den Rest (Reviewer/Kommentatoren/Beauftragte, denen gh pr view nur einen bloßen login gibt). Bevor Sie den Credits-Abspann in Schritt 3 schreiben, lösen Sie alle null-Namen selbst für die 1-6 Personen auf, die tatsächlich in diesem Frame erscheinen werden: gh api users/<login> --jq .name (Sie haben bereits gh – kein Skript dafür nötig). Wenn GitHub für diesen Benutzer ebenfalls keinen öffentlichen Namen hat, fallen Sie auf dem Bildschirm auf den Login zurück und entfernen Sie diese Person aus der gesprochenen Zeile (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-Redaktionelle Frame-Voreinstellung übernehmen; ein Skript verwandelt sie in das frame.md + Beschriftungs-Skin dieses Videos.
Der Stil ist festgelegt – Code-Redaktionell (warm redaktionell; eine marineblaue Code-Oberfläche, die für Diffs entwickelt wurde). Führen Sie aus:
node <SKILL_DIR>/scripts/build-frame.mjs --preset code-editorial --hyperframes .
Das Skript kopiert die Code-Redaktionelle Voreinstellung FRAME.md → frame.md, remixt es auf alle Markentoken in capture/extracted/tokens.json (ein PR hat keine → colors:[]/fonts:[] behält die eigene Palette der Code-Redaktionellen, ein vollständiges Design), kopiert das Beschriftungs-Skin der Voreinstellung nach .hyperframes/caption-skin.html und validiert sich selbst (beendet mit 1 bei einer defekten Zuordnung). Fahren Sie fort, sobald es mit 0 beendet – keine manuelle Bearbeitung.
Tor: build-frame.mjs wurde mit 0 beendet – frame.md existiert von der Code-Redaktionellen Voreinstellung und .hyperframes/caption-skin.html existiert als Quelle des Beschriftungs-Skins.
Schritt 3: Storyboard und Skript
Ziel: Den PR in einen genehmigten Frame-für-Frame-Erklärungsplan umwandeln.
Lesen Sie ../hyperframes-creative/references/story-spine.md (Haken-Sprache, Wert-vor-Beweis, Storyboard-als-Vorschlag, quellennachvollziehbare Visualisierungen), 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 erforderlich ist, SCRIPT.md zu schreiben. Setzen Sie die duration: im Frontmatter aus der length des Briefs – eine grobe Erwartung; der Zusammenbau berichtet, wo der Schnitt im Vergleich dazu landet.
Verwenden Sie story-design.md für den PR-Archätyp (Changelog / Feature-Reveal / Fix-Explainer / Refaktor-Walkthrough), die PR-nativen Frametypen, Haken, Überzeugung, Beats, das Wortbudget pro Frame und den Credits-Abspann. Die Reihenfolge stammt aus dem narrativen Design, nicht der Dateireihenfolge des Diffs – erklären Sie die Änderung, lesen Sie nicht den Diff 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 Kandidaten-Blueprint impliziert, und taggen Sie diesen Kandidaten mit der 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 jedes in der scene des Frames haben soll. Frames tragen keine asset_candidates außer dem credits-Abschluss (1–6 assets/<login>.png Avatare). Verwenden Sie die genauen erforderlichen Felder aus den Storyboard- und Skript-Referenzen.
Führen Sie nach dem Entwurf den Überprüfungsdurchlauf der Planungsphase durch – ../hyperframes/references/review-loop.md § 1: Präsentieren Sie den Plan als Vorschlag und stellen Sie die beiden Fragen – genehmigen oder ändern, und Skizzen zuerst (empfohlen) oder überspringen. Feedback kommt als Chat-Antwort; wiederholen Sie den Vorgang, bis genehmigt. Dies ist ein Kontrollpunkttor (Brief-Vertrag § 1): Im autonomen Modus gibt es nichts zu fragen – posten Sie dieselbe Zusammenfassung als Vorankündigung und fahren Sie fort; Skizzen fallen in den Bau, und die finale 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 erforderlich ist, und der Benutzer hat den Plan genehmigt (autonom: die Zusammenfassung wurde als Vorankündigung gepostet).
Schritt 3.1: Audio
Ziel: Erzählung, Wortzeitsteuerung, Musik und Audio-Metadaten aus dem genehmigten Skript generieren.
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 aus der Anfrage des Benutzers, bevor Sie aufrufen. Wenn die Anfrage eine Stimme, ein Geschlecht oder einen Ton benannt hat, wählen Sie eine passende Stimmen-ID aus und übergeben Sie sie mit --voice <id>. Die 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 (Brief-Vertrag § 2), bevor Sie die Pipeline-Standard verwenden.
Der Inhalt wurde aus Gründen der Übersetzungsanforderung gekürzt. Der vollständige Skill-Markdown würde die restlichen Schritte (Schritt 4: Visuelles Design, Schritt 5: Frames, Schritt 6: Finaler Render) sowie die Referenzen, Rezepte und den vollständigen Review-Loop enthalten.