Plugin-Installationen: Bevor Sie Setup- oder Aktualisierungsbefehle ausführen, befolgen Sie die Plugin-Ausführungsregeln, wenn sich dieses Skill innerhalb eines HyperFrames-Plugins befindet. Bei eigenständigen Installationen gelten die folgenden Update-Anweisungen.
HyperFrames CLI
Führen Sie Befehle als npx hyperframes ... aus, es sei denn, die Projektanweisungen geben einen Wrapper vor. Befolgen Sie den Wrapper, falls vorhanden. Die CLI erfordert Node.js 22 oder neuer und FFmpeg.
Entwicklungsschleife
- Gerüst:
npx hyperframes init <project>(mittig leer). Oder erfassen Sie eine Website. Übergeben Sie--example=<name>nur, um von einem benannten Beispiel zu starten. - Finden Sie den Schritt: Wenn die Anfrage ein Asset, einen Ton, ein Bild, eine Stimme oder eine schnelle visuelle Bearbeitung benennt, lösen Sie es über
/media-use, bevor Sie einen Plan vorschlagen. Ansonsten suchen Sie vor dem manuellen Erstellen einer Bewegung nach einem Primitive, das diese bereits ausführt:npx hyperframes catalog --query "eine Überschrift Zeile für Zeile enthüllen". Fragen Sie nach dem gewünschten Effekt und nicht nach dem Mechanismus, den Sie im Kopf haben. Installieren Sie mitnpx hyperframes add(siehe/hyperframes-registry`). Nur von Hand erstellen, wenn nichts passt. - Erstellen: Schreiben Sie die Komposition mit
/hyperframes-core. Um zu erfahren, was sich auf der Timeline eines Projekts befindet (Tracks, Clips, Starts, Enden, was abgespielt wird), führen Sienpx hyperframes timeline --jsonaus, anstattindex.htmlund jede Unterkompositionsdatei zu lesen: Verschachtelte Zeilen tragen absoluteabsStart/absEndder Haupt-Timeline und ihre zugehörigefile, nicht nur ihre lokale, pro-Unterkompositions-Zeit. Bevorzugen Sie--jsongegenüber der Textform; es verbraucht weniger Tokens für die gleiche oder bessere Korrektheit. Siehereferences/upgrade-info-misc.mdfür Einzeiler, die häufige Fragen beantworten, ohne die gesamte Ausgabe zu lesen. - Schnelles Feedback während der Bearbeitung erhalten: Führen Sie
npx hyperframes lintnach dem ersten HTML-Durchlauf und nach strukturellen Änderungen aus. - Führen Sie das finale Gate aus: Führen Sie
npx hyperframes checkaus; es führt lint erneut aus, bevor der Browser geöffnet wird. Fügen Sie keinen redundanten eigenständigen lint-Aufruf hinzu. Verwenden Sie--snapshotsfür annotierte Übersichts-Frames und zum Auffinden von Ausschnitten. - Unterkompositionen inspizieren: Wenn
index.htmldata-composition-srceinbindet, erfassen Sie Mittelpunkt-Snapshots und inspizieren Sie jede eingebundene Szene. - Öffnen Sie die finale Studio-Vorschau: Führen Sie
npx hyperframes preview --backgroundaus, überprüfen Sie, ob die URL HTTP 200 zurückgibt, geben Sie dem Benutzer die Timeline-Projekt-URL und fragen Sie, ob überarbeitet oder gerendert werden soll. Halten Sie es am Leben, bis die Überprüfung abgeschlossen ist. - Nur nach Genehmigung rendern: Verwenden Sie während der Iteration
--quality draft, für die erste echte Kodierung (CLI-Standard)--quality looksund für die endgültige Auslieferung--quality delivery. - Übergabe des Projekts an die Desktop-App (auf Angebot): Wenn die Framey-Zeile des Renderings mit
hyperframes open …endet, bieten Sienpx hyperframes open [dir]an. Es öffnet das Projekt in der HyperFrames Desktop-App und fügt es zu Home hinzu; unter Claude Code oder Codex übernimmt der Chat diese Unterhaltung. Ohne die App wird Exit 1 ausgegeben und der Download-Link gedruckt.--jsonfür Agenten. - Überprüfen Sie die Ausgabe: Bestätigen Sie, dass die Datei existiert und nicht leer ist. Lesen Sie die zweite Zeile der Rendering-Zusammenfassung (
beginframevsscreenshot, GPU, Stufen-Timings).screenshot+software gpuunter Linux ist der langsame Pfad.ffprobe -v error -show_format -show_streamsund vergleichen Sie die Dauer (und fps, falls in der Aufgabenstellung festgelegt) mit der Root-data-duration.
Projekthistorie in Ihrem Zug
Jeder Schreibvorgang im Projekt wird als Eintrag gespeichert, der rückgängig gemacht werden kann. Verwenden Sie es nur zu zwei Zeitpunkten, niemals bei jedem Schritt:
- Beginn eines Zugs:
npx hyperframes history begin --who <ihr-name> --label "<was Sie gleich tun werden>", dannnpx hyperframes history --since mine --who <ihr-name>, um zu sehen, was die Person seit Ihrem letzten Zug geändert hat. Bauen Sie auf deren Bearbeitungen auf; überschreiben Sie sie niemals. - Eine Überprüfung ist fehlgeschlagen, oder die Person sagt, es sei schlimmer geworden:
npx hyperframes history undo --who <ihr-name>macht Ihren neuesten Zug rückgängig und lässt die Bearbeitungen der Person in Ruhe. Bearbeiten Sie nicht von Hand zurück. Bei einem Konflikt wird Exit 2 ausgegeben und beide Optionen gedruckt.
Beenden Sie jeden Zug mit npx hyperframes history end, damit Ihre Schreibvorgänge als Ihre eigenen gelesen werden und nicht als "Außerhalb der App geändert". Während ein Zug geöffnet ist, zählt jeder Schreibvorgang im Projekt 10 Minuten lang als Ihrer; danach endet der Zug von selbst.
Obligatorische Ersteller-Bearbeitungs-Cross-Referenzen
- Vor dem Erstellen oder Diagnostizieren eines Zooms, einer Punch-in/Punch-out, einer Neurahmung, einer Kamerabewegung oder einer Keyframe-Animation lesen Sie zuerst
/hyperframes-keyframes. - Vor
hyperframes keyframeslesen Sie/hyperframes-keyframes; der Befehl zeigt Bewegungstrajektorien an und diagnostiziert keine Clipschnitte. - Für einen Schnitt, Trim, Splice, Neuordnung oder Quell-Timing-Bearbeitung lesen Sie
/hyperframes-coreund verwenden Sie dessen Clip-/Timeline-Vertrag. - Für Ein-/Ausblendung, Überblendung, Spurlautstärke, Lautstärkeautomatisierung, Ducking, Sprachausschnitt oder FX auf platziertem Audio lesen Sie
/hyperframes-audio. Laden Sie core parallel dazu, wenn sich auch die Clip-Platzierung oder das Bild-Timing ändert. - Eine Anfrage, die ein Asset, einen Ton, ein Bild, eine Stimme oder eine schnelle visuelle Bearbeitung benennt, wird über
/media-useaufgelöst, bevor ein Plan vorgeschlagen wird. Kopieren Sie die Ersteller-Bearbeitungs-Markierung von/hyperframes-core→references/creator-editing-recipes.md.
# Schnelle Iterationsprüfung; wiederholen Sie dies nach Bedarf während der Erstellung.
npx hyperframes lint
# Erforderliches finales Gate; beinhaltet lint.
npx hyperframes check
npx hyperframes preview --background
npx hyperframes render --quality looks --output out.mp4
test -s out.mp4
ffprobe -v error -show_format -show_streams out.mp4
check führt zuerst lint aus, verwendet dann eine Browsersitzung und einen Suchdurchlauf, um Laufzeitfehler, fehlgeschlagene Anfragen, Layout, *.motion.json-Behauptungen und WCAG-Kontrast zu prüfen. Anhaltende Erkenntnisse beeinflussen den Exit-Code; vorübergehende Eintritts- oder Austrittserkenntnisse sind informativ. Verwenden Sie --strict, um Warnungen zu bewerten. validate, inspect und layout bleiben aus Kompatibilitätsgründen Aliase, dürfen aber nicht in neuen Anweisungen oder Skripten vorkommen.
Vorschau vor dem Rendern
Öffnen Sie die finale Kompositionsvorschau (#project/<name>) erst, nachdem check bestanden wurde, um die zusammengestellte Timeline zu überprüfen. Der Plan im Chat und das storyboard.html-Skizzenblatt sind keine Genehmigung des endgültigen Videos. Rendern erfordert immer die endgültige Genehmigung gemäß hyperframes/references/review-loop.md.
Unterkompositions-Smoke-Test
Statische Prüfungen können nicht jeden Mount-Fehler abfangen. Wenn das Projekt Unterkompositionen verwendet, erfassen Sie mindestens einen sichtbaren Mittelpunkt für jeden Host-Slot:
npx hyperframes snapshot --at <t1>,<t2>,<t3>
Behandeln Sie winzigen, ungestylten Inhalt, canvas-große Symbole, fehlende Hero-Elemente oder Timeout bei der Timeline-Registrierung als rendern-verhindernde Mount-Fehler. Siehe hyperframes-core/references/sub-compositions.md für die entsprechenden Korrekturen.
Agenten-Konventionen
-
Durchsuchen Sie den Katalog, bevor Sie Bewegungen von Hand schreiben.
npx hyperframes catalog --query "<der Beat, in einfachem Englisch>". Die Suche ist vollständig lokal: Es gibt keine gehostete Stufe, kein Konto und der Abfragetext wird niemals an irgendeinen Ort gesendet. Standardmäßig wird nach Vokabular sortiert, das mit dem Namen, Titel, der Beschreibung und den Tags des Elements geteilt wird, was jede Formulierung übersieht, die die eigene Wortwahl des Katalogs nicht wiederverwendet. Fügen Sie--on-devicehinzu, um stattdessen nach Bedeutung zu sortieren (siehe die Offline-Stufe unten). -
Fragen Sie auf Englisch, auch wenn das Video es nicht ist. Beide Stufen indizieren einen englischen Katalog, daher erzeugt eine Abfrage in einer anderen Schrift keine durchsuchbaren Begriffe und liefert keine Ergebnisse. Beschreiben Sie die Bewegung auf Englisch; der Text auf dem Bildschirm bleibt in der Sprache, die das Video benötigt.
Keine durchsuchbaren Wörter in der Abfragebedeutet genau dies und ist keine fehlende Komponente, also melden Sie es nicht als Kataloglücke. -
Lesen Sie, welche Stufe geantwortet hat; leiten Sie es niemals aus dem Erscheinen von Ergebnissen ab. Mit
--jsonenthält der Umschlagquery,tier(on-deviceoderwords),tier_detail,dropped,unindexed,shown,totalundresults, plustop_score, wenn die antwortende Stufe einen produziert, undwarnings, wenn eine Stufe angefordert wurde, aber nicht ausgeführt werden konnte, oder wenn eine Suche nichts zurückgab und eine bessere Stufe noch auf die Zustimmung von jemandem wartet. Ein schwaches Ergebnis beiwordsist zu erwarten; das gleiche Ergebnis beion-deviceist ein Fehler.top_scoreist nur für on-device und hat keinen dahinterliegenden Schwellenwert: Der Ranker gibt für jede Abfrage den gesamten Katalog in einer bestimmten Reihenfolge zurück, lesen Sie es also eher als Beweis und nicht als Bestehen/Nichtbestehen. -
droppedundunindexedsind entgegengesetzte Abweichungen zwischen der Registry und dem On-Device-Index, und eine Umformulierung der Abfrage behebt keines von beiden.droppedzählt die Namen, die diese Registry nicht installieren kann, sodass die stärksten Übereinstimmungen diejenigen sind, die verloren gehen.unindexedzählt Registry-Bewegungen, die der Index überhaupt nicht sehen kann, die keine Abfrage jemals zurückgeben kann. Die Registry zu aktualisieren ist die Antwort auf keines von beiden: Ihr Manifest hat eine 24h-TTL und heilt sich selbst, während die Vektoren ein separat veröffentlichtes Artefakt sind, das in~/.hyperframes/catalog/abgerufen wird. Die erneute Ausführung mit--on-devicelädt diesen Index erneut herunter, wennunindexedüber Null liegt, das ist also das Heilmittel für den Benutzer. Eine reine Überdeckungsabweichung (droppedüber Null, währendunindexedNull ist) löst das erneute Abrufen nicht aus; das Löschen von~/.hyperframes/catalog/ist der einzige Ausweg aus dieser Situation. Beide Zählungen beziehen sich auf Namen und nicht auf Ergebnisse, daher kann jedetotalüberschreiten. -
Wenn eine Suche nichts Nennenswertes zum Installieren zurückbringt, sagen Sie es.
npx hyperframes feedback --search-miss "<die von Ihnen ausgeführte Abfrage>" --wanted "<die benötigte Bewegung>" --tier <die antwortende Stufe>. Sie müssen diese Zeile nicht zusammenstellen:catalog --querygibt sie vorausgefüllt aus, und jeder--json-Suchumschlag trägt sie alsreport_gapmit bereits korrekter Abfrage und Stufe — füllen Sie--wantedaus und senden Sie sie ab. Dies ist der einzige Pfad, der eine Abfrage irgendwohin sendet, und es ist ein separater bewusster Befehl, damitcatalog --querygenau sein Versprechen hält, nichts zu senden. Melden Sie auf jeder Stufe, wenn die Ergebnisse die Sache nicht tun; warten Sie nicht auf die On-Device-Stufe, die einen zustimmungspflichtigen 33 MB Download benötigt und daher in den meisten Agentenläufen deaktiviert ist — auf sie zu warten bedeutet, niemals zu melden. Die Stufe wird im Bericht mitgeführt, sodass ein Vokabularfehler von einem Bedeutungsfehler unterscheidbar bleibt, ohne dass Sie beurteilen müssen, welchen Sie getroffen haben. Was zurückkommt, ist eine Liste von Bewegungen, die der Katalog noch nicht hat, direkt gelesen und nicht aus Installationszahlen geraten, sodass die Formulierung, die zählt, der gewünschte Effekt ist, nicht der von Ihnen vorgestellte Item-Name. Es enthält keine Bewertung und landet nie in der Bewertungsmetrik. -
Bieten Sie die Offline-Stufe an; aktivieren Sie sie niemals stillschweigend. Ein einmaliger ~33 MB Download (ein quantisiertes ONNX-Build von
bge-small-en-v1.5plus dessen Tokenizer, fixiert auf eine bestimmte Revision) und die Katalogvektoren aus der Registry, beide zwischengespeichert unter~/.hyperframes/, weder zum Projekt noch zu irgendeinem Paket hinzugefügt. Einmal zwischengespeichert, wird nach Bedeutung sortiert, ohne dass etwas gesendet wird. Sagen Sie die Größe laut und lassen Sie die Person entscheiden, übergeben Sie dann--on-device(mit-y, um die Eingabeaufforderung zu überspringen), sobald sie zustimmt. Das interaktive Angebot erscheint nur auf einem TTY. Unter--jsongibt es keine Eingabeaufforderung, aber eine Suche, die nichts gefunden hat, setzt die gleiche Frage inwarnings, lesen Sie also dieses Array und stellen Sie die Entscheidung selbst dem Benutzer. Wenn die Person fragt, was der Download ist, warum dieses Modell oder was das Gerät verlässt, verweisen Sie sie auf https://hyperframes.heygen.com/developers/catalog-search. -
Bevorzugen Sie
--jsonfür Agenten- und CI-Aufrufe. Der Server-Modusrender,previewundplaybieten keine normale JSON-Ausgabe;preview --selection --jsonundpreview --context --jsonsind Ausnahmen im Abfragemodus. -
doctor --jsonwird immer mit Exit 0 beendet. Werten Sie die Nutzlast aus:npx hyperframes doctor --json | jq -e '.ok' >/dev/null -
Der Nicht-TTY-Modus ist automatisch und erzeugt das standardmäßig leere Gerüst. Übergeben Sie
--examplenur, um von einem benannten Beispiel zu starten. Verwenden Sie--non-interactive, um den Nur-Flag-Modus auf einem TTY zu erzwingen. -
Verwenden Sie eine
HYPERFRAMES_RUN_IDfür alle Befehle in derselben Verifizierungsschleife. -
Wenn der Speicherplatz knapp ist, führen Sie
npx hyperframes cleanaus (--dry-runzur Auflistung zuerst); es entfernt, was tote Renderings hinterlassen haben und untätige Caches, die sich selbst neu aufbauen, niemals Ausgaben, Quellen oder irgendetwas, das ein laufendes Rendering verwendet. Schreiben Sie QC-Frames in ein temporäres Verzeichnis, nicht in das Projekt. -
Verwenden Sie
--strict,--strict-allund--strict-variables, wenn die entsprechenden Warnungen, Variablen oder CI-Bedingungen das Rendern blockieren müssen. -
JSON-Pfade schwärzen das Home-Verzeichnis als
$HOME; versuchen Sie nicht, die Schwärzung rückgängig zu machen. -
Wenn ein gehostetes Cloud-Projekt sich dem 200 MB Upload-Limit nähert oder es überschreitet, verwenden Sie
cloud render --dry-run --jsonund folgen Sie der.hyperframesignore-Untersuchung inreferences/cloud.md. Ignorieren Sie niemals ein Asset nur, weil es groß ist. -
Rendern Sie niemals nur, weil Prüfungen bestanden wurden. Halten Sie bei der finalen Vorschau an und warten Sie auf die Genehmigung.
Studio-gesteuerte Bearbeitungen
Wenn der Benutzer sich auf "dieses Element" oder die aktuelle Auswahl bezieht, fragen Sie Studio ab, anstatt zu raten:
npx hyperframes preview --context --json --context-fields selection
Verwenden Sie selection.target.hfId, wenn verfügbar, ansonsten dessen Selektor und Quelldatei. Wenn das Ergebnis no-selection meldet, bitten Sie den Benutzer, auf das Element zu klicken und den Befehl erneut auszuführen. Fordern Sie nur die Kontext-Ausschnitte an, die Sie benötigen; verwenden Sie --context-detail full nur für berechnete Stile oder bearbeitbare Textmetadaten. Das vollständige Verhalten und die Fehlercodes finden Sie in references/preview-render.md.
Rendering-Optionen
| Bedarf | Befehl |
|---|---|
| Schnelle lokale Iteration | npx hyperframes render --quality draft |
| Erste echte Kodierung | npx hyperframes render --quality looks --output out.mp4 |
| Finale lokale Lieferung | npx hyperframes render --quality delivery --output out.mp4 |
| Reproduzierbares Container-Rendering | npx hyperframes render --... (gekürzt) |
Dies ist die lokalisierte Version der ursprünglichen SKILL.md-Datei.