derrickgong87/demo-video-creation-skill

Compétence de Création de Vidéo de Démo

Créer une vidéo de démonstration de produit soignée à partir d'une URL d'entreprise ou d'actifs produit. Le rendu par défaut est une vidéo de 60 à 90 secondes en 1080p+ ; effectuer le rendu en 4K lorsque la machine, les actifs et la cible de livraison le permettent.

Norme de Fonctionnement

• Baser la vidéo sur la surface réelle du produit : pages web, écrans d'application, workflows connectés, captures d'écran, actifs fournis par l'utilisateur ou démos publiques vérifiées.
• Considérer une entrée uniquement par URL comme suffisante pour commencer. Inférer le produit, le public, le workflow principal et le système de marque à partir du site, puis ne demander que les accès manquants ou les préférences à fort impact.
• Privilégier la narration de type product-manager plutôt que le marketing générique. Montrer le problème de l'utilisateur, ce qu'il fait dans le produit, ce qui change à l'écran et pourquoi le résultat est important.
• Utiliser Remotion pour la composition animée lorsque c'est pratique et FFmpeg pour l'inspection, l'encodage, les planches contact, la gestion audio et la conversion de livraison.
• Garder les affirmations défendables. Ne pas inventer de métriques, logos clients, résultats de détection, intégrations, statut de conformité ou tarifs, sauf s'ils sont vérifiés à partir de la source.
• Éviter le sur-ajustement à un client antérieur. Réutiliser le workflow, les contrôles de qualité et les motifs de mouvement ; ne pas réutiliser les captures d'écran, textes, couleurs, tarifs, personas ou corrections version par version spécifiques à un client.

Entrées

Si l'utilisateur fournit uniquement une URL de site web :

1. Ouvrir le site dans un navigateur, cartographier la navigation, la proposition de valeur, les pages produit, les tarifs, la documentation d'aide et les états interactifs visibles.
2. Capturer des captures d'écran haute résolution des pages et des surfaces d'interface qui expliquent le mieux le produit.
3. Construire un récit autour de la boucle produit la plus forte découverte sur le site.
4. Indiquer toute limite d'accès si une zone produit connectée est requise.

Si l'utilisateur fournit plus de contexte, l'utiliser pour améliorer la qualité :

• Public cible, plateforme de campagne, rapport d'aspect, durée préférée, CTA, objectif de lancement.
• Étapes du workflow produit, accès au compte de démo, exemples d'entrées ou résultat avant/après attendu.
• Actifs de marque, captures d'écran, références vidéo, polices, direction musicale, affirmations interdites et notes juridiques.

Routage des Références

• Lire references/capture-workflow.md avant la recherche dans le navigateur, la capture connectée ou le travail de capture d'écran.
• Lire references/storytelling.md avant d'écrire le script, le storyboard, la liste des plans ou le récit produit.
• Lire references/visual-system.md avant de choisir le langage de mouvement, la typographie, les transitions, la mise en page ou la musique.
• Lire references/remotion-ffmpeg.md avant d'implémenter le projet vidéo ou de rendre les fichiers.
• Lire references/qc-checklist.md avant de déclarer la vidéo terminée.

Flux de Production

1. Définir le livrable

   • Confirmer la durée cible, le rapport d'aspect, la résolution, la langue et la plateforme de livraison lorsque disponible.
   • Par défaut : 16:9, 60–90 secondes, 30 ips, H.264 MP4, 1080p minimum.
   • Utiliser la 4K lorsqu'elle est demandée ou lorsque la vidéo sera utilisée pour un lancement, des investisseurs, une conférence ou une distribution publicitaire payante.

2. Rechercher le produit

   • Parcourir le site web et les pages produit suffisamment en profondeur pour identifier la boucle principale, pas seulement la promesse de la page d'accueil.
   • Construire une carte rapide des fonctionnalités : utilisateur principal, problème, action principale, résultat visible du produit, preuve, CTA.
   • Si le produit est derrière une connexion, utiliser la session de navigateur active de l'utilisateur ou lui demander de se connecter, puis continuer à partir de l'interface authentifiée.

3. Capturer les preuves produit

   • Capturer des captures d'écran en bureau à une échelle 2x ou plus si possible.
   • Capturer les états remplis et vides s'ils expliquent la transformation.
   • Nommer les actifs par scène et état, par exemple dashboard-empty.png, workflow-result.png, pricing.png.
   • Conserver un manifeste avec l'URL, le titre de la page, l'heure de capture, la zone d'affichage, le nom du fichier et des notes.

