Plugin-Installationen: Bevor Sie Setup- oder Aktualisierungsbefehle ausführen, befolgen Sie die Plugin-Installationsregeln, wenn sich diese Fähigkeit innerhalb eines HyperFrames-Plugins befindet. Eigenständige Installationen behalten die untenstehenden Aktualisierungsanweisungen bei.
Zuerst: Halten Sie diese Fähigkeit aktuell – bestätigen Sie mit dem Benutzer vor der Ausführung:
npx hyperframes skills update product-launch-video. Ein schneller No-Op, wenn alles aktuell ist; andernfalls aktualisiert es diese Fähigkeit plus die Kern-Domain-Fähigkeiten, von denen sie abhängt, 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 ihren offiziellen Quellen zu beziehen. Führen Sie zuerst--adoptaus, um vorhandene Assets zu registrieren. Siehe/media-use-Fähigkeit.
figma-Quelle: Wenn die Quelle eine figma.com-URL ist, führen Sie zuerst
/figmaaus – Asset-Export, Marken-Tokens und Komponenten/Storyboard-Rekonstruktion falls nötig – und bauen Sie dann diesen Workflow aus dessen Ausgabe auf. Treiben Sie Figma nicht direkt mit rohen MCP-Tools: Das überspringt die SVG-Bereinigung, die.media/manifest.jsonl-Herkunft und dievar()-Bindung von Marken-Tokens, sodass eine spätere Markenänderung nicht ohne vollständigen Neuimport propagiert werden kann.
Produkteinführung in HyperFrames
Verwenden Sie diese Fähigkeit, um ein Produkt zu erfassen, seine Marke zu verstehen, ein Einführungsvideo zu planen und es Bild für Bild in HyperFrames zu erstellen.
Der Eingang ist
/hyperframes. Sie sind der Orchestrator. Führen Sie jeden Schritt aus, überprüfen Sie sein Gate und fahren Sie erst dann mit dem nächsten Schritt fort. Diese Fähigkeit ist für ein Produkt, das vermarktet, eingeführt, beworben oder enthüllt wird, einschließlich Anfragen wie „Werbung für unsere Website“, wenn der Zweck werblich ist. Eine Website-Tour/Präsentationsanfrage bleibt ebenfalls hier:BRIEF.mdtransportiert die „Zeig es, wie es ist“-Absicht, und die erfassten Screenshots werden zu den Assets, die das Video zeigt. Bei jeder anderen Absicht, einem bloßen „Video erstellen“ oder bei Unsicherheit → lesen Sie zuerst/hyperframes– die Absichtsebene trifft alle Routenentscheidungen, und eine frische Erstellung, die hier ohneBRIEF.mdankommt, durchläuft sie trotzdem (Einstiegsregel von Setup).
Sie sind der Orchestrator. Arbeiten Sie in videos/<projekt>/. Führen Sie die Schritte in der Reihenfolge aus und bestehen Sie jedes Gate, bevor Sie fortfahren. Benutzergesteuerte Gates sind Schritt 0, Schritt 3 und Schritt 6. Lesen Sie ../hyperframes/references/brief-contract.md vor Schritt 0 – es definiert die Gate-Typen und wie BRIEF.md's flow/storyboard den Modus ableiten, der die Schritte 3/4/6 Gates regiert. Führen Sie jeden Schritt selbst aus, außer Schritt 5, bei dem Sie einen Unter-Agenten pro Frame entsenden. Platzieren Sie keine Design- oder Bewegungsregeln hier; diese leben im Frame-Worker-Unter-Agenten, den lokalen ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/ dieser Fähigkeit und hyperframes-creative.
Workflow: Schritt 0 Setup -> hyperframes.json; Schritt 1 Erfassung -> capture/; 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 Finales Rendern -> renders/video.mp4.
Schritt 0: Setup
Ziel: Mit einem bestätigten Briefing eintreten, das HyperFrames-Projekt erstellen und das Briefing dauerhaft machen.
Das Briefing wird von der Absichtsebene bestätigt, nicht durch hier gestellte Fragen. Einstiegsregel, in der Reihenfolge: (1) BRIEF.md existiert → lesen Sie es und fragen Sie nichts – das Briefing ist abgeschlossen, und sein flow/storyboard leiten den Modus ab (Briefing-Vertrag § 1). (2) Kein BRIEF.md, aber das Projekt existiert (hyperframes.json / STORYBOARD.md auf der Festplatte) → setzen Sie vom Frontmatter des Storyboards und den gespeicherten Präferenzen fort fort; befragen Sie ein halbfertiges Projekt niemals erneut. (3) Weder noch – eine frische Erstellungsanfrage, die direkt hier ankommt → lesen Sie /hyperframes und führen Sie dessen Absichtsebene aus (references/intent-interview.md): es prüft Rezepte und gespeicherte Voreinstellungen, führt die Fragen dieser Route durch (../hyperframes/references/routes/product-launch-video.md) und gibt das gesperrte Briefing zurück. Bearbeitungsanfragen überspringen all dies – führen Sie die Bearbeitung durch.
Initialisieren Sie nur, wenn hyperframes.json fehlt. Benennen Sie <projekt> nach der Marke oder Domain in Kebab-Schreibweise, z. B. acme-promo; verwenden Sie niemals den Arbeitsbereichsnamen oder einen Zeitstempel.
npx hyperframes init "videos/<projekt>" --non-interactive --example=blank --skill=product-launch-video – init prüft die installierten Fähigkeiten gegen die neuesten auf GitHub und aktualisiert den globalen Satz, wenn welche veraltet sind.
Setzen Sie nach dem Init <PROJEKT_ROOT> auf videos/<projekt> und führen Sie jeden nachfolgenden relativen Pfadbefehl mit diesem Verzeichnis als Arbeitsverzeichnis aus. In den folgenden Befehlen bedeutet . <PROJEKT_ROOT>; schreiben Sie niemals .media, capture oder Ausgabedateien in das Aufruferverzeichnis.
Schreiben Sie BRIEF.md sofort nach dem Init (niemals davor – init verweigert ein nicht leeres Verzeichnis): das gesperrte Briefing der Absichtsebene, Struktur gemäß ../hyperframes/references/brief-format.md. Lösen Sie <MEDIA_DIR> als das installierte /media-use-Fähigkeitsverzeichnis 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 Absichtsebene 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 Skelette zurück, von denen Schritt 3 Entwürfe erstellt. Ein Rezept füllt Antworten, nicht Genehmigungen; die Überprüfungsgates laufen trotzdem.
Zeigen Sie den Anmeldestatus an, bevor Sie nach dem Setup fortfahren – führen Sie npx hyperframes auth status aus und geben Sie dessen Ausgabe wörtlich weiter. Es meldet, ob Stimme/BGM HeyGen oder lokale Engines verwenden werden und, wenn abgemeldet, wie man sich anmeldet. Beachten Sie den Exit-Code-Vertrag: auth status beendet sich mit 1, wenn nicht angemeldet (und wenn der gespeicherte Berechtigungsnachweis abgelehnt wird) – dieser Exit-Code ungleich Null ist der normale abgemeldete Zustand, kein Befehlsfehler, behandeln Sie ihn also nicht als Fehler, wiederholen Sie ihn nicht und verketten Sie ihn nicht mit &&/set -e auf eine Weise, die den Workflow abbrechen würde. 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.
Verschweigen Sie nicht stillschweigend eine erforderliche Fähigkeit, wenn kein Offline-Anbieter existiert; zeigen Sie das Hindernis auf. Falten Sie diese Entscheidung nicht in eine andere Frage ein und schreiben Sie keine Schlüssel in eine repo-spezifische .env-Datei. Authentifizierungsinhaberschaft und Offline-Fallback: /media-use references/setup-providers.md § Anbieter.
Gate: hyperframes.json und BRIEF.md existieren; die präferenzgestützten Antworten wurden aufgezeichnet (Briefing-Vertrag § 2); der Anmeldestatus wurde angezeigt (angemeldet, oder Offline-Fortsetzung).
Schritt 1: Assets erfassen
Ziel: Das Quellmaterial, Markensignale und brauchbare Assets für das Video sammeln.
Klassifizieren Sie die Eingabe und wählen Sie den Pfad. Explizite URL -> erfassen Sie sie und verwenden Sie die Website für Erzählung und Assets. Eingefügtes Skript/Briefing -> speichern Sie es wörtlich als user_script.txt; VO_MODE (wörtlich oder umstrukturiert) stammt aus BRIEF.md – die Absichtsebene fragt danach, wenn ein Skript ankommt (fragen Sie hier nur einmal, wenn das Briefing es irgendwie vermissen lässt). Lösen Sie dann das Erfassungsziel auf: URL im Text -> verwenden Sie sie; nur Markenname -> WebSearch, bestätigen Sie die URL in einer Zeile, dann crawlen; keine URL/Website (oder das Briefing sagt, nicht zu scrapen) -> No-Capture-Pfad.
Führen Sie die Erfassung aus mit: npx hyperframes capture "<URL>" -o ./capture --json. Behalten Sie das standardmäßige Post-Navigationsbudget bei, es sei denn, der Auftraggeber hat eine kleinere Frist; dann übergeben Sie ein positives --capture-budget <millisekunden>, das Zeit für nachgelagerte Arbeiten lässt. --timeout steuert nur die Seitennavigation. Verwenden Sie --skip-vision nur, wenn die optionale Bildunterschrift absichtlich deaktiviert ist.
Überprüfen Sie das Befehlsergebnis und das Ausgabeverzeichnis sofort. Ein Exit-Code ungleich Null, JSON ok: false oder capture/BLOCKED.md ist ein harter Stopp für den Erfassungspfad: melden Sie den aufgezeichneten Grund und verwenden Sie keine Teilscreenshots, DOM, Tokens oder Assets. Konstruieren Sie keinen synthetischen No-Capture-Fallback nach einer fehlgeschlagenen URL-Erfassung. Fahren Sie nur mit dem No-Capture-Pfad fort, wenn das ursprüngliche Briefing das Quellmaterial bereitgestellt hat oder wenn der Benutzer nach dem Fehler explizit zu einem bereitgestellten Screenshot oder Briefing wechselt.
Warnungen wie „sehr wenig Textinhalt“ zusammen mit einem leeren Asset-Katalog sind kein Beweis für eine brauchbare Seite. Verlangen Sie für eine Website-Tour oder ein „Zeig es, wie es ist“-Briefing eine vertrauenswürdige erfasste Struktur oder einen bereitgestellten Screenshot; wenn keines existiert, stoppen Sie. Erfinden oder bauen Sie die Seite nicht neu, nur weil die Erfassung unbrauchbar ist.
Verwenden Sie für eine Website-Tour oder ein „Zeig es, wie es ist“-Briefing die erfasste Seite als visuelle Quelle der Wahrheit. Verwenden Sie den echten Screenshot anstatt die vollständige Website in HTML neu zu erstellen. Wenn der Screenshot interne Bewegung benötigt, behalten Sie den Screenshot als Basis und überlagern Sie echte erfasste Assets an gemessenen Positionen, oder bauen Sie nur die eine Komponente neu, die sich bewegt. Animieren Sie für einen Scroll-Screenshot den Viewport über capture/screenshots/full-page.png – die 1x-Platte des gesamten Dokuments, pixelgenau für einen 1920 breiten Viewport, der darüber fährt. Diese fehlt, wenn die Seite zu hoch war, um in einem Stück erfasst zu werden; fallen Sie auf die überlappenden Scroll-Positions-Screenshots im selben Verzeichnis zurück. Ein Hineinzoomen über 1:1 hinaus erfordert stattdessen eine eigene 2x-Erfassung dieser Region, da die Platte keinen Spielraum über 1x hinaus hat. Bauen Sie die gesamte Seite nur neu, wenn der Benutzer explizit nach einer stilisierten Interpretation fragt; eine unbrauchbare Erfassung allein ist keine Autorisierung.
Wenn GEMINI_API_KEY, GOOGLE_API_KEY oder ein OpenRouter-Schlüssel existiert, beschriftet die Erfassung automatisch Assets in capture/extracted/asset-descriptions.md. Dies ist kein Überprüfungsgate. Ohne einen Vision-Schlüssel verwenden Sie den DOM-Kontext und fahren Sie fort.
No-Capture-Pfad: Erstellen Sie capture/extracted/tokens.json, capture/extracted/visible-text.txt, capture/extracted/asset-descriptions.md und capture/assets/ manuell. tokens.json sollte { "title": "", "description": "", "colors": [], "fonts": [] } sein; füllen Sie Titel/Beschreibung aus dem Briefing, wenn möglich. visible-text.txt enthält das vollständige Briefing oder Skript. asset-descriptions.md sollte angeben, dass keine Assets erfasst wurden, es sei denn, der Benutzer hat Asset-Notizen gegeben.
Gate: Erfassungs-JSON meldete ok: true; capture/BLOCKED.md existiert nicht; capture/extracted/tokens.json, capture/extracted/visible-text.txt, capture/extracted/asset-descriptions.md und capture/assets/ existieren; und Sie können die Marke in einem klaren Satz angeben. Behandeln Sie asset-descriptions.md als das Haupt-Asset-Inventar. Falls es nach einer echten Erfassung fehlt, stoppen Sie und melden Sie die unvollständige Erfassung. Warnungen über eine degradierte optionale Phase sind nur akzeptabel, wenn dieses strukturelle Gate dennoch bestanden wird.
Schritt 2: Designsystem
Ziel: Eine der ausgelieferten Frame-Vorlagen auswählen; ein Skript verwandelt sie in das frame.md- + Caption-Skin des Videos.
Wenn BRIEF.md einen style_preset benennt – der Benutzer hat ihn im Auge bei den Vorführungen in der Absichtsebene ausgewählt – verwenden Sie ihn; die Beurteilung liegt nur bei Ihnen, wenn das Briefing schweigt. Dann treffen Sie die eine Entscheidung – welches Preset: lesen Sie ../hyperframes-creative/references/design-spec.md und wählen Sie das Preset, dessen Aussehen am besten zur Marke und zum Briefing passt. Führen Sie dann aus:
node <SKILL_DIR>/scripts/build-frame.mjs --preset <name> --hyperframes .
Das Skript erledigt den Rest deterministisch: kopiert das FRAME.md des Presets → frame.md und remixt es auf die Marken-Tokens in capture/extracted/tokens.json (Markenfarben werden nach Rolle den Farb-Schlüsseln des Presets zugeordnet – Tinte, Leinwand, Akzente – wobei Schlüssel/Struktur/Komponenten erhalten bleiben; die Display- + Textschriften des Presets werden durch die der Marke ersetzt), kopiert das Caption-Skin des Presets nach .hyperframes/caption-skin.html und validiert sich selbst (beendet sich mit 1 bei einer fehlerhaften Zuordnung). Fahren Sie mit dem nächsten Schritt fort, sobald es mit 0 beendet ist – keine manuelle Bearbeitung der Spezifikation.
tokens.json ohne Markenfarben/-schriften (z. B. keine Erfassung) → das Skript behält die eigene Palette des Presets, ein vollständig lieferbares Design. Wenn das Briefing Markenfarben/-schriften benennt, die die Erfassung verpasst hat, fügen Sie sie zu capture/extracted/tokens.json hinzu, bevor Sie das Skript ausführen (oder verwenden Sie das design.md des Benutzers, um es zu füllen); passen Sie frame.md danach nur von Hand an, wenn eine Zuordnung es wirklich benötigt.
Gate: build-frame.mjs wurde mit 0 beendet – frame.md existiert aus einem benannten Preset, und (wenn das Preset eines ausliefert) .hyperframes/caption-skin.html existiert als Caption-Skin-Quelle; das gewählte Preset wurde als Präferenz aufgezeichnet (--key style_preset --workflow <dieser Workflow>, Briefing-Vertrag § 2).
Schritt 3: Storyboard und Skript
Ziel: Das Briefing und das erfasste Material in einen genehmigten bildweisen Story-Plan verwandeln.
Lesen Sie ../hyperframes-creative/references/story-spine.md (Hook-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 die duration: im Frontmatter aus der length des Briefings – eine grobe Erwartung; die Zusammenstellung meldet, wo der Schnitt im Vergleich dazu landet.
Verwenden Sie story-design.md für den Story-Bauplan, Hook, Überzeugungslogik, Beats, VO_MODE und Asset-Auswahl. Konsultieren Sie als weiche Anleitung die Rolle→Bauplan-Menü in ../hyperframes-animation/blueprints-index.md: notieren Sie für jeden Beat eine Kandidaten-Bauplan-ID, wenn eine passt. Die Story-Wahrheit entscheidet dennoch, welche Beats existieren – erzwingen Sie niemals einen Beat, um in einen Bauplan zu passen, und erfinden Sie niemals einen Beat, nur weil eine bewährte Form verfügbar ist. Wählen Sie die asset_candidates jedes visuellen Frames aus capture/extracted/asset-descriptions.md (dem kanonischen Inventar) – stöbern Sie nicht in rohen capture/assets/. Bitten Sie den Benutzer nicht, Assets auszuwählen, es sei denn, dieses Inventar fehlt oder ist unbrauchbar. Verwenden Sie die genauen erforderlichen Felder aus den Storyboard- und Skript-Referenzen.
Führen Sie nach dem Entwurf den Plan-Durchlauf der Überprüfungsschleife aus – ../hyperframes/references/review-loop.md § 1: präsentieren Sie den Plan als Vorschlag und stellen Sie die beiden Fragen – Genehmigen oder Ändern, und Sketches zuerst (empfohlen) oder Überspringen. Feedback kommt als Chat-Antwort; wiederholen Sie die Schleife bis zur Genehmigung. Dies ist ein Kontrollpunkt-Gate (Briefing-Vertrag § 1): im autonomen Modus (
[gekürzt für Übersetzung]