Plugin-Installation: Führen Sie vor Einrichtungs- oder Aktualisierungsbefehlen die Plugin-Ausführungsregeln aus, wenn sich dieser Skill innerhalb eines HyperFrames-Plugins befindet. Bei eigenständigen Installationen gelten die untenstehenden Aktualisierungshinweise weiterhin.
HyperFrames Studio Konventionen
Das Studio zeichnet eine Timeline-Zeile pro Element der obersten Ebene. Ein Projekt, das die folgenden Regeln befolgt, öffnet sich als kurze, lesbare Timeline; eines, das dies nicht tut, öffnet sich als Wand aus unbeschrifteten Zeilen, die der Benutzer nicht bearbeiten kann. Dies sind Konventionen für das, was gebaut werden soll. Informationen zum Ändern eines Clips finden Sie unter /hyperframes-core references/creator-editing-recipes.md und erfinden Sie niemals eine andere Form derselben Bearbeitung.
0. Reden, bevor Sie bauen
Lesen Sie die Nachricht, bevor Sie eine Datei öffnen. Entscheiden Sie, was darin gefragt wird:
| Die Person | Sie |
|---|---|
| nennt eine Änderung, und sei es höflich („machen Sie den Titel größer“, „können Sie die dritte Szene herausschneiden?“) | Machen Sie sie. |
| gibt einen gefühlvollen Hinweis zum gebauten Film („Der Einstieg fühlt sich ruckartig an“, „Es ist nicht lang genug“) | Finden Sie die Ursache, ändern Sie das messbare Ding, sagen Sie, was der Hinweis bedeutete und was sich geändert hat, und dokumentieren Sie es gemäß /hyperframes-creative references/storyboard-recipe.md § 4. |
| stellt eine Frage und nennt keine Änderung („Warum hüpft der Titel?“) | Beantworten Sie sie. Ändern Sie nichts. |
| sagt, ändere nichts, warte, „ich denke nur nach“, „lass uns reden“ | Ändern Sie keine Datei, nicht einmal einen Fehler, den Sie bemerkt haben. Bieten Sie es in Worten an. |
| bringt eine Idee für diesen Film ohne konkrete Änderung („Ich möchte, dass das Ende sich größer anfühlt“) | Schlagen Sie die Änderung vor und fügen Sie sie dem Plan hinzu (siehe unten). Ändern Sie keine Kompositionsdatei. |
| bittet um einen neuen Film | Planen Sie ihn (§ 5). |
| genehmigt einen Plan („Bau es“, „Los“) | Bauen Sie das Genehmigte. |
Eine Nachricht, die eine Frage stellt und eine Änderung nennt, erhält die Antwort und die Änderung. Nur wenn Sie nicht erkennen können, ob überhaupt etwas gefragt wird, handelt es sich um ein Gespräch: Eine falsche Antwort kostet eine Nachricht; ein falscher Bau kostet einen langen Durchlauf und eine Runde Anmerkungen.
Eine Gesprächsantwort:
- Antworten Sie zuerst, in einfachen Worten, in ein paar Sätzen.
- Stellen Sie nur Fragen, deren Antwort den Film verändert, jeweils mit einer empfohlenen Antwort und deren Kompromiss („30 Sekunden passen in einen Feed; 60 lassen Platz für die Demo“).
- Wenn es eine Idee zu formen gibt: Bei einem neuen Film, Richtungen gemäß
/hyperframesreferences/pitch-round.md; bei einer Idee für diesen Film, zwei oder drei Optionen für den genannten Teil. Empfehlen Sie eine. - Beenden Sie mit dem nächsten Schritt und dem Wort, das ihn startet („Sagen Sie Bauen und ich beginne“).
Halten Sie den Plan im Projekt fest, nicht nur im Chat: Die nächste Nachricht kann eine neue Sitzung starten, die diese hier nicht sehen kann. Fügen Sie ihn gemäß /hyperframes-creative references/storyboard-recipe.md § 4, wie eine Runde dokumentiert wird, zur STORYBOARD.md hinzu; überschreiben Sie niemals gesperrte Frames. Wenn die Person Sie gebeten hat, gar nichts zu ändern, schreiben Sie nichts: Halten Sie den Plan in der Antwort fest und bieten Sie an, ihn zu speichern.
1. Jede Szene ist eine Unterkomposition
Die Root-Komposition enthält nur getimte Hosts, Medien und Audio. Jede Szene mit verschachtelter Struktur (ein Div, das Kinder enthält, ein Titel mit einem Untertitel, ein Diagramm) ist eine eigene Datei, geladen mit data-composition-src, verdrahtet in references/sub-compositions.md.
Verschachteltes Markup, das innerhalb der Root verbleibt, wird nicht zu einer eigenen Zeile. Es versteckt sich innerhalb einer undurchsichtigen Zeile, die nicht einzeln getrimmt oder verschoben werden kann.
Autorisieren Sie so, als ob ein Struktur-Lint jeden Verstoß ablehnt.
2. Eine einzelle Caption-Spur
- Alle Captions leben auf einer Spur: einem einzelnen Unterkompositions-Host (einem
data-track-index), markiert mitdata-track-kind="captions", der jede Caption-Gruppe in der richtigen Reihenfolge trägt. - Niemals eine Zeile pro Caption-Gruppe, und niemals Captions auf einer Spur mit einer anderen Art gemischt.
- Die Regeln für das Wort-Timing sind unverändert: Siehe
/embedded-captionsund diecaption_*Lint-Regeln.
3. Ein Elementtyp pro Spur
Gruppieren Sie nach Typ, sodass jede Zeile eine Sache ist, die der Benutzer als Set auswählen, stummschalten oder ziehen kann.
| Typ | data-track-kind |
|---|---|
| Basisvideo / A-Roll | video (vom Tag) |
| Szenen, Overlays, Grafiken | graphics |
| Captions | captions |
| Audio (Voiceover, Musik, Soundeffekte) | audio (vom Tag) |
Setzen Sie data-track-kind auf Unterkompositions-Hosts. Video- und Audio-Typen kommen vom Tag, daher benötigen <video> und <audio> kein Attribut. Geben Sie jedem Typ seinen eigenen data-track-index; die Nummer dient nur der Anzeige; sie ändert niemals, was oben gerendert wird. Verwenden Sie CSS für die Überlagerung.
4. Sichere Zonen
Jedes Lineal oder jede Safe-Box-Überlagerung lebt im Vorschaufenster, niemals innerhalb der Komposition. Fügen Sie daher keine Führungselemente zum HTML hinzu. Beide Rahmungen (breit und vertikal) verwenden dieselben zwei Safe-Boxen, Premiere-Standard. Der Vorschalt-Umschalter zeichnet sie mit einem Teilstrich am Mittelpunkt jeder Kante. Quelle: ACTION_SAFE_PERCENT und TITLE_SAFE_PERCENT in packages/studio/src/utils/previewSafeMargins.ts.
| Box | Anteil am Frame | Einzug an jeder Kante |
|---|---|---|
| Action-safe | 90% | 5% |
| Title-safe | 80% | 10% |
- Sichere Ränder: Alles Sichtbare bleibt innerhalb der Action-Safe-Box (90%), und Captions sowie Schlüsselinhalte bleiben innerhalb der Title-Safe-Box (80%).
- Zwei- und 50/50-Layouts halten den Inhalt jeder Hälfte innerhalb der Title-Safe-Box.
5. Ein neuer Film: Planen, Storyboard, Bauen
Die Filme von hyperframes-launches wurden in dieser Reihenfolge erstellt. Jeder Schritt hat einen Besitzer; folgen Sie ihm und wiederholen Sie ihn hier nicht.
| Schritt | Besitzer |
|---|---|
| 1. Brief | /hyperframes references/intent-interview.md. Innerhalb eines bestehenden Projekts bleibt nur eine Weiterführung desselben Films: Eine neue Version oder ein Cutdown, gleicher Workflow und Seitenverhältnis. Stellen Sie die Muss-Fragen, überspringen Sie hyperframes init, überschreiben Sie niemals BRIEF.md oder STORYBOARD.md, fügen Sie einen neuen datierten Abschnitt zu jeder hinzu und sagen Sie dies in der Antwort. Ein Film mit einem anderen Workflow oder Seitenverhältnis startet ein neues Projekt, und die Antwort sagt dies. |
| 2. Richtungen | /hyperframes references/pitch-round.md |
| 3. Storyboard | /hyperframes-creative references/storyboard-recipe.md |
| 4. Bauen | Der Workflow, zu dem der Brief führt (/hyperframes § 2) und seine eigenen Referenzen |
| 5. Anmerkungen | /hyperframes references/review-loop.md |
Was die Launch-Filme für einen Produkt-Launch hinzufügen. Wo der gewählte Bogen des Workflows etwas anderes sagt, gewinnt der Bogen.
- Echtes Filmmaterial für das gelaunchte Produkt. Fragen Sie im Brief nach einer Bildschirmaufnahme, es sei denn, der Workflow erfasst sie selbst (eine Site von ihrer URL aus), und halten Sie ihren Platz mit einem beschrifteten Platzhalter, bis sie eintrifft. Nähern Sie niemals die Benutzeroberfläche des gelaunchten Produkts an. Ein Drittanbieter-Tool, das als Kontext gezeigt wird (eine Chat-App, ein Editor), wird originalgetreu aus einer Aufnahme nachgebaut.
- Eine Welt. Dasselbe Fenster oder Canvas setzt sich über die Beats hinweg fort. Überprüfen Sie jeden Schnitt: Was bestehen bleibt, darf nicht springen.
- Cursor und gescrollter Inhalt. Ein Cursor oder Inhalt, den das Fenster selbst hinausscrollt, verlässt das Fenster oder die Frame-Kante, nicht durch Ausblenden innerhalb des Frames. Element- und Textwechsel folgen dem
cut-catalog.mddes Workflows, wo vorhanden. - Schließen Sie mit dem Befehl oder der Adresse ab, wobei das Logo in noch bewegtes Filmmaterial einfliegt.
- Geben Sie die Laufzeit bei jeder Version an. Das Überschreiten des Ziels ist die Entscheidung der Person, nicht Ihre.
Überprüfen Ihrer Arbeit
Führen Sie hyperframes lint aus und beheben Sie jeden Befund. Öffnen Sie dann das Projekt im Studio und überprüfen Sie, ob die Timeline eine Basiszeile, eine Zeile pro Szenen-Host, eine Caption-Zeile und die Audio-Zeilen anzeigt.