Communitygithub.com

Réalisateur de Vidéos de Démonstration Produit

Flux de travail interactif de réalisation pour les vidéos de démonstration produit, les démos CLI, les démos de recherche et les vidéos de flux de travail d'agents. À utiliser lorsque l'utilisateur souhaite planifier, éditer, peaufiner ou générer une vidéo de démonstration et a besoin de choix de style avant la production. Commence par une phase de conception créative structurée avant tout enregistrement, montage, rendu, TTS, musique, avatar ou appel API externe.

Qu'est-ce que Réalisateur de Vidéos de Démonstration Produit ?

Cette compétence est un flux de travail complet de réalisation vidéo, conçu pour la création de démonstrations produit, de démos CLI, de démos de recherche et de vidéos de workflow d'agents. Elle n'est pas un simple outil de rendu, mais un processus structuré allant de la conception créative à la vérification finale. L'accent est mis sur la clarté, la reproductibilité et la personnalisation du style, avec des paramètres clairs pour la plateforme cible, le public, la durée, le style et les éléments audio/visuels. Elle prend en charge plusieurs styles prédéfinis comme 'paper_clean' pour les démos de recherche, 'cli_product' pour les outils en ligne de commande, et 'launch_minimal' pour les lancements de produits, avec des règles strictes pour éviter toute décoration superflue ou l'utilisation non autorisée d'API externes. Le flux de travail se divise en phases : une phase d'accueil structurée (questions obligatoires), un audit des matériaux et des informations sensibles, la création d'un storyboard et d'une liste de décisions de montage, la génération de versions prototypées (avec des exports versionnés), le polissage et enfin une vérification rigoureuse (durée, résolution, problèmes de black frame, lisibilité des sous-titres, etc.). L'agent doit toujours terminer la phase d'accueil avant toute action de production, sauf si l'utilisateur demande explicitement de continuer avec les valeurs par défaut.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add SeanYuanWSY/product-demo-video-director

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait Réalisateur de Vidéos de Démonstration Produit ?

Opérez en tant que réalisateur vidéo pour les démonstrations produit, les démos CLI, les démos de recherche et les vidéos de flux de travail d'agents. Cette compétence n'est pas un simple outil de rendu. Il s'agit du flux de travail de conception créative, de style, de storyboard, de production et de vérification qui décide des outils à utiliser.

Référence visuelle par défaut pour le style "papier-propre" des démos de recherche/produit :

examples/style-reference/

Interprétation esthétique par défaut :

  • clarté de type papier
  • fonds blancs ou clairs si possible
  • typographie sobre et lignes fines
  • haute densité d'information avec une hiérarchie claire
  • légendes, étiquettes et chemins de fichiers axés sur les preuves
  • pas d'animation décorative sauf si elle explique un changement d'état
  • pas de musique de fond par défaut
  • pas d'avatar ou de tête parlante à temps plein par défaut
  • chaque vidéo exportée doit être reproductible à partir des fichiers du projet

Quand Utiliser

Utilisez cette compétence lorsque l'utilisateur demande de :

  • faire une vidéo de démonstration produit
  • éditer un enregistrement de workflow CLI ou terminal
  • créer une vidéo de recherche ou de supplément d'article
  • montrer un workflow d'agent, une exécution multi-agents ou un processus d'orchestration de modèle
  • transformer des enregistrements d'écran en une démo soignée
  • créer une vidéo de lancement, une vidéo README, une présentation ou un clip social
  • décider du style vidéo avant le montage
  • construire un workflow de création vidéo réutilisable ou une compétence prête pour GitHub

Règle d'Activation

Ne commencez pas l'enregistrement, le montage, le rendu, l'ajout de sous-titres, l'ajout de voix off, l'ajout de musique, la création d'un humain numérique, l'appel à une API vidéo ou la génération de fichiers finaux avant que la phase d'accueil ne soit terminée.

Ne sautez la phase d'accueil complète que si l'utilisateur dit explicitement quelque chose comme :

  • utiliser les valeurs par défaut et continuer
  • ne pas poser de questions
  • continuer à partir du brief existant

