video-director-previs
Treffen Sie teure kreative Entscheidungen in der günstigsten Phase. Dieser Skill besitzt die Vorproduktion: Regie, Geschichte, Drehbuch, Storyboard, Styleframes, Animatic, Musik, Soundeffekte, Sprachausgabe, Engine-Wahl, Qualitätssicherung, Review, Versionen und Freigabe. Engines (HyperFrames, video-shotcraft, Remotion, motion-reel, bang-motion, Diffusion Studio) bauen nur das, was der Eigentümer genehmigt hat.
Arbeitsbeispiel: examples/crumb-previs/ (eine fiktive App zum Teilen von Rechnungen). Sein Datenpaket ist der Demofilm im Previs Studio (_shared/previs/studio/films/011-crumb/).
Die App ändert sich nie pro Film. Previs Studio ist eine feste React + TypeScript-App (Quelle _shared/previs/app/, siehe README). npm run build dort type-checkt, bündelt und bindet sie in _shared/previs/studio/index.html und _shared/previs/page/index.html (Vorlage); füge ein Ziel in scripts/inline.mjs für jede pro-Film-Seite hinzu. npm run smoke fährt die erstellte Seite in echtem Chrome auf Desktop, Tablet, Telefon und Vollbild (Screenshots mit --out). Bearbeiten Sie niemals manuell das erstellte index.html.
Was der Eigentümer bekommt: Ansehen (Video-Player mit echtem Vollbild, Hover-Scrub-Vorschau, Endkarte; Kommentarmodus, der den kleinsten Teil unter dem Zeiger benennt, scrollen für größer oder kleiner, ziehen Sie eine Box um mehrere Teile, Stift und Pfeil, ziehen Sie über die Aufnahmenzeile für einen Zeitbereich; Tonspuren mit Wellenformen, Beats, Duck-Kurve, Solo/Stumm/Lautstärke und ziehbaren Soundeffekten, die am Beat einrasten), Entscheidungen, die ihren Moment an Ort und Stelle mit Ton abspielen, Seitenvergleich, Halten zum Hören des Originals, Storyboard (Karten, die ihre Aufnahme an Ort und Stelle abspielen, Alle abspielen, Entscheidungen pro Aufnahme, ein Aufnahmeplan), Plan (Chefregisseur, Geschichte, Regieteam, Look, Ton, Assets, Produktion, Prüfungen, Versionen mit „Rückgängig anfragen“, Spezifikationsexport), eine geführte Überprüfung, Fragen Sie den Regisseur, ⌘K-Suche, Rückgängig/Wiederholen, helle und dunkle Designs, Tooltips auf jedem Steuerelement. Filme kommen nur als Datenpakete an.
Zwei Zuhause, gleiche App
- Previs Studio (alle Filme):
_shared/previs/studio/. Einen Film hinzufügen =films/<id>/previs.json+films/<id>/audio/...und eine Zeile infilms.jsonhinzufügen. Lokal:python3 -m http.server --directory _shared/previs/studio(oder den Eintragprevis-studioin.claude/launch.json). - Pro-Film-Seite:
projects/NNN/previs/page/enthält eine Kopie desselbenindex.html(Titel<Produkt> Previs),films.jsonmit einer Zeile, derenpath""ist,previs.jsonundaudio/. - Als claude.ai Artifact (nur Claude): Veröffentlichen Sie die Seite mit
capabilities: {"db": {}, "user": {}, "sample": {}, "comments": {}, "downloads": true}.dbspeichert Notizen und Auswahlen,samplebetreibt „Fragen Sie den Regisseur“,commentsträgt „An Claude Code senden“,downloadsden Spezifikationsexport. Ohne sie funktioniert die Seite immer noch und speichert im Browser. - Datenbank-Pfade: comments (Änderungsanfragen, die an den Film geheftet sind; die Sammlung behält den alten Namen)
films/<id>/notes(kindframe, region, range, sound, shot, revert oder request;target,targets,box,strokes,quickChips,t/t2,picksundversionzum Zeitpunkt); Auswahlen und Sound-Tweaksfilms/<id>/state/picks(tweaks:<szene>.<sfx>{dt, db},lane.vo|music|sfx{db},mix.duck{on}); hinzugefügte Optionenfilms/<id>/state/custom; Genehmigungfilms/<id>/state/approval; Claudes Statusfilms/<id>/state/claude; Aktivitätfilms/<id>/state/activity; notes (freie Gedanken zum gesamten Film: lesen Sie sie als Hintergrund, niemals als Aufgaben)films/<id>/pad.
Libraries: mehr als drei Optionen auf Abruf
Jede Entscheidung liefert drei Regie-Optionen; D['libraries'] fügt mehr Optionen hinzu, die der Rezensent (oder der „Fragen“-Tab) einziehen kann: direction (Looks: Token-Sets + fonts_url), music (CC0-Betten mit bpm, phase, tags, level), motion (ease, spring {f,d} oder bezier), pacing, camera, transition, sfx (jeder Ton im Film) und voice (Fish-Stimmen: dir, durs, texts für andere Sprachen, intro, sample). Die globale voice-Entscheidung wählt den Erzähler; eine Stimme löst jede Zeile in <dir><szene>-<A|B|C>.mp3 auf, und eine Stimme mit needs und ohne dir spielt als Untertitel, bis sie aufgenommen ist. Hinzugefügte Optionen leben in der Seitendatenbank, sind rückgängig zu machen und gehen in die genehmigte Spezifikation ein. Bauen Sie Libraries mit examples/crumb-previs/libraries.py als Modell:
- Musik: Durchsuchen Sie Freesound CC0 (
freesound.py search ... --min-dur 20),freesound.py get, dannpython3 _shared/previs/music_lib.py <page>/audio/music/lib <oggs>(beat-ausgerichtete 24 s Auszüge, gemessenes BPM); schreiben Sie Tags und ein „Warum“ pro Bett; Zeilen in_shared/ASSETS.md. - Stimmen: Wählen Sie öffentliche Fish-Stimmen mit
search_voices(keine echten Personen oder Zeichen-Klone), listen Sie sie invoices/voices.tsvauf, schreiben Sievoices/lines-<lang>.txt, führen Sievoices/make_voices.shaus (kostenloses Modell), dann überprüfen Sie Takes punktuell mit whisper-cli und generieren Sie alle, die Wörter fallen lassen, neu. - Der KI-Regisseur („Fragen“-Tab,
lib/director.ts) kann auch Looks entwerfen (kontrastgeprüft, erlaubte Google Fonts), Bewegungsgefühle und neue Zeilenformulierungen (diese benötigen eine Aufnahme: es stellt eine Anfragenotiz für Claude Code).
Claude Codes Seite der Notizen (dies in jeder Runde tun)
Der Eigentümer sendet Notizen von der Seite („An Claude Code senden“: ein Live-Kommentar, der eine beobachtende Sitzung weckt, oder eine kopierte Nachricht). Dann:
0. Ziehen, bevor Sie ändern. Claude auf claude.ai kann einen „An Claude Code senden“-Thread selbst beantworten, die Datendatei bearbeiten und eine neue Version veröffentlichen. Lesen Sie vor dem Bauen das veröffentlichte previs.json, vergleichen Sie es mit Ihrem lokalen Build und übertragen Sie jede Änderung in build_previs.py, damit der nächste Build sie behält.
- Setzen Sie
films/<id>/state/claude {state: "reading"|"working"|"publishing"|"idle", at, message, version, open}, damit die Seite zeigt, was Sie tun. - Für jede offene Notiz:
updateSie sie mitclaude: {state:"seen"}, wenn gelesen,{state:"working"}während der Änderung, dannstatus:"done",claude:{state:"done", at, msg}und fügen Sie{by:"claude", text, at}zureplieshinzu (pinif_version). Verwenden Siestate:"question"(mit der Frage inmsg), wenn Sie den Eigentümer brauchen,"wontfix", wenn Sie empfehlen, es zu belassen. Notizen mitkind:"request"sind Jobs vom „Fragen“-Tab (eine neue Zeile aufnehmen, einen Ton finden);preferzeigt auf die Option, die der Eigentümer mag;intent:"question"will eine Antwort, keine Änderung. Jedesatist die reale Zeit: nehmen Sie sie vondate -u +%Y-%m-%dT%H:%M:%SZ, niemals eine Schätzung. - Fügen Sie Zeilen zu
films/<id>/activityhinzu ({at, by:"claude", kind:"seen"|"applied"|"published"|"question", text, version}): was Sie gelesen, geändert, veröffentlicht haben. - Antworten Sie im Seitenkommentar-Thread, wenn der Eigentümer „An Claude Code senden“ verwendet hat, und lösen Sie ihn dann auf.
Regeln
- Ein Regisseur, kein Komitee. Arbeiten Sie untenstehende Spezialisten-Checkliste selbst und in dieser Reihenfolge ab. Keine Workflows oder Unter-Agenten, es sei denn, der Eigentümer fragt (Kostenregel).
- Aggressiv inferieren; nur echte Blockaden fragen (Produktwahrheit, ein fehlendes Asset, eine Lizenzfrage). Niemals ein langer Fragebogen, bevor der Eigentümer etwas sieht.
- Drei Optionen für jede Entscheidung, standardmäßig. Richtung, Musik, Bewegungsgefühl, Tempo, und pro Szene: Übergang, Kamera, Stimme, jedes SFX-Ereignis. Optionen müssen sich echt unterscheiden. Markieren Sie die Wahl des Regisseurs und geben Sie jeder Option einen einfachen Satz zu Warum oder Kompromiss. „Nichts“ ist eine gültige SFX-Option.
- Produktwahrheit. Jede Szene ist mit
real_ui,conceptual_ui,conceptual_visualoderexternal_footagebeschriftet; alles, was nicht real ist, zeigt ein Label im Player. - Hausregeln gelten weiterhin (AGENTS.md, OWNER.md): verbotene Klischees, Träger, zwei Textebenen, aufgenommene Foley, die Standardstimme, Lizenzen. Die Seite spielt nur CC0 oder selbst erstellte Audioinhalte; Mixkit (nur Rendering) erscheint nur namentlich.
- Herunterskalieren. Ein 6-Sekunden-Sting kann eine Richtungskarte, 3 Musikoptionen und eine 6-Sekunden-Animatic sein. Ein 40-Sekunden-Produktfilm bekommt das volle Set.
- Sperren. Sobald der Eigentümer genehmigt hat, sind Geschichte, Text, Reihenfolge, Timing und Auswahlen gesperrt. Eine spätere Notiz ändert nur ihr Ziel; listen Sie, was Sie bewahrt haben.
Spezialisten-Checkliste (der Regisseur deckt jeden Punkt kurz ab)
Geschichte (Hook bis 2 s, ein Zustand pro Schlag) · Drehbuch und Stimmlinien (Wörter pro Sekunde ≤ 3,4) · Redaktionelles Tempo (unterschiedliche Aufnahmenlängen, Pausen, nicht jeder Schnitt auf dem Beat) · Art Direction (3 Richtungen als Token-Sets: bg, on-bg, card, on-card, muted, line, paper, on-paper, accent, on-accent, frame, display, ui, mono) · Typografie · Referenzen (borgen / vermeiden / wo verwendet; Grammatik, niemals Inhalt) · Kamera (jede Bewegung hat einen Grund) · Bewegung (Zweck, Easing, Überschwingen ≤ 4 % auf UI, keins auf Typo) · Übergänge (ein einfacher Schnitt ist gültig) · Assets (vorhanden / neu / generiert / Platzhalter, mit Lizenz) · Musik (gemessenes BPM und Phase, Energie-Kurve, wo der Drop landet) · SFX (Asset, Zeit, Auslöser, Verstärkung, Warum) · Mix (Stimme führt, Duck 8 dB, Impact am lautesten) · Engine (gewählt, warum, Alternative, Fallback) · Qualitätssicherung.
Dateien (ein Ordner pro Film)
projects/NNN-name/previs/
build_previs.py # schreibt page/previs.json; kopieren Sie examples/crumb-previs/build_previs.py und bearbeiten Sie es (Szenen = HTML Styleframe + Anim-Tweens)
vo-lines.txt # 3 Formulierungen pro Zeile, für fish_tts.py
page/index.html # erstellt von _shared/previs/app (npm run build; fügen Sie diese Seite als Ziel in scripts/inline.mjs hinzu)
page/films.json # [{"id": "NNN-name", "name": "Product", "path": ""}]
page/previs.json # der gesamte Plan
page/audio/{music,vo,sfx}/
changes.jsonl # append-only Änderungsprotokoll, ein Vorgang pro Zeile
approved-video-spec.json # geschrieben von _shared/previs/freeze_spec.py nach Genehmigung
Schritte
- Lesen Sie das Briefing oder die Einzeiler-Frage und die Produktquelle (echte UI, Tokens, Text). Schreiben Sie
BRIEF.mdmit den inferierten Entscheidungen. - Audio (günstig, lokal):
- Betten: Messen Sie Tempo und Phase durch Comb-Fit über 85–150 BPM auf einer Low-Band-Onset-Hüllkurve (
AGENTS-tooling.md, „Previs“); schneiden Sie 24 s Auszüge, die auf einem Beat beginnen, loudnorm auf −18 LUFS:ffmpeg -ss <phase> -t 24 -i bed.wav -af "loudnorm=I=-18:TP=-2,afade=t=out:st=22.5:d=1.5" page/audio/music/A.mp3. - Stimme:
python3 _shared/tools/fish_tts.py --lines previs/vo-lines.txt --out-dir previs/vo-wav(kostenloses Modell), dann trimmen Sie Stille inpage/audio/vo/sN-{A,B,C}.mp3. - Foley: Kopieren Sie CC0-Vorschauen von
_guide/prompt-studio/media/foley/oder holen Sie sie mitfreesound.py.
- Betten: Messen Sie Tempo und Phase durch Comb-Fit über 85–150 BPM auf einer Low-Band-Onset-Hüllkurve (
- Planen Sie in
build_previs.py(siehe das Beispiel für jedes Feld):project,summary,chief,story(Beats → Szenen),directors,assets,gates,pipeline,changes,directions(3),global.music|motion|pacing|voice(je 3),engine,references,style_rules,audio_notes,qa,versions,film_css(alle Farben via Tokens, Klassen mitf-präfigiert),fonts_url, undscenes[]mithtml,anim(Tweens{s, t:[a,b], f, to, e}auf x, y, s, sx, sy, r, o, clip, w, blur;{s, set, at, until}Klassen-Umschalter;{s, count:[from,to], t, p, d}Zähler;e:'m'folgt dem Bewegungs-Pick),decisions(Übergangstypen cut, push, slide, zoom, iris; Kamera{s,x,y,origin}; vo{text, src, dur, at, copy}),sfx(atkann eine Liste für Läufe sein),key(der Moment des Storyboard-Stills). Geben Sie jedem Element, auf das der Eigentümer zeigen könnte, einen einfachendata-name(„Rechnungssumme“, „Anfrage-Button“). - Lokal prüfen: Servieren Sie den Seitenordner, sehen Sie sich einen Still jeder Szene und einen mittleren Übergang an, schalten Sie alle drei Richtungen einmal um, bestätigen Sie keine Konsolenfehler. Ein Durchlauf, keine Schleife.
- Teilen Sie die Seite (lokal oder als claude.ai Artifact mit den obigen Fähigkeiten) und fügen Sie den Film Previs Studio hinzu. Geben Sie dem Eigentümer den Link und eine Zusammenfassung von fünf Zeilen. Stoppen Sie für eine Überprüfung.
- Überprüfungsschleife (jede Runde ist eine erneute Veröffentlichung):
- Lesen Sie Notizen, Auswahlen und Genehmigung.
- Für jede offene Notiz: ändern Sie nur ihr Ziel, fügen Sie einen Vorgang an
changes.jsonlan ({"v","target","t","change","from","to","reason","preserve":[...]}), markieren Sie dann die Notiz als erledigt mit einer einzeiligen Antwort (Protokoll oben). Einerevert-Notiz bittet darum, eine aufgeführte Änderung rückgängig zu machen. - Erhöhen Sie
versionsund fügen Sie die Änderungen der Runde inbuild_previs.pyhinzu, führen Sie es erneut aus, kopieren Sieprevis.jsonin die Studio-Kopie, veröffentlichen Sie erneut. Der Player zeigt ein „Was hat sich geändert“-Banner und der Plan listet jede Änderung mit einer Rückgängig-Anfrage auf.
- Genehmigung: wenn
state/approvalapproved: truehat (es trägtpicks,tweaksundcustom), speichern Sie es, führen Siepython3 _shared/previs/freeze_spec.py projects/NNN-name/previs --approval <file>aus (es löst hinzugefügte Optionen und die Stimme auf und listetneeds_before_buildauf, wie z. B. nicht aufgenommene Zeilen), schreiben SieSHOTLIST.mdaus der Spezifikation, dann übergeben Sie an die in der Spezifikation benannte Engine. Die Engine baut genau die Spezifikation (Nachbesserung erlaubt, Entscheidungen nicht).
Kosten
Nur Einzelarbeit. Eine 20-Sekunden-Previs sind einige Stunden einer Sitzung (etwa $30–60 API-Äquivalent), mit Fish auf dem freien Modell und ohne Renderings. Das Produktions-Rendering und seine Prüfungen kommen nach der Genehmigung.