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 conteneur
phpde votre worktree : le skill s'exécute côté conteneur, jamais sur la machine hôte. /usr/bin/chromiumest présent — il est piloté par Playwright viaexecutablePath. Il est fourni par l'image de développementkirexo-dev; 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/ffmpegest présent (ffmpeg -versionrépond) — il assure la conversion.webm→.mp4et l'incrustation des sous-titres.- Le serveur MCP
playwrightest déclaré dans.mcp.json(voir Config MCP Playwright). Il sert au pilotage exploratoire, pas à la capture vidéo. glabest 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¶
- Invoquez
/demo-videoen 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. - Ajoutez, si utile, des sous-titres à l'écran (optionnels) : ils sont injectés en surimpression pour commenter chaque étape.
- Le skill enregistre la session, convertit la capture en
.mp4(libx264,yuv420p,faststart) et dépose le fichier sousvar/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 ?¶
Deux obligations distinctes, à deux échelles différentes.
Par lot. Un lot qui touche un ou plusieurs fichiers .twig (ajoutés, modifiés ou renommé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 à ce titre.
- La détection est automatisée :
detect-twig.sh(.claude/skills/implementer-lot/bin/detect-twig.sh, et son jumeau dans.claude/skills/implementer-lot-ticket/) compare la branche de lot à sa parente et rend0dès qu'au moins un.twigest concerné. Les suppressions pures sont exclues : retirer un template ne justifie pas une vidéo. - 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.
Par cycle. Dès qu'au moins un lot du cycle a touché une surface visuelle — .twig, .css, ou assets/ (contrôleurs Stimulus, importmap, templates servis) —, une unique vidéo « grand tour » couvrant toutes les modifications visuelles du cycle est publiée sur le work-item parent. C'est un récap d'intégration UI/UX, pas une vidéo par lot ; il vaut pour un cycle normal comme pour un cycle de remédiation. Aucune surface visuelle touchée sur tout le cycle → pas de vidéo de récap.
Les deux obligations se cumulent : un lot qui modifie un .twig produit sa vidéo de lot, et alimente en plus le récap de fin de cycle.
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¶
- Config MCP Playwright — le serveur de pilotage, distinct de la capture vidéo.
- Commandes Castor — inventaire des cibles de développement.
- Image de développement — Outillage ajouté au stage
frankenphp_dev— provenance dechromiumetffmpeg. - Workflow des agents Claude — pourquoi la délégation et la preuve visuelle.