Même dans ce cas, confirmez les valeurs par défaut minimales avant tout travail destructeur ou coûteux :

  • target_platform (plateforme cible)
  • audience (public cible)
  • duration (durée de la vidéo)
  • style_preset (préréglage de style)
  • source_materials (sources de matériel)
  • voiceover (voix off)
  • captions (sous-titres)
  • music (musique)
  • avatar (humain numérique)
  • external_api_allowed (API externe autorisée oui/non)
  • deliverables (livrables)
  • validation_criteria (critères de validation)

Règles Non Négociables

  • N'utilisez jamais de musique de fond par défaut. Demandez d'abord. Pour les vidéos denses de CLI/recherche, le défaut est l'absence de musique.
  • N'utilisez jamais un humain numérique à temps plein par défaut. Demandez d'abord. Le défaut est aucun, ou une introduction/outro uniquement si explicitement demandé.
  • Ne couvrez jamais des sorties CLI denses, des tableaux, du code, des graphiques ou des lignes de progression avec des sous-titres persistants.
  • N'écrasez jamais les exports précédents. Créez des sorties versionnées comme v1, v2, v3.
  • Ne considérez jamais une vidéo générée comme complète sans une passe de validation.
  • Ne divulguez jamais de secrets dans les captures d'écran, vidéos, sous-titres, journaux, noms de fichiers ou texte README.
  • N'utilisez jamais d'API externes payantes/cloud sauf si l'utilisateur les autorise explicitement pour cette exécution.
  • N'écrivez jamais de clés API dans des scripts, fichiers de projet, markdown ou journaux de commandes. Utilisez des variables d'environnement.
  • Ne privilégiez jamais la décoration cinématographique au détriment de la lisibilité pour les démos CLI/recherche/produit.
  • Produisez toujours une liste de décisions de montage ou un storyboard avant le rendu final.

Flux de Travail d'Accueil

Commencez par une explication concise :

Je vais d'abord effectuer un accueil de production vidéo : plateforme, public, durée, style, matériel, voix off, sous-titres, avatar, musique, autorisations API, versions et validation. Ensuite, je rédigerai le storyboard et seulement ensuite je produirai les fichiers.

Posez les groupes suivants. Lorsque l'interface prend en charge les questions structurées, regroupez-les en 3 à 5 questions à la fois. Sinon, posez-les sous forme de liste de contrôle markdown.

1. Objectif et Plateforme

Demandez :

  1. Quel est l'objectif principal ?

    • démonstration de capacité produit
    • démonstration de workflow CLI / agent
    • démonstration de résultat de recherche
    • tutoriel d'installation
    • vidéo GitHub README / release
    • présentation conférence / cours / laboratoire
    • présentation investisseur / collaborateur / conseiller
  2. target_platform (plateforme cible) :

    • GitHub README
    • GitHub Release
    • YouTube
    • Bilibili
    • X / Twitter
    • Xiaohongshu
    • WeChat Channels
    • cours / réunion de laboratoire / soutenance
    • page de destination
    • archive locale uniquement
  3. Que doivent retenir les spectateurs en une phrase ?

  4. Besoin d'un titre, d'une description, d'un extrait README ou d'un texte de publication social ?

2. Public et Profondeur d'Explication

Demandez :

  1. audience (public cible) :

    • développeurs
    • chercheurs
    • conseillers / IP
    • relecteurs
    • utilisateurs open-source
    • investisseurs / évaluateurs de produits
    • étudiants
    • utilisateurs généraux
  2. Niveau de familiarité :

    • CLI
    • GitHub
    • LLM / workflows d'agents
    • expériences de recherche
    • métriques de benchmark
    • applications web
  3. Profondeur d'explication :

    • effet uniquement
    • explication légère
    • explication niveau développeur
    • explication technique / reproductibilité approfondie
  4. Gestion des termes :

    • aucune explication de terme
    • expliquer uniquement les termes principaux
    • expliquer chaque terme clé une fois
    • termes bilingues

3. Format, Durée et Versions

Demandez :

  1. duration (durée de la vidéo) :

    • teaser de 15 à 30 s
    • démo rapide de 45 à 60 s
    • démo standard de 90 à 120 s
    • présentation de 3 à 5 min
    • tutoriel de 8 à 12 min
    • laisser le matériel déterminer la durée
  2. aspect_ratio (ratio d'aspect) :

    • 16:9 1920x1080
    • 16:9 4K
    • 4:3 aspect article / diapositive
    • 9:16 vertical
    • 1:1 carré
    • versions multi-plateformes
  3. version_count (nombre de versions) :

    • une version finale
    • version complète + version courte
    • GitHub + social + présentation
    • versions de style A/B
  4. Besoin d'une miniature, d'une image d'affiche, d'un GIF ou d'une fiche de contact ?

4. Sources de Matériel

Demandez :

  1. Quels matériaux existent ?

    • vidéo existante
    • captures d'écran
    • enregistrement CLI
    • enregistrement interface web
    • sortie terminal
    • notebook
    • figures d'article
    • CSV / JSON / journaux
    • diagramme d'architecture
    • README / documentation
    • logo / icône
    • audio
    • fichier de sous-titres
    • besoin d'un nouvel enregistrement
  2. Chemins des matériaux.

  3. L'agent peut-il enregistrer l'écran localement ?

    • oui
    • non, matériel existant uniquement
    • CLI uniquement
    • interface web uniquement
    • l'utilisateur enregistrera manuellement
  4. Risque d'informations sensibles :

    • clés API
    • jetons
    • cookies
    • emails
    • chemins privés
    • résultats non publiés
    • noms de projets privés
    • tableaux de bord de services payants
    • messages personnels
    • champs de données privés
  5. Politique de rédaction :

    • aucune rédaction nécessaire
    • détection automatique et proposition de rédaction
    • zones de rédaction spécifiées par l'utilisateur
    • recadrer les régions sensibles
    • ré-enregistrer avec de fausses données

5. Histoire et Preuves

Demandez :

  1. Structure souhaitée :

    • problème -> outil -> workflow -> résultat -> preuve -> appel à l'action
    • problème -> méthode -> expérience -> résultat -> interprétation
    • installation -> commande -> sortie -> vérification
    • avant -> après
    • narration personnalisée
  2. Montrer les échecs ou uniquement le chemin idéal ?

    • chemin idéal uniquement
    • un échec et sa résolution
    • processus de débogage
    • comparaison avant/après
  3. Types de preuves à montrer :

    • commandes
    • journaux
    • chemins de fichiers
    • Git diff
    • résultats de tests
    • métriques d'expérience
    • horodatages
    • chemins des artefacts générés
    • citations / sources
  4. Besoin d'un diagramme d'architecture, d'un arbre de fichiers, d'une chronologie ou d'une carte multi-agents ?

6. Préréglage de Style

Proposez ces préréglages et autorisez le mélange :

paper_clean (style sobre fond blanc)

Par défaut pour les démos de recherche/produit.

  • fond blanc ou blanc chaud
  • axes, grilles, séparateurs fins
  • couleurs d'accent sobres
  • petits titres, étiquettes de type légende
  • haute densité d'information
  • preuves lisibles (graphiques, tableaux, terminal)
  • pas de musique persistante
  • pas d'avatar par défaut
  • transitions lentes et intentionnelles
  • idéal pour les démos de recherche, vidéos de benchmark, suppléments d'articles, preuve de reproductibilité

cli_product (style outil CLI de précision)

  • le terminal est la vedette
  • fonds sombres/clairs mélangés
  • surlignages de commandes et recadrages ciblés
  • sous-titres capsules peu nombreux
  • pas de musique de fond par défaut
  • voix off d'intro/outro optionnelle
  • idéal pour les outils CLI, workflows d'agents, utilitaires open-source

launch_minimal (style lancement minimaliste)

  • structure de lancement produit sobre
  • titres plus grands que paper_clean, mais sans encombrement promotionnel
  • 2 à 4 cartes de sections
  • mouvement subtil et transitions propres
  • voix off courte optionnelle
  • musique très basse optionnelle uniquement si l'utilisateur approuve

social_punchy (style réseaux sociaux rythmé)

  • coupes plus rapides
  • accroche forte dans les 3 premières secondes
  • sous-titres plus grands
  • zooms plus agressifs
  • musique et conception sonore optionnelles
  • pas par défaut pour la recherche/CLI sauf si l'utilisateur le choisit

documentary (style documentaire sobre)

  • pas de musique ou très faible ambiance
  • voix off rare
  • pauses plus longues sur les preuves
  • titres minimalistes
  • idéal lorsque la confiance et le sérieux sont plus importants que l'accroche du regard

explainer_animated (style animation explicative)

  • utiliser Manim/Remotion pour les diagrammes système
  • révélation progressive
  • un concept par scène
  • l'animation explique le changement d'état
  • idéal pour l'architecture, les algorithmes, les mécanismes de modèles, les diagrammes de coordination multi-agents

Demandez les questions de suivi :

  • Utiliser le chemin de référence par défaut complètement, partiellement ou uniquement comme inspiration ?
  • visual_density (densité d'information) : faible / moyenne / moyenne-élevée / élevée
  • motion_level (niveau d'animation) : aucun / sobre / modéré / élevé
  • title_card_style (style de carte titre) : légende papier / carte CLI / carte lancement / aucun

7. Sous-titres, Voix Off, Avatar, Musique

Demandez :

  1. captions (sous-titres) :

    • aucun
    • étiquettes de chapitre uniquement
    • sous-titres clés peu nombreux
    • sous-titres complets
    • bilingues
    • SRT externe uniquement
  2. voiceover (voix off) :

    • aucune
    • intro/outro uniquement
    • narration guide rare
    • narration complète
    • audio fourni par l'utilisateur
    • TTS autorisé
  3. avatar (humain numérique) :

    • aucun (par défaut)
    • intro/outro uniquement
    • petite fenêtre dans le coin pour des segments sélectionnés
    • tête parlante à temps plein
  4. music (musique) :

    • aucune (par défaut pour CLI/recherche)
    • uniquement des sons d'interface subtils
    • ambiance très basse
    • musique de lancement produit
    • musique fournie par l'utilisateur
  5. external_api_allowed (API externe autorisée oui/non) :

    • aucune API externe
    • TTS uniquement
    • avatar uniquement
    • génération vidéo autorisée
    • analyse vidéo cloud autorisée
    • demander avant chaque action externe payante

Spécifications des Styles Préréglés

paper_clean

  • Fond : #ffffff, #fbfbf8, ou #f7f7f2
  • Texte : quasi noir, pas de lueur, pas de dégradés lourds
  • Accent : un bleu froid plus un contraste chaud à faible saturation
  • Typographie : petites capitales avec parcimonie ; poids réguliers/moyens ; éviter les titres marketing géants
  • Lignes : 1px-1.5px ; graphiques et séparateurs fins
  • Sous-titres : étiquettes de type légende, en haut à gauche ou sous la figure, pas de barres pleine largeur
  • Transitions : coupe, fondu 0.2s-0.45s, balayage uniquement si sémantiquement significatif
  • Audio : pas de musique par défaut ; voix off uniquement si elle clarifie
  • Avatar : aucun par défaut
  • Validation : toutes les figures/texte du terminal lisibles en pause

cli_product

  • Fond : terminal sombre avec cartes titres sobres de style paper_clean
  • Texte : le contenu du terminal reste principal
  • Sous-titres : sous-titres capsules peu nombreux, disparaissent après 1.5-3s
  • Zooms : uniquement pour se concentrer sur les commandes, les lignes d'agent, la progression, la sortie ; éviter les zooms aveugles
  • Audio : pas de musique par défaut ; voix off courte optionnelle
  • Transitions : fondu minimal ; éviter les diapositives flashy sur du texte dense

launch_minimal

  • Fond : panneaux simples sombres ou clairs
  • Titres : cartes de sections de 3 à 6 mots
  • Sous-titres : courtes déclarations d'avantages
  • Mouvement : ease-in/out sobre, pas de décoration particulaire/ornementale
  • Audio : musique basse optionnelle uniquement si approuvée

social_punchy

  • Accroche en premier
  • Sous-titres volumineux
  • Plans courts
  • Moments avant/après marquants
  • Plus de zooms, mais valider la lisibilité du texte
  • Musique et effets sonores autorisés uniquement après approbation

documentary

  • Plans suffisamment longs pour lire
  • Sous-titres rares
  • La voix off peut remplacer les sous-titres
  • Pas de musique sauf demande explicite de l'utilisateur
  • Idéal pour les affirmations techniques ou de recherche sérieuses

explainer_animated

  • Utiliser Manim pour les mathématiques/graphiques/transitions d'état
  • Utiliser Remotion ou HTML-to-vidéo pour les cartes UI et les diagrammes
  • Chaque animation prouve un point
  • Éviter les séquences cinématographiques génériques

Guide de Sélection d'Outils

Utilisez des couches d'outils, pas un seul outil fixe :

  • ffmpeg : sondage, rognage, recadrage, concaténation, multiplexage, volume, extraction d'images, détection d'images noires, encodage final
  • MoviePy : assemblage Python local lisible lorsque les graphes ffmpeg deviennent difficiles à maintenir
  • Playwright / ui-demo : enregistrement d'interface web et capture de démonstration scriptée
  • Remotion : composition avancée, sous-titres, cartes UI animées, variantes de plateforme
  • HTML-to-video / flux de style HyperFrames : cartes titres légères et prototypes visuels rapides
  • Manim : algorithmes, graphiques, architecture, mécanismes de modèles, explicateurs de recherche
  • VideoDB : compréhension vidéo optionnelle, indexation de transcription, opérations de chronologie cloud
  • API TTS/avatar : optionnelles uniquement après autorisation explicite ; ne jamais conserver les secrets

Flux de Travail de Production

Phase 0 : Accueil

Terminez l'accueil. Enregistrez les réponses dans un fichier brief si la tâche doit produire des fichiers.

Fichier recommandé :

video_brief.md

Phase 1 : Audit du Matériel

Créez :

  • source_inventory.md (inventaire des sources)
  • sensitive_info_audit.md (audit des informations sensibles)
  • fichiers proxy ou miniatures si nécessaire
  • fiche de contact d'images pour les vidéos existantes

Ne continuez pas si du matériel sensible est visible et non résolu.

Phase 2 : Storyboard et EDL

Créez avant le montage :

  • storyboard.md (storyboard)
  • edit_decision_list.json (liste de décisions de montage)
  • style_contract.md (contrat de style)

Les entrées EDL doivent inclure :

  • fichier source
  • horodatage d'entrée/sortie source
  • nom du segment de destination
  • règle de recadrage/re-cadrage
  • règle de vitesse
  • règle de sous-titres/voix off
  • raison de l'existence de ce segment

Phase 3 : Versions Prototypes

Générez au moins le nombre de versions demandé.

Par défaut :

  • v1_complete : complète, lisible, axée sur les preuves
  • v2_release : plus courte et plus soignée

N'écrasez jamais les versions antérieures.

Phase 4 : Polissage

Polissez uniquement après que la structure est approuvée ou clairement acceptable.

Polissage possible :

  • supprimer les images inconnues / les coupes accidentelles
  • corriger les images sombres/noires
  • réduire les arrêts statiques
  • améliorer les positions de recadrage
  • réduire l'obstruction des sous-titres
  • normaliser l'audio s'il est présent
  • affiner les cartes titres
  • créer une image d'affiche ou un GIF

Phase 5 : Vérification

Avant de signaler la fin, effectuez les vérifications applicables :

  • ffprobe durée, fps, résolution, vérification du flux
  • fiche de contact d'images
  • détection d'images noires/sombres
  • détection de segments statiques
  • vérification de la lisibilité des sous-titres
  • vérification OCR pour le texte important si possible
  • vérification du volume audio si l'audio existe
  • re-vérification des informations sensibles
  • chemin et taille du fichier final

Sortie

…

[tronqué pour la traduction]

Skills associés