SiuZheng/video-erstellen

Ein Video erstellen

Der Benutzer erstellt mit Ihnen YouTube-Videos: Lange Erklärvideos (16:9) und Shorts (9:16), animiert in Code mit Remotion, vertont mit einer Gemini-Stimme, oft mit einer Figurengrafik. Diese Fähigkeit ist der gesamte Prozess. Die Werkzeuge befinden sich in <videokit>, dem Videokit-Ordner dieses Skill-Repositorys (lesen Sie references/toolkit.md, bevor Sie etwas ausführen). Wenn <videokit> noch nicht durch einen echten Pfad ersetzt wurde, fragen Sie den Benutzer, wo er das Repository geklont hat (den Ordner, der vk.py enthält), und verwenden Sie diesen Pfad.

Dem Benutzer liegen drei Dinge am meisten am Herzen, und deshalb ist der Prozess so gestaltet:

1. Es wird nichts gebaut, bevor sie einen Entwurf genehmigt haben. Sie wollen zuerst die Geschichte und genau sehen, wie jede Szene aussehen und klingen wird – ihre Übergänge, Animation, Beleuchtung, Soundeffekte und Qualität. Einen Plan zu ändern kostet Minuten; ein Rendering zu ändern kostet Stunden.
2. Es muss professionell aussehen. Motivierte Übergänge mit Bewegungsunschärfe, abgestufte Bewegung, Tiefe, echte Beleuchtung, ein Sound für alles, was passiert, sauberes 1080p. references/pro-look.md erklärt, was das in der Praxis bedeutet und welche Komponenten es umsetzen.
3. Sie wollen das fertige Video, keinen Strom von Fragen. Ein Reviewer-Agent beantwortet die Fragen während des Prozesses und bewertet die Arbeit anhand einer festen 10-Punkte-Checkliste; der Benutzer erhält das Video, sobald es 9/10 erreicht. references/review.md beschreibt wie: wer was entscheidet, die Checkliste, die Aufforderungen und wann aufzuhören ist. Reviews kommen früh (der Entwurf, das Animatic), wenn Änderungen billig sind, nicht erst am Ende.

Die Phasen

Jede ✋ ist ein Stopp: Warten Sie auf die Antwort, bevor Sie fortfahren. ✋ Benutzer: Der Benutzer entscheidet. ✋ Reviewer: Der Reviewer-Agent tut es (ein Agent für das gesamte Video, fortgesetzt mit SendMessage – review.md).

0. Das Briefing ✋ Benutzer

Fragen Sie, was Sie aus der Anfrage nicht erkennen können, mit AskUserQuestion (bis zu 4 Fragen pro Aufruf; ein zweiter Aufruf für alles Übrige). Gehen Sie bei keinem dieser Punkte von etwas aus, selbst wenn das Thema einen nahelegt:

• Format: Langvideo (16:9, 1920×1080) · Short (9:16, 1080×1920, unter 3 Min.) · beide (ein Langvideo plus 3-5 daraus geschnittene Shorts).
• Erzählung: KI-Stimme (Gemini TTS; Sie senden Samples) · keine Erzählung (Musik + Text auf dem Bildschirm) · die eigene Aufnahme des Benutzers.
• Look: Bieten Sie 3-4 konkrete Stile an, die zum Thema passen (z. B. cineastischer, code-gezeichneter Raum mit echtem Licht; saubere, flache Bewegungsgrafik; handgezeichnetes Doodle; Märchenbuch-Papierschnitt), jeder in einer Zeile beschrieben.
• Figuren: ihre vorhandenen Figurengrafiken (in <videokit>/sprites; python vk.py characters listet sie auf) · neue Figuren, generiert mit einem Bildgenerierungswerkzeug wie Gemini (Nano Banana, kostet Geld) · Emoji · in Code gezeichnet · keine.
• Alle anderen Assets (Requisiten, Objekte, Symbole, Hintergründe) – fragen Sie dies separat, jedes Mal: in Code gezeichnet (kostenlos; der Look der Effektbibliothek) · Emoji (kostenlos; die Emoji-Komponente, beleuchtet wie alles andere) · generiert mit einem Bildgenerierungswerkzeug wie Gemini (kostet Geld) · eine Mischung, Asset für Asset im Entwurf entschieden. Fragen Sie es bei jedem Video. Generierte Bilder werden nur erstellt, wenn der Benutzer dies hier ausgewählt hat.
• Musik: eine Originalpartitur (Stimmung: Wunder / Spannung / verspielt / episch) · eine Note-für-Note für dieses Video komponierte Partitur (ein Thema, Akkorde und auf die Szenen abgestimmte Einsätze – toolkit.md „Eine komponierte Partitur“) · ihr eigenes Lied (sie senden Audio und Text – niemals herunterladen) · keine.

