Quand l'utiliser
Utilisez cette compétence lorsque l'utilisateur demande une vidéo promotionnelle, une vidéo 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 de découverte pour les réseaux sociaux / Reels / TikTok, une vidéo pour un commerce local, une vidéo de style restaurant / blog culinaire, une publicité produit, une vidéo produit de type e-commerce / Amazon, une vidéo packshot ou à rotation 360°, une vidéo de vitrine / 探店, une publicité de conversion DTC / réponse directe / avant-après, une vidéo montée de plus de 20 secondes, ou toute vidéo complète qui introduit un sujet visuellement.
Privilégiez ce flux Remotion chaque fois que la demande décrit une vidéo montée complète avec timeline, plans, légendes, audio, langage 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 « promotionnel ». Utilisez la génération vidéo AI directe uniquement pour un clip source court unique 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 :
- Promo de projet — un projet, une application ou une fonctionnalité que l'agent construit lui-même 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 un contexte confirmé antérieurement. Résolvez d'abord l'application source promue.
app/promoest le projet vidéo de sortie, pas automatiquement l'application source. - Promo thématique — un sujet, un concept, une marque ou un sujet externe fourni par l'utilisateur qui ne nécessite pas de projet d'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>.
width/height/source_orientation DOIVENT provenir des spécifications d'exportation du storyboard, pas de cet exemple. L'exemple ci-dessous montre des valeurs paysage comme espaces réservés ; si le storyboard est en portrait, passez width=1080 height=1920 source_orientation=portrait (et carré → 1080/1080/square). Le nom du fichier de sortie est promo-<width>x<height>.mp4, donc un rendu portrait qui utilise par erreur 1920x1080 est un signe que vous avez copié l'exemple au lieu de lire le storyboard.
<RemotionPromoRenderer.render>
<promo_dir>/absolute/path/to/app/promo</promo_dir>
<width>WIDTH_FROM_STORYBOARD</width>
<height>HEIGHT_FROM_STORYBOARD</height>
<source_orientation>ORIENTATION_FROM_STORYBOARD</source_orientation>
</RemotionPromoRenderer.render>
Classification du sujet
Avant toute 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 « faire une vidéo de présentation sur le système solaire ») et que l'espace de travail n'a pas de
app/frontendou de code d'application à promouvoir → promo thématique. - Si le message de l'utilisateur fait référence à une construction
app/frontendexistante, à une application en cours de génération par l'agent, ou à une fonctionnalité à venir → promo de projet. - Si le sujet est un produit physique, un commerce / lieu local, ou une offre de réponse directe sans interface utilisateur d'application reconstituable comme sujet principal (par exemple une publicité pour un diffuseur de parfum de voiture, une rotation 360° de bijoux, un 探店 de restaurant de ramen, une publicité DTC pour un appareil à enlever les poils d'animaux) → promo commerciale.
- Si les deux s'appliquent (par exemple « fais une promo pour notre application d'explication du système solaire ») → traitez l'application comme sujet principal et utilisez le sujet comme élément de support ; c'est une promo de projet.
Utilisez ces critères de départage lorsque plusieurs cas pourraient correspondre : une interface utilisateur logicielle reconstituable est le sujet → promo de projet ; un produit physique / lieu physique / offre sans interface utilisateur reconstituable → promo commerciale ; un concept ou une connaissance externe sans produit → promo thématique. Un cas mixte (par exemple un produit logiciel DTC dont la publicité montre également un écran de paiement réel) est classifié en fonction de ce que vendent les plans principaux, et peut emprunter les règles de l'autre classe par plan (par exemple un temps de ui-demo de paiement à l'intérieur d'une promo commerciale).
Les promos thématiques et les promos commerciales sont de première classe. Ne rejetez pas et ne bloquez pas une promo thématique simplement parce qu'il n'y a pas de app/frontend dans l'espace de travail, et ne dégradez pas une promo commerciale en promo thématique simplement parce que le produit n'a pas de app/frontend à reconstruire.
Base de conformité
Les vidéos promotionnelles doivent par défaut respecter des règles de sécurité publicitaire conservatrices. N'utilisez que des affirmations, offres, prix, remises, cadeaux, noms de marque, appels à l'action, 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 plateforme, d'approbations de marque ou de certifications, sauf si le matériel source les fournit explicitement.
N'utilisez pas d'affirmations trompeuses ou invérifiables telles que des résultats garantis, des classements absolus, des promesses sans risque, de la rareté artificielle, des comptes à rebours factices, des notifications factices, des boutons factices, des interfaces utilisateur système factices, des témoignages factices, des avis factices, des fausses nouvelles ou des captures d'écran de résultats exagérées. Ne ciblez pas directement des attributs personnels sensibles tels que la santé, les finances, l'âge, la race, la religion, la sexualité, le handicap, l'état matrimonial, la morphologie ou l'apparence ; utilisez plutôt un langage 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'interfaces utilisateur de produits tiers, de médias, de polices, de filigranes, de contenu pour adultes, de scènes gores, de contenu choquant, de contenu haineux, de harcèlement, de contenu humiliant, d'armes, de drogues, de jeux d'argent, de tabac ou de contenu politiquement sensible. Pour les catégories à haut risque telles que les produits médicaux, les compléments alimentaires, la perte de poids, les procédures esthétiques, les finances, les prêts, les crypto-monnaies, les jeux d'argent, l'alcool, les sites de rencontre, les contenus pour enfants, les contenus juridiques, le recrutement, l'immobilier, la politique, la religion ou les questions sociales, gardez la vidéo informative et évitez les promesses fortes, les visuels avant/après dramatiques ou la pression agressive à la conversion.
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 assets, ou de sous-titres/logos/CTA recadrés sur les bords. En cas d'incertitude 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 les risques mais ne constitue pas une garantie d'approbation par la plateforme.
Les appels à l'action de conversion finaux sont un 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 laisse entendre que le spectateur peut cliquer pour naviguer. Utilisez plutôt une ligne de carte de fin, un slogan de marque, un nom de compte, une URL, un espace réservé pour QR, ou un texte simple « visitez / scannez / suivez ». Les démonstrations de produits et les visites guidées de pages peuvent montrer des boutons, formulaires et éléments de navigation d'interface utilisateur réels ou simulés lorsqu'ils illustrent le flux du produit, mais ils ne doivent pas devenir l'appel à l'action final de conversion.
Toute URL visible, nom 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 de projet confirmée, de la page de destination ou d'un autre asset 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 le texte de la marque ; pour un traitement de fenêtre de navigateur, utilisez un libellé de page non URL ou laissez la barre d'adresse vide. N'inférez pas un nom de domaine, un nom de compte ou une destination à partir du nom de l'application, du nom du dépôt, du nom du 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 rapide et de rendu complet ultérieures doivent utiliser la variante correspondante.
- Classez le sujet (promo de projet vs. promo thématique) en utilisant la section Classification du sujet ci-dessus. N'arrêtez pas pour demander « de quoi devrait-il s'agir ? » si la demande originale nomme déjà un sujet ou un projet.
- Ancrez le sujet :
- Promo de projet : résolvez d'abord l'application source promue, puis lisez la source
app/frontendde cette application, les manifestes et les commentaires de validation antérieurs. Si l'espace de travail actuel contient principalement la sortie de la promo, ne traitez pasapp/promolui-même comme l'application source. Une fois que vous avez identifié l'application source, verrouillez cette racine de projet source / chemin frontend danspromo_storyboard.mdou les notes de travail et continuez à réutiliser le même chemin après être passé dansapp/promo; ne dégradez pas en promo thématique simplement parce que l'espace de travail de la promo lui-même n'a pas deapp/frontend. Avant d'écrire du code Remotion, enregistrez les chemins de fichiers sources frontend clés sur lesquels vous vous appuierez danspromo_storyboard.md(pages/routes/composants pour les temps de démonstration). Plus tard, lors de l'implémentation desrc/, rouvrez ces fichiers sources et copiez/reformez à partir du code au lieu de vous fier à un long résumé en prose. - Promo thématique : extrayez le sujet du message de l'utilisateur et de la conversation précédente ; tirez des faits supplémentaires de vos propres connaissances ou d'outils externes (génération d'image / vidéo / 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 des images jointes, 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 promo, 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 l'URL seule.
- Promo de projet : résolvez d'abord l'application source promue, puis lisez la source
- Appliquez la Base de conformité : confirmez quels faits, affirmations, offres et assets sont réellement pris en charge par la demande, le produit, le texte publicitaire ou la page de destination. N'inventez pas d'offres, certifications, chiffres de vente, effets, partenariats officiels, endossements de plateforme ou soutiens de marque non pris en charge ; en cas d'incertitude, choisissez un texte et des visuels informatifs et conservateurs.
- 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 par défaut l'anglais. Un message utilisateur écrit en chinois/japonais/etc., la langue du chat environnant 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 du code vidéo ou de générer des assets. 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 ni ne maintenez detodo.mdséparé. - Si l'utilisateur demande une narration, une voix off, un commentaire parlé, ou si le storyboard a clairement besoin d'un narrateur, incluez un plan de narration par 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. - Après la génération TTS, préférez la
durationretournée pour chaque segment audio. Sidurationest manquante ounull, mesurez la durée réelle à partir de l'URL retournée (par exemple avecffprobe), puis décidez le timing final de chaque plan à 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 dur : n'appelez pasMusicCreator.generate_music,VideoCreator.generate_videos, ne générez pas d'autres assets visuels, et n'écrivez passrc/timeline.tstant que le timing mis à jour n'est pas persisté danspromo_storyboard.md. Après ce verrouillage,promo_storyboard.mdne doit plus contenir de lignes de timing d'espace réservéTBDni une durée totale obsolète. - Par défaut, les vidéos promotionnelles doivent également inclure un plan de musique de fond globale, à moins que l'utilisateur ne dise explicitement non à la musique ou que le morceau soit clairement meilleur sans musique. Lisez
music-generationet appelezMusicCreator.generate_musicavec exactement une demande instrumentale / sans voix après que le timing final des plans est verrouillé. L'invite doit inclure les secondes totales cibles, 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 la musique, utilisez l'URL retournée directement et préférez la
durationretournée, comme pour la narration. Sidurationest manquante ounull, mesurez la durée réelle du BGM avecffprobe. Mettez immédiatement à jourpromo_storyboard.mdavec l'URL du BGM, les secondes mesurées, la durée totale cible, la stratégie d'ajustement et les valeurs de mixage prévues avant d'écriresrc/timeline.tsousrc/PromoVideo.tsx. La durée verrouillée du storyboard/timeline est la source de vérité. Ne raccourcissez jamais la vidéo juste pour correspondre à un BGM court ; découpez, bouclez minimalement ou régénérez la musique à la place, sauf si l'utilisateur a explicitement demandé une coupe plus courte. - Générez tous les autres assets AI image/vidéo/audio nécessaires après que le storyboard est écrit et que le timing de la narration + BGM est réglé dans
promo_storyboard.md. - Lisez
remotion-best-practiceset concentrez-vous sur les sections pertinentes pour le storyboard. - Éditez l'implémentation Remotion sur place dans
app/promo— conservez la dispositionsrc/plate 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, effectuez une rapide auto-vérification : supprimez les imports/variables inutilisés, omettez lesSequence from={0}redondants, gardez le mouvement purement basé sur les images (pas deanimation/transitionCSS, et les durées doivent correspondre exactement à la timeline).