Shrimer06/remotion-video-superpowers

Remotion Video Superpowers

Utilisez cette compétence pour exécuter une production vidéo Remotion en suivant un workflow discipliné de spécification → planification → exécution → validation. Ne sautez pas directement dans l’animation pour des vidéos non triviales.

Workflow

1. Créez ou mettez à jour un cahier des charges vidéo avant l’implémentation.

   • Lisez references/writing-video-specs.md.
   • Enregistrez les spécifications sous docs/video/specs/YYYY-MM-DD-nom-projet.md dans le projet lorsque c’est pertinent.
   • Capturez les objectifs, non-objectifs, public cible, direction visuelle, assets, exigences de voix-off, contraintes et critères d’acceptation.

2. Créez ou mettez à jour un plan de production.

   • Lisez references/writing-video-plans.md.
   • Enregistrez les plans sous docs/video/plans/YYYY-MM-DD-nom-projet.md dans le projet lorsque c’est pertinent.
   • Utilisez des tâches à cocher. Chaque tâche doit lister les fichiers, les étapes, la validation et les conditions d’arrêt.

3. Terminez la collecte des assets avant l’implémentation de l’animation.

   • Lisez references/asset-sourcing.md.
   • Collectez et enregistrez les assets produit, les assets de marque, les références d’interface utilisateur, les captures d’écran, les modèles 3D, les ressources cartographiques/géospatiales, les tokens/noms d’environnement de service, les références audio, les licences, les attributions, les chemins locaux et les solutions de repli.
   • Ne commencez pas l’animation de scène tant que les assets requis ne sont pas disponibles localement ou qu’une solution de repli n’est pas explicitement enregistrée.

4. Exécutez le plan tâche par tâche.

   • Lisez references/remotion-scene-execution.md avant de modifier du code Remotion.
   • Lisez references/frontend-animation-system.md lorsque la vidéo contient une interface web, une interface produit, un tableau de bord, une animation de style frontend, Three.js, Anime.js ou une chorégraphie d’animation complexe.
   • Lisez references/3d-map-and-model-resources.md lorsque la vidéo nécessite des cartes, itinéraires, villes, terrains, bâtiments, points d’intérêt, jumeaux numériques, équipements, vaisseaux spatiaux, objets 3D réels ou des services basés sur des tokens comme Mapbox/Cesium ion.
   • Utilisez useCurrentFrame() et interpolate() pour une animation compatible avec la recherche temporelle.
   • Évitez les transitions CSS et les animations runtime non déterministes.
   • Gardez le texte des scènes court ; déplacez les explications dans la voix-off.
   • Rendez des images fixes autour des débuts, pics et transitions des scènes avant le rendu final.

5. Gérez la voix-off comme une source temporelle de premier ordre.

   • Lisez references/elevenlabs-v3-scripting.md avant d’écrire des scripts ElevenLabs v3.
   • Lisez references/audio-sync-and-muxing.md avant d’importer, synchroniser ou multiplexer l’audio.
   • Inspectez la durée réelle de l’audio avec le script scripts/inspect-audio.sh de cette compétence.
   • Préférez étendre la temporisation des scènes pour s’adapter à la voix-off finale plutôt que de couper l’audio.

6. Effectuez un contrôle qualité final avant la livraison.

   • Lisez references/qa-checkpoints.md.
   • Exécutez le lint/vérification de type du projet lorsqu’il est disponible.
   • Rendez les images fixes de vérification avec le script scripts/render-checkpoints.sh de cette compétence ou des commandes explicites npx remotion still.
   • Rendez le MP4 final.
   • Multiplexez la voix-off avec le script scripts/mux-voiceover.sh de cette compétence lorsque la fiabilité audio est importante.
   • Vérifiez la durée, le flux audio et le volume avec ffprobe/ffmpeg.

Règles Super-pouvoirs

• Traitez le cahier des charges comme la source de vérité. Si l’implémentation entre en conflit avec le cahier des charges, mettez à jour le cahier des charges ou arrêtez-vous et demandez.
• Traitez le plan comme exécutable. Ne marquez pas une tâche comme terminée tant que sa validation n’est pas réussie.
• Arrêtez-vous en cas d’échec de validation affectant la qualité finale de la vidéo : lint cassé, texte illisible, scènes qui se chevauchent, audio manquant, durée non correspondante ou visuels clés vides.
• Pour les révisions, identifiez d’abord la scène et la plage de trames affectées, rendez les images fixes avant/après, puis corrigez uniquement le code nécessaire.
• Préservez les médias fournis par l’utilisateur. Copiez-les ou référencez-les délibérément ; n’écrasez pas les téléchargements source.
• N’utilisez pas de captures d’écran comme langage visuel principal pour une promotion sauf si l’utilisateur veut explicitement une visite guidée d’écran. Traduisez les idées produit en métaphores de mouvement et utilisez les captures d’écran comme preuve, transitions ou bref témoignage produit.

Routage des Références

• Besoin de concevoir la vidéo : lisez writing-video-specs.md.
• Besoin de planifier l’implémentation : lisez writing-video-plans.md.
• Besoin de rassembler les assets produit, les assets de modèle, les captures d’écran, les tokens, les licences ou les références : lisez asset-sourcing.md.
• Besoin de coder des scènes ou transitions Remotion : lisez remotion-scene-execution.md.
• Besoin de concevoir des animations de style frontend riches : lisez frontend-animation-system.md.
• Besoin de cartes, de villes/terrain 3D, d’itinéraires ou de modèles 3D externes : lisez 3d-map-and-model-resources.md.
• Besoin d’un script de voix-off, en particulier ElevenLabs v3 : lisez elevenlabs-v3-scripting.md.
• Besoin d’aligner l’audio MP3/WAV ou de corriger « pas de son » : lisez audio-sync-and-muxing.md.
• Besoin d’inspecter la qualité finale : lisez qa-checkpoints.md.

Lorsque vous exécutez des scripts groupés depuis un répertoire de projet, utilisez le chemin absolu vers le répertoire scripts/ de cette compétence, sauf si des scripts équivalents locaux au projet existent.