Plugin-Installationen: Führe vor Setup- oder Aktualisierungsbefehlen die Plugin-Ausführungsregeln aus, wenn dieser Skill innerhalb eines HyperFrames-Plugins verwendet wird. Bei eigenständigen Installationen gelten die folgenden Aktualisierungsanweisungen.
HyperFrames Einstiegspunkt
Verbleibende Nutzung prüfen
Führe zu Beginn der Erstellung npx hyperframes usage --json aus. Überprüfe die Nutzung erneut zu wichtigen Meilensteinen des Arbeitsablaufs, z. B. nach dem Entwurf und vor dem Rendern, da sich die Nutzung während des Laufs ändern kann. Lies die verfügbaren Fenster und deren Rückstellzeiten; eine vorherige Abfrage reserviert kein Kontingent. Wenn der Befehl fehlschlägt, nicht verfügbar ist oder status: unknown zurückgibt, melde, dass die Nutzung unbekannt ist, und spekuliere nicht. Stimme Umfang und Workflow-Wahl mit dem Benutzer ab.
HyperFrames rendert Videos aus HTML – eine Komposition ist eine HTML-Datei, deren DOM mit data-*-Attributen die Zeitsteuerung deklariert, deren Animationslaufzeit suchbar ist und deren Medienwiedergabe vom Framework gesteuert wird. Der vollständige Erstellungsvertrag befindet sich in /hyperframes-core; lies ihn, bevor du Kompositions-HTML schreibst. Briefing, Storyboard, Review, Produktion, Versand und Frame-Worker-Verträge befinden sich im references/-Verzeichnis dieses Skills.
1. Vom Projektzustand starten
Wende die erste zutreffende Zeile an; werte keine niedrigeren Zustandszeilen aus:
| Zustand | Aktion |
|---|---|
| Expliziter Port einer bestehenden Remotion-Quelle zu HyperFrames | Lies references/routes/remotion-to-hyperframes.md, leite dann direkt an diesen Workflow weiter. Überspringe die Absichtsschicht. |
| Bestimmte Operation an einem bestehenden HyperFrames-Projekt: inspizieren, diagnostizieren, validieren, Vorschau, rendern, veröffentlichen oder Batch-Rendering | Führe nur diese Operation aus. Überspringe die Absichts- und Workflow-Routing; lade /hyperframes-cli und alle erforderlichen Domänen-Skills. |
| Eine Frage, ein Halt, eine Idee ohne konkrete Änderung oder eine gefühlte Notiz zu einem fertigen Film in einem bestehenden Projekt | Folge /hyperframes-studio § 0. |
| Ein neuer Film, der innerhalb eines bestehenden Projekts angefordert wird | Folge /hyperframes-studio § 5. |
| Bestimmte Bearbeitung eines bestehenden Projekts | Führe die Bearbeitung durch. Führe die Absichtsschicht nicht aus. Um zu erfahren, was sich auf der Zeitleiste eines Projekts befindet (Spuren, Clips, Start, Ende, was abgespielt wird), führe npx hyperframes timeline [--json] aus, anstatt index.html und jede Unterkompositionsdatei zu lesen. |
BRIEF.md existiert | Lies workflow und flow. Führe diesen Workflow aus; flow: companion wird immer in /general-video ausgeführt. Stelle keine Briefing-Fragen. |
Kein Briefing, aber hyperframes.json oder STORYBOARD.md existiert | Setze aus Projektdateien und aufgezeichneten Präferenzen fort. Leite den zugehörigen Workflow aus vorhandenen Artefakten ab. Wenn er nicht eindeutig bestimmt werden kann, stelle eine einzige Routing-Frage; führe das Absichtsinterview nicht durch. |
| Frische Erstellung | Führe die Absichtsschicht aus – references/intent-interview.md – leite dann einmalig gemäß § 2 weiter. |
Wenn du ein bestehendes Projekt bearbeitest, klammer deine Bearbeitungen mit der Projekthistorie (/hyperframes-cli, Projekthistorie in deinem Zug) ein.
Wenn eine frische Anfrage das Thema oder die Eingabe nicht identifiziert, frage, worum es im Video geht, bevor du weiterleitest. Überprüfe Präferenzen und Rezepte, bevor du etwas fragst (references/intent-interview.md, Schritt 1). Eine figma.com-Eingabe oder ein benanntes Rezept ändert die Aufnahme, nicht die Weiterleitung – der Abschnitt „Anpassen orthogonaler Eingaben" des Interviews behandelt beides.
Halte das CLI des Projekts aktuell
Ein eingerüstetes Projekt fixiert hyperframes@<version> in seinen package.json-Skripten, sodass Renderings reproduzierbar bleiben; die Fixierung wird nie von selbst aktualisiert, und ein fixierter Lauf einer älteren CLI gibt dazu keine Warnung aus. Wenn ein Projekt fortgesetzt wird, dessen Skripte eine Fixierung enthalten, überprüfe einmal vor dem ersten rendern-affektierenden Befehl:
npx hyperframes@latest upgrade --project . --check
Der Test ist schreibgeschützt und meldet die Fixierung gegen die neueste Version; behalte das explizite . – bei älteren CLI-Versionen könnte ein bloßes --project gefolgt von einem anderen Flag dieses Flag als Verzeichniswert interpretieren. Wenn der Test meldet, dass das Projekt zurückliegt – oder jede andere CLI-Ausgabe dies bereits anzeigt (der stderr-Hinweis This project pins hyperframes@… (latest …) oder _meta.updateAvailable: true in einem --json-Ergebnis eines fixierten Skripts) – wende npx hyperframes@latest upgrade --project . an, überprüfe dann mit npx hyperframes check. Eine bestandene Überprüfung bestätigt, dass die Kompositionen des Projekts noch auf der neuen Version validieren – nicht, dass das gerenderte Ergebnis mit dem alten Pin bildidentisch ist –, daher ist ein erfolgreicher Sprung nie still: Nenne die alte und neue Version in der Zusammenfassung des Laufs. Ein Projekt ohne Komposition benötigt keine Verifizierung. Wenn die Überprüfung fehlschlägt, mache die Änderung in package.json rückgängig, fahre mit der fixierten Version fort und melde, auf welcher Version das Projekt bleibt und warum. Handle das Signal, anstatt es an den Benutzer weiterzuleiten; lasse niemals einen aktualisierten Pin unverifiziert.
2. Frische Erstellung weiterleiten
Verwende die erste zutreffende Zeile. Stimme das angeforderte Ergebnis ab, nicht ein beiläufig erwähntes Wort oder Dateityp.
| Priorität | Anfrage | Workflow |
|---|---|---|
| 1 | Explizit eine bestehende Remotion-Quelle portieren | /remotion-to-hyperframes |
| 2 | Eine Präsentation, Pitch-Deck oder navigierbares interaktives Deck verfassen | /slideshow |
| 3 | Einfache Untertitel zu bestehendem Talking-Head-Material hinzufügen, ohne es zu ändern | /embedded-captions |
| 4 | Gestaltete Grafik-Overlays zu bestehendem 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-Aufnahme | /music-to-video |
| 6 | Eine explizit kurze, unerzählte, bewegungsfokussierte 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 aus einer URL oder einer seitenbezogenen Kurzbeschreibung vermarkten oder präsentieren | /product-launch-video |
| 9 | Ein Thema, einen Artikel oder Notizen mit erfundenen Bildern erklären, ohne Produkt- oder Website-Aufnahme | /faceless-explainer |
| 10 | Jedes andere benutzerdefinierte Video oder Komposition | /general-video |
Bevor du die Route finalisierst, lies references/routes/<workflow>.md – eine kleine Datei pro Route: den kanonischen Vertrag für Eingabe/Ausgabe/Auslöser (verfügbar bevor lazy-installierte Workflow-Skills vorhanden sind) plus den Interview-Einstieg dieser Route. Wenn der Kandidat seinen Vertrag nicht erfüllt, setze die Weiterleitung fort, anstatt die Übereinstimmung zu erzwingen. Lies nur die Datei der passenden Route.
Allgemeine Mehrdeutigkeiten auflösen
- Ein kurzer animierter Titel, Logo-Sting, Statistik-Hit, Diagramm-Hit, Karten-Hit oder eigenständiger Lower-Third ist
/motion-graphics, wenn er unerzählt ist und die Bewegung die Botschaft ist. Eine statische Titelcard, erzählte Sequenz, längere Montage 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 „Mach ein Video aus dieser Website" ist
/product-launch-video. - Bestehendes Material mit Untertiteln wird zu
/embedded-captionsweitergeleitet; Material mit gestalteten Informationskarten zu/talking-head-recut. Neusynchronisation, Neuordnung, Neufä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 themenbezogene Route nicht. - „Ich möchte ein Storyboard" ändert den Review-Prozess, nicht den Workflow. Ohne anderes Routing-Signal verwende
/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 bei 30–90s. Leite ein deutlich längeres Stück zu
/general-videoweiter. Die Länge überschreibt niemals einen expliziten Port, ein Deck, Untertitel, Overlay oder musikgesteuertes Ergebnis.
3. Einmal weiterleiten, dann verlassen
Bei einer frischen Erstellung führt die Absichtsschicht (references/intent-interview.md) das gesamte Gespräch – Gedächtnis, Triage, Pitch-Runde, Muss-Eigenschaften, Laufform, Übergabe – und endet mit dem Schreiben von BRIEF.md. Das Briefing ist das einzige Routing-Artefakt, das der Workflow liest; nichts später öffnet diesen Skill oder das Interview erneut. Beantworte jede spätere Frage „Was hat die Route verlangt?" aus BRIEF.md.
4. Workflow installieren und betreten
Bevor du den ausgewählten Workflow liest, installiere oder aktualisiere ihn und die Kern-Domänen-Skills:
npx hyperframes skills update <workflow-name>
Verwende den bloßen Namen ohne /. Wenn der Befehl fehlschlägt, gib den Fehler aus; rekonstruiere den Workflow nicht aus dem Gedächtnis. Alles Weitere zur Installation – die Aufteilung in Kern- vs. Lazy-Skills, was init aktualisiert, Diagnose, CI-Opt-out und die CLI-Fallback-Option – 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-Diagnose | /hyperframes-keyframes |
| Design-Spezifikationen, Konzept, Palette, Typografie, Erzählung, Beat-Planung | /hyperframes-creative |
| Bilder, Symbole, Logos, Audio, Untertitel, Grades, LUTs, wiederverwendbare Medien | /media-use |
| Sprachausgabe-Schnitt, Audio-Effektketten, Automationshüllkurven oder eine Kette/Fader über mehrere Spuren (Submix-Bus) | /hyperframes-audio |
| Init, Lint, Check, Snapshots, Compare, Batch-Render, Studio, Render, Publish oder Diagnose | /hyperframes-cli |
| Registry-Blöcke und -Komponenten | /hyperframes-registry |
| Ein benannter Look, Effekt, Behandlung oder Übergang – CRT-Zeilen, Glitch, Filmkorn, Schimmer-Wisch, Konfetti-Ausbruch – BEVOR du es von Hand baust | /hyperframes-registry |
| Figma-Assets, Token, Komponenten oder Storyboard-Frames als rekonstruierte Bewegung | /figma |
Ersteller-Bearbeitungsphrasen sind domänenübergreifende Anfragen. Lade jeden Skill, der in der passenden Zeile genannt wird:
| Ersteller-Anfrage | Erforderliche Domänen |
|---|---|
| ... | ... |