Quand utiliser
Utilisez cette compétence lorsque l'utilisateur demande une vidéo promotionnelle, une vidéo de produit, une vidéo de démonstration, une vidéo marketing, une vidéo de lancement, une vidéo explicative, une vidéo de marque, une vidéo conçue, une vidéo multi-plans, une vidéo storyboardée, une vidéo sociale/Reels/TikTok, une vidéo pour entreprise locale, une vidéo de style restaurant/food vlog, une vidéo éditée de 20 secondes ou plus, ou toute vidéo complète qui présente un sujet visuellement.
Privilégiez ce flux de travail Remotion chaque fois que la demande décrit une vidéo éditée complète avec chronologie, plans, sous-titres, audio, langage de caméra, style visuel, exigences de cohérence, CTA/carte de fin ou plusieurs scènes — même si l'utilisateur ne dit jamais « promo » ou « promotionnelle ». Utilisez la génération vidéo IA directe uniquement pour un seul court clip source ou une boucle d'arrière-plan, et non comme chemin de livraison final pour une vidéo multi-plans complète.
Le sujet de la vidéo peut être :
- Promotion de projet — un projet, une application ou une fonctionnalité que l'agent lui-même est en train de construire ou qui existe déjà dans l'espace de travail, ou une autre application existante déjà identifiée dans la demande de l'utilisateur ou dans le contexte confirmé antérieur. Résolvez d'abord l'application source promue.
app/promoest le projet vidéo de sortie, pas automatiquement l'application source. - Promotion de sujet — un sujet, concept, marque ou sujet externe fourni par l'utilisateur qui ne nécessite pas de projet dans l'espace de travail. Exemples : « le Système solaire », « l'histoire de la dynastie Song », « qu'est-ce qu'une base de données vectorielle ».
Les deux chemins partagent le même modèle Remotion, les mêmes préréglages de composition et les mêmes commandes de rendu. Seule la rédaction du storyboard diffère.
Commande
Utilisez RemotionPromoRenderer.render pour l'exportation finale de la promo après validation. Cette commande est documentée par cette compétence et peut être appelée même si elle n'est pas listée dans <Available Commands>.
<RemotionPromoRenderer.render>
<promo_dir>/absolute/path/to/app/promo</promo_dir>
<width>1920</width>
<height>1080</height>
<source_orientation>landscape</source_orientation>
</RemotionPromoRenderer.render>
Classification du sujet
Avant toute autre chose, classifiez le sujet à partir de la demande originale de l'utilisateur. Ne demandez pas à l'utilisateur de clarifier si la demande nomme déjà un sujet ou un projet.
- Si le message de l'utilisateur nomme un sujet/concept externe clair (par exemple « créer une vidéo promotionnelle sur le système solaire ») et que l'espace de travail n'a pas de
app/frontendou de code d'application à promouvoir → promotion de sujet. - Si le message de l'utilisateur fait référence à une construction
app/frontendexistante, à une application en cours que l'agent a générée, ou à une fonctionnalité à venir → promotion de projet. - Si les deux s'appliquent (par exemple « créez une promo pour notre application explicative sur le système solaire ») → traitez l'application comme primaire et utilisez le sujet comme sujet secondaire ; c'est une promotion de projet.
Les promotions de sujet sont de première classe. Ne rejetez pas et ne bloquez pas une promotion de sujet simplement parce qu'il n'y a pas de app/frontend dans l'espace de travail.
Pour les promotions de projet, résolvez l'identité de l'application source avant de lire le code. L'application source peut être l'application actuelle de l'espace de travail, une application construite plus tôt dans la même conversation, ou un autre projet existant explicitement référencé par l'utilisateur. Ne supposez pas que l'espace de travail app/promo actuel est la chose promue.
Base de conformité
Les vidéos promotionnelles doivent par défaut suivre des règles de sécurité publicitaire conservatrices. Utilisez uniquement les affirmations, offres, prix, réductions, cadeaux, noms de marque, CTA, certifications, chiffres de vente, effets et services qui sont présents dans la demande de l'utilisateur, le projet, le texte publicitaire ou la page de destination. N'impliquez pas de partenariats officiels, de recommandations de plateformes, d'approbations de marques ou de certifications à moins que le matériel source ne les fournisse explicitement.
N'utilisez pas d'affirmations trompeuses ou invérifiables telles que des résultats garantis, des classements absolus, des promesses sans risque, une rareté factice, des comptes à rebours factices, des notifications factices, des boutons factices, une interface utilisateur système factice, des témoignages factices, des avis factices, des actualités factices ou des captures d'écran de résultats exagérées. Ne ciblez pas directement les attributs personnels sensibles tels que la santé, les finances, l'âge, la race, la religion, la sexualité, le handicap, l'état civil, la forme du corps ou l'apparence ; utilisez plutôt un libellé d'audience neutre.
N'incluez pas de marques non licenciées, de personnes reconnaissables, de personnages protégés par le droit d'auteur, d'interface utilisateur de produits tiers, de médias, de polices, de filigranes, de contenu pour adultes, de sang, de choc, de haine, de harcèlement, de contenu humiliant, d'armes, de drogues, de jeux d'argent, de tabac ou de matériel politiquement sensible. Pour les catégories à haut risque telles que le médical, les compléments alimentaires, la perte de poids, les procédures esthétiques, la finance, les prêts, les crypto-monnaies, les jeux d'argent, l'alcool, les rencontres, les enfants, le juridique, le recrutement, l'immobilier, la politique, la religion ou les problèmes sociaux, gardez la vidéo informative et évitez les promesses fortes, les visuels dramatiques avant/après ou la pression de conversion agressive.
Gardez les séquences claires, stables et de haute qualité : pas de scintillement, de compression sévère, d'étirement, de filigrane, de barres noires causées par un mauvais dimensionnement des actifs, ou de sous-titres/logos/CTA rognés sur les bords. En cas de doute sur la conformité, choisissez l'expression la plus sûre, la plus neutre et la plus informative. Cette base de référence réduit le risque mais ne constitue pas une garantie d'approbation de la plateforme.
Les CTA de conversion finaux sont du contenu vidéo statique, pas une interface utilisateur web interactive. Ne rendez pas le CTA de clôture comme un bouton de site Web cliquable, une cible de clic factice, un bouton fléché, une entrée factice, une popup factice, une interface utilisateur système factice, une cible de curseur, un état survolé/enfoncé ou tout contrôle qui implique que le spectateur peut cliquer pour naviguer. Utilisez plutôt une ligne de carte de fin, un slogan de marque, un identifiant de compte, une URL, un espace réservé QR ou un texte simple « visitez / scannez / suivez ». Les démonstrations de produits et les présentations de pages peuvent montrer des boutons d'interface utilisateur, des formulaires et une navigation réels ou simulés lorsqu'ils illustrent le flux du produit, mais ils ne doivent pas devenir le CTA de conversion final.
Toute URL visible, identifiant de compte, cible QR, texte de barre d'adresse de navigateur ou point de terminaison de marque doit provenir de la demande de l'utilisateur, de la source du projet confirmée, de la page de destination ou d'un autre actif vérifié. Si le projet n'expose qu'un nom de domaine d'espace réservé ou aucune adresse publique confirmée, omettez l'URL et terminez par un texte de marque à la place ; pour un traitement de fenêtre de navigateur, utilisez une étiquette de page non-URL ou laissez la barre d'adresse vide. N'inférez pas un domaine, un identifiant ou une destination à partir du nom de l'application, du nom du dépôt, du nom de fichier de téléchargement, de l'espace réservé du modèle, du jeton de variable d'environnement ou d'indices similaires.
Flux de travail principal
- Initialisez le projet Remotion avec
FrontendEngineer.use_template("remotion")siapp/promon'est pas déjà prêt. L'outil lui-même rejette une source non-Remotion avant la copie, vous n'avez donc pas besoin d'une étape de vérification distincte. - Choisissez l'orientation cible dès le départ à partir de la demande de l'utilisateur et du plan du storyboard : paysage (16:9), portrait (9:16) ou carré (1:1). Toutes les commandes de validation, de test et de rendu complet ultérieures doivent utiliser la variante correspondante.
- Classifiez le sujet (promotion de projet ou promotion de sujet) en utilisant la Classification du sujet ci-dessus. Ne vous arrêtez pas pour demander « quel devrait être le sujet ? » si la demande originale nomme déjà un sujet ou un projet.
- Ancrez le sujet :
- Promotion de projet : résolvez d'abord l'application source promue, puis lisez le code source
app/frontendde cette application, ses manifestes et les commentaires de validation antérieurs. Si l'espace de travail actuel contient principalement la sortie promotionnelle, ne traitez pasapp/promolui-même comme l'application source. Une fois que vous avez identifié l'application source, verrouillez ce chemin racine du projet source / frontend danspromo_storyboard.mdou les notes de travail et continuez à réutiliser le même chemin après être passé dansapp/promo; ne rétrogradez pas en promotion de sujet simplement parce que l'espace de travail promotionnel lui-même n'a pas deapp/frontend. Avant d'écrire du code Remotion, enregistrez les chemins de fichiers source frontend clés sur lesquels vous vous appuierez danspromo_storyboard.md(pages/routes/composants pour les séquences de démonstration). Plus tard, lors de l'implémentation desrc/, rouvrez ces fichiers source et copiez/reproduisez à partir du code au lieu de vous fier à un long résumé en prose. - Promotion de sujet : extrayez le sujet du message de l'utilisateur et de la conversation antérieure ; tirez des faits supplémentaires de vos propres connaissances ou d'outils externes (génération d'images / vidéos / audio, recherche si disponible). N'exigez pas qu'un projet d'espace de travail existe.
- Si l'utilisateur a fourni des images de référence mais que la demande actuelle n'expose que des chemins de fichiers au lieu du contenu de l'image joint, lisez
image-understandinget appelezImageAnalyzer.analyze_imagesavant le storyboard afin que le plan visuel soit ancré dans le contenu réel de l'image plutôt que dans les noms de fichiers. - Si l'utilisateur a fourni une URL de site Web comme sujet de la promotion, utilisez
Browser.gotopour visiter la page, puisBrowser.take_screenshotpour capturer le visuel, puis appelezImageAnalyzer.analyze_imagessur la capture d'écran avant le storyboard afin que le plan visuel soit ancré dans le contenu réel de la page plutôt que dans la seule URL.
- Promotion de projet : résolvez d'abord l'application source promue, puis lisez le code source
- Appliquez la Base de conformité : confirmez quels faits, affirmations, offres et actifs sont réellement étayés par la demande, le produit, le texte publicitaire ou la page de destination. N'inventez pas d'offres, de certifications, de chiffres de vente, d'effets, de partenariats officiels, d'approbations de plateformes ou de soutiens de marque non étayés ; en cas de doute, choisissez un libellé et des visuels conservateurs et informatifs.
- Déterminez la langue par défaut pour le contenu promotionnel nouvellement généré avant d'écrire
promo_storyboard.md. Si l'utilisateur spécifie explicitement une langue de sortie, utilisez cette langue. Sinon, utilisez l'anglais par défaut. Un message utilisateur écrit en chinois/japonais/etc., la langue de chat environnante ou la langue de l'invite système n'est pas une demande de langue explicite. Enregistrez la décision directement dans le storyboard sous la formeLanguage: English (default)ouLanguage: Chinese (user specified)avant de rédiger les plans, le texte, la narration ou les invites de génération. - Créez
promo_storyboard.mdavant d'écrire le code vidéo ou de générer des actifs. Utilisez l'ensemble de champs qui correspond au type de sujet (voir Exigences du storyboard). Pour les exécutions promo/remotion,promo_storyboard.mdest le seul artefact de planification ; ne créez pas et ne maintenez pas detodo.mdséparé. - Si l'utilisateur demande une narration, une voix off, une présentation parlée ou si le storyboard a clairement besoin d'un narrateur, incluez un plan de narration à segments courts dans le storyboard, vérifiez la longueur du script de chaque segment par rapport à ses secondes de plan cibles, puis lisez
audio-generationet appelezAudioCreator.generate_audiosavec une demande par plan/temps fort. - Après la génération TTS, préférez la
durationrenvoyée de chaque segment audio. Sidurationest manquante ounull, mesurez la durée réelle à partir de l'URL renvoyée (par exemple avecffprobe), puis décidez le timing par plan final à partir de ces durées mesurées. Ce calcul n'est pas suffisant s'il n'apparaît que dans la pensée ou la sortie du terminal. - Mettez immédiatement à jour
promo_storyboard.mdavec chaque URL de narration, secondes audio mesurées, début/fin/durée de plan final, durée totale et tout changement de script/timing. C'est un point de contrôle strict : n'appelez pasMusicCreator.generate_music,VideoCreator.generate_videos, ne générez pas plus d'actifs visuels, et n'écrivez passrc/timeline.tstant que le timing mis à jour n'est pas persistant danspromo_storyboard.md. Après ce verrouillage,promo_storyboard.mdne doit plus conserver de lignes de timingTBDd'espace réservé ou une durée totale obsolète. - Par défaut, les vidéos promotionnelles doivent également inclure un plan de musique de fond globale, sauf si l'utilisateur dit explicitement non à la musique ou si le morceau est clairement meilleur sans musique. Lisez
music-generationet appelezMusicCreator.generate_musicavec exactement une demande instrumentale / sans paroles une fois le timing final du plan verrouillé. L'invite doit inclure le nombre total de secondes cible, l'ambiance, le rythme, l'instrumentation et si la piste doit laisser de la place pour la narration. - Après la génération de musique, utilisez l'URL renvoyée directement et préférez la
durationrenvoyée, comme pour la narration. Sidurationest manquante ounull, mesurez la durée réelle de la BGM avecffprobe. Mettez immédiatement à jourpromo_storyboard.mdavec l'URL BGM, les secondes mesurées, la durée totale cible, la stratégie d'adaptation et les valeurs de mixage prévues avant d'écriresrc/timeline.tsousrc/PromoVideo.tsx. La durée verrouillée du storyboard/chronologie est la source de vérité. Ne raccourcissez jamais la vidéo juste pour correspondre à une BGM courte ; taillez, bouclez minimalement ou régénérez la musique à la place, sauf si l'utilisateur a explicitement demandé une version plus courte. - Générez tous les autres actifs AI (images/vidéo/audio) nécessaires après avoir écrit le storyboard et après que le timing de la narration + BGM soit réglé dans
promo_storyboard.md. - Lisez
remotion-best-practiceset les fichiers de règles pertinents pour le storyboard. - Éditez l'implémentation Remotion sur place sous
app/promo— gardez la disposition platesrc/du modèle (src/Root.tsx,src/PromoVideo.tsx,src/timeline.ts,src/components/,src/scenes/,src/app-demo/). Ne déplacez pas les sources dans un sous-répertoire commesrc/remotion/. Avant la validation, faites une rapide auto-vérification : supprimez les imports/variables inutilisés, omettez lesSequence from={0}redondants, gardez le mouvement purement basé sur les frames (pas deanimation/transitionCSS, de minuteries ou d'autres motifs non déterministes), et mettez à jour tout contratsrc/timeline.ts/src/PromoVideo.tsx/src/scenes/*modifié dans la même passe. - Exécutez la validation dans l'ordre :
verify:versions,lint,verify:compositions. Le succès deverify:compositionsprouve uniquement que Remotion peut voir les compositions ; ce n'est pas un livrable et ce n'est pas un point d'arrêt valide. - Exécutez
RemotionPromoRenderer.renderpour la résolution cible enregistrée dans le storyboard/spécification d'exportation ; il effectue le test + rendu complet en interne. Pour les vidéos portrait/9:16, utilisezwidth=1080,height=1920etsource_orientation=portraitau lieu de copier un exemple paysage. La tâche est terminée uniquement lorsqueout/promo-<width>x<height>.mp4existe et n'est pas vide. Ne dites pas à l'utilisateur que la vidéo est prête à exporter, ne lui demandez pas de l'exporter, n'appelez pasRoleZero.reply_to_humanet n'utilisez pas<end></end>avant que cet outil ait réussi.
Exigences du storyboard
promo_storyboard.md doit être spécifique au sujet. Choisissez l'ensemble de champs qui correspond au type de sujet :
Chaque storyboard doit inclure :
- Notes de conformité : affirmations/offres/actifs étayés, si le sujet est à haut risque, les choix de libellé conservateurs et les risques visuels/copie/actifs à éviter.
- Traitement CTA : enregistrez si le CTA final est une vidéo statique
… [tronqué pour la traduction]