Klären Sie auch das Thema, die Länge und die Sprache, wenn sie nicht klar sind. Dann erstellen Sie das Projekt: python -X utf8 vk.py new <ordner> --title "..." --format long|short|both (aus dem Videokit-Ordner; das Projekt wird daneben erstellt).

1. Der Entwurf ✋ Reviewer, dann ✋ Benutzer

Recherchieren Sie das Thema (überprüfen Sie jede Tatsache; notieren Sie alles, was vom heutigen Datum abhängt), schreiben Sie script.md (die Erzählung, eine aufgenommene Zeile pro "> "-Zeile), dann schreiben Sie plan.md aus der Vorlage, die bereits im Projekt ist. references/draft.md erklärt jeden Abschnitt. Das Herzstück ist die szenenweise Tabelle: für jede Einstellung die Erzählung, was wir sehen (und was die Figur darin tut), die Kamera und Animation, der Übergang rein und raus, die Beleuchtung und Farbe, die Soundeffekte und die Musik. Plus die Look-, Bewegungs-, Beleuchtungs-, Übergangs- und Tonpläne, die Qualitätsspezifikationen, die Shorts (wenn "beide"), Fakten mit Quellen und die Kosten. Schreiben Sie auch 2-3 Hook-Optionen (jeweils eine erste Zeile und ein erster Frame). Für einen Short folgen Sie draft.md "Die ersten 3 Sekunden": die Überraschung bis Sekunde 1, eine Aktion mit einem Ton bei Frame 0, ein heller erster Frame. Echte Short-Zahlen zeigen, dass Views dort gewonnen oder verloren werden; die eigenen des Benutzers finden sich in references/channel-numbers.md.

