Allgemeines Video
Bevor du diesen Workflow verwendest, führe Folgendes aus:
npx hyperframes skills update general-video
Ein erfolgreicher No-Op bedeutet, dass das Skill aktuell ist. Zeige einen Update-Fehler an, anstatt aus dem Gedächtnis weiterzumachen.
1. Quellenübergreifende Adapter anwenden
- Medien: Für Audio-, Bild-, Icon-, Logo-, Sprach-, Grading-, LUT-, Treatment/Effekt-, Untertitel- oder Medienoperations-Anforderungen 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../media-use/references/media-treatments.mdvor der Bearbeitung; 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. Wenn abgemeldet, wende die Absperrung in../hyperframes-core/references/brief-contract.mdan: Kollaborativ wartet auf Anmeldung oder eine explizite Offline-Entscheidung; Autonom meldet den Status 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 keine Authentifizierungs-Absperrung. - Figma: Wenn es sich bei einer Eingabe um eine
figma.com-URL handelt, führe zuerst/figmaaus. Baue aus deren exportierten Assets, Tokens, Komponenten oder Storyboard-Frames auf. Verwende keine rohen Figma-Connector-Aufrufe, da sie die SVG-Bereinigung, die Medienherkunft und die Marken-Token-Bindung überspringen.
Diese Adapter ändern nicht den von /hyperframes ausgewählten Workflow.
2. Vom Projektzustand aus starten
Wende die erste übereinstimmende Zeile an; werte keine niedrigeren Zustandszeilen aus:
| Zustand | Aktion |
|---|---|
| Spezifische Bearbeitung | Führe die Bearbeitung durch, behalte bestehende Projektentscheidungen bei, führe dann betroffene Prüfungen erneut aus. Öffne die Erkundung nicht erneut. |
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 vorhanden | Setze aus Dateien und aufgezeichneten Präferenzen fort. Fülle BRIEF.md nur aus bekannten Fakten nach. |
| Neuerstellung | Führe /hyperframes und seine Absichtsebene aus. Kehre nur für workflow: general-video oder flow: companion hierher zurück. |
Wähle für ein neues Projekt einen Kebab-Case-Verzeichnisnamen aus dem Brief und erstelle das Grundgerüst, bevor du den Brief schreibst:
npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=general-video
Dann schreibe BRIEF.md im Projektstammverzeichnis mit ../hyperframes-core/references/brief-format.md. In einem bestehenden Projekt ist der Stamm das Verzeichnis, das hyperframes.json enthält. Zeichne nur die bestätigten, präferenzgestützten Felder auf, die vom Brief-Format genannt werden, und verwende node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes <PROJECT_ROOT>; zeichne niemals abgeleitete Standardwerte auf. Hier ist <MEDIA_DIR> das installierte /media-use-Skill-Verzeichnis und <PROJECT_ROOT> das Verzeichnis, das hyperframes.json enthält. Wenn die Absichtsebene 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-core/references/brief-contract.md:
| Feld | Bedeutung | Auswirkung |
|---|---|---|
flow | Wer steuert | automation: Wähle und führe die Route aus. companion: Co-kreiere im Gespräch. |
storyboard | Ob das Board eine Review-Oberfläche ist | yes: Führe Plan- und Skizzen-Review durch. no: Baue ohne das Board. |
abgeleiteter mode | Wie sich Checkpoint-Absperrungen verhalten | Folge dem Brief-Contract. Frage den Benutzer niemals, einen Modus zu benennen. |
Erfinde keine Synonyme für diese Zustände. Ein anhaltendes „Baue es einfach“-Signal wird von der Absichtsebene behandelt und kommt als flow: automation, storyboard: no an.
- Für
flow: automationwähle die Route und gib sie in einer Zeile im ersten Fortschritts-Update an. - Führe bei einer spezifischen Bearbeitung die Bearbeitung durch, ohne eine neue Route zu erfinden.
Companion-Flow
Wenn flow: companion:
- Lese
BRIEF.mdund gleiche akzeptierte## Assetsund## Customizationsmit den Projektartefakten ab. Schließe akzeptierte Arbeit ab, die noch aussteht; lasse abgeschlossene Arbeit in Ruhe; biete eine akzeptierte Fähigkeit nicht erneut an, als wäre sie neu. - Erscheine als Regisseur, nicht als Auftragnehmer. Ein Benutzer, der sich für Companion entschieden hat, hat sich für Beteiligung und Qualität entschieden; die ehrliche Antwort ist die beste Version, die du entwerfen kannst, nicht die kleinste, die du verteidigen kannst. Der erste Plan ist die Ceiling Treatment: der Handlungsbogen (verwende die nächstgelegene Genre-Linse — Menü § Genre-Linsen), das Design-Spezifikation, die Bewegungsbehandlung jeder Szene, zitiert mit Namen (§ 5's Disziplin des Plans), die Übergänge, die Audio-Identität — Musik und Sound-Marks oder bewusste Stille — das platziert Material des Benutzers und ein gestalteter Anfang und Schluss. Sage, was jede Ebene in einer Zeile hinzufügt; markiere die teuren (Renderzeit, Anmeldung, Abrechnung), während du sie nennst. Der Benutzer trimmt eine Behandlung herunter; sie sollten niemals eine Genehmigung für die Zusammenstellung benötigen.
- Die Obergrenze gehört dem Konzept, nicht der Toolbox. Jede Ebene muss der Botschaft des Briefs dienen – eine Behandlung, die jedes Video auf die gleiche Weise kleiden würde, ist Dekoration. Handwerk steigt bis zur Obergrenze; Inhalt wächst nie über das Gefragte hinaus (§ 6).
- Zwischen Checkpoints funktioniert
../hyperframes/references/capability-menu.mdin zwei Richtungen. Als Trigger-Liste: Biete eine relevante Fähigkeit an, wenn der Benutzer deren Eingabe erwähnt oder der Build deren Bedarf erreicht. Als Upgrade-Kanal jedes Durchlaufs: Ein Plan-, Skizzen- oder Build-Checkpoint kann ein oder zwei verfolgte Angebote tragen, die auf Material gerichtet sind, das der Benutzer ansieht („Szene 3s Statistik möchte die Zähl-Treatment“). Lese es, bevor du es anbietest; wirf niemals den vollständigen Katalog aus. - Nachdem der Benutzer eine Fähigkeit akzeptiert hat, erstelle ihr Artefakt und zeichne die Entscheidung sofort im passenden
BRIEF.md-Body-Abschnitt auf. Überschreibe ein Frontmatter-Feld und zeichne die bestätigte Präferenz nur auf, wenn der Benutzer sie explizit ändert. - Behalte die gleichen Storyboard-, Validierungs-, Final-Preview- und Render-Approval-Gates bei. Companion ändert, wer steuert, nicht, was Qualität erfordert.
4. Erforderliches Wissen vor jeder Phase laden
Diese Lesevorgänge sind obligatorisch, wenn ihre Bedingung zutrifft:
| Bedingung | Vor dem Handeln lesen |
|---|---|
| Jegliches Kompositions-HTML oder Szenenlayout | /hyperframes-core; verwende references/determinism-rules.md für dessen 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übergang | /hyperframes-animation; folge dessen Routing zu den passenden Regeln, Adaptern, Blueprints oder Übergangsreferenzen |
storyboard: yes | ../hyperframes-core/references/storyboard-format.md und ../hyperframes-core/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 lese auch /hyperframes-core → references/variables-and-media.md |
| Mehrszenen-Montage | ../hyperframes-core/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 Ceiling Treatment wird daraus entworfen, nicht erinnert |
| Ein Companion-Fähigkeitsangebot, Capture, Beat-Raster, generatives Video, Karte, Veröffentlichung oder workflowübergreifende Fähigkeit | ../hyperframes/references/capability-menu.md |
| Ein Design-Spezifikation 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 ist.
5. Die Komposition ausführen
Verwende diese Abhängigkeitsreihenfolge. Überspringe eine Phase nur, wenn ihre Eingabe fehlt.
-
Plan. Gib den Betrachterbogen, die Struktur, den Rhythmus und den Dauer-Treiber an. Verwende eine Datei für eine kurze einzelne Szene; verwende Unterkompositionen für drei oder mehr harte Szenenschnitte oder für 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. Erweitere für einen offenen mehrszenigen Brief die Eingabeaufforderung durch/hyperframes-creative→references/prompt-expansion.md. Ein mehrszeniger Plan zitiert die Form jeder Szene: eine Blueprint-ID aus/hyperframes-animation→blueprints-index.md, wenn eine passt, oder die benannten Regeln, die sie ausrules-index.mdzusammensetzt, wenn keine passt – Bewegungsnamen stammen aus diesen Indizes, niemals erfunden. Die Wahrheit der Geschichte entscheidet, welche Szenen existieren; das Zitat kleidet sie. Ein mehrszeniger Plan wird auch als Dispatch-Artefakt aufgezeichnet: ein## Frame N-Block pro Szene inSTORYBOARD.md–status: outline, eine deklariertesrc:, das Blueprint/Regeln-Zitat und der Beat-Text – auch wennstoryboard: no. Der Block ist die Dispatch-Einheit; das Board ist nur die Review-Oberfläche. -
Überprüfe den Plan, wenn angefordert. Führe für
storyboard: yesdie gemeinsame Review-Schleife über diese Blöcke aus. Fahre fürstoryboard: nofort, ohne das Board zu öffnen. Wenn trotzdem eine Plan-Pause auftritt, füge die Delegierungsgenehmigung des Sub-Agenten (von Codex für Dispatch in Schritt 4 benötigt) in diese Pause ein, anstatt später erneut anzuhalten. -
Löse Abhängigkeiten auf. Installiere Registry-Blöcke vor paralleler Arbeit. Stufe Benutzer-Assets bereit, übernehme vorhandene Medien und löse nur das auf, was der Brief erfordert. Starte Audio früh, wenn dessen Timing die Dauer bestimmt.
-
Baue Szenen. Implementiere für ein kurzes Ein-Szene-Stück die Szene in ihrem sichtbarsten Moment, bevor du Bewegung hinzufügst (das bestätigte Wireframe, falls vorhanden, ist dieser Endzustand und darf nicht neu gezeichnet werden), animiere dann aus dem zitierten Blueprint oder den Regeln – lese den vollständigen Rezept-Text (
/hyperframes-animation→blueprints/<id>.md,rules/<id>.md) bevor du Bewegung schreibst.Dispatch amortisiert sich nur im großen Maßstab. Das Erstellen von Paketen und das Aufwärmen frischer Worker-Kontexte kostet echte Minuten und Tokens: Ein Film mit bis zu ~6 kurzen Szenen baut INLINE schneller, in diesem Kontext, Szene für Szene (gemessen: 5 kurze Szenen ≈ 9 min inline vs. ≈ 21 min paketiert). Verteile nur, wenn der Plan das übersteigt – mehr Szenen oder einzeln schwere – und gib dann jedem Worker 2–3 Szenen, nicht eine, und starte alle Worker in einer einzigen Welle (eine zweite Welle verdoppelt fast das Zeitfenster). Beim Verteilen:
node <SKILL_DIR>/scripts/frame-packets.mjs --project "$PROJECT_DIR" --storyboard "$PROJECT_DIR/STORYBOARD.md"Der Builder schreibt ein begrenztes Paket pro Szene unter
.hyperframes/frame-packets/(den genauen Storyboard-Block der Szene + den Blueprint-Text + jedes zitierte Rezept der Regel, inline) und_role.md(../hyperframes-core/references/frame-worker-role.md), dann:node <SKILL_DIR>/scripts/frame-dispatch.mjs --project "$PROJECT_DIR" --worker-count NDieser Befehl startet durch den Client-Tunnel generierte Sub-Agenten; jeder baut seine Szenenpakete der Reihe nach in diesem einzigen Worker-Thread, wobei er den vollständigen Inhalt von
_role.mdals System-Ebene verwendet. Während die Worker laufen, zeige den Fortschritt an. Verwende nach Abschluss den zentralen Context-Snapshot (diff) des Dispatchers, um fortzufahren. Das Verteilungsmodell ist Szenen-Sharding, nicht Pipeline-Sharding – kein Worker gibt an einen anderen weiter.Baue für lange Szenen ohne Dispatch (oder Szenen, die zu schwer für einen einzelnen Worker sind) dennoch pro Szene und verwende nur die gerenderte Vorschau für die nächste Szene; führe keine vollständigen Ladungen tief in den vorherigen Code durch.
-
Überprüfe das Storyboard, wenn angefordert. Führe den Review-Zyklus über die Frame-Blöcke aus, wenn
storyboard: yes. Verwende../hyperframes-core/references/review-loop.md. Zeichne jede Genehmigungs- oder Änderungsentscheidung auf. -
Finalisiere die Komposition. Wende das Design-Spezifikations-Treatment an. Optimiere die Gesamtstruktur. Baue eine Vorschau – verwende
../hyperframes-core/references/video-preview-format.md:npx hyperframes previewGib den Vorschau-Link aus. Harveste keine Metadaten aus der Vorschau, ohne zuzustimmen.
-
Präsentiere zum Genehmigen. Wenn die Vorschau genehmigt ist, rendere sie mit:
npx hyperframes renderGib Ausgabe-Link und Datei-URL aus.
Die Ausgabe ist eine Videodatei; Zustellung, Veröffentlichung oder Post-Production sind separate Workflows und werden hier nicht angesprochen.
6. Redaktionelle Absperrungen
Diese Absperrungen setzen Konventionen durch, die die Ausgabe vorhersehbar und professionell halten:
| Grenze | Warum |
|---|---|
| Inhalte wachsen nie über das Gefragte hinaus. Stattdessen dienen. | Minimiert Aufblähung, wahrt die Brief-Treue. |
| Keine versteckten Transparenz-Overlays für Placebo-Authentifizierung. | Täuschende UX untergräbt Vertrauen und Prüfbarkeit. |
| Firmentarife (DJI, stock, CDN) sind Partner-Preise, keine Komponenten. | Vermeidet Lizenzprobleme. |
| Eine „Sende es raus“-Änderung ist eine redaktionelle Markierung, kein Build. | Der Build wird neu ausgeführt, weil das Medium sonst unzuverlässig ist. |
| Verwirkliche Qualität, nicht nur Funktionalität. Der „es funktioniert“-Standard ist die Schwelle, nicht das Ziel. | Verhindert mittelmäßige Ausgabe – jedes Stück verdient Absicht. |
| Erkläre die Formatierung nicht; erkläre die Wahl dahinter. | Vermeidet Ablenkung im Review, klärt Designkonsequenzen. |
| Tabellarisches Material, Fuel-Vektoren, generierte Audio-Marke und direkte Text-zu-Video-Cliplinks erfordern Fähigkeitsaktivierung. | Hält die Build-Zeit vorhersehbar und verhindert nicht angekündigte teure Vorgänge. |
Diese sind redaktionell – Behandlungssperren, nicht Hard Locks.
Gelesene Referenzen:
../hyperframes-core/references/brief-contract.md../hyperframes-core/references/brief-format.md../hyperframes-core/references/composition-patterns.md../hyperframes-core/references/determinism-rules.md../hyperframes-core/references/production-loop.md../hyperframes-core/references/review-loop.md../hyperframes-core/references/storyboard-format.md../hyperframes-core/references/variables-and-media.md../hyperframes-core/references/video-preview-format.md/hyperframes-animation/hyperframes-creative→references/house-style.md,references/video-composition.md,references/story-spine.md,references/beat-direction.md,references/prompt-expansion.md,references/design-adherence.md/media-use../hyperframes/references/capability-menu.md