Aller au contenu

Enregistrer une vidéo de démo pour un ticket

Vous êtes développeur·se sur Kirexo et vous avez modifié un rendu (.twig, CSS, composant) ; vous voulez en produire une courte vidéo .mp4 pour l'attacher à un ticket.

Prérequis

  • Vous travaillez dans le devcontainer : le skill s'exécute côté conteneur, jamais sur la machine hôte.
  • /usr/bin/chromium est présent — il est piloté par Playwright via executablePath. Il est fourni par l'image du devcontainer ; la version épinglée et le mécanisme de pin sont documentés dans la Référence du Dockerfile multi-stage — Chromium.
  • /usr/bin/ffmpeg est présent (ffmpeg -version répond) — il assure la conversion .webm→.mp4 et l'incrustation des sous-titres.
  • Le serveur MCP playwright est déclaré dans .mcp.json (voir Config MCP Playwright). Il sert au pilotage exploratoire, pas à la capture vidéo.
  • glab est authentifié uniquement si vous comptez attacher la vidéo à un work-item (étape optionnelle).

Le symlink ffmpeg est posé automatiquement

Playwright attend son propre binaire ffmpeg à un chemin bundlé. Le skill /demo-video pose ce symlink vers le ffmpeg système de façon idempotente — aucun geste manuel de votre part. Vous n'avez pas non plus à whitelister le CDN de téléchargement des navigateurs Playwright : on branche directement sur le Chromium et le ffmpeg déjà présents dans l'image.

Enregistrer une vidéo avec le skill /demo-video

  1. Invoquez /demo-video en décrivant le scénario à jouer : l'URL de départ, puis la suite d'actions à dérouler (navigations, clics, saisies). Le scénario doit illustrer précisément la modification de rendu que vous venez de faire.
  2. Ajoutez, si utile, des sous-titres à l'écran (optionnels) : ils sont injectés en surimpression pour commenter chaque étape.
  3. Le skill enregistre la session, convertit la capture en .mp4 (libx264, yuv420p, faststart) et dépose le fichier sous var/claude/. Le chemin exact est renvoyé à la fin du run.

Rédiger un scénario court et déterministe

Attendez les états stables (élément visible, requête terminée) plutôt que de vous appuyer sur des délais fixes. Un scénario bref et sans timing fragile produit une vidéo reproductible ; un scénario qui course l'interface produit des captures aléatoires.

Attacher la vidéo à un work-item GitLab (optionnel)

Passez au skill l'IID du work-item concerné : il attache le .mp4 en pièce jointe du ticket.

Action à effet remote

L'upload touche GitLab : il passe donc par un script validé sous var/claude/*.sh, conformément à la règle projet des actions à effet remote (.claude/skills/_shared/actions-remote-scripts.md). Vous validez le script avant qu'il ne s'exécute.

Nettoyage automatique

Les artefacts intermédiaires déposés sous var/claude/ sont nettoyés en fin de run — aucun node_modules jetable ni fichier temporaire résiduel ne subsiste.

Quand une vidéo est-elle obligatoire ?

Un lot qui touche un ou plusieurs fichiers .twig (créés ou modifiés) doit produire une vidéo via /demo-video et l'attacher au work-item du lot. Un lot qui ne touche aucun .twig n'a pas besoin de vidéo.

  • La détection du .twig touché est automatisée par les skills /implementer-lot et /implementer-lot-ticket : ils vous signalent quand la vidéo est requise.
  • Le scénario, lui, reste rédigé par l'implémenteur du lot : l'obligation porte sur produire et poster la vidéo, pas sur une génération automatique du parcours à filmer — seul l'implémenteur sait quel parcours illustre sa modification.

Pour la justification de cette règle (preuve visuelle pour le reviewer), voir Workflow des agents Claude — Vidéo de démo obligatoire sur impact visuel.

Voir aussi