Die Entwurfsprüfung: Starten Sie den Reviewer mit plan.md und script.md (review.md, „Starten"). Beheben Sie jeden Mangel, den es findet, und alles, was der Entwurf für die Punkte beheben kann, die es mit unter 2 bewertet hat; übernehmen Sie seine Hook-Auswahl in den Entwurf; protokollieren Sie, was Sie übernommen und nicht übernommen haben, in out/review/decisions.md.

Zeigen Sie es dann dem Benutzer: eine kurze Zusammenfassung im Chat (die Geschichte in wenigen Zeilen, die Szenen als kompakte Liste, alles, worüber Sie entscheiden müssen, und die prognostizierte Punktzahl des Reviewers in einer Zeile) mit einem Link zu plan.md. Fragen Sie nach Genehmigung oder Änderungen, überarbeiten Sie und wiederholen Sie, bis er/sie grünes Licht gibt. Nehmen Sie nichts auf, generieren oder animieren Sie nichts vorher – das ist die Regel des Benutzers.

2. Stimme (wenn vertont)

• Die Standardstimme (video.json: Gemini „Kore" mit speed 1,2) erfordert keine Frage. Eine neue Stimme oder einen neuen Stil: vk.py voice samples → senden Sie die Samples (SendUserFile) → ✋ Benutzer: er/sie wählt nach Gehör aus (Agenten können nicht hören, daher geht dies nie an den Reviewer). Setzen Sie es in video.json, mit speed.
• vk.py voice record (zwischengespeichert; identische Zeilen werden aus anderen Projekten kostenlos wiederverwendet), dann vk.py words (Wort-Zeitsteuerungen + eine Überprüfung, dass jede Zeile sagt, was das Skript sagt; hören Sie sich alle an, die es markiert).
• Fehler Gemini 402 = das Prepaid-Guthaben ist aufgebraucht: Stoppen Sie und informieren Sie den Benutzer.

3. Look ✋ Reviewer

• Erstellen Sie jedes Asset so, wie es die genehmigte Asset-Liste des Entwurfs vorgibt (Code, Emoji, Gemini oder vorhandene):
  • vorhandene Grafiken kommen in CHARACTERS / PROP_DIRS in scripts/build.py;
  • generierte (nur wenn genehmigt): ein Bildgenerierungswerkzeug wie Gemini (Nano Banana), in transparente PNGs geschnitten und auf die gleiche Weise eingebunden (toolkit.md, „Gemini Bilder");
  • Emoji: <Emoji char="🚀" .../> (fx/emoji.tsx) mit dem Randlicht der Szene und einem Kontaktschatten;
  • Code: in der Szene mit der fx-Bibliothek gezeichnet (LitSphere, Sun, Formen, DrawPath...).
• Bauen Sie 3-4 Styleframes – die Schlüsselmomente des Entwurfs, vollständig beleuchtet – als Kontaktbogen (vk.py stills ...) und senden Sie ihn an den Reviewer („Eine Entscheidung auf dem Weg"): genehmigen Sie den Look oder sagen Sie, was zu ändern ist. Protokollieren Sie die Antwort.

4. Bauen

1. scripts/build.py: füllen Sie aus dem Entwurf aus – Pausen, Cues (c.at(line, 'phrase')), MOVES (wie jeder Abschnitt hereinkommt), effects() (ein Sound für jedes Ereignis), music() (Stimmung, Intensitätsbogen, Akzente – oder die komponierte Partitur), ambience(), den YouTube-Text. Führen Sie vk.py build aus.

2. Szenen: eine Datei pro Szene in src/scenes/, geschrieben in Story-Sekunden gegen die Cues, unter Verwendung von src/fx (Kamera, Tiefenebenen, Beleuchtung, Partikel, kinetischer Text, die Spur der Figur). Listen Sie sie in src/Video.tsx mit ihren Übergängen auf. Halten Sie die Figur innerhalb der Handlung (stehen auf, reiten, zeigen auf, reagieren auf das, was auf dem Bildschirm ist) – eine Figur, die nur herumschwebt, wirkt wie Füllmaterial. Blockieren Sie zuerst jede Einstellung aus – platziert, zeitlich auf ihre Cues abgestimmt und in Bewegung – bevor der Beleuchtungs- und der Detaildurchgang beginnt. Bewegung bedeutet mehr als die Figur: Ab dem Blocking hat jede Einstellung eine Kamera, die driftet oder sich bewegt, CamLayer-Tiefenbänder und etwas anderes in Bewegung. Ein Short, der 20/20 Punkte mit einer unbewegten Welt hinter der Figur erzielte, wurde dennoch als zu eintönig bezeichnet, sobald er in Bewegung gesehen wurde.

3. Das Animatic ✋ Reviewer: vk.py animatic rendert das gesamte Video in halber Größe mit seinem echten Sound und ohne Bewegungsunschärfe (ca. 1,5 Min. für einen 30-Sek.-Short) und führt die Tempochecks daran durch. Senden Sie es an den Reviewer (die Animatic-Aufforderung). Beheben Sie Hook, Timing und Klarheit jetzt, vor der Verfeinerung.

4. Shorts (wenn „beide"): Spezifikationen in build.py via kit.shorts.build, eine Szene pro Short in src/shorts/.

5. Detaildurchgang: Gehen Sie Einstellung für Einstellung gegen „Mach es reichhaltig" in references/pro-look.md vor und fügen Sie Effekte hinzu, wo immer eine Einstellung schlicht ist. Jede Einstellung benötigt:

   • einen Hintergrund mit Tiefe;
   • ein sichtbares Licht;
   • das Subjekt, das in der Welt sitzt;
   • etwas im Vordergrund;
   • eine Kamera, die nie stillsteht;
   • Hintergrundleben;
   • den Abschluss;
   • den Sound.

   Jedes Video sollte reichhaltig wirken, daher ist dies Teil der Aufgabe, kein Extra. Beachten Sie die Zurückhaltungsregeln, damit es sauber bleibt, und halten Sie Effekte vom Text fern.

5. Überprüfung (Schleife bis sauber)

vk.py qa rendert jeden Cue und jeden Übergangs-Mittelpunkt in Kontaktbögen (out/qa/) und führt dann die automatischen Prüfungen durch → out/qa/<comp>_checks.md: Text unter YouTube-/TikTok-Buttons und -Titeln, kleiner als 44 px, überlappend oder aus dem Frame laufend (auf der Seite selbst gemessen); und beim neuesten Render, Dehnungen, wo sich das Bild kaum ändert, Einstellungen, wo der Hintergrund stillsteht (weniger als 25 % des Frames in Bewegung), Lücken in der Stimme, unbedeckte Streifen entlang des Frame-Rands, die Loop-Naht und die Lautstärke. Beheben Sie jedes Problem, das es auflistet, und sehen Sie sich jeden „sehenswert"-Eintrag an. Gehen Sie dann die Bögen gegen die Checkliste in references/pro-look.md durch – Übergänge in der Mitte, Lichtrichtung, die Figur in der Szene, keine schlichten Frames (alles, was flach oder leer aussieht, wird angereichert) – beheben und erneut ausführen (vk.py qa --auto führt nur die Prüfungen erneut aus, dauert etwa eine Minute). Führen Sie einen kurzen Testrender (vk.py render --frames 0-150) durch, um echte Bewegung und die Rendergeschwindigkeit vor dem vollständigen Render zu sehen. Render verwenden jeden 4-s-Chunk, dessen Frames sich nicht geändert haben, wieder; führen Sie nach einer Korrektur also einfach den Render erneut aus (--fresh nur nach Änderung einer Canvas-Zeichnung oder dem Austausch einer Videodatei).

6. Final ✋ Reviewer

• vk.py final (und vk.py final --comp Short-<id> für jeden Short): 1080p H.264, gesichert als v1/v2..., geprüft auf Größe, fps, Codecs, -14 LUFS und True Peak. Keine Telefonvorschau- oder 720p-Kopien – liefern Sie nur die 1080p-Datei. Dann vk.py qa --auto darauf.
• Die finale Überprüfung (review.md, „Runden und wann aufhören"): Der Reviewer bewertet es anhand der Checkliste und wählt den Titel aus. Beheben Sie die Mängel und die am höchsten priorisierten Korrekturen, protokollieren Sie die Entscheidungen, rendern Sie erneut und senden Sie die neue Version zusammen mit der vorherigen zum Vergleich. Es besteht bei 18/20, wenn kein Punkt 0 ist und keine offenen Mängel vorliegen; stoppen Sie nach 3 Runden, oder früher, wenn eine Runde nichts Neues findet und die Punktzahl stabil bleibt.
• TikTok (Shorts, wenn der Benutzer sie auch dort postet): vk.py final --platform tiktok → " (TikTok).mp4": kein Korn, halber Staub, eine höhere Bitrate und eine leichte Schärfung, weil TikTok jeden hochgeladenen Upload stark neu codiert.
• Thumbnail (src/Thumbnail.tsx → 1280×720 jpg), captions.srt, youtube.md (Titel, Beschreibung mit Kapiteln, Tags, der KI-Stimmen-Offenlegung); shorts.md für Shorts.

7. Liefern

Senden Sie das fertige Video mit SendUserFile, wenn es unter ~30 MB liegt (Shorts sind es normalerweise); geben Sie andernfalls den anklickbaren Pfad an (der TikTok-Schnitt ist normalerweise größer: geben Sie seinen Pfad an). Fassen Sie zusammen, was Szene für Szene darin enthalten ist und wie es abgeschnitten hat: die endgültige Punktzahl des Reviewers (und die früheren Runden), alles, was noch unter 2 liegt, die Kanalnotizen des Reviewers (Dinge über den Kanal als Ganzes – seine Beurteilung) und dass der Reviewer den Sound nur nach Metern beurteilt hat: ein eigenes Anhören mit Sound ist die letzte Prüfung. Fügen Sie die Upload-Notizen hinzu. Speichern oder aktualisieren Sie dann eine Projekterinnerung (was erstellt wurde, wo, welche Entscheidungen der Benutzer getroffen hat). Wenn der Benutzer später fragt, wie ein geposteter Short abgeschnitten hat, fügen Sie seine Zeile zu references/channel-numbers.md hinzu.

Immer geltende Regeln

references/house-rules.md enthält die ständigen Regeln – lesen Sie sie einmal pro Video. Die Kurzfassung: niemals den API-Schlüssel ausdrucken; keine Gemini-Bilder ohne ein Ja; niemals Songs herunterladen oder Texte anderer Künstler auf den Bildschirm bringen; „frage nur"-Fragen erhalten Antworten, keine Bauten; Entwurf vor dem Bauen; nur 1080p; der Reviewer beantwortet die Phasenfragen, während das Briefing, der Entwurf, eine neue Stimme, Geld und alles Öffentliche beim Benutzer bleiben.

Referenzen

• references/review.md – der Reviewer-Agent: wer was entscheidet, die 10-Punkte-Checkliste, die Aufforderungen für jede Phase, das Entscheidungsprotokoll und wann aufzuhören ist.
• references/draft.md – wie man den Entwurf (plan.md) schreibt und präsentiert, einschließlich der 3-Sekunden-Regeln für Shorts.
• references/channel-numbers.md – eine Vorlage für die eigenen YouTube-Statistiken des Benutzers (Stay-Rate pro Short, was jeder Opener gemacht hat) und wie man Studio liest.
• references/pro-look.md – der professionelle Standard: Übergänge, Animation, Beleuchtung, Partikel, Typografie, Sound, Qualitätsprüfungen, Render-Performance und die Komponenten für jeden Bereich.
• references/toolkit.md – Videokit-Befehle (die automatischen Prüfungen, das Animatic, der TikTok-Schnitt), das Projekt-Layout, die Story-Uhr, build.py-Hooks, Shorts, Musikvideos, Windows-Fallen.
• references/house-rules.md – die ständigen Regeln und warum.