finance-video-script

Finance Video Script

Agent (Sie) schreibt das Skript. Das Skript scripts/vengine_cli.py bereitet das Beat-Gerüst vor, nimmt Szenen pro Beat auf und führt Lints gegen den Styleguide durch.

Umfang

• Enthalten: Briefing (inklusive Wahl des visuellen style) → Beat-Sheet → Skript pro Beat (scenes.json) → Lint → visuelle Seitenzuordnung (map-pages) → Export (naskah.md, prompts.json, naskah.srt) → Generierung von KI-Vollbild-Assets (generate-images) → Rendern eines vollständigen kinematografischen MP4-Videos mit indonesischem TTS (render).
• Nicht enthalten: Automatischer Upload auf Plattformen.

Vorbereitung

• Python 3.10+ mit pip install pydantic pyyaml pillow edge-tts imageio-ffmpeg, oder führen Sie es über uv run aus (automatische Abhängigkeiten).
• <skill-dir> = Ordner, in dem sich diese SKILL.md befindet. Alle Befehle: python <skill-dir>/scripts/vengine_cli.py <Befehl> ... (unter Windows kann py anstelle von python verwendet werden).
• Führen Sie die Befehle aus dem Arbeitsverzeichnis des Benutzers aus, nicht aus dem Skill-Ordner. Das Projekt wird in ./video-projects/<slug>/ gespeichert (ändern mit --home DIR oder der Variablen VENGINE_HOME).

Arbeitsablauf

1. Briefing sammeln. Fragen Sie nach, was unklar ist: Thema, Format (A = Geschichte, B = Schritt-für-Schritt-Anleitung, S = Kurzform 30–60 Sekunden), Dauer, visueller style (Voreinstellungen: claymation, flat-vector, 3d-pixar, anime-ghibli, cinematic-realistic, watercolor, comic-book, dark-moody oder eine benutzerdefinierte Beschreibung), Zielgruppe, key_numbers und speziell für Format A die Charaktere (Protagonist, Kontrastfigur, Nebenfiguren). Fragen Sie auch nach Call-to-Action für Kommentare/Abonnements und erwähnten Finanzinstrumenten. Erfinden Sie keine Schlüsselzahlen; diese stammen vom Benutzer oder aus Berechnungen, die Sie selbst in Formeln niederschreiben.
2. Lesen Sie references/panduan-naskah.md, bevor Sie etwas schreiben. Es ist die Quelle der Wahrheit für Stil, Techniken und Regeln zu Zahlen/Behauptungen.
3. Projekt erstellen. init <slug> --topic "..." --format A|B|S --minutes N --style <style>, füllen Sie brief.yaml gemeinsam mit dem Benutzer aus, dann build <slug> (erstellt Story Bible und Beat-Sheet).
4. Pro Beat schreiben (wiederholen, bis alle Beats fertig sind):
   1. beat <slug> zeigt die Aufgabe für den nächsten Beat an: Briefing, Charaktere, drei vorherige Szenen, Inhaltsangabe, Zielwörter/Szene und Tag-Anforderungen.
   2. Schreiben Sie das JSON der Szene in video-projects/<slug>/draft/<beat>.json. image_prompt sollte auf Englisch für jede Szene sein (da alle Szenen als Vollbild gerendert werden).
   3. add <slug> --beat <id> --file video-projects/<slug>/draft/<id>.json.
   4. Bei Fehlern wird der Beat nicht gespeichert. Korrigieren Sie das JSON gemäß der Meldung und führen Sie add erneut aus. Wenn ein Beat nach dem Speichern neu geschrieben werden muss, fügen Sie --replace hinzu. Verwenden Sie --force nur, wenn der Benutzer es verlangt.
5. Überprüfen. status <slug> für Fortschritt, lint <slug> für vollständige Prüfung. Fehler müssen auf Null sein, bevor das Skript als endgültig präsentiert wird; Warnungen werden gemeinsam mit dem Benutzer gelesen und entschieden.
6. Visuelle Seiten zuordnen. Führen Sie map-pages <slug> aus, um page_type und props automatisch gemäß dem Katalog references/design-video.md zuzuordnen.
7. Exportieren. export <slug> erzeugt:
   • video-projects/<slug>/out/naskah.md (kanonisches Skript pro Akt)
   • video-projects/<slug>/out/prompts.json (Illustrations-Prompts als Vollbild, bereit zur Generierung für alle Szenen inklusive Charaktere und Stil)
   • video-projects/<slug>/out/naskah.srt (Untertitel mit Zeitstempeln)
