Vidéo de démonstration
Une vidéo de démonstration, c'est montrer le parcours d'utilisation réel d'un service, du point de vue de l'utilisateur, en moins de 5 minutes.
« Filme ce processus et ajoute une explication simple » : une seule ligne suffit pour que tout soit fait automatiquement avec les valeurs par défaut ci-dessous.
Valeurs par défaut : Enregistrement Playwright (1280×720) · Narration par sous-titres (SRT + incrustation), voix sur demande uniquement · Résultat : mp4 + srt.
La manière de lancer le service, les comptes de test et le style vidéo suivent le CLAUDE.md du projet.
Étapes
-
Découpage en scènes — Décomposer la demande en un flux de 3 à 6 scènes, telles que vécues par l'utilisateur. Pour chaque scène, indiquer « ce que l'on voit » et « une ou deux phrases d'explication ».
-
Enregistrement réel complet — Lancer le service et enregistrer, du début à la fin, en effectuant les manipulations réelles avec
recordVideode Playwright (taille = viewport). À vitesse humaine (slowMo~300 ms), attendre après chaque clic que le résultat s'affiche à l'écran. Le fichier vidéo n'est finalisé qu'après fermeture du contexte. En cas d'échec, ne réenregistrer que la scène concernée. Noter les horodatages de référence (début, résultat visible, fin) pour chaque scène. -
Rédaction des sous-titres — Dire « ce que cela apporte de bon », sans jargon technique ni nom de code. 1 à 2 phrases par scène, après l'apparition du résultat.
- Mauvais : « Je crée une PR qui change la règle hit policy de DMN rule 3 en FIRST. »
- Bon : « Les règles en conflit sont nettoyées, donc une même commande ne reçoit pas deux fois la remise. »
-
Montage sous 5 minutes — Rogner les temps de chargement ou les accélérer. Conserver les instants de manipulation et les 2–3 secondes de lecture du résultat. Si la durée dépasse, fusionner les scènes. Ne pas supprimer les étapes clés mentionnées dans la demande.
-
Composition — Concaténer les segments avec
ffmpeg, recalculer le SRT en fonction des temps de la version finale montée, puis incruster les sous-titres. Sous Windows, se placer dans le dossier de travail et utiliser des chemins relatifs (problème d'échappement des:). Police :Malgun Gothicsous Windows,Noto Sans CJK KR(ou toute police coréenne installée) sous Linux.ffmpeg -i edited.mp4 -vf "subtitles=demo.srt:force_style='FontName=Malgun Gothic,FontSize=22'" -c:a copy demo.mp4 -
Vérification — Contrôler la durée avec
ffprobe -v error -show_entries format=duration -of csv=p=0 demo.mp4(≤ 300 s). Extraire quelques images aux horodatages des sous-titres (ffmpeg -ss <secondes> -i demo.mp4 -frames:v 1 f_<secondes>.png) et les ouvrir directement pour vérifier que ce que disent les sous-titres correspond à l'écran et que le coréen ne s'affiche pas mal.
Règles à respecter
- Ne pas utiliser d'écrans factices, de réponses mock, d'injection de valeurs DOM ni de clics forcés. Si le parcours complet échoue, signaler l'échec.
- Les opérations difficilement réversibles (fusion réelle de PR, modification de données en production, envoi, paiement) ne doivent être effectuées que dans l'environnement de test défini par le projet. En l'absence d'un tel environnement, demander à l'utilisateur juste avant la scène concernée. Veiller à ce qu'aucun mot de passe ou jeton ne soit visible à l'écran ou dans les sous-titres.
- Rapport : chemins des fichiers mp4 et srt, durée réelle, description par scène, images contrôlées visuellement, points non vérifiés. La publication ou l'envoi ne se fait que sur demande explicite.