HyperFrames Prompt Builder
Spezialist, der das Marketing-Engine-Piece-Modell (brief, task_kind, provider_override) und den HyperFrames-Kompositionsvertrag verbindet. Spiegelt in der Struktur higgsfield-prompt-builder und topview-prompt-builder wider – gleicher Dispatcher, unterschiedliches Ziel – sodass video-prompt-builder Provider austauschen kann, ohne seine eigene Logik zu ändern.
Wann aufrufen
video-prompt-builderlöst den Video-Provider aufhyperframesfür ein Piece auf.task_kindist einer der Wertemotion-typography,data-viz-reel,programmatic-short(die natives HyperFrames-Aufgaben inPROVIDERS.md).- Ein Piece deklariert
provider_override.video: hyperframesin seinem Frontmatter. - Ein genehmigtes Standbild (Zitatkarte von
gpt-image, Karussell vontopview) wird zur Bewegung hochgestuft und das Typsystem muss bytegetreu zum Original bleiben. - Der Orchestrator benötigt die gleiche Komposition mit neuen Variablenwerten neu gerendert (wöchentlicher KPI-Reel, tägliches Preis-Update, A/B-Varianten-Text), ohne einen KI-Generator neu anzufragen.
Eingaben
brief: Objekt. Die Piece-Brief mit mindestensheadline,body?,cta?,aspect,duration_seconds.task_kind:"motion-typography" | "data-viz-reel" | "programmatic-short".piece_path: Zeichenkette, optional. Pfad zu.specs/pieces/<piece-id>.md. Frontmatter kannprovider_override,compliance_flags,variablesenthalten.client_slug: Zeichenkette. Wird verwendet, um.marketing-engine/clients/<slug>/design.md(oderclients/<slug>/design.mdim Engine-Repo) zu laden.output_dir: Zeichenkette. Wo das Projekt und die endgültige MP4-Datei liegen (Standard:outputs/<client>/<date>/<piece-id>/).dry_run: Boolesch, optional. Wenntrue, wird die Kompositionsspezifikation und die Render-Argumente zurückgegeben, ohnehyperframes-cliaufzurufen.
Ablauf
- Markenkontext laden.
clients/<client_slug>/design.mdlesen und{ colors, type_pairing, spacing_scale, brand_voice }auflösen. Fehlt die Datei, wird die Verarbeitung verweigert – den fehlenden Pfad anzeigen. Markenverstöße können nachgelagert nicht behoben werden. - Überschreibungen auflösen. Wenn
piece_pathgesetzt ist und das Frontmatterprovider_override.videoenthält, bestätigen, dass eshyperframesist; andernfalls sollte dieser Skill nicht ausgeführt werden. - Task-Kind auf eine Kompositionsvorlage abbilden.
motion-typography→kinetic-type-Vorlage, eine Szene, typgetrieben.data-viz-reel→nyt-graph-Vorlage, Hauptszene mit deklarierten numerischen Variablen.programmatic-short→play-mode-Vorlage, Hook/Body/CTA, der gesamte Kundentext als Variablen deklariert.
- Variablen deklarieren. Alles aus der Brief, das sich bei jedem Neurendern ändern könnte (Überschrift, Text, KPI-Zahlen, CTA, Datumsstempel), wandert in
variablesmit explizitem Typ + Bezeichnung + Standardwert. Hartcodierte Texte sind verboten, wenn eine Variable funktionieren würde. - Kompositionsspezifikation erstellen in der Form, die
hyperframeserwartet:{ composition_id, aspect, duration_seconds, scenes, design_tokens, variables, assets, output_dir }.composition_idaus<piece-id>berechnen (slug-sicher). - Render-Argumente erstellen in der Form, die
hyperframes-clierwartet:{ project_path, mode: "render", render_opts: { fps, quality, format, variables, strict: true, strict_variables: true, output } }.quality: "high"für hochgestufte Pieces,"draft"für die Erstbegutachtung. - Kostenschätzung. Lokales Rendern – Schätzung aus
duration_seconds × workers × $0.00(keine Auslagen; stattdessen Wandzeit in Minuten alslatency_estimate_minmelden). - Auflösung protokollieren in
data/video-usage.jsonlmit{ ts, provider: "hyperframes", piece_id, task_kind, composition_id, dry_run }. - Wenn
dry_run, ohne Aufruf vonhyperframes-clizurückgeben. Andernfallshyperframesaufrufen (um das Projekt zu erstellen), dannhyperframes-cli(Moduslint→inspect→render) in dieser Reihenfolge.
Ausgaben
provider_used:"hyperframes".composition_spec: Objekt. Die Eingabe, die an den Skillhyperframesübergeben wird.render_args: Objekt. Die Eingabe, die an den Skillhyperframes-cliübergeben wird (Modusrender).expected_artifact: Zeichenkette. Der MP4-Pfad, der nach dem Rendern existieren wird.latency_estimate_min: Zahl. Geschätzte Wandzeit für das Rendern.cost_estimate_usd: 0 (lokales Rendern; nur Betriebskosten).
Beispiele
Beispiel 1: Wöchentlicher KPI-Reel (programmatic-short)
Eingabe: { brief: { headline: "Semana 21 em números", aspect: "9:16", duration_seconds: 12 }, task_kind: "programmatic-short", client_slug: "saas-consultoria-imagem", piece_path: ".specs/pieces/2026-05-22-kpi.md" }
Ausgabe: Kompositionsspezifikation mit composition_id: "kpi-weekly-2026-05-22", drei Szenen (Hook/Body/CTA), numerischen Variablen (leads, delta_pct); Render-Argumente mit --strict --strict-variables --quality high --variables '{"leads":42,"delta_pct":12}'.
Beispiel 2: Bewegte Zitatkarte (motion-typography)
Eingabe: { brief: { headline: "Coloque a sua marca onde os olhos já estão.", aspect: "1:1", duration_seconds: 6 }, task_kind: "motion-typography", client_slug: "saas-consultoria-imagem" }
Ausgabe: Kompositionsspezifikation mit einer einzelnen kinetischen Typoszene, maskiertem Texteingang, Design-Tokens aus dem aktiven Client-design.md; Render-Argumente mit Ziel outputs/saas-consultoria-imagem/<date>/<piece-id>/final.mp4.
Beispiel 3: Provider-Überschreibung
Eingabe: Ein Piece mit provider_override.video: hyperframes, dessen task_kind nicht in der Matrix ist.
Ausgabe: Trotzdem hierher geroutet, Standard-task_kind auf programmatic-short, Fallback protokollieren.
Unverhandelbare Regeln
- Niemals Design-Tokens erfinden. Verarbeitung verweigern, wenn
design.mdfehlt. - Piecespezifischen Text immer als
variabledeklarieren, auch wenn er statisch erscheint – die Komposition muss ohne Code-Änderungen neurenderbar sein. - Immer
--strict-variablesin den Render-Argumenten übergeben. Ein Tippfehler in einer Variablen-ID ist ein harter Fehler. - Niemals
hyperframes-clidirekt aufrufen, ohne die Reihenfolgelint → inspect → rendereinzuhalten.
Fehlermodi
- Unbekannte
task_kind: Standard aufprogrammatic-short, eine Warnung protokollieren und fortfahren. design.mdfehlt: Anhalten. Keine Farbpalette wählen; den Operator bitten, die Datei hinzuzufügen.- Brief enthält eine markenrechtlich unzulässige Behauptung (gemäß
compliance-<aktiver Client>): Blockieren vor der Autorenschaft; Compliance läuft vorgelagert zum Rendern. - HyperFrames CLI nicht installiert: Installationsbefehl anzeigen (
npm i -g hyperframesodernpx hyperframes@latest) und anhalten.
Verwandte Skills
hyperframes: Kompositions-Erstellungsregeln (von diesem Skill konsumiert).hyperframes-cli: Ausführung von Lint/Inspect/Render (von diesem Skill konsumiert).video-prompt-builder: Dispatcher, der diesen Skill auswählt.qa-tech-specs: Wird gegen die fertige MP4 ausgeführt.compliance-<aktiver Client>/compliance-generic: Wird gegen die aufgelösten Variablen und das gerenderte Artefakt ausgeführt.llm-router: Wird hier nicht direkt verwendet, kann aber das LLM auswählen, das die Überschrift/den Text entwirft, bevor dieser Skill die Kompositionsspezifikation erstellt.