Plugin-Installationen: Führe vor Setup- oder Frische-Befehlen die Plugin-Ausführungsregeln aus, wenn sich dieses Skill innerhalb eines HyperFrames-Plugins befindet. Bei eigenständigen Installationen behältst du die untenstehenden Aktualisierungshinweise bei.
Allgemeines Video
Bevor du dich auf diesen Workflow verlässt, führe folgenden Befehl aus:
npx hyperframes skills update general-video
Ein erfolgreicher No-Op bedeutet, dass das Skill aktuell ist. Zeige einen Aktualisierungsfehler an, anstatt aus dem Speicher fortzufahren.
1. Querliegende Quelladapter anwenden
- Medien: Bei Bedarf an Audio, Bild, Icon, Logo, Stimme, Grading, LUT, Behandlung/Effekt, Untertitel oder Medienoperation lade
/media-useund folge../media-use/references/resolve.md(auflösen, übernehmen, wiederverwenden) und../media-use/references/setup-providers.md(Anbieter, Authentifizierung). Vages Footage-Feedback und benannte Stile verwenden vor der Bearbeitung../media-use/references/media-treatments.md; improvisiere keine unterstützten Medieneffekte mit CSS/SVG/Opazität. Führe vor der ersten authentifizierten Anbieteraktionnpx hyperframes auth statusaus und gib die Ausgabe wörtlich wieder. Bei Abmeldung wende das Gate in../hyperframes/references/brief-contract.mdan: Kollaboratives Arbeiten wartet auf Anmeldung oder eine explizite Offline-Entscheidung; autonomes Arbeiten gibt den Status an und fährt mit einem verfügbaren Offline-Anbieter fort. Zeige einen Blocker an, wenn kein Offline-Anbieter eine erforderliche Fähigkeit erfüllen kann. Die lokale Übernahme allein erfordert kein Authentifizierungs-Gate. - Figma: Wenn eine Eingabe eine
figma.com-URL ist, führe zuerst/figmaaus. Baue auf Basis seiner exportierten Assets, Tokens, Komponenten oder Storyboard-Frames. Verwende keine rohen Figma-Connector-Aufrufe, da diese die SVG-Bereinigung, die Medienherkunft und die Marken-Token-Bindung überspringen.
Diese Adapter ändern nicht den von /hyperframes ausgewählten Workflow.
2. Vom Projektstatus starten
Wende die erste passende Zeile an; werte keine niedrigeren Statuszeilen aus:
| Status | Aktion |
|---|---|
| Spezifische Bearbeitung | Führe die Bearbeitung durch, bewahre bestehende Projektentscheidungen und führe dann die betroffenen Prüfungen erneut aus. Starte keine erneute Erkundung. |
BRIEF.md existiert | Lese es. Wenn workflow einen anderen Workflow nennt und flow nicht companion ist, übergib. Stelle keine Brief-Fragen. |
Kein Brief, aber hyperframes.json oder STORYBOARD.md existiert | Setze aus Dateien und aufgezeichneten Präferenzen fort. Fülle BRIEF.md nur mit bekannten Fakten auf. |
| Frische Erstellung | Führe /hyperframes und seine Absichtsschicht aus. Kehre nur für workflow: general-video oder flow: companion hierher zurück. |
Wähle für ein neues Projekt einen Verzeichnisnamen im Kebab-Case aus dem Brief und erstelle das Gerüst, bevor du den Brief schreibst:
npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=general-video
Schreibe dann BRIEF.md im Projektstammverzeichnis unter Verwendung von ../hyperframes/references/brief-format.md. In einem bestehenden Projekt ist das Stammverzeichnis das Verzeichnis, das hyperframes.json enthält. Zeichne nur die bestätigten, präferenzgestützten Felder auf, die das Brief-Format nennt, und verwende dazu node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes <PROJECT_ROOT>; zeichne niemals abgeleitete Standardwerte auf. Hierbei ist <MEDIA_DIR> das installierte /media-use-Skill-Verzeichnis und <PROJECT_ROOT> das Verzeichnis, das hyperframes.json enthält. Wenn die Absichtsschicht ein Rezept übernommen hat, wende es jetzt mit node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes <PROJECT_ROOT> --name <name> an und frage nicht erneut.
3. Die Ausführungsform interpretieren
Verwende nur die kanonischen Begriffe aus ../hyperframes/references/brief-contract.md:
| Feld | Bedeutung | Wirkung |
|---|---|---|
flow | Wer steuert | automation: Route wählen und ausführen. companion: gemeinsam im Gespräch erstellen. |
storyboard | Planung, Skizze und Überprüfung vor dem Build | yes: Planung und Skizzen-Review durchführen (storyboard.html). no: ohne Build bauen. |
abgeleiteter mode | Wie sich Checkpoint-Gates verhalten | Folge dem Brief-Contract. Frage den Benutzer nie, einen Modus zu benennen. |
Erfinde keine Synonyme für diese Zustände. Ein laufendes „Bau es einfach“-Signal wird von der Absichtsschicht verarbeitet und kommt als flow: automation, storyboard: no an.
- Führe bei
flow: automationdie Route aus und nenne sie in einer Zeile im ersten Fortschrittsupdate. - Führe bei einer spezifischen Bearbeitung die Bearbeitung durch, ohne eine neue Route zu erfinden.
Für einen harten Schnitt, Trim, Splice oder eine Neuanordnung von vorhandenem Footage dupliziere dieselbe Videoquelle in mehrere Clip-Elemente. Setze auf jeder Kopie den Quellbereich mit data-media-start plus data-duration und dann die erstellte Platzierung/Reihenfolge mit data-start. Separat erstelltes Audio folgt den identischen Clip-Bereichen und dem Timing auf passenden <audio>-Elementen. /hyperframes-core verwaltet diese zeitliche Bearbeitung; verwende /hyperframes-keyframes nur für visuelle Eigenschaftsanimationen wie Zoom, Punch, Pan, Crop, Mask oder clip-path auf einem inneren Wrapper. Kopiere die vollständigen Verträge aus ../hyperframes-core/references/creator-editing-recipes.md.
Companion-Flow
Wenn flow: companion:
- Lese
BRIEF.mdund gleiche die akzeptierten## Assetsund## Customizationsmit den Projekt-Artefakten ab. Schließe akzeptierte Arbeiten ab, die noch ausstehen; lasse abgeschlossene Arbeiten in Ruhe; biete eine akzeptierte Fähigkeit nicht erneut an, als wäre sie neu. - Erscheine als Regisseur, nicht als Auftragnehmer. Ein Benutzer, der den Companion-Modus wählt, wählt Beteiligung und Qualität; die ehrliche Antwort ist die beste Version, die du entwerfen kannst, nicht die kleinste, die du rechtfertigen kannst. Der erste Plan ist die Deckenbehandlung: der Handlungsbogen (leihe die nächstgelegene Genre-Linse – Menü § Genre-Linsen), die Designspezifikation, die Bewegungsbehandlung jeder Szene mit Namen (§ 5's Plan-Disziplin), die Übergänge, die Audio-Identität – Musik und Sound-Marken oder bewusste Stille – das Material des Benutzers platziert, und ein gestalteter Anfang und Schluss. Sage in einer Zeile, was jede Ebene hinzufügt; kennzeichne die teuren (Renderzeit, Anmeldung, Abrechnung) beim Nennen. Der Benutzer trimmt eine Behandlung herunter; er sollte nie eine Genehmigung für eine Genehmigung zusammenstellen müssen.
- Die Decke gehört zum Konzept, nicht zur Toolbox. Jede Ebene muss der Botschaft des Briefs dienen – eine Behandlung, die jedes Video gleich kleiden würde, ist Dekoration. Handwerk steigt bis zur Decke; Inhalt wächst nie über das Gefragte hinaus (§ 6).
- Zwischen Checkpoints funktioniert
../hyperframes/references/capability-menu.mdin zwei Richtungen. Als Auslöserliste: Biete eine relevante Fähigkeit an, wenn der Benutzer ihre Eingabe erwähnt oder der Build ihren Bedarf erreicht. Als Upgrade-Kanal jedes Durchlaufs: Ein Plan-, Skizzen- oder Build-Checkpoint kann ein oder zwei verfolgte Angebote tragen, die auf das Material zeigen, das der Benutzer gerade ansieht („Szene 3s Statistik möchte die Count-up-Behandlung“). Lese es, bevor du ein Angebot machst; gib niemals den gesamten Katalog aus. - Nachdem der Benutzer eine Fähigkeit akzeptiert hat, erstelle das Artefakt und zeichne die Entscheidung sofort im passenden
BRIEF.md-Textabschnitt auf. Überschreibe ein Frontmatter-Feld und zeichne die bestätigte Präferenz nur auf, wenn der Benutzer sie explizit ändert. - Behalte dieselben Storyboard-, Validierungs-, Endvorschau- und Renderfreigabe-Gates bei. Companion ändert, wer steuert, nicht, was die Qualität erfordert.
4. Erforderliches Wissen vor jeder Stufe laden
Diese Lesevorgänge sind zwingend erforderlich, wenn ihre Bedingung zutrifft:
| Bedingung | Lesevorgang vor der Aktion |
|---|---|
| Jegliches Kompositions-HTML oder Szenen-Layout | /hyperframes-core; verwende references/determinism-rules.md für seinen Layout-Vertrag |
| Jegliche nicht-triviale Erstellung oder visuelle Behandlung | /hyperframes-creative → references/house-style.md und references/video-composition.md |
| Jegliche Bewegung, Animation oder Szenen-Überleitung | /hyperframes-animation; folge seiner Weiterleitung zu den passenden Regeln, Adaptern, Blaupausen oder Übergangs-Referenzen |
storyboard: yes | ../hyperframes/references/storyboard-format.md und ../hyperframes/references/review-loop.md |
| Jegliches Medien-Asset oder -Operation, einschließlich Erzählung, Hintergrundmusik, Soundeffekte, Untertitel, Grading oder Transformationen | /media-use; für Framework-Wiedergabe und Platzierung lies auch /hyperframes-core → references/variables-and-media.md |
| Mehrszenen-Montage | ../hyperframes/references/production-loop.md |
flow: companion, vor dem ersten Plan | /hyperframes-creative → references/story-spine.md und references/house-style.md; die nächstgelegene Genre-Linse und das vollständige ../hyperframes/references/capability-menu.md – die Deckenbehandlung wird daraus entworfen, nicht abgerufen |
| Ein Companion-Capability-Angebot, Capture, Beat-Gitter, generatives Video, Karte, Veröffentlichungs- oder Cross-Workflow-Capability | ../hyperframes/references/capability-menu.md |
| Eine Designspezifikation existiert, vor der endgültigen Genehmigung | /hyperframes-creative → references/design-adherence.md |
Ersetze diese Lesevorgänge nicht durch Erinnerung. Progressive Offenlegung spart Kontext nur, wenn die passende Referenz tatsächlich geladen wird.
5. Die Komposition ausführen
Verwende diese Abhängigkeitsreihenfolge. Überspringe eine Stufe nur, wenn ihre Eingabe fehlt.
- Plan. Nenne den Betrachter-Bogen, die Struktur, den Rhythmus und den Dauer-Treiber. Verwende eine Datei für eine kurze einzelne Szene; verwende Unterkompositionen für drei oder mehr harte Szenenschnitte oder jede wiederverwendete Szene. Lese
/hyperframes-creative→references/story-spine.mdfür erzählte Bögen,references/beat-direction.mdfür Rhythmus und/hyperframes-core→references/composition-patterns.mdfür Struktur. Für einen offenen Mehrszenen-Brief erweitere die Eingabeaufforderung über/hyperframes-creative→references/prompt-expansion.md. Ein Mehrszenen-Plan zitiert die Form jeder Szene: eine Blaupausen-ID aus/hyperframes-animation→blueprints-index.md, wenn eine passt, oder die benannten Regeln, die sie ausrules-index.mdkomponiert, wenn keine passt – Bewegungsnamen stammen aus diesen Indizes, niemals erfunden. Die Story-Wahrheit entscheidet, welche Szenen existieren; das Zitat kleidet sie. Durchsuche den Live-Katalog, bevor du planst, einen benannten Look selbst zu bauen: für jeden Look, Effekt, jede Behandlung oder Überleitung, die der Brief nennt – „CRT-Scanlines“, „Glitch“, „Filmkorn“, „Schimmer-Sweep“, „Konfetti-Ausbruch“ – führenpx hyperframes catalog --query "<der Look, auf Deutsch>" --jsonaus und lese die obersten Ergebnisse, bevor der Plan nennt, wie dieser Look gebaut wird. Die Suche benötigt nichts installiert: kein Projekt, kein vorherigesadd, kein Konto. Sie bewertet das gesamte gehostete Registry (~400 Blöcke und Komponenten) aus jedem Verzeichnis, gilt also auch für einen Look, den der Benutzer während des Builds anfordert. Vom Plan genannte Blöcke werden in Stufe 3 installiert; erstelle einen Look von Hand nur, nachdem eine Suche danach nichts Passendes ergeben hat. Ein Mehrszenen-Plan wird auch als das Dispatch-Artefakt aufgezeichnet: ein## Frame N-Block pro Szene inSTORYBOARD.md–status: outline, eine deklariertesrc:, die Blaupausen/Regeln-Zitation und den Beat-Text – selbst wennstoryboard: no. Der Block ist die Dispatch-Einheit; das Storyboard-Blatt ist nur die Überprüfungsoberfläche. - Überprüfe den Plan bei Bedarf. Führe bei
storyboard: yesdie gemeinsame Überprüfungsschleife über diese Blöcke aus. Fahre beistoryboard: noohne Planungspause oder Skizzenblatt fort. Wenn eine Planungspause eintritt, verlasse den Prompt nicht. - Baue die Komposition. Installiere alle benötigten Blöcke aus dem Plan mit
npx hyperframes add <block>@<version>. Lies dann/hyperframes-core→references/composition-patterns.mdundreferences/html-structure.md. Baueindex.html, das alle Szenen lädt, und einescenes/- odercompositions/-Datei pro Szene. Bei einem Mehrszenen-Build fülle die Dispatch-Blöcke, während die Szenen erstellt werden. - Lege Medien fest. Befolge
../hyperframes/references/media-placement.md. Verwende immer die Variablen- und Medien-Referenz aus/hyperframes-core→references/variables-and-media.md. Für parallele Audio-Spuren lese/hyperframes-core→references/audio-layering.md. - Überprüfe die Komposition. Validiere die Einhaltung der Hausregeln (
/hyperframes-creative→references/design-adherence.md). Behebe alle Verstöße. Fordere die Überprüfung über die Validierungsschleife des Review-Loops an, wennstoryboard: yeszutrifft. Führe nach jedem Build den Validator aus:npx hyperframes validate --dir <project-dir>und behebe alle gemeldeten Probleme. Überprüfe visuell die Komposition bei WebKit-basierten Browsern. Stelle sicher, dass die Komposition im Vollbildmodus attraktiv ist. - Generiere und überprüfe die Vorschau. Lade das Vorschau-Asset:
npx hyperframes build --out preview.mp4. Teile die Ausgabe sofort (lasse den Benutzer es ansehen). Wenn die Vorschau nicht den Erwartungen entspricht, iteriere zurück zu Stufe 1 (Planung) oder Stufe 3 (Build). Spiele die Vorschau nicht ab, während der Benutzer sie nicht sehen kann. - Exportiere die endgültige Ausgabe. Lade das Export-Asset:
npx hyperframes build --out output.mp4. Kommuniziere, dass Datei bereit zum Hochladen ist.
6. Qualität, Sicherheit und Umfang
- Ausgabequalität: Jeder Render muss den Evaluierungskriterien für allgemeine Videos in der Überprüfungsreferenz des Kerns entsprechen.
- Sicherheit: Validiere alle Benutzereingaben und -dateien auf Sicherheitsprobleme vor der Verarbeitung.
- Umfang: Überschreite nicht den Umfang des Briefs. Wenn der Brief 30 Sekunden vorsieht, liefere 30 Sekunden. Jede Szene, jeder Übergang und jedes Asset muss das Geforderte direkt bedienen. Dekoration, Füllmaterial und sinnlose visuelle Effekte sind innerhalb der ersten Iteration nicht erlaubt. Überschreite niemals die erwartete Renderzeit ohne ausdrückliche Zustimmung.
7. Fehlerbehandlung
Wenn ein Schritt fehlschlägt, gib die Fehlermeldung, die Exit-Codes und alle relevanten Logs aus. Gib dem Benutzer einen klaren nächsten Schritt, ohne den gesamten Workflow abzubrechen.
8. Conventions (Deutsch)
- Die Kompositionssprache ist Deutsch.
- Verwende für alle Benutzeroberflächen-Elemente und Interaktionen Deutsch.
- Alle Dokumentationen und Kommentare sind auf Deutsch.
- Medien-Assets (Bilder, Videos) können in ihrer Originalsprache bleiben.
9. Finale Validierung
Vor dem Abschluss: Stelle sicher, dass alle Regeln korrekt befolgt wurden.