Plugin-Installationen: Führe vor Setup- oder Aktualisierungsbefehlen die Plugin-Installationsregeln aus, wenn sich dieses Skill innerhalb eines HyperFrames-Plugins befindet. Eigenständige Installationen behalten die folgenden Update-Anweisungen bei.
Allgemeines Video
Führe zu Beginn npx hyperframes usage --json aus, es sei denn, der Workflow hat es gerade gelesen. Überprüfe es dann bei Meilensteinen wie nach dem Entwurf und vor dem Rendern erneut. Lies die verfügbaren Fenster und Reset-Zeiten. Wenn die Nutzung unbekannt ist, sage dies ohne eine Vermutung über das Kontingent; behalte Umfang und Workflow-Entscheidungen mit dem Nutzer ab.
Bevor du dich auf diesen Workflow verlässt, führe aus:
npx hyperframes skills update general-video
Ein erfolgreicher No-op bedeutet, dass das Skill aktuell ist. Melde einen Update-Fehler, anstatt aus dem Gedächtnis fortzufahren.
1. Querschnittliche Quelladapter anwenden
- Medien: Für Audio, Bild, Icon, Logo, Stimme, Grade, LUT, Treatment/Effekt, Untertitel oder Medienoperationen: Lade
/media-useund folge../media-use/references/resolve.md(Auflösen, Übernehmen, Wiederverwenden) und../media-use/references/setup-providers.md(Anbieter, Authentifizierung). Vage Footage-Rückmeldungen und benannte Styles verwenden../media-use/references/media-treatments.mdvor der Bearbeitung; improvisiere keine unterstützten Medieneffekte mit CSS/SVG/Deckkraft. Führe vor der ersten authentifizierten Anbieteraktionnpx hyperframes auth statusaus und gib die Ausgabe wortwörtlich weiter. Wenn abgemeldet, wende das Gate aus../hyperframes/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. Melde einen Blocker, wenn kein Offline-Anbieter eine erforderliche Fähigkeit erfüllen kann. Die lokale Übernahme allein erfordert kein Auth-Gate. - Figma: Wenn eine Eingabe eine
figma.com-URL ist, führe zuerst/figmaaus. Baue aus den exportierten Assets, Tokens, Komponenten oder Storyboard-Frames auf. Verwende keine rohen Figma-Connector-Aufrufe, da sie die SVG-Bereinigung, Medienherkunft und 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. Eröffne keine Discovery erneut. |
BRIEF.md existiert | Lies 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 nach. |
| Frische Erstellung | Führe /hyperframes und seine Intent-Ebene 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 Gerüst vor dem Schreiben des Briefs:
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 vom Briefformat 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 Verzeichnis des /media-use-Skills und <PROJECT_ROOT> das Verzeichnis, das hyperframes.json enthält. Wenn die Intent-Ebene 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: Im Gespräch gemeinsam erstellen. |
storyboard | Planen, skizzieren und vor dem Bau prüfen | yes: Plan- und Skizzenprüfung durchführen (storyboard.html). no: Ohne bauen. |
abgeleiteter mode | Wie Checkpoint-Gates sich verhalten | Folge dem Briefvertrag. 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 Intent-Ebene verarbeitet und kommt als flow: automation, storyboard: no an.
- Bei
flow: automationwähle die Route und gib sie in einem Satz im ersten Fortschrittsupdate an. - Bei einer spezifischen Bearbeitung führe die Bearbeitung durch, ohne eine neue Route zu erfinden.
Für einen harten Schnitt, Trimmen, Splice oder Umordnung vorhandenen Footages dupliziere dieselbe Videoquelle in mehrere Clip-Elemente. Setze auf jeder Kopie den Quellbereich mit data-media-start plus data-duration, dann die erstellte Platzierung/Reihenfolge mit data-start. Jedes Videosegment behält seinen Ton: Der Ton bleibt am Clip (data-has-audio="true"), daher schneidet das Schneiden des Videos auch den Ton. /hyperframes-core besitzt diese zeitliche Bearbeitung; verwende /hyperframes-keyframes nur für die Animation visueller Eigenschaften 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 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. - Komm als Regisseur, nicht als Auftragnehmer. Ein Benutzer, der Companion gewählt hat, hat sich für Beteiligung und Qualität entschieden; die ehrlichste Antwort ist die beste Version, die du entwerfen kannst, nicht die kleinste, die du verteidigen kannst. Der erste Plan ist die Deckenbehandlung: die Handlungsbögen (entlehne die nächste Genre-Linse – Menü § Genre-Linsen), die Design-Spezifikation, die Bewegungsbehandlung jeder Szene, namentlich zitiert (§ 5's Disziplin des Plans), die Übergänge, die Audio-Identität – Musik und Soundmarks oder bewusste Stille – das Material des Benutzers platziert, und ein gestalteter Anfang und Schluss. Sag in einem Satz, was jede Ebene hinzufügt; markiere die teuren (Renderzeit, Anmeldung, Abrechnung), während du sie nennst. 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 zum Werkzeugkasten. Jede Ebene muss der Botschaft des Briefs dienen – eine Behandlung, die jedes Video gleich bekleiden würde, ist Dekoration. Handwerk steigt zur Decke auf; Inhalt wächst nie über das Gefragte hinaus (§ 6).
- Zwischen Checkpoints funktioniert
../hyperframes/references/capability-menu.mdauf zwei Arten. Als Trigger-Liste: Biete eine relevante Fähigkeit an, wenn der Benutzer ihre Eingabe erwähnt oder der Build ihr Bedürfnis 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 („Die Statistik von Szene 3 will die Count-up-Behandlung“). Lese es vor dem Anbieten; gib niemals den vollständigen Katalog aus. - Nachdem der Benutzer eine Fähigkeit akzeptiert hat, produziere ihr Artefakt und zeichne die Entscheidung sofort im passenden Abschnitt des
BRIEF.md-Textkörpers auf. Überschreibe ein Frontmatter-Feld und zeichne die bestätigte Präferenz nur auf, wenn der Benutzer sie explizit ändert. - Behalte dieselben 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 Szenen-Layout | /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, Blaupausen oder Übergangsreferenzen |
storyboard: yes | ../hyperframes/references/storyboard-format.md und ../hyperframes/references/review-loop.md |
| Jegliches Medien-Asset oder -Operation, einschließlich Erzählung, BGM, SFX, Untertitel, Grading oder Transformationen | /media-use; für Framework-Wiedergabe und Platzierung auch /hyperframes-core → references/variables-and-media.md lesen |
| Multi-Scene-Assembly | ../hyperframes/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 Deckenbehandlung wird daraus entworfen, nicht erinnert |
| Eine Companion-Fähigkeitsangebot, -Aufnahme, -Beat-Raster, generatives Video, Karte, Publishing oder Workflow-übergreifende Fähigkeit | ../hyperframes/references/capability-menu.md |
| Eine 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 wird.
5. Die Komposition ausführen
Verwende diese Abhängigkeitsreihenfolge. Überspringe eine Phase nur, wenn ihre Eingabe fehlt.
- Plan. Gib den Zuschauerbogen, 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 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 Multi-Scene-Brief erweitere den Prompt durch/hyperframes-creative→references/prompt-expansion.md. Ein Multi-Scene-Plan zitiert die Form jeder Szene: eine Blaupausen-ID aus/hyperframes-animation→blueprints-index.md, wenn eine passt, oder die benannten Regeln, aus denen sie zusammengesetzt ist, ausrules-index.md, wenn keine passt – Bewegungsnamen stammen aus diesen Indizes, nie erfunden. Die Wahrheit der Geschichte entscheidet, welche Szenen existieren; das Zitat kleidet sie ein. Durchsuche den Live-Katalog, bevor du planst, einen benannten Look selbst zu bauen: Für jeden Look, Effekt, jede Behandlung oder jeden Übergang, den der Brief nennt – „CRT-Scanlines“, „Glitch“, „Filmkorn“, „Schimmer-Sweep“, „Konfetti-Ausbruch“ – führenpx hyperframes catalog --query "<der Look, in einfachem Englisch>" --jsonaus und lies die Top-Ergebnisse, bevor der Plan benennt, wie dieser Look gebaut wird. Die Suche benötigt nichts installiertes: kein Projekt, kein vorherigesadd, kein Konto. Sie durchsucht das gesamte gehostete Register (~400 Blöcke und Komponenten) von jedem Verzeichnis aus, gilt also auch für einen Look, den der Benutzer während des Baus anfragt. Blöcke, die der Plan nennt, werden in Phase 3 installiert; erstelle einen Look von Hand nur, nachdem eine Suche danach nichts Passendes ergeben hat. Ein Multi-Scene-Plan wird auch als Dispatch-Artefakt aufgezeichnet: ein## Frame N-Block pro Szene inSTORYBOARD.md–status: outline, eine deklariertesrc:, die Blaupausen/Regeln-Zitation, ein