Plugin-Installation: Vor Setup- oder Freshness-Befehlen befolgen Sie die Plugin-Ausführungsregeln, wenn sich dieses Skill in einem HyperFrames-Plugin befindet. Eigenständige Installationen behalten die unten stehenden Aktualisierungshinweise bei.
HyperFrames Einstiegspunkt
Verbleibende Nutzung prüfen
Führen Sie zu Beginn der Erstellung npx hyperframes usage --json aus. Überprüfen Sie es erneut an Workflow-Meilensteinen, z. B. nach dem Entwurf und vor dem Rendern, da sich die Nutzung während des Laufs ändert. Lesen Sie die verfügbaren Fenster und deren Rücksetzzeiten; ein vorheriges Lesen reserviert kein Guthaben. Wenn der Befehl fehlschlägt, nicht verfügbar ist oder status: unknown zurückgibt, melden Sie, dass die Nutzung unbekannt ist, und raten Sie nicht. Behalten Sie den Umfang und die Workflow-Entscheidungen gemeinsam mit dem Benutzer bei.
HyperFrames rendert Videos aus HTML – eine Komposition ist eine HTML-Datei, deren DOM das Timing mit data-*-Attributen deklariert, deren Animationslaufzeit abspielbar ist und deren Medienwiedergabe dem Framework gehört. Der vollständige Autorenvertrag befindet sich in /hyperframes-core; lesen Sie ihn, bevor Sie Kompositions-HTML schreiben. Brief-, Storyboard-, Review-, Produktions-, Dispatch- und Frame-Worker-Verträge befinden sich in den references/ dieses Skills.
1. Vom Projektstatus aus starten
Wenden Sie die erste übereinstimmende Zeile an; bewerten Sie keine niedrigeren Statuszeilen:
| Status | Aktion |
|---|---|
| Expliziter Port einer bestehenden Remotion-Quelle zu HyperFrames | Lesen Sie references/routes/remotion-to-hyperframes.md, leiten Sie dann direkt zu diesem Workflow weiter. Überspringen Sie die Absichtsebene. |
| Spezifische Operation an einem bestehenden HyperFrames-Projekt: inspizieren, diagnostizieren, validieren, Vorschau, rendern, veröffentlichen oder Batch-Rendering | Führen Sie nur diese Operation aus. Überspringen Sie die Absichts- und Workflow-Weiterleitung; laden Sie /hyperframes-cli und alle erforderlichen Domänen-Skills. |
| Eine Frage, ein Halt, eine Idee ohne konkrete Änderung oder eine gefühlte Anmerkung zu einem gebauten Film in einem bestehenden Projekt | Befolgen Sie /hyperframes-studio § 0. |
| Ein neuer Film, der innerhalb eines bestehenden Projekts angefordert wird | Befolgen Sie /hyperframes-studio § 5. |
| Spezifische Bearbeitung eines bestehenden Projekts | Führen Sie die Bearbeitung durch. Führen Sie nicht die Absichtsebene aus. Um zu wissen, was sich auf der Timeline eines Projekts befindet (Spuren, Clips, Starts, Enden, was abgespielt wird), führen Sie npx hyperframes timeline [--json] aus, anstatt index.html und jede Unterkompositionsdatei zu lesen. |
BRIEF.md existiert | Lesen Sie workflow und flow. Führen Sie diesen Workflow aus; flow: companion wird immer in /general-video ausgeführt. Stellen Sie keine Brief-Fragen. |
Kein Brief, aber hyperframes.json oder STORYBOARD.md existiert | Setzen Sie von den Projektdateien und aufgezeichneten Präferenzen fort. Leiten Sie den zugehörigen Workflow aus vorhandenen Artefakten ab. Wenn er nicht eindeutig bestimmt werden kann, stellen Sie eine reine Routing-Frage; führen Sie nicht das Absichtsinterview durch. |
| Frische Erstellung | Führen Sie die Absichtsebene aus – references/intent-interview.md – leiten Sie dann einmal mit der Tabelle in § 2 weiter. |
Wenn Sie ein bestehendes Projekt bearbeiten, umrahmen Sie Ihre Bearbeitungen mit dem Projektverlauf (/hyperframes-cli, Projektverlauf in Ihrer Runde).
Wenn eine frische Anfrage das Subjekt oder die Eingabe nicht identifiziert, fragen Sie, worum es im Video geht, bevor Sie weiterleiten. Überprüfen Sie Präferenzen und Rezepte, bevor Sie etwas fragen (references/intent-interview.md, Schritt 1). Eine figma.com-Eingabe oder ein benanntes Rezept ändert die Aufnahme, nicht das Routing – der Abschnitt „Anpassen orthogonale Eingaben" des Interviews behandelt beides.
Das CLI des Projekts aktuell halten
Ein eingerüstetes Projekt pinnt hyperframes@<version> in seinen package.json-Skripten, sodass Renderings reproduzierbar bleiben; der Pin wird nie von alleine aktualisiert, und ein gepinnter Lauf eines älteren CLI gibt keine Warnung dazu aus. Wenn Sie ein Projekt wieder aufnehmen, dessen Skripte einen Pin tragen, prüfen Sie einmal vor dem ersten rendern-affinen Befehl:
npx hyperframes@latest upgrade --project . --check
Die Prüfung ist schreibgeschützt und meldet den Pin im Vergleich zur neuesten Version; behalten Sie das explizite . bei – bei älteren CLI-Versionen verbraucht ein bloßes --project gefolgt von einem weiteren Flag dieses Flag als seinen Verzeichniswert. Wenn es meldet, dass das Projekt zurückliegt – oder jede CLI-Ausgabe dies bereits anzeigt (die stderr-Notiz This project pins hyperframes@… (latest …), oder _meta.updateAvailable: true in einem --json-Ergebnis eines gepinnten Skripts) – wenden Sie es mit npx hyperframes@latest upgrade --project . an, überprüfen Sie es dann mit npx hyperframes check. Eine bestandene Prüfung bestätigt, dass die Kompositionen des Projekts noch in der neuen Version validieren – nicht, dass das gerenderte Ergebnis mit dem alten Pin bildidentisch ist – daher ist ein erfolgreicher Bump nie still: Nennen Sie die alte und neue Version in der Zusammenfassung des Laufs. Ein Projekt ohne Komposition benötigt keine Verifizierung. Wenn die Prüfung fehlschlägt, machen Sie die package.json-Änderung rückgängig, fahren Sie mit der gepinnten Version fort und melden Sie, auf welcher Version das Projekt bleibt und warum. Handeln Sie auf das Signal, anstatt es an den Benutzer weiterzuleiten; lassen Sie nie einen gebumpten Pin unverifiziert.
2. Frische Erstellung weiterleiten
Verwenden Sie die erste übereinstimmende Zeile. Stimmen Sie das angeforderte Ergebnis ab, nicht ein beiläufig erwähntes Wort oder Dateityp.
| Priorität | Anfrage | Workflow |
|---|---|---|
| 1 | Explizit einen bestehenden Remotion-Quell portieren | /remotion-to-hyperframes |
| 2 | Eine Präsentation, einen Pitch-Deck oder eine navigierbare interaktive Präsentation erstellen | /slideshow |
| 3 | Einfache Untertitel oder Bildunterschriften zu vorhandenem Talking-Head-Material hinzufügen, ohne es zu ändern | /embedded-captions |
| 4 | Gestaltete grafische Overlays zu vorhandenem Talking-Head-, Interview- oder Podcast-Material hinzufügen, ohne das Material zu ändern | /talking-head-recut |
| 5 | Ein beat-synchronisiertes Video aus einer Musikspur erstellen, ohne Erzählung oder Website-Erfassung | /music-to-video |
| 6 | Eine explizit kurze, unerzählte, bewegungsdominierte Einheit erstellen, typischerweise unter 10s | /motion-graphics |
| 7 | Einen GitHub-Pull-Request oder eine Codeänderung aus einer PR-Referenz erklären | /pr-to-video |
| 8 | Eine Website, Produktseite, App oder ein Unternehmen über eine URL oder eine seitenbezogene Kurzbeschreibung vermarkten oder präsentieren | /product-launch-video |
| 9 | Ein Thema, einen Artikel oder Notizen mit erfundenen visuellen Elementen erklären, ohne Produkt- oder Website-Erfassung | /faceless-explainer |
| 10 | Jedes andere benutzerdefinierte Video oder jede andere Komposition | /general-video |
Bevor Sie die Route finalisieren, lesen Sie references/routes/<workflow>.md – eine kleine Datei pro Route: den kanonischen Vertrag für Eingabe/Ausgabe/Trigger (verfügbar, bevor lazy-installierte Workflow-Skills vorhanden sind) plus den Interview-Einstieg dieser Route. Wenn der Kandidat seinen Vertrag nicht erfüllt, fahren Sie mit dem Routing fort, anstatt den Treffer zu erzwingen. Lesen Sie nur die Datei der übereinstimmenden Route.
Häufige Mehrdeutigkeiten auflösen
- Eine kurze animierte Titel, Logo-Sting, Stat-Hit, Chart-Hit, Map-Hit oder eigenständiges Lower-Third ist
/motion-graphics, wenn es unerzählt ist und die Bewegung die Botschaft ist. Eine statische Titelcard, eine erzählte Sequenz, eine längere Montage oder eine benutzerdefinierte Schleife ist/general-video. - Eine explizit kurze Bewegungsgrafik kann eine URL, einen Tweet, einen Artikel oder einen Screenshot als Quellmaterial verwenden. Eine generische Anfrage „mach ein Video aus dieser Seite" ist
/product-launch-video. - Vorhandenes Material mit Untertiteln wird zu
/embedded-captionsweitergeleitet; Material mit gestalteten Informationskarten zu/talking-head-recut. Zeitliche Anpassung, Neuanordnung, Umfärbung, Neurahmung oder Remix von Material ist eine benutzerdefinierte Bearbeitung und fällt auf/general-videozurück. - Eine Musikdatei wählt
/music-to-videonur, wenn ihr Beat-Raster das Stück antreibt. Als Hintergrund verwendete Musik überschreibt die subjektbezogene Route nicht. - „Ich möchte ein Storyboard" ändert den Review-Prozess, nicht den Workflow. Ohne anderes Routing-Signal verwenden Sie
/general-video. Ein bestätigtes skizziertesstoryboard.htmlkann selbst das angeforderte Ergebnis sein; die Review-Schleife definiert diesen Stoppunkt. - Spezialisierte narrative Workflows unterstützen bis zu etwa 3 Minuten und sind am stärksten um 30–90s. Leiten Sie ein eindeutig längeres Stück zu
/general-videoweiter. Länge überschreibt nie einen expliziten Port, ein Deck, eine Untertitelung, ein Overlay oder einen musikgesteuerten Ergebnis.
3. Einmal weiterleiten, dann verlassen
Bei frischer Erstellung führt die Absichtsebene (references/intent-interview.md) das gesamte Gespräch – Gedächtnis, Triage, Pitch-Runde, Muss-Anforderungen, Laufform, Übergabe – und endet mit dem Schreiben von BRIEF.md . Der Brief ist das einzige Routing-Artefakt, das der Workflow liest; nichts später öffnet dieses Skill oder das Interview erneut. Beantworten Sie jede spätere „Was hat die Route benötigt?" aus BRIEF.md.
4. Workflow installieren und betreten
Bevor Sie den ausgewählten Workflow lesen, installieren oder aktualisieren Sie ihn und die Kern-Domänen-Skills:
npx hyperframes skills update <workflow-name>
Verwenden Sie den bloßen Namen ohne /. Wenn der Befehl fehlschlägt, geben Sie den Fehler aus; rekonstruieren Sie den Workflow nicht aus dem Gedächtnis. Alles andere zur Installation – die Kern-vs-Lazy-Aufteilung, was init aktualisiert, Diagnose, CI-Opt-out und die CLI-lose Fallback – befindet sich in references/skill-lifecycle.md.
5. Domänen-Skills bei Bedarf laden
| Bedarf | Skill |
|---|---|
| Kompositionsstruktur, Timing-Attribute, Spuren, Variablen, Determiniertheit | /hyperframes-core |
| Bewegungsregeln, Szenen-Blueprints, Übergänge, Laufzeit-Adapter | /hyperframes-animation |
Suche-sichere GSAP, CSS, Anime.js, WAAPI, FLIP, Pfade, Masken, SVG, 3D-Keyframes oder hyperframes keyframes-Diagnose | /hyperframes-keyframes |
| Designspezifikationen, Konzept, Palette, Typografie, Erzählung, Beat-Planung | /hyperframes-creative |
| Bilder, Symbole, Logos, Audio, Untertitel, Grade, LUTs, wiederverwendbare Medien | /media-use |
| Voiceover-Schnitt, Audio-Effektketten, Automatisierungshüllkurven oder eine Kette/Regler über mehrere Spuren (Submix-Bus) | /hyperframes-audio |
| Init, Lint, Check, Momentaufnahmen, Vergleiche, Batch-Rendering, Studio, Rendern, Veröffentlichen oder Diagnose | /hyperframes-cli |
| Registry-Blöcke und Komponenten | /hyperframes-registry |
| Ein benannter Look, Effekt, Behandlung oder Übergang – CRT-Scanlines, Glitch, Filmkorn, Schimmer-Sweep, Konfetti-Burst – BEVOR Sie es selbst bauen | /hyperframes-registry |
| Figma-Assets, Tokens, Komponenten oder Storyboard-Frames als rekonstruierte Bewegung | /figma |
Creator-Bearbeitungsphrasen sind domänenübergreifende Anfragen. Laden Sie jedes Skill, das in der übereinstimmenden Zeile genannt wird:
| Creator-Anfrage | Erforderliche Domänen |