4. Écrire l'histoire du produit

   • Commencer par le problème de l'utilisateur ou le résultat souhaité en langage simple.
   • Parcourir la boucle produit dans cet ordre : configuration, action, transformation, révision/preuve, workflow plus large, CTA.
   • Garder le texte suffisamment court pour une vidéo animée. Utiliser des légendes comme points d'ancrage, pas des paragraphes.
   • Utiliser un texte qui sonne naturel pour le public ; éviter les phrases génériques d'IA comme "déverrouiller la productivité" à moins que le produit ne le dise réellement.

5. Concevoir le système de mouvement

   • Utiliser les vraies couleurs et la typographie de la marque comme base, puis ajouter une police d'affichage ou un accent retenu si cela améliore la hiérarchie.
   • Utiliser les captures d'écran du produit comme actifs principaux. Ajouter des cadres de navigateur, des chemins de curseur, des zooms, des masques, des lignes de balayage, des panneaux de comparaison ou une typographie cinétique uniquement lorsqu'ils clarifient le workflow.
   • Choisir des transitions qui correspondent au produit : liquide/rideau pour une transformation fluide, balayage pour l'analyse, révélation projecteur pour la preuve, poussée spatiale pour la navigation, comparaison fractionnée pour avant/après.
   • Garder le mouvement continu. Les changements de scène doivent donner l'impression que la caméra ou l'interface se déplace à travers une seule histoire produit, pas des diapositives séparées.

6. Construire et rendre

   • Utiliser le modèle de démarrage dans assets/remotion-starter/ lorsqu'un squelette de projet est utile.
   • Rendre des images d'aperçu ou une planche contact avant de rendre la vidéo finale.
   • Rendre d'abord en 1080p pour la QA, puis en 4K final si demandé.
   • Utiliser FFmpeg ou ffprobe pour vérifier la durée, la résolution, le codec, la fréquence d'images et le flux audio.

7. QA avant la livraison

   • Vérifier qu'aucun texte ne se chevauche, ne recadre maladroitement ou ne devient illisible sur les coupes rapides.
   • Vérifier que les boutons, curseurs, légendes et masques s'alignent avec l'interface sous-jacente.
   • Vérifier que toutes les captures d'écran sont suffisamment nettes à l'échelle finale.
   • Vérifier que la musique est instrumentale, libre de droits et équilibrée sous toute voix off ou effets sonores.
   • Fournir le MP4 final ainsi que les artefacts de production utiles : storyboard, manifeste des actifs, planche contact et projet source lorsque pertinent.

Scripts Réutilisables

• scripts/create_demo_brief.py crée un brief structuré à partir d'une URL et d'un contexte produit optionnel.
• scripts/qc_video.py inspecte les métadonnées de la vidéo finale avec ffprobe et signale les problèmes de résolution, durée, codec et audio.
• scripts/make_contact_sheet.py crée une planche contact visuelle avec FFmpeg pour une révision rapide.

Exécuter les scripts depuis un dossier de projet ou avec des chemins absolus. Ce sont des aides, pas un remplacement du jugement visuel.

Modèle de Démarrage

Copier assets/remotion-starter/ dans le projet de travail lors du démarrage d'une nouvelle vidéo. Remplacer la configuration fictive dans src/demoConfig.ts, ajouter les captures d'écran dans public/ ou les actifs statiques Remotion, et adapter les scènes au récit produit.

Le modèle est intentionnellement générique :

• Il inclut une composition d'histoire produit avec les scènes d'ouverture, workflow, preuve et CTA.
• Il utilise des emplacements de captures d'écran réels mais tombe sur des espaces réservés d'interface propres.
• Il inclut des primitives de mouvement pour les fondus, zooms, déplacements en rail, accentuation du curseur et panneaux de comparaison.
• Il évite les textes, couleurs ou actifs spécifiques à un client.

Barre d'Achèvement

Ne pas déclarer la vidéo terminée tant que ces conditions ne sont pas remplies :

• L'histoire produit est dérivée de preuves produit réelles.
• Le rendu final est au moins en 1080p, ou l'utilisateur a explicitement accepté une cible inférieure.
• La vidéo a été inspectée visuellement via des images fixes, un rendu d'aperçu ou une planche contact.
• Les métadonnées FFmpeg/ffprobe confirment la résolution, la durée, le codec vidéo et l'état audio.
• Toute limitation de licence ou de source pour la musique, les polices, les séquences libres de droits ou les pages tierces est documentée.
• L'utilisateur reçoit un fichier vidéo concret, pas seulement un plan ou un script.