Communitygithub.com

démo-vidéo

Planifiez et réalisez de courtes vidéos centrées sur les preuves pour des changements logiciels, des démos de sprint, des récapitulatifs, des résultats de recherche, des versions, des présentations, des tutoriels et des reproductions de bugs.

Qu'est-ce que démo-vidéo ?

Cette compétence est un plan de production vidéo pour ingénieurs logiciels, conçu pour créer des films courts où la preuve prime sur la mise en scène. Elle est utile pour documenter du travail logiciel (une fusion, un sprint, un bug) sous forme de vidéo facile à consommer sur téléphone. La compétence ne fournit pas de rendu vidéo intégré, mais décrit une méthode, une structure de plan, un story-board textuel et la chaîne de capture/render. Elle fonctionne avec n'importe quel générateur HTML-vers-vidéo (comme HyperFrames, Remotion, Motion Canvas) et des outils d'automatisation de navigateur (Playwright). Le processus suit un cycle strict : brief → tableau de revendications → story-board → capture → composition → vérification → rendu → livraison. Des règles non négociables imposent que chaque image montre un état réel (pas de données inventées), que les textes soient lisibles sur un écran de téléphone, que la marque soit approuvée et que la musique soit sous licence. La compétence s'utilise en mode "done", "sprint-demo", "previously-on", "research", "release", "concept", "walkthrough" ou "repro", avec des longueurs et formats adaptés à chaque usage.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jernejk/jkstack/tree/HEAD/blueprints/demo-video

Demander à votre IA préférée

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

Documentation

Vidéo de démonstration

Une vidéo est ici une preuve d'abord et un film ensuite. Chaque image montre quelque chose de réel, étiqueté pour ce que c'est, lisible sur un téléphone, et chronométrée pour que le résultat arrive avant le détail.

Ceci est un plan, pas une compétence installée. Il décrit une méthode qui a produit de vrais films, mais il ne fournit ni rendu, ni enregistreur, ni vérificateur. Utilisez les outils dont vous disposez ; les extensions décrivent ceux qui valent la peine d'être construits. Résolvez les chemins de référence par rapport à ce dossier de compétence.

1. Choisir le mode, puis rédiger le brief

ModeUtilisation pourDuréeFormat
doneune fusion ou correction de bug terminée15–30 scarte d'intro → le changement dans l'UI réelle → carte de fin avec le ticket ou la PR
sprint-demoune revue de sprint pour les parties prenantes2–4 minobjectif du sprint → 3 à 5 réalisations, la plus importante en premier → non fait → suite
previously-onun épisode d'un projet en cours1–3 mindernier fil ouvert → parties : question → résultat → ce qui a changé → fil suivant
researchune expérience, un pic ou une nuit de recherche1–2,5 minquestion → méthode en une image → résultat avec son dénominateur → surprises → décision
releasece qui a été livré et la suite1–2,5 minformat récapitulatif avec états fusionné → publié → en staging → en production
conceptun film de fonctionnalité, une maquette ou une proposition45–95 saccroche résultat → un exemple concret → preuve → limite honnête → résultat final
walkthroughcomment réaliser une tâche30–90 srésultat final → étapes dans l'UI réelle → résultat final à nouveau
reproun rapport de bug10–30 senvironnement → étapes → l'échec, maintenu → résultat attendu en texte

Détails par mode : modes. Les rétrospectives, anniversaires et adieux sont l'extension de parcours dans extensions.

Avant toute capture, écrivez BRIEF.md dans le dossier du film : mode, public, le seul message clé, largeur de visualisation (par défaut : un téléphone, 844 px paysage et 390 px portrait pour le lecteur), profil de marque, la classe de preuve de chaque scène, date limite et livrables. Ne demandez que ce que vous ne pouvez pas déduire de la demande ou des sources.

