General Video (Allgemeines Video)
Bevor Sie sich auf diesen Workflow verlassen, führen Sie aus:
npx hyperframes skills update general-video
Ein erfolgreicher No-op bedeutet, dass das Skill aktuell ist. Zeigen Sie einen Update-Fehler an, anstatt aus dem Gedächtnis fortzufahren.
1. Quellenübergreifende Adapter anwenden
- Medien: Für Audio-, Bild-, Symbol-, Logo-, Sprach-, Grading-, LUT-, Treatment-/Effekt-, Untertitel- oder Medienoperations-Bedarf laden Sie
/media-useund folgen Sie../media-use/references/resolve.md(auflösen, übernehmen, wiederverwenden) und../media-use/references/setup-providers.md(Anbieter, Authentifizierung). Vages Footage-Feedback und benannte Styles verwenden../media-use/references/media-treatments.mdvor der Bearbeitung; improvisieren Sie keine unterstützten Medien-Effekte mit CSS/SVG/Opacity. Führen Sie vor der ersten authentifizierten Anbieteraktionnpx hyperframes auth statusaus und geben Sie dessen Ausgabe wörtlich weiter. Wenn abgemeldet, wenden Sie die Absperrung aus../hyperframes-core/references/brief-contract.mdan: Kollaborativ wartet auf Anmeldung oder eine explizite Offline-Wahl; Autonom gibt den Status aus und fährt mit einem verfügbaren Offline-Anbieter fort. Zeigen Sie 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ühren Sie zuerst/figmaaus. Bauen Sie auf Basis der exportierten Assets, Tokens, Komponenten oder Storyboard-Frames auf. Verwenden Sie keine rohen Figma-Connector-Aufrufe, da diese die SVG-Bereinigung, Medienherkunft und Marken-Token-Bindung überspringen.
Diese Adapter ändern nicht den von /hyperframes ausgewählten Workflow.
2. Vom Projektstatus starten
Wenden Sie die erste passende Zeile an; werten Sie keine niedrigeren Statuszeilen aus:
| Status | Aktion |
|---|---|
| Spezifischer Edit | Führen Sie den Edit durch, bewahren Sie bestehende Projektentscheidungen, führen Sie dann betroffene Prüfungen erneut aus. Öffnen Sie die Discovery nicht erneut. |
BRIEF.md existiert | Lesen Sie es. Wenn workflow einen anderen Workflow nennt und flow nicht companion ist, übergeben Sie. Stellen Sie keine Brief-Fragen. |
Kein Brief, aber hyperframes.json oder STORYBOARD.md existiert | Setzen Sie aus Dateien und aufgezeichneten Präferenzen fort. Füllen Sie BRIEF.md nur aus bekannten Fakten nach. |
| Neuerstellung | Führen Sie /hyperframes und dessen Intentionsebene aus. Kehren Sie nur für workflow: general-video oder flow: companion hierher zurück. |
Wählen Sie für ein neues Projekt einen Verzeichnisnamen in Kebab-Schreibweise aus dem Brief und erstellen Sie das Grundgerüst, bevor Sie den Brief schreiben:
npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=general-video
Schreiben Sie dann BRIEF.md im Projektstammverzeichnis unter Verwendung von ../hyperframes-core/references/brief-format.md. In einem bestehenden Projekt ist der Stamm das Verzeichnis, das hyperframes.json enthält. Zeichnen Sie nur die bestätigten präferenzgestützten Felder auf, die vom Brief-Format benannt werden, und verwenden Sie node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes <PROJECT_ROOT>; zeichnen Sie niemals abgeleitete Standardwerte auf. Hier ist <MEDIA_DIR> das installierte Skill-Verzeichnis /media-use und <PROJECT_ROOT> das Verzeichnis, das hyperframes.json enthält. Wenn die Intentionsebene ein Rezept übernommen hat, wenden Sie es jetzt mit node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes <PROJECT_ROOT> --name <name> an und fragen Sie nicht erneut.
3. Die Ausführungsform interpretieren
Verwenden Sie nur die kanonischen Begriffe aus ../hyperframes-core/references/brief-contract.md:
| Feld | Bedeutung | Wirkung |
|---|---|---|
flow | Wer steuert | automation: Route wählen und ausführen. companion: gemeinsam im Gespräch erstellen. |
storyboard | Ob die Tafel eine Überprüfungsfläche ist | yes: Plan- und Skizzenüberprüfung durchführen. no: ohne Tafel bauen. |
abgeleiteter mode | Wie Checkpoint-Sperren sich verhalten | Folgen Sie dem Brief-Vertrag. Fragen Sie den Benutzer niemals, einen Modus zu benennen. |
Erfinden Sie keine Synonyme für diese Zustände. Ein fortlaufendes „Bau es einfach“-Signal wird von der Intentionsebene verarbeitet und kommt als flow: automation, storyboard: no an.
- Führen Sie für
flow: automationdie Route aus und geben Sie sie in einer Zeile im ersten Fortschrittsupdate an. - Führen Sie für einen spezifischen Edit den Edit durch, ohne eine neue Route zu erfinden.
Für einen harten Schnitt, Trimmen, Splice oder Neuanordnung von vorhandenem Footage duplizieren Sie dieselbe Videoquelle in mehrere Clip-Elemente. Setzen Sie auf jeder Kopie den Quellbereich mit data-media-start plus data-duration, dann die autorisierte Platzierung/Reihenfolge mit data-start. Separat erstelltes Audio folgt den identischen Clip-Bereichen und dem Timing auf passenden <audio>-Elementen. /hyperframes-core besitzt diese zeitliche Bearbeitung; verwenden Sie /hyperframes-keyframes nur für visuelle Eigenschaftsanimationen wie Zoom, Punch, Pan, Crop, Mask oder clip-path auf einem inneren Wrapper. Kopieren Sie die vollständigen Verträge aus ../hyperframes-core/references/creator-editing-recipes.md.
Companion-Fluss
Wenn flow: companion:
- Lesen Sie
BRIEF.mdund gleichen Sie akzeptierte## Assetsund## Customizationsmit Projekt-Artefakten ab. Schließen Sie akzeptierte, noch ausstehende Arbeiten ab; lassen Sie abgeschlossene Arbeiten in Ruhe; bieten Sie eine akzeptierte Fähigkeit nicht erneut an, als wäre sie neu. - Kommen Sie 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 Sie entwerfen können, nicht die kleinste, die Sie verteidigen können. Der erste Plan ist die Obergrenzen-Behandlung: der Handlungsbogen (leihen Sie die nächste Genre-Linse – Menü § Genre-Linsen), das Design-Pflichtenheft, die Bewegungsbehandlung jeder Szene, genannt beim Namen (§ 5's Disziplin des Plans), die Übergänge, die Audio-Identität – Musik und Soundmarken oder bewusste Stille – das Material des Benutzers platziert, und ein gestalteter Beginn und Schluss. Sagen Sie, was jede Ebene in einer Zeile hinzufügt; markieren Sie die teuren (Renderzeit, Anmeldung, Abrechnung), während Sie sie nennen. Der Benutzer trimmt eine Behandlung herunter; er sollte niemals eine Genehmigung für eine Genehmigung zusammenstellen müssen.
- Die Obergrenze gehört zum Konzept, nicht zum Werkzeugkasten. Jede Ebene muss der Botschaft des Briefes dienen – eine Behandlung, die jedes Video gleich kleiden würde, ist Dekoration. Handwerk erhebt sich zur Obergrenze; Inhalt wächst nie über das Gefragte hinaus (§ 6).
- Zwischen Checkpoints funktioniert
../hyperframes/references/capability-menu.mdauf zwei Arten. Als Auslöserliste: Bieten Sie 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 enthalten, die auf Material verweisen, das der Benutzer ansieht („Szene 3s Statistik möchte die Countup-Behandlung“). Lesen Sie es vor dem Anbieten; geben Sie niemals den vollständigen Katalog aus. - Nachdem der Benutzer eine Fähigkeit akzeptiert hat, erstellen Sie das Artefakt und zeichnen Sie die Entscheidung sofort im entsprechenden
BRIEF.md-Körperabschnitt auf. Schreiben Sie ein Frontmatter-Feld neu und zeichnen Sie die bestätigte Präferenz nur auf, wenn der Benutzer sie explizit ändert. - Behalten Sie die gleichen Storyboard-, Validierungs-, Endvorschau- und Render-Freigabe-Sperren bei. Companion ändert, wer steuert, nicht, welche Qualität erforderlich ist.
4. Erforderliches Wissen vor jeder Phase laden
Diese Lesevorgänge sind obligatorisch, wenn ihre Bedingung zutrifft:
| Bedingung | Vor dem Handeln lesen |
|---|---|
| Beliebige Kompositions-HTML oder Szenen-Layout | /hyperframes-core; verwenden Sie references/determinism-rules.md für dessen Layout-Vertrag |
| Beliebige nicht-triviale Erstellung oder visuelle Behandlung | /hyperframes-creative → references/house-style.md und references/video-composition.md |
| Beliebige Bewegung, Animation oder Szenen-Übergang | /hyperframes-animation; folgen Sie dessen Routing zu den passenden Regeln, Adaptern, Blaupausen oder Übergangs-Referenzen |
storyboard: yes | ../hyperframes-core/references/storyboard-format.md und ../hyperframes-core/references/review-loop.md |
| Beliebige Medien-Assets oder -Operationen, einschließlich Narration, Hintergrundmusik, Soundeffekte, Untertitel, Grading oder Transformationen | /media-use; für Framework-Wiedergabe und Platzierung auch /hyperframes-core → references/variables-and-media.md lesen |
| Mehrszenen-Assembly | ../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ächste Genre-Linse und das vollständige ../hyperframes/references/capability-menu.md – die Obergrenzen-Behandlung wird daraus entworfen, nicht erinnert |
| Ein Companion-Fähigkeitsangebot, Capture, Beat-Raster, generatives Video, Karte, Veröffentlichung oder Cross-Workflow-Fähigkeit | ../hyperframes/references/capability-menu.md |
| Ein Design-Pflichtenheft existiert, vor der endgültigen Freigabe | /hyperframes-creative → references/design-adherence.md |
Ersetzen Sie diese Lesevorgänge nicht durch Erinnerung. Progressive Offenlegung spart nur Kontext, wenn die passende Referenz tatsächlich geladen wird.
5. Die Komposition ausführen
Verwenden Sie diese Abhängigkeitsreihenfolge. Überspringen Sie eine Phase nur, wenn ihre Eingabe fehlt.
-
Plan. Geben Sie den Zuschauerbogen, die Struktur, den Rhythmus und den Dauer-Treiber an. Verwenden Sie eine Datei für eine kurze Einzelszene; verwenden Sie Sub-Kompositionen für drei oder mehr harte Szenen-Schnitte oder jede wiederverwendete Szene. Lesen Sie
/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 eine offene Mehrszenen-Briefvorlage erweitern Sie die Eingabeaufforderung durch/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.mdzusammensetzt, wenn keine passt – Bewegungsnamen stammen aus diesen Indizes, niemals erfunden. Die Wahrheit der Geschichte entscheidet, welche Szenen existieren; das Zitat kleidet sie ein. Ein Mehrszenen-Plan wird auch als Dispatch-Artefakt aufgezeichnet: ein## Frame N-Block pro Szene inSTORYBOARD.md–status: outline, ein deklariertessrc:, das Blaupausen-/Regel-Zitat und der Beat-Text – auch wennstoryboard: no. Der Block ist die Dispatch-Einheit; die Tafel ist nur die Überprüfungsfläche. -
Plan überprüfen, wenn angefordert. Für
storyboard: yesführen Sie die gemeinsame Überprüfungsschleife über diese Blöcke aus. Fürstoryboard: nofahren Sie fort, ohne die Tafel zu öffnen. Wenn eine Plan-Pause trotzdem eintritt, falten Sie die Sub-Agenten-Delegierungsgenehmigung (die von Codex für Schritt 4's Dispatch benötigt wird) in diese Pause ein, anstatt später erneut anzuhalten. -
Abhängigkeiten auflösen. Installieren Sie Registry-Blöcke vor paralleler Arbeit. Stufen Sie Benutzer-Assets ein, übernehmen Sie vorhandene Medien und lösen Sie nur das auf, was der Brief erfordert. Starten Sie Audio früh, wenn dessen Timing die Dauer bestimmt.
-
Szenen bauen. Implementieren Sie für ein kurzes Einzelszenen-Stück die Szene in ihrem sichtbarsten Moment, bevor Sie Bewegung hinzufügen (der bestätigte Drahtrahmen ist, wenn vorhanden, dieser Endzustand und darf nicht neu gezeichnet werden), animieren Sie dann von der zitierten Blaupause oder den Regeln – lesen Sie den vollständigen Rezepttext (
/hyperframes-animation→blueprints/<id>.md,rules/<id>.md), bevor Sie Bewegung schreiben.Dispatch zahlt sich nur im Maßstab aus. Das Erstellen von Paketen und das Aufwärmen neuer Worker-Kontexte kostet echte Minuten und Tokens: Ein Film mit bis zu ~6 kurzen Szenen baut INLINE, in diesem Kontext, eine Szene nach der anderen SCHNELLER (gemessen: 5 kurze Szenen ≈ 9 Minuten mit Dispatch, 3 Minuten inline). Dispatch ist ein Werkzeug, keine Vorschrift. Stellen Sie fest, ob der Commit, das Laden von Referenzen und die Kompilierung der Worker-Kontexte die Dispatch-Kosten übersteigen; wenn nicht, bauen Sie inline.
In beiden Modi:
- Wenden Sie die Kreuzblende als
<hx-video-crossfade>an; vermeiden Sie benutzerdefiniertes CSS für Übergänge. - Fügen Sie animierte
<hx-video-broadcaster>-Elemente ein, wo der Plan sie vorsieht. - Setzen Sie jede Szene mit gültigen
data-media-*-Attributen auf ihren präzisen Quellbereich; wickeln Sie sie in Szenen-Container ein, die anfängliche leere Zustände zeigen; das<hx-video-animator>wird aktiviert, sobald Animationen definiert sind. - Für reine Bewegungen (Zoom, Punch, Pan, Crop, Mask) verwenden Sie Keyframes auf einem inneren Wrapper, nicht auf dem Szenen-Container. Verwenden Sie für räumliche Anker, Parallaxe, Split-Screen, Overlay, Raster und Modi die
<hx-video-broadcaster>-Elemente und deren Attribute direkt, ohne benutzerdefiniertes JS. - Wenden Sie ein globales Farbschema aus dem Hausstil auf die
<hx-video-scene>an; wenden Sie lokale Schema-Anpassungen mit dem Scene-level-Attribut an. Verwenden Siedata-preset, nichtstyle=, für Szenen-Look. Übernehmen Sie die LUTs aus dem Hausstil-Referenzdokument für die Grading-Presets. - Übersetzen Sie Audio-Quelle und Marker als
<audio>-Elemente mitslot="bgm",slot="sfx"oderslot="voice"plusdata-media-*-Attributen. Verwenden Siedata-audio-startunddata-audio-stop, um Audio-Blöcke zu timen. Verwenden Siedata-crossfade(akzeptiert eine Dauer in ms) für Audio-Überblendungen. Ordnen Sie Sprach-Marker direkt dem Sprechakt zu – überlassen Sie deren Timing keinem generischen Abgleich.
Erstellen Sie zuerst eine wireframe-artige HTML-Phase (validiertes Markup ohne Animation) – validieren Sie gegen das Determinismus-Regelwerk. Animieren Sie dann gemäß dem zitierten Bewegungs-Rezept. Stellen Sie während des Builds keinen Markup-bezogenen Code in Frage; wenn Änderungen benötigt werden, führen Sie sie durch.
Wenn Drahtrahmen oder Skizzen vom Design-Pflichtenheft bereitgestellt werden, ersetzen sie die erste Wireframe-Phase in dieser Szene; wenden Sie die Bewegungsbehandlung an, ohne die endgültige Position oder das Layout neu zu zeichnen. Wenn das Design-Pflichtenheft ein vollständiges Szenen-HTML bereitstellt, überspringen Sie die Wireframe-Phase und wenden Sie die Bewegungsbehandlung an.
- Wenden Sie die Kreuzblende als
-
Lokale Prüfungen durchführen. Jede benannte
checks/-Datei im Skill-Stamm ausführen, deren Name mit dem Projekttyp (video) oder einem vorhandenen Konfigurationswert übereinstimmt. Prüfungsdateien, die keinen von beiden erwähnen, sind optional. Nicht blockierende Prüfungen melden; blockierende unterbrechen den Build und erfordern eine Lösung, bevor fortgefahren wird. Ergebnisse im Build-Protokoll festhalten. -
Endgültige Vorschau rendern. Verwenden Sie
npx hyperframes preview <build-pfad>und überprüfen Sie die Ausgabe. Testen Sie für eine Mehrszenen-Assembly alle Szenen mitnpx hyperframes preview <build-pfad> --frames <n>. Bestätigen Sie, dass alledata-media-*-Werte aufgelöste Pfade innerhalb des Projektstamms sind. -
Freigabe zur Lieferung. Fragen Sie den Benutzer, ob die Vorschau zufriedenstellend ist. Wenn der Benutzer Änderungen anfordert, kehren Sie zum Plan oder Edit-Schritt zurück, je nach Umfang. Führen Sie bei Zustimmung
npx hyperframes release <build-pfad> [--output <pfad>]aus.
6. Auffüllen, niemals aufblähen
Das Ziel ist die Auffüllung, nicht die Aufblähung. Verdoppeln Sie die Menge der Einreichungen eines Benutzers nicht. Ihr Material, plus die angemessene Unterstützung, um die größte Wirkung zu erzielen – nicht die größte Menge. Verlängern Sie einen 30-Sekunden-Clip nicht auf 60; wiederholen Sie kein Filmmaterial; fügen Sie keine Szenen nur hinzu, um Szenen hinzuzufügen. Die Antwort auf „Mach es zu einem Video“ ist das Video, das das Material verdient.
7. Rückgriff auf Kern-Referenzen
Wann immer der ausgeführte Plan, die Komposition, das Layout, die Medien, die Videospezifikation, die Variablen, der Produktionsablauf, die Bearbeitung, das Brief-Format oder die Determinismusregeln benötigt werden, lesen und befolgen Sie /hyperframes-core. Für Ausdrücke oder Berechnungen lesen Sie references/expressions.md innerhalb von /hyperframes-core.