Wann verwenden?
Verwenden Sie dieses Skill, wenn der Benutzer nach einem Werbevideo, Produktvideo, Demovideo, Marketingvideo, Startvideo, Erklärvideo, Markenvideo, gestalteten Video, mehreren Aufnahmen umfassenden Video, storyboardeten Video, Social-/Reels-/TikTok-Erkundungsvideo, lokalen Geschäftsvideo, Restaurant-/Food-Vlog-Video, Produktanzeige, E-Commerce-/Amazon-ähnlichen Produktvideo, Packshot- oder 360-Grad-Produktdrehvideo, Storefront-/ 探店 -Video, DTC-/Direct-Response-/Vorher-Nachher-Conversion-Anzeige, 20s+ geschnittenem Video oder jedem vollständigen Video, das ein Thema visuell einführt, fragt.
Bevorzugen Sie diesen Remotion-Workflow immer dann, wenn die Anfrage ein vollständig geschnittenes Video mit Timeline, Shots, Untertiteln, Audio, Kamerasprache, visuellem Stil, Konsistenzanforderungen, Call-to-Action (CTA)/Endkarte oder mehreren Szenen beschreibt – selbst wenn der Benutzer nie "Promo" oder "Werbung" sagt. Verwenden Sie die direkte KI-Videogenerierung nur für einen einzelnen kurzen Quellclip oder Hintergrundloop, nicht als endgültigen Lieferpfad für ein vollständiges Mehr-Shot-Video.
Das Videothema kann entweder sein:
- Projekt-Promo – ein Projekt, eine App oder eine Funktion, die der Agent selbst entwickelt, die bereits im Arbeitsbereich existiert, oder eine andere bestehende App, die bereits in der Benutzeranfrage oder im zuvor bestätigten Kontext identifiziert wurde. Lösen Sie zuerst die Quell-App auf, die beworben wird.
app/promoist das Ausgabevideoprojekt, nicht automatisch die Quell-App. - Themen-Promo – ein vom Benutzer bereitgestelltes Thema, Konzept, eine Marke oder ein externes Subjekt, das kein Arbeitsbereichsprojekt erfordert. Beispiele: "Das Sonnensystem", "Geschichte der Song-Dynastie", "Was ist eine Vektordatenbank?"
Beide Pfade teilen dieselbe Remotion-Vorlage, dieselben Kompositionsvoreinstellungen und dieselben Renderbefehle. Nur die Storyboard-Erstellung unterscheidet sich.
Befehl
Verwenden Sie RemotionPromoRenderer.render für den endgültigen Promo-Export nach der Validierung. Dieser Befehl wird durch dieses Skill dokumentiert und kann aufgerufen werden, auch wenn er nicht in <Verfügbare Befehle> aufgeführt ist.
width/height/source_orientation MÜSSEN aus der Export-Spezifikation des Storyboards stammen, nicht aus diesem Beispiel. Das folgende Beispiel zeigt Querformat-Werte als Platzhalter; wenn das Storyboard Hochformat ist, übergeben Sie width=1080 height=1920 source_orientation=portrait (und Quadrat → 1080/1080/square). Der Ausgabedateiname ist promo-<width>x<height>.mp4, daher ist ein Hochformat-Render, das fälschlicherweise 1920x1080 verwendet, ein Zeichen dafür, dass Sie das Beispiel kopiert haben, anstatt das Storyboard zu lesen.
<RemotionPromoRenderer.render>
<promo_dir>/absoluter/pfad/zu/app/promo</promo_dir>
<width>BREITE_AUS_DEM_STORYBOARD</width>
<height>HOEHE_AUS_DEM_STORYBOARD</height>
<source_orientation>ORIENTIERUNG_AUS_DEM_STORYBOARD</source_orientation>
</RemotionPromoRenderer.render>
Themenklassifizierung
Klassifizieren Sie vor allem anderen das Thema aus der ursprünglichen Benutzeranfrage. Fragen Sie den Benutzer nicht nach Klärung, wenn die Anfrage bereits ein Thema oder Projekt nennt.
- Wenn die Benutzernachricht ein klares externes Thema/Konzept nennt (z. B. "Erstelle ein Werbevideo über das Sonnensystem") und der Arbeitsbereich kein
app/frontendoder keinen Anwendungscode zu bewerben hat → Themen-Promo. - Wenn die Benutzernachricht auf einen bestehenden
app/frontend-Build, eine laufende App, die der Agent erstellt hat, oder eine bevorstehende Funktion verweist → Projekt-Promo. - Wenn das Subjekt ein physisches Produkt, ein Einzelhandels-/Lokalgeschäft oder -ort oder ein Direct-Response-Angebot ohne wiederaufbaubare App-Benutzeroberfläche als primäres Subjekt ist (z. B. eine Auto-Dufterfrischer-Anzeige, ein 360-Grad-Dreh für Schmuck, ein Ramen-Laden- 探店 , eine DTC-Anzeige für Tierhaarentferner) → Commerce-Promo.
- Wenn beides zutrifft (z. B. "Erstelle eine Promo für unsere Sonnensystem-Erklärer-App") → behandeln Sie die App als primär und das Thema als unterstützendes Subjekt; dies ist ein Projekt-Promo.
Verwenden Sie diese Tie-Breaker, wenn mehr als eine Klassifizierung passen könnte: Eine wiederaufbaubare Software-Benutzeroberfläche ist das Subjekt → Projekt-Promo; ein physisches Produkt / physischer Ort / Angebot ohne wiederaufbaubare Benutzeroberfläche → Commerce-Promo; ein externes Konzept oder Wissen ohne Produkt → Themen-Promo. Ein gemischter Fall (z. B. ein DTC-Softwareprodukt, dessen Anzeige auch einen echten Checkout-Bildschirm zeigt) wird danach klassifiziert, was die Hauptaufnahmen verkaufen, und kann pro Aufnahme die Regeln der anderen Klasse ausleihen (z. B. ein ui-demo Checkout-Beat innerhalb eines Commerce-Promo).
Themen-Promos und Commerce-Promos sind erstklassig. Lehnen Sie ein Themen-Promo nicht ab oder halten Sie es nicht an, nur weil es kein app/frontend im Arbeitsbereich gibt, und stufen Sie ein Commerce-Promo nicht zu einem Themen-Promo herab, nur weil das Produkt kein app/frontend zum Wiederaufbauen hat.
Compliance-Baseline
Promo-Videos müssen standardmäßig konservative Werbesuspizierungsregeln einhalten. Verwenden Sie nur Behauptungen, Angebote, Preise, Rabatte, Geschenke, Markennamen, CTAs, Zertifizierungen, Verkaufszahlen, Effekte und Dienstleistungen, die in der Anfrage des Benutzers, dem Projekt, dem Anzeigentext oder der Landing Page vorhanden sind. Implizieren Sie keine offiziellen Partnerschaften, Plattformempfehlungen, Markenbestätigungen oder Zertifizierungen, sofern das Quellmaterial diese nicht explizit bereitstellt.
Verwenden Sie keine irreführenden oder nicht verifizierbaren Behauptungen wie garantierte Ergebnisse, absolute Rangfolgen, risikofreie Versprechen, falsche Knappheit, falsche Countdowns, falsche Benachrichtigungen, falsche Schaltflächen, falsche System-Benutzeroberflächen, falsche Testimonials, falsche Bewertungen, falsche Nachrichten oder übertriebene Ergebnis-Screenshots. Zielen Sie nicht direkt auf sensible persönliche Attribute wie Gesundheit, Finanzen, Alter, Rasse, Religion, Sexualität, Behinderung, Familienstand, Körperform oder Aussehen ab; verwenden Sie stattdessen neutrale Zielgruppenformulierungen.
Fügen Sie keine nicht lizenzierten Markenzeichen, erkennbaren Personen, urheberrechtlich geschützten Charaktere, Produkt-Benutzeroberflächen Dritter, Medien, Schriftarten, Wasserzeichen, Inhalte für Erwachsene, Gewalt, Schock, Hass, Belästigung, demütigende Inhalte, Waffen, Drogen, Glücksspiel, Tabak oder politisch sensibles Material ein. Halten Sie das Video bei Hochrisikokategorien wie Medizin, Nahrungsergänzungsmittel, Gewichtsabnahme, Schönheitsoperationen, Finanzen, Kredite, Kryptowährungen, Glücksspiel, Alkohol, Dating, Kinder, Recht, Rekrutierung, Immobilien, Politik, Religion oder sozialen Themen informativ und vermeiden Sie starke Versprechen, dramatische Vorher/Nachher-Bilder oder aggressiven Conversion-Druck.
Halten Sie das Filmmaterial klar, stabil und von hoher Qualität: kein Flackern, starke Komprimierung, Verzerrung, Wasserzeichen, schwarze Balken durch falsche Asset-Größen oder abgeschnittene Untertitel/Logos/CTAs am Rand. Wenn Sie sich bei der Compliance unsicher sind, wählen Sie den sichereren, neutraleren, informationsorientierten Ausdruck. Diese Baseline reduziert das Risiko, ist jedoch keine Plattformgenehmigungsgarantie.
Finale Conversion-CTAs sind statische Videoinhalte, keine interaktive Web-Benutzeroberfläche. Rendern Sie den abschließenden CTA nicht als anklickbar aussehende Website-Schaltfläche, gefälschtes Klickziel, Pfeiltaste, gefälschtes Eingabefeld, gefälschtes Popup, gefälschte System-Benutzeroberfläche, Cursor-Ziel, Hover-/Gedrückt-Zustand oder ein Steuerelement, das impliziert, dass der Betrachter klicken kann, um zu navigieren. Verwenden Sie stattdessen eine Endkartenzeile, Marken-Tagline, Kontohandle, URL, QR-Platzhalter oder einfachen "Besuchen / Scannen / Folgen"-Text. Produktdemos und Seiten-Walkthroughs können echte oder simulierte UI-Schaltflächen, Formulare und Navigationen zeigen, wenn sie den Produktfluss demonstrieren, aber sie dürfen nicht zum endgültigen Conversion-CTA werden.
Jede sichtbare URL, Kontohandle, QR-Ziel, Browser-Adressleistentext oder Markenendpunkt muss aus der Anfrage des Benutzers, dem bestätigten Projektquellcode, der Landing Page oder einem anderen verifizierten Asset stammen. Wenn das Projekt nur einen Platzhalter-Domainnamen oder keine bestätigte öffentliche Adresse preisgibt, lassen Sie die URL weg und enden Sie stattdessen mit Markenkopie; verwenden Sie für eine Browser-Fenster-Behandlung ein Nicht-URL-Seitenlabel oder lassen Sie die Adressleiste leer. Leiten Sie keine Domain, keinen Handle oder kein Ziel aus dem App-Namen, Repo-Namen, Download-Dateinamen, Vorlagenplatzhalter, Env-Var-Token oder ähnlichen Hinweisen ab.
Kern-Workflow
- Initialisieren Sie das Remotion-Projekt mit
FrontendEngineer.use_template("remotion"), fallsapp/promonoch nicht bereit ist. Das Tool selbst lehnt eine Nicht-Remotion-Quelle vor dem Kopieren ab, daher benötigen Sie keinen separaten Überprüfungsschritt. - Wählen Sie die Zielorientierung vorab aus der Benutzeranfrage und dem Storyboard-Plan: Querformat (16:9), Hochformat (9:16) oder Quadrat (1:1). Alle späteren Validierungs-, Smoke- und Full-Render-Befehle müssen die passende Variante verwenden.
- Klassifizieren Sie das Thema (Projekt-Promo vs. Themen-Promo) anhand der Themenklassifizierung oben. Halten Sie nicht inne, um zu fragen "Worum soll es gehen?", wenn die ursprüngliche Anfrage bereits ein Thema oder Projekt nennt.
- Verankern Sie das Thema:
- Projekt-Promo: Lösen Sie zuerst die zu bewerbende Quell-App auf, lesen Sie dann den
app/frontend-Quellcode dieser App, Manifeste und vorheriges Validierungsfeedback. Wenn der aktuelle Arbeitsbereich hauptsächlich die Promo-Ausgabe enthält, behandeln Sieapp/promonicht selbst als Quell-App. Sobald Sie die Quell-App identifiziert haben, sperren Sie dieses Quellprojekt-/Frontend-Verzeichnis inpromo_storyboard.mdoder Arbeitsnotizen und verwenden Sie denselben Pfad nach dem Wechsel zuapp/promoweiter; stufen Sie nicht zu einem Themen-Promo herab, nur weil der Promo-Arbeitsbereich selbst keinapp/frontendhat. Notieren Sie vor dem Schreiben von Remotion-Code die wichtigsten Quell-Frontend-Dateipfade, auf die Sie sich verlassen werden, inpromo_storyboard.md(Seiten/Routen/Komponenten für die Demo-Beats). Öffnen Sie später beim Implementieren vonsrc/diese Quelldateien erneut und kopieren/erstellen Sie aus dem Code, anstatt sich auf eine lange Zusammenfassung in Prosa zu verlassen. - Themen-Promo: Extrahieren Sie das Thema aus der Benutzernachricht und dem vorherigen Gespräch; ziehen Sie zusätzliche Fakten aus Ihrem eigenen Wissen oder externen Tools (Bild-/Video-/Audio-Generierung, Suche, falls verfügbar). Erfordern Sie nicht, dass ein Arbeitsbereichsprojekt existiert.
- Wenn der Benutzer Referenzbilder bereitgestellt hat, die aktuelle Anfrage jedoch nur Dateipfade anstelle von angehängten Bildinhalten preisgibt, lesen Sie
image-understandingund rufen SieImageAnalyzer.analyze_imagesauf, bevor Sie das Storyboard erstellen, damit der visuelle Plan auf den tatsächlichen Bildinhalten und nicht nur auf Dateinamen basiert. - Wenn der Benutzer eine Website-URL als Promo-Thema bereitgestellt hat, verwenden Sie
Browser.goto, um die Seite zu besuchen, dannBrowser.take_screenshot, um das Visuelle zu erfassen, dann rufen SieImageAnalyzer.analyze_imagesfür den Screenshot auf, bevor Sie das Storyboard erstellen, damit der visuelle Plan auf dem tatsächlichen Seiteninhalt und nicht nur auf der URL basiert.
- Projekt-Promo: Lösen Sie zuerst die zu bewerbende Quell-App auf, lesen Sie dann den
- Wenden Sie die Compliance-Baseline an: Bestätigen Sie, welche Fakten, Behauptungen, Angebote und Assets tatsächlich durch die Anfrage, das Produkt, den Anzeigentext oder die Landing Page gestützt werden. Erfinden Sie keine nicht unterstützten Angebote, Zertifizierungen, Verkaufszahlen, Effekte, offiziellen Partnerschaften, Plattformbestätigungen oder Markenunterstützung; wählen Sie im Zweifelsfall eine konservative, informationsorientierte Formulierung und Bilder.
- Bestimmen Sie die Standardsprache für neu generierte Promo-Inhalte, bevor Sie
promo_storyboard.mdschreiben. Wenn der Benutzer explizit eine Ausgabesprache angibt, verwenden Sie diese Sprache. Andernfalls standardmäßig auf Englisch. Eine Benutzernachricht, die in Chinesisch/Japanisch/Ähnlichem verfasst ist, die umgebende Chat-Sprache oder die Sprache des System-Prompts ist keine explizite Sprachanfrage. Halten Sie die Entscheidung direkt im Storyboard alsSprache: Englisch (Standard)oderSprache: Chinesisch (vom Benutzer angegeben)fest, bevor Sie Shots, Kopie, Erzählung oder Generierungs-Prompts entwerfen. - Erstellen Sie
promo_storyboard.md, bevor Sie Videocode schreiben oder Assets generieren. Verwenden Sie den Feldsatz, der zum Subjekttyp passt (siehe Storyboard-Anforderungen). Für Promo/Remotion-Läufe istpromo_storyboard.mddas einzige Planungsartefakt; erstellen oder pflegen Sie keine separatetodo.md. - Wenn der Benutzer Erzählung, Voice-Over, gesprochenen Walkthrough anfordert oder das Storyboard eindeutig einen Erzähler benötigt, nehmen Sie einen Plan für kurze Erzählsegmente in das Storyboard auf, überprüfen Sie die Skriptlänge jedes Segments gegen seine Zielaufnahme-Sekunden, lesen Sie dann
audio-generationund rufen SieAudioCreator.generate_audiosmit einer Anfrage pro Shot/Beat auf. - Bevorzugen Sie nach der TTS-Generierung die zurückgegebene
durationjedes Audiosegments. Wenndurationfehlt odernullist, messen Sie die tatsächliche Dauer von der zurückgegebenen URL (z. B. mitffprobe), und legen Sie dann die endgültige Timing pro Aufnahme aus diesen gemessenen Dauern fest. Diese Berechnung reicht nicht aus, wenn sie nur im Gedanken oder in der Terminalausgabe erscheint. - Aktualisieren Sie sofort
promo_storyboard.mdmit jeder Erzählungs-URL, gemessenen Audiosekunden, endgültigem Shot-Start/Ende/Dauer, Gesamtdauer und allen Skript-/Timing-Änderungen. Dies ist ein harter Checkpoint: Rufen SieMusicCreator.generate_music,VideoCreator.generate_videosnicht auf, generieren Sie keine weiteren visuellen Assets und schreiben Sie keinsrc/timeline.ts, bis das aktualisierte Timing inpromo_storyboard.mdbeibehalten ist. Nach dieser Sperre darfpromo_storyboard.mdkeine Platzhalter-TBD-Timing-Zeilen oder eine veraltete Gesamtdauer mehr enthalten. - Standardmäßig sollten Promo-Videos auch einen globalen Hintergrundmusikplan enthalten, es sei denn, der Benutzer sagt explizit keine Musik oder das Stück ist eindeutig besser ohne Musik. Lesen Sie
music-generationund rufen SieMusicCreator.generate_musicmit genau einer instrumentalen / stimmlosen Anfrage auf, nachdem das endgültige Shot-Timing gesperrt ist. Der Prompt muss die Ziel-Gesamtsekunden, Stimmung, Tempo, Instrumentierung und ob der Track Platz für Erzählung lassen soll, enthalten. - Verwenden Sie nach der Musikgenerierung die zurückgegebene URL direkt und bevorzugen Sie die zurückgegebene
duration, genau wie bei der Erzählung. Wenndurationfehlt odernullist, messen Sie die tatsächliche BGM-Dauer mitffprobe. Aktualisieren Sie sofortpromo_storyboard.mdmit der BGM-URL, gemessenen Sekunden, Ziel-Gesamtdauer, Anpassungsstrategie und geplanten Mix-Werten, bevor Siesrc/timeline.tsodersrc/PromoVideo.tsxschreiben. Die gesperrte Storyboard-/Timeline-Dauer ist die Quelle der Wahrheit. Kürzen Sie das Video niemals nur, um es an eine kurze BGM anzupassen; schneiden Sie stattdessen, minimieren Sie Loops oder generieren Sie die Musik neu, es sei denn, der Benutzer hat explizit nach einem kürzeren Schnitt gefragt. - Generieren Sie alle anderen benötigten KI-Bild/Video/Audio-Assets, nachdem das Storyboard geschrieben und das Erzählungs- + BGM-Timing in
promo_storyboard.mdfestgelegt ist. - Lesen Sie
remotion-best-practicesund konzentrieren Sie sich auf die für das Storyboard relevanten Abschnitte. - Bearbeiten Sie die Remotion-Implementierung vor Ort unter
app/promo– behalten Sie das flachesrc/-Layout der Vorlage bei (src/Root.tsx,src/PromoVideo.tsx,src/timeline.ts,src/components/,src/scenes/,src/app-demo/). Verschieben Sie Quellen nicht in ein Unterverzeichnis wiesrc/remotion/. Führen Sie vor der Validierung eine schnelle Selbstüberprüfung durch: Entfernen Sie ungenutzte Importe/Vars, entfernen Sie redundanteSequence from={0}, halten Sie die Bewegung rein frame-gesteuert (kein CSSanimation/transition, Zeit...