2. Incontournables

  • La preuve avant l'art. Montrez l'UI réelle, la sortie réelle sauvegardée et les pages sources réelles. Ne peignez jamais un état qui ne s'est pas produit, n'inventez pas de nombre, et n'impliquez pas de vitesse, de publication ou d'utilisation en production. Chaque fait à l'écran a une ligne dans le tableau de revendications avant que sa scène soit construite (preuve).
  • Étiquetez ce que c'est, à l'écran, en permanence. Un rail hors caméra indique la classe de preuve : Build local, Démo concept · données échantillon, Réponse enregistrée · rejouée, Staging, Production. Les concepts et maquettes ne passent jamais pour des fonctionnalités livrées.
  • Le résultat d'abord. Le message clé et un nombre héros ou un résultat visible arrivent en environ 1,5 s après le début d'une scène et restent jusqu'à la coupe. Durée de scène ≥ 1 s + mots ÷ 3 + 1,5 s de maintien (rythme).
  • Lisible sur un téléphone. Texte héros ≥ 80 px en 1080p ; tout ce qu'un spectateur doit lire ≥ 36 px. Trop de mots : coupez les mots ou recomposez, ne réduisez jamais.
  • UI nette. Capturez la preuve en densité 2× et affichez-la à une échelle ≥ 1,0 ou zoomez. Ne jamais upscaler un écran dense en 1080p et l'appeler un gros plan.
  • Marque approuvée uniquement. La marque personnelle ou d'entreprise provient d'un profil de marque et des actifs approuvés de cette marque (marque). Ne redessinez, ne recolorez et n'approchez jamais un logo.
  • Son sous licence. La musique et les effets nécessitent une licence vérifiée et le crédit qu'elle exige.
  • Terminé signifie vérifié. Signalez séparément les vérifications techniques, les images inspectées, la lecture à vitesse réelle et l'écoute. L'acceptation du demandeur est son propre état (revue).

3. Boucle de travail

  1. Brief et revendications. BRIEF.md et le tableau de revendications. Pour les films avec des nombres, faites vérifier par un relecteur indépendant, idéalement d'une famille de modèles différente ou une personne, le texte final à l'écran, y compris le texte dans les captures d'écran, avant le rendu complet.
  2. Story-board en mots. Une ligne par scène : fenêtre temporelle, ligne héros, image, étiquette de preuve, indication sonore, comment elle enchaîne. Choisissez les 3 à 5 types de transitions que le film utilise et ce qui provoque chacune.
  3. Capture (capture). Flux de navigateur scriptés pour les séquences interactives, capture d'images à horloge fictive pour l'animation propre d'une page, captures d'écran d'éléments en 2× pour les images fixes.
  4. Composition (composeur). Les modes courts conviennent à un compositeur piloté par spécification ; les modes plus longs conviennent à une composition artisanale sur une seule timeline en pause avec les scènes sur une grille de barres.
  5. Vérifier avant le rendu. Prenez un instantané de chaque scène à son premier moment lisible, à mi-parcours, en fin de maintien et des deux côtés de chaque coupe. Corrigez les collisions, le texte tronqué, les images vides et tout ce qu'un étranger ne pourrait pas lire.
  6. Rendre, mixer, vérifier. Rendez, encodez, mixez la musique et les effets, exécutez les vérifications techniques, puis lisez vous-même la planche contact, les bandes de coupe et les fiches téléphone (mouvement et son).
  7. Livrer. Copies silencieuse, avec musique et web, plus une affiche, le crédit musical à côté du lecteur, et un REVIEW.md : ce qui a été mesuré, ce qui a seulement été regardé, et le plan le plus faible.

4. Chaîne d'outils

N'importe quel rendu qui produit des images de manière déterministe fera l'affaire. HyperFrames (Apache-2.0) et un script de capture d'images redirigé vers FFmpeg rendent les compositions HTML directement. Remotion (React ; vérifiez d'abord les termes de sa licence d'entreprise) et Motion Canvas (scènes TypeScript) ont leurs propres modèles de scène ; le contrat de composition dans composeur se traduit vers eux. L'automatisation de navigateur comme Playwright pilote la capture. FFmpeg encode, mixe et mesure. Verrouillez les versions du rendu et désactivez la télémétrie là où elle est proposée.

5. Autorité

Faire un film autorise la capture locale, la composition et la vérification. Cela n'autorise pas les téléchargements, les messages, les commentaires de PR ou de tickets, les modifications de produit ou la publication. Utilisez des données fictives d'échantillon ou approuvées ; ne montrez jamais de noms de clients, de clients ou d'employés sans approbation, et ne zoomez jamais sur une identité connectée.

Références

BesoinLire
Profils de mode et formes d'histoiremodes
Revendications, étiquettes, états de statut, vérification des faitspreuve
Temps de lecture, tailles de texte, largeurs de téléphonerythme et téléphone
Mouvement, transitions, musique et effetsmouvement et son
Profils de marque personnelle et d'entreprisemarque
Techniques de capture et piègescapture
Spécification de vidéo terminée et contrat de compositioncomposeur
Étapes de revue et suggestions de livraisonrevue et livraison
Enregistreur, vérificateurs, récapitulatifs à partir d'une timeline, films de parcoursextensions

Skills associés