Launch-Video Publish Pipeline

Launch / Walkthrough-Video

Eine wiederholbare Pipeline, um ein Produkt, eine Funktion oder eine Seite in ein kurzes Bewegtvideo mit Sprachausgabe zu verwandeln, es dann auf YouTube zu veröffentlichen, auf der Seite einzubetten und anzukündigen. Sie existiert, weil dies von Hand zu tun bedeutet, jedes Mal ein Dutzend nicht offensichtlicher Details neu zu entdecken (OAuth-Eigenheiten, Voice-Over-Synchronisations-Mathematik, das Click-to-Play-Embed, Lautstärkeziele).

Standardausgabe: ein 1080p / 30fps-Video, ~45–60s, mit einer emotionalen Sprachausgabe, das zuerst ungelistet zur Freigabe durch den Benutzer hochgeladen wird, dann öffentlich geschaltet wird. Veröffentlichen Sie niemals ein Video öffentlich, ohne dass der Benutzer es gehört/gesehen hat – Stimmen und Tempo sind subjektiv.

Konfigurieren Sie dies für Ihr Projekt

Füllen Sie vor der ersten Nutzung config.md aus (einige IDs und Pfade). Der Skill liest diese anstelle von fest codierten Werten, sodass er für jedes Produkt funktioniert. Die benötigten Werte:

• Ihr YouTube-Kanal (das OAuth-Konto muss ihn ausgewählt haben)
• Ihr OAuth-Client-Secret-Pfad und Ihre GCP-Projektnummer (YouTube Data API v3 aktiviert)
• Wohin die Ankündigungen für fertige Videos gehen (Slack-Kanal, Discord usw.)
• Ihre Markenfarben und das Produkt-URL-Muster

Wann es verwendet werden sollte

Bei der Erstellung eines Videos für eine Seite/Funktion/ein Werkzeug, beim Hinzufügen einer Sprachausgabe oder beim Versenden eines Videos an YouTube. Für eine breite Anfrage "Fügen Sie Videos zu unseren besten Seiten hinzu" ziehen Sie zuerst die Top-Seiten (aus Ihren Analysen), dann führen Sie diese Pipeline einmal pro Seite aus – pilotieren Sie eine, holen Sie die Genehmigung für das Format ein, dann bearbeiten Sie die restlichen im Batch.

Die Pipeline (7 Schritte)

Arbeiten Sie von oben nach unten. Jeder Schritt enthält Details in der referenzierten Datei oder dem Skript.

1. Verstehen Sie das Thema. Lesen Sie die Implementierung/Dokumentation, sodass die gezeigten Schritte dem tatsächlichen Verhalten entsprechen. Für eine Tool-Walkthrough navigieren Sie das Live-Tool (Playwright), um den tatsächlichen Eingabe→Ausgabe-Fluss zu sehen – das IST die Walkthrough.

2. Erfassen Sie echte Screenshots. Playwright gegen die Produktion, 1920×1080. Verstecken Sie zuerst alle Werbebanner / Cookie-Leisten. Siehe references/video-production.md → "Capturing screenshots".

3. Erstellen Sie das Remotion-Video. Kopieren Sie die remotion-scaffold/-Struktur. Szenen werden mit 30fps in src/theme.ts framegezählt. Passen Sie jede Szene an ihre Sprechlänge an (Schritt 4). Vollständige Szenen-/Animationsmuster in references/video-production.md.

4. Generieren Sie die Sprachausgabe. scripts/tts_voiceover.py – OpenAI gpt-4o-mini-tts, Stimme ash, mit einem instructions-Prompt für Emotionen (ohne ist das Vorlesen flach und roboterhaft – dies ist das wichtigste Detail der Sprachausgabe). Es erzeugt szenenweise Clips, synchronisiert sie mit dem Startframe jeder Szene und normalisiert die Lautstärke des gemischten Tracks. Passen Sie die Szenenzeiten in theme.ts an, wenn ein Clip seine Szene überläuft, und rendern Sie dann erneut.

5. Rendern + Muxen + Codieren. npx remotion render, muxen Sie den VO-Track mit ffmpeg (-c:v copy), dann codieren Sie einen < 10 MB-Upload-Schnitt (libx264 -crf 25 -movflags +faststart). Befehle in references/video-production.md → "Render, mux, encode".

6. Auf YouTube veröffentlichen. scripts/youtube.py (umhüllt youtubeuploader für den Upload, verwendet die Data API für alles andere). Hochladen ungelistet, die Zustimmung des Benutzers einholen, dann auf öffentlich setzen. Lesen Sie zuerst references/youtube-publishing.md – es enthält die Auth-Einrichtung, die OAuth-Weiterleitungsfalle, den Fehler "API nicht aktiviert", Kontingentlimits und die Metadatenvorlage.

7. Einbetten + Ankündigen. Fügen Sie einen Click-to-Play-Fassadenabschnitt zur Seite hinzu (Poster + Abspielknopf; das YouTube-Iframe wird nur bei Klick eingehängt – hält es vom initialen Laden fern). Veröffentlichen Sie dann den Link in Ihrem Team-Kanal. Beide Muster in references/embed-and-announce.md.

Leitplanken

• Ungelistet → genehmigen → öffentlich, jedes Mal. Das Hochladen auf den eigenen Kanal des Benutzers benötigt dessen Freigabe.
• Die Google OAuth-Zustimmung muss der Benutzer geben – Sie können nicht "Zulassen" für ihn klicken. Wenn die Authentifizierung nicht eingerichtet ist, führen Sie ihn hindurch (siehe references/youtube-publishing.md), versuchen Sie nicht, sie zu umgehen.
• Behalten Sie den Master-Render; nur der Upload-Schnitt ist größenbeschränkt.
• YouTube-API-Kontingent ≈ 6 Uploads / 24h. Ein Batch, der größer ist, muss über Tage verteilt werden – sagen Sie dies, anstatt stillschweigend mittendrin zu scheitern.
• CLI kann kein Thumbnail setzen – weisen Sie darauf hin, dass der Benutzer eines in Studio hinzufügen sollte (oder separat über die API setzen).