8. KI-Vollbild-Assets generieren. Führen Sie generate-images <slug> aus (optional mit --style <style>, --scene <nummer> zum Wiederholen einer Szene oder --force zum Überschreiben aller), um KI-Vollbilder (Pollinations Flux) herunterzuladen nach video-projects/<slug>/out/images/scene_XXX.png.
9. MP4-Video rendern (optional/nur auf Anfrage). Führen Sie render <slug> aus (optional mit --voice id-ID-ArdiNeural oder id-ID-GadisNeural sowie --fps 12 für den Stop-Motion-claymation-Stil), um die Vollbildhintergründe (mit Stop-Motion- / Ken-Burns-Bewegung, Vignette, Glassmorphismus-Overlay für Zahlen/Punchlines und Karaoke-Untertiteln), indonesisches Voiceover-Audio zu einem einzigen video-projects/<slug>/out/video.mp4 zusammenzufügen.

JSON-Szenenformat

{"scenes": [
  {"narration": "Strategie eins: Geld muss gleich am Anfang getrennt werden.",
   "tags": ["SECTION"], "image_prompt": "clean modern workspace with warm morning sunlight beams", "characters": [], "mood": "warm", "notes": ""},
  {"narration": "Wenn du jeden Tag zwanzigtausend Rupiah beiseitelegst, kommen in einem Monat sechshunderttausend Rupiah zusammen.",
   "tags": ["CALC"], "image_prompt": "neatly stacked glass savings jars with glowing coins on wooden desk",
   "motion_prompt": "Stop-motion claymation, slow subtle push-in camera, soft ambient light flicker", "characters": [], "mood": "neutral",
   "notes": "20.000 x 30 = 600.000"}
]}

• narration: vorgelesen, 15–35 Wörter. PUNCH- und SECTION-Szenen maximal 14 Wörter und stehen für sich.
• tags: PUNCH, BRIDGE, SECTION, CTA, NUMBER, CALC. Die Anforderungen pro Beat finden Sie in der Aufgabe von beat.
• image_prompt: auf Englisch, kein Text oder Zahlen im Bild; wird für jede Szene empfohlen, damit der Vollbildhintergrund kontextuell passend ist (wenn null, erstellt die Engine automatisch einen kontextuellen Hintergrund-Prompt).
• end_image_prompt (optional): auf Englisch für den End Frame, wenn die Szene einen Objekt-/Beleuchtungswechsel hat (z. B. Lichtschalter von dunkel auf hell; wird mit demselben Samen generiert).
• motion_prompt (optional): Bewegungsanweisungen pro Szene (z. B. zoom_flicker, bobbing, switch_light für Stop-Motion-Claymation-Animation).
• characters: Charakter-IDs aus der Story Bible (z. B. protagonis), nicht der Name.
• mood: tense, neutral, warm, uplift, melancholy.
• notes: Muss die Formel A x B = C für CALC-/NUMBER-Szenen enthalten; notieren Sie auch die Quelle der Behauptung.

Unverletzliche Regeln

• Original schreiben. Kopieren oder paraphrasieren Sie keine Referenzvideos oder -transkripte; nur Struktur und Techniken werden übernommen.
• Alle Zahlen neu berechnen. Der Zeitplan zum Erreichen des Zielbetrags muss explizit und ehrlich sein.
• Keine Statistiken ohne Quellenangabe („90% der Menschen...“), keine Ergebnisversprechen. Finanzinstrumente nur als Beispiele und mit Haftungsausschluss-Satz versehen.
• Fiktionaler Inhalt (Format A) wird als „illustrierte Geschichte“ gekennzeichnet.
• Ändern Sie beats.json oder scenes.json nicht von Hand; verwenden Sie add, damit Validierung und Neunummerierung der Szenen erhalten bleiben.

Problemlösung

• Modul 'pydantic' nicht installiert → pip install pydantic pyyaml oder verwenden Sie uv run.
• Projekt ... nicht gefunden → Überprüfen Sie das Arbeitsverzeichnis; das Projekt befindet sich in ./video-projects/ in dem Ordner, in dem der Befehl ausgeführt wurde, oder in --home.
• Lint mirip_referensi → Legen Sie das Referenztranskript als .txt in ./references/ ab (oder --refs DIR); schreiben Sie die gemeldeten Teile in Ihren eigenen Worten neu.
• Lint total_kata → Fügen Sie Szenen in dem Beat hinzu oder entfernen Sie sie, der stark vom Ziel abweicht (siehe status), dann add --replace.