Que fait Vidéo de démonstration du navigateur ?
Vous écrivez le scénario de la vidéo sous forme de code, ce qui rend les prises reproductibles : un changement de voix ou une étiquette corrigée signifie une reprise automatique, pas un réenregistrement manuel. Le pipeline :
script.cjs ──tts.cjs──▶ audio/*.wav + durations.json
│ │
└──────────record.cjs◀───────────┘ Chrome + overlay, CDP screencast → takes/<target>/frames + timeline.json
│
post.py ──▶ MP4 (coupures supprimées, narration + sons de clic, −16 LUFS, chapitres)
│
review.py ──▶ planches contact + vérification du volume et des chapitres → vous inspectez, puis livrez
Moteur : scripts/ dans cette compétence. Projet par vidéo : ~/Movies/Demos/<slug>/ (jamais /tmp, qui est effacé), contenant video.config.cjs, script.cjs, audio/ et takes/. Exemple exécutable : examples/hello-orders/ (une petite page intégrée dans un shell hôte ; utilisez-le pour vérifier votre configuration). Lisez references/lessons.md avant la première prise.
Prérequis : Chrome, Node avec Playwright (record.cjs le trouve, ou définissez playwright dans la configuration), ffmpeg/ffprobe, Python 3 et l'interface AWS CLI pour Polly.
1. Validez la vidéo (avant tout code)
Confirmez et proposez un plan auquel l'utilisateur peut réagir :
- Public. Les vidéos internes couvrent les rôles, les autorisations, les contrôles et les limitations connues, et se terminent par un chapitre « À savoir ». Les vidéos pour la direction et les clients couvrent les résultats et le chemin heureux uniquement.
- Le déroulement de bout en bout, sous forme de chapitres, et la durée cible. Environ 10 à 12 minutes convenaient pour une plongée en profondeur interne.
- Où enregistrer (décision). Le parcours clique sur de vrais boutons et écrit un état réel, donc il ne doit jamais s'exécuter sur des données réelles et partagées. Recommandez une copie, un espace de test ou un environnement de développement avec des données réalistes, ainsi qu'un moyen de le réinitialiser entre les prises. Si la création de cette copie écrit en production, cela nécessite un oui explicite.
- Identités (décision). Si le flux nécessite deux personnes (créateur et vérificateur), soit un vrai collègue se connecte dans une seconde fenêtre, soit une personne joue les deux rôles et la vidéo l'indique à l'écran. Ne créez jamais d'utilisateurs et ne gérez pas les mots de passe ; si un compte de test est nécessaire, l'utilisateur le crée.
- Voix (décision). Par défaut, la voix générative Polly « Amy » (en-GB), qui a bien fonctionné avec de vrais spectateurs. Proposez un échantillon d'environ 30 s de chaque voix candidate avant de tout générer :
aws polly synthesize-speech --profile <profil dev> --region eu-west-2 --engine generative --voice-id Amy --output-format mp3 --text "<passage avec le jargon du produit>" sample-Amy.mp3Utilisez un compte AWS non production. macOSsayfonctionne hors ligne mais sonne synthétique. La propre voix de l'utilisateur est l'option la plus naturelle. - Cadrage. Seul le produit est dans le cadre : pas de panneaux latéraux de l'hôte, de listes ou de bannières. Configurez cela dans le hook
setupde la configuration.
2. Configurez le projet
P=~/Movies/Demos/<slug>; K=~/.claude/skills/browser-demo-video
mkdir -p "$P" && cp $K/templates/video.config.cjs $K/templates/script.cjs "$P"/
Dans video.config.cjs, renseignez : l'url de l'environnement jetable, frame si le produit s'exécute dans une iframe, ready, setup (cadrage), theme (couleur d'accentuation du produit et pied de page), voice, et helpers.waitLoaded (le signal de chargement du produit).
Cartographiez l'interface utilisateur avant d'écrire les étapes. Ouvrez-la, listez les sélecteurs stables (ids, rôles, data-*, texte visible) et notez les chargements lents. Préférez les sélecteurs basés sur le texte affiché (tr:has-text("-1 250,00") [data-resolve]) aux clés générées.
3. Écrivez le script de la scène
Chaque étape a { id, chapter?, pre?, say?, act?, gap? }. L'API h est documentée en haut de templates/script.cjs.
- La narration pilote le timing.
acts'exécute pendant que le clip joue, eth.at(0.6)aligne une seconde action sur les mots. Gardez chaquesayà une ou deux phrases parlées. - Écrivez les nombres comme ils sont prononcés (« quatre-vingt-dix-sept pour cent », « le quatorze septembre »).
- Utilisez les décisions réelles d'utilisateurs réels lorsqu'elles existent, afin que les chiffres à l'écran correspondent à ce que l'équipe connaît.
- Placez une carte de chapitre (
h.card) avant chaque chapitre, et ajoutez des anneaux avec des étiquettes de 3 à 6 mots. Utiliseznote()uniquement là où un point doit être souligné, comme une propriété de sécurité, une mise en garde ou « dans un usage réel… ». - Encadrez chaque chargement lent dans
h.cut(() => h.waitLoaded(), 'Chargement …'). Cette durée est supprimée en post-production. - Exprimez chaque simplification à l'écran et dans la narration. Par exemple, une personne joue deux rôles : montrez le contrôle qui le bloque, montrez le réglage modifié « pour cet enregistrement uniquement », puis expliquez ce qui se passe dans un usage réel.
- Pointez sur les téléchargements ; ne cliquez pas dessus (voir les leçons).
4. Générez la voix off
node $K/scripts/tts.cjs "$P". Seules les lignes modifiées sont régénérées. Claude ne peut pas écouter le résultat, nommez donc les mots risqués (acronymes, noms) et demandez à l'utilisateur de les vérifier. Avec macOS say, épetez les acronymes comme des lettres (« S A P »).
5. Exécution à blanc, puis connexion, puis enregistrement
- Exécution à blanc. Pointez
TARGET=previewavecpreviewUrlsur une version locale si elle existe. Sinon, exécutez de courts segments sur l'environnement jetable :ONLY='^(c1|load0|where1)$' node $K/scripts/record.cjs "$P" record. Vérifiez quelques images avec l'outil Read (takes/prod/frames/*.jpg,failure.pngen cas d'erreur), et vérifiez avec ffprobe que les images sont en 1920×1080. Réinitialisez l'environnement ensuite. - Connectez-vous. Exécutez
node $K/scripts/record.cjs "$P" loginavecrun_in_background. L'utilisateur se connecte dans la fenêtre qui s'ouvre, puis la ferme. S'il dit avoir terminé mais que la fenêtre est toujours ouverte,pkill -INT -f "record.cjs.* login". - Prise complète. Réinitialisez l'environnement, puis exécutez
node $K/scripts/record.cjs "$P" recordavecrun_in_background. Avant qu'elle ne démarre, dites à l'utilisateur que cela prend environ la durée de la narration plus un tiers, dans une fenêtre Chrome visible sur laquelle il ne doit pas cliquer. Attendez la notification de fin ; ne sondez pas avec sleep. Vérifiez le journal pour chaque étapeoket aucune ligneFAILEDouCRASHED.
6. Assemblez et révisez
python3 $K/scripts/post.py "$P/takes/prod" "$P/takes/prod/walkthrough.mp4" # run_in_background ; ~10 min pour une vidéo de 10 min
python3 $K/scripts/review.py "$P/takes/prod" "$P/takes/prod/walkthrough.mp4" "$P/review" # optionnel : step_id:0.8 picks
Lisez chaque planche review/s*.jpg. Recherchez des étiquettes coupées ou qui se chevauchent, des anneaux sur le mauvais élément, des états de chargement qui n'ont pas été coupés, et des superpositions résiduelles. Le volume doit être d'environ −16 LUFS et le nombre de chapitres doit correspondre au script. Corrigez les problèmes dans le script, réinitialisez l'environnement, et refaites la prise. Les reprises sont peu coûteuses.
7. Livrez et nettoyez
- Livrez. Copiez la vidéo vers
$P/<slug>.mp4et lancezopen. Si une version précédente existe, conservez-la renommée (par exempleold-<voice>-<slug>.mp4), pas écrasée. - Rapportez. Donnez la durée, la résolution, les chapitres, la voix, l'endroit où elle a été enregistrée, chaque simplification montrée, ce que vous n'avez pas pu vérifier (l'audio), et les défauts visuels restants.
- Demandez avant de nettoyer. Obtenez l'accord de l'utilisateur avant de supprimer la copie jetable ou l'environnement, et avant de supprimer
takes/(les images prennent des Go). Gardezscript.cjs, la configuration etaudio/pour que la vidéo puisse être réenregistrée ultérieurement. - Enregistrez-le. Si le travail appartient à un ticket ou un fichier de notes, notez l'emplacement de la vidéo et le fait que la suppression de la copie est en attente. Validez uniquement ce fichier.