Plugin-Installation: Führen Sie vor Setup- oder Aktualisierungsbefehlen die Plugin-Ausführungsregeln aus, wenn dieses Skill sich in einem HyperFrames-Plugin befindet. Bei eigenständigen Installationen gelten die unten stehenden Aktualisierungshinweise.
HyperFrames Einstiegspunkt
Verbleibende Nutzung prüfen
Führen Sie zu Beginn der Erstellung npx hyperframes usage --json aus. Überprüfen Sie dies erneut bei 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ückstellzeiten aus; ein vorheriges Lesen reserviert kein Kontingent. 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-Auswahl 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 suchbar ist und deren Medienwiedergabe vom Framework gesteuert wird. 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 starten
Wenden Sie die erste übereinstimmende Zeile an; werten Sie keine niedrigeren Statuszeilen aus:
| Status | Aktion |
|---|---|
| Explizite Portierung einer vorhandenen Remotion-Quelle zu HyperFrames | Lesen Sie references/routes/remotion-to-hyperframes.md und leiten Sie dann direkt zu diesem Workflow weiter. Überspringen Sie die Intent-Ebene. |
| Spezifische Operation an einem vorhandenen HyperFrames-Projekt: inspizieren, diagnostizieren, validieren, Vorschau, rendern, veröffentlichen oder Stapelrendern | Führen Sie nur diese Operation durch. Überspringen Sie Intent und Workflow-Routing; laden Sie /hyperframes-cli und alle erforderlichen Domänen-Skills. |
| Eine Frage, eine Pause, eine Idee ohne konkrete Änderung oder eine gefühlte Anmerkung zu einem fertigen Film in einem vorhandenen Projekt | Folgen Sie /hyperframes-studio § 0. |
| Ein neuer Film, der innerhalb eines vorhandenen Projekts angefordert wird | Folgen Sie /hyperframes-studio § 5. |
| Spezifische Bearbeitung eines vorhandenen Projekts | Führen Sie die Bearbeitung durch. Führen Sie nicht die Intent-Ebene aus. Um zu erfahren, was sich auf der Zeitleiste 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 | Nehmen Sie die Arbeit anhand der Projektdateien und gespeicherten Präferenzen wieder auf. 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 kein Intent-Interview durch. |
| Frisch erstellen | Führen Sie die Intent-Ebene aus – references/intent-interview.md – und leiten Sie dann einmalig anhand der Tabelle in § 2 weiter. |
Wenn Sie ein vorhandenes Projekt bearbeiten, umschließen Sie Ihre Änderungen mit der Projektverlauf (/hyperframes-cli, Projektverlauf in Ihrem Zug).
Wenn eine frische Anfrage das Thema oder die Eingabe nicht identifiziert, fragen Sie, worum es in dem Video geht, bevor Sie weiterleiten. Überprüfen Sie Einstellungen 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 „Angepasste orthogonale Eingaben" des Interviews behandelt beides.
Halten Sie die CLI des Projekts aktuell
Ein Gerüstprojekt fixiert hyperframes@<version> in seinen package.json-Skripten, damit Rendering reproduzierbar bleibt; die Fixierung wird nie automatisch aktualisiert, und eine fixierte Ausführung einer älteren CLI gibt keine Warnung dazu aus. Wenn Sie ein Projekt fortsetzen, dessen Skripte eine Fixierung enthalten, prüfen Sie einmal vor dem ersten rende-relevanten Befehl:
npx hyperframes@latest upgrade --project . --check
Die Prüfung ist schreibgeschützt und meldet die Fixierung gegen die neueste Version; behalten Sie das explizite . bei – bei älteren CLI-Versionen verbraucht ein bloßes --project gefolgt von einem anderen Flag dieses Flag als Verzeichniswert. Wenn sie meldet, dass das Projekt zurückliegt – oder eine CLI-Ausgabe dies bereits zeigt (der stderr-Hinweis This project pins hyperframes@… (latest …), oder _meta.updateAvailable: true in einem --json-Ergebnis aus einem fixierten Skript) – wenden Sie npx hyperframes@latest upgrade --project . an und überprüfen Sie dann mit npx hyperframes check. Eine bestandene Prüfung bestätigt, dass die Kompositionen des Projekts mit der neuen Version noch gültig sind – nicht, dass die gerenderte Ausgabe mit der alten Fixierung bildidentisch ist –, daher ist ein erfolgreicher Bump niemals still: nennen Sie die alte und neue Version in der Zusammenfassung des Laufs. Ein Projekt ohne Komposition benötigt keine Überprüfung. Wenn die Prüfung fehlschlägt, machen Sie die Änderung der package.json rückgängig, fahren Sie mit der fixierten Version fort und melden Sie, auf welcher Version das Projekt verbleibt und warum. Handeln Sie aufgrund des Signals, anstatt es an den Benutzer weiterzuleiten; lassen Sie einen erhöhten Bump niemals unbestätigt.
2. Frische Erstellung weiterleiten
Verwenden Sie die erste übereinstimmende Zeile. Ordnen Sie das angeforderte Ergebnis zu, nicht ein beiläufig erwähntes Wort oder Dateityp.
| Priorität | Anfrage | Workflow |
|---|---|---|
| 1 | Explizite Portierung einer vorhandenen Remotion-Quelle | /remotion-to-hyperframes |
| 2 | Erstellen einer Präsentation, eines Pitch-Decks oder einer navigierbaren interaktiven Präsentation | /slideshow |
| 3 | Hinzufügen einfacher Untertitel oder Bildtexte zu vorhandenem Talking-Head-Material ohne es zu ändern | /embedded-captions |
| 4 | Hinzufügen gestalteter Grafik-Overlays zu vorhandenem Talking-Head-, Interview- oder Podcast-Material ohne das Material zu ändern | /talking-head-recut |
| 5 | Erstellen eines taktsynchronen Videos aus einem Musiktitel, ohne Erzählung oder Website-Erfassung | /music-to-video |
| 6 | Erstellen einer explizit kurzen, unerzählten, bewegungsorientierten Einheit, typischerweise unter 10 s | /motion-graphics |
| 7 | Erklären eines GitHub-Pull-Requests oder einer Code-Änderung anhand einer PR-Referenz | /pr-to-video |
| 8 | Vermarkten oder Präsentieren einer Website, Produktseite, App oder eines Unternehmens anhand einer URL oder standortspezifischen Kurzbeschreibung | /product-launch-video |
| 9 | Erklären eines Themas, Artikels oder von Notizen mit erfundenen Grafiken 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: der kanonische Input/Output/Auslöser-Vertrag (verfügbar, bevor faul installierte Workflow-Skills vorhanden sind) plus den Interview-Eintrag dieser Route. Wenn der Kandidat seinen Vertrag nicht erfüllt, setzen Sie das Routing fort, anstatt die Übereinstimmung zu erzwingen. Lesen Sie nur die Datei der übereinstimmenden Route.
Häufige Mehrdeutigkeiten auflösen
- Eine kurze animierte Titelsequenz, Logo-Sting, Statistik-Hit, Chart-Hit, Karten-Hit oder eigenständige untere Drittel ist
/motion-graphics, wenn sie unerzählt ist und Bewegung die Botschaft ist. Eine statische Titelsequenz, erzählte Sequenz, längerer Zusammenschnitt oder benutzerdefinierte Schleife ist/general-video. - Eine explizit kurze Bewegungsgrafik kann eine URL, einen Tweet, einen Artikel oder einen Screenshot als Quellmaterial verwenden. Eine allgemeine Anfrage „Erstelle ein Video von dieser Website" ist
/product-launch-video. - Vorhandenes Filmmaterial mit Untertiteln wird an
/embedded-captionsweitergeleitet; Filmmaterial mit gestalteten Informationskarten an/talking-head-recut. Das Neu-Timing, Neu-Anordnen, Neu-Einfärben, Neu-Rahmen oder Neu-Mischen von Filmmaterial ist eine benutzerdefinierte Bearbeitung und fällt auf/general-videozurück. - Eine Musikdatei wählt
/music-to-videonur aus, wenn ihr Taktgitter das Stück antreibt. Als Hintergrund verwendete Musik überschreibt nicht die themenbezogene Route. - „Ich möchte ein Storyboard" ändert den Überprüfungsprozess, nicht den Workflow. Ohne anderes Routing-Signal verwenden Sie
/general-video. Ein bestätigtes skizziertesstoryboard.htmlkann selbst das angeforderte Ergebnis sein; die Überprüfungsschleife definiert diesen Stoppunkt. - Spezialisierte narrative Workflows unterstützen bis zu etwa 3 Minuten und sind am stärksten im Bereich von 30–90 s. Leiten Sie ein deutlich längeres Stück an
/general-videoweiter. Die Länge überschreibt niemals ein explizites Portierungs-, Präsentations-, Untertitel-, Overlay- oder musikgesteuertes Ergebnis.
3. Einmalig weiterleiten, dann verlassen
Bei frischer Erstellung führt die Intent-Ebene (references/intent-interview.md) die gesamte Unterhaltung – Gedächtnis, Triage, Pitch-Runde, Must-haves, Lauf-Form, Übergabe – und endet mit dem Schreiben von BRIEF.md. Der Brief ist das einzige Routing-Artefakt, das der Workflow liest; nichts späteres öffnet dieses Skill oder das Interview erneut. Beantworten Sie jede spätere Frage „Was hat die Route verlangt?" 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, zeigen Sie den Fehler an; rekonstruieren Sie den Workflow nicht aus dem Gedächtnis. Alles andere zur Installation – die Kern-vs.-Faul-Aufteilung, was init aktualisiert, Diagnose, CI-Opt-out und der Fallback ohne CLI – 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-Blaupausen, Übergänge, Laufzeit-Adapter | /hyperframes-animation |
Suchsicheres GSAP, CSS, Anime.js, WAAPI, FLIP, Pfade, Masken, SVG, 3D-Keyframes oder hyperframes keyframes-Diagnosen | /hyperframes-keyframes |
| Design-Spezifikationen, Konzept, Palette, Typografie, Erzählung, Taktplanung | /hyperframes-creative |
| Bilder, Icons, Logos, Audio, Untertitel, Grades, LUTs, wiederverwendbare Medien | /media-use |
| Voiceover-Schnitt, Audio-Effektketten, Automationshüllkurven oder eine Kette/Fader über mehrere Spuren (Submix-Bus) | /hyperframes-audio |
| Init, Lint, Check, Schnappschüsse, Vergleiche, Stapelrender, Studio, Rendern, Veröffentlichen oder Diagnosen | /hyperframes-cli |
| Registry-Blöcke und -Komponenten | /hyperframes-registry |
| Ein benannter Look, Effekt, eine Behandlung oder ein Übergang – CRT-Abtastzeilen, Glitch, Filmkorn, Schimmer-Wisch, Konfetti-Ausbruch – BEVOR Sie es selbst erstellen | /hyperframes-registry |
| Figma-Assets, Tokens, Komponenten oder Storyboard-Frames als rekonstruierte Bewegung | /figma |
Creator-Bearbeitungsphrasen sind domänenübergreifende Anfragen. Laden Sie jedes im übereinstimmenden Zeile genannte Skill:
| Creator-Anfrage | Erforderliche Domänen |
Genauere Angaben folgen in den referenzierten Dateien.