Communitygithub.com

release-film

Montre à un agent comment planifier, construire ou monter un « film de mise à jour » dont le résultat concret est une animation que l’agent peut justifier plan par plan. La procédure parcourt : Film de mise à jour : ce qui a changé, montré en train de changer, 0 — Y a-t-il un film dans cette mise à jour ?, 1 — Demander, puis attendre. À utiliser lorsqu’une nouvelle tâche nécessite ce savoir-faire.

Qu'est-ce que release-film ?

Cette compétence spécialisée guide un agent IA (comme Claude Code ou Cursor) pour produire des vidéos « quoi de neuf » pour les versions logicielles, en se concentrant précisément sur les changements d'interface visibles par l'utilisateur final. Contrairement à une vidéo promotionnelle générale, un film de mise à jour montre le delta entre deux versions à des utilisateurs qui connaissent déjà le produit. La compétence s'appuie sur le moteur du film promotionnel du site (`site-promo-film`), mais ajoute des règles strictes : toutes les modifications doivent être vérifiées par le code source au tag Git, chaque clic doit être visible et à l'arrêt, et seuls deux ou trois changements majeurs sont présentés, le reste étant résumé dans un générique. Elle prend en charge le rendu en 16 sous-images avec flou de mouvement, des mises en page larges et carrées, et produit une sortie vérifiable via des scripts de vérification des clics. La compétence comprend un modèle de démonstration de 16 secondes, des scripts de rendu et de livraison, et un mode guidé pour la configuration initiale. La sortie est une vidéo autonome avec une carte de version en ouverture et fermeture, montrant les changements en contexte avec un curseur réel et des raccourcis claviers.

Compatible avec✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/gfazioli/manovella/tree/HEAD/plugins/manovella/skills/release-film

Demander à votre IA préférée

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

Documentation

Film de mise à jour : ce qui a changé, montré en train de changer

Un film promotionnel vend le produit ; un film de mise à jour montre le delta d'une version à des personnes qui connaissent déjà le produit pour la plupart. Même moteur, travail différent : l'état avant compte, chaque affirmation est liée à un tag, et le film est un épisode d'une série.

Cette compétence étend site-promo-film, dans le répertoire frère ../site-promo-film/. Lisez d'abord son SKILL.md : la direction, l'apparence, les interdits, les règles de construction, les pièges du canevas, les images fixes avant le rendu, le rendu et la vérification s'appliquent tous sans changement. Ce fichier ne contient que ce qu'une version ajoute.

FichierCe que c'est
template/release.htmlLe moteur plus une démo de version de 16 s : carte de version → l'application telle qu'elle était → une nouvelle commande arrive dans la barre d'outils et est cliquée (la liste se réordonne, les lignes se soulèvent) → un raccourci sur des touches ouvre une nouvelle surface (une pilule qui s'ouvre en panneau) → le reste du journal des modifications → le chemin de mise à jour cliqué dans un menu vitré → retour à la carte de version. Dispositions large et carrée à partir d'un seul fichier ; chaque changement vedette peut avoir sa propre lumière.
../site-promo-film/template/film.jsLa scène (gigue sous-pixel par sous-image : rien ne saute ni ne scintille dans les mouvements lents), FILM.draw pour les icônes et symboles, la timeline pour un long film, les effets. Le modèle le charge ; documenté en haut et dans site-promo-film §5.
../site-promo-film/template/parts.jsPièces vectorielles : fenêtres, un navigateur, un terminal, des appareils, des touches, un interrupteur, un anneau.
../site-promo-film/template/fx.jsL'apparence — arrière-plan, lumière, grain, verre, ondulations de clic — partagée avec le modèle promotionnel, qui le documente (son §4).
../site-promo-film/scripts/render.mjs, contact.mjs, beats.mjsLe moteur de rendu, la planche contact et le rythme d'une bande-son (site-promo-film §7, Le rythme), utilisés tels quels : PAGE=release.html node render.mjs ….
../site-promo-film/scripts/clickcheck.mjsChaque clic est-il vu (§3b) : la caméra immobile et le curseur au repos à chacun des CLICKS de la page. node clickcheck.mjs release.html, sortie 1 sur un clic que personne ne verra.
../site-promo-film/scripts/deliver.mjsLes films terminés et leurs couvertures dans un dossier dédié, puis le dossier de travail à la Corbeille une fois sa trousse en sécurité (site-promo-film §8).

Copiez le modèle (ou la trousse du produit, §5), film.js, parts.js, fx.js (et type.js avec les polices qu'il définit, pour les titres dans un style type.js) et les quatre scripts dans le dossier de travail src/, ~/Downloads/<produit>-<version>-quoi-de-neuf-work/src/ (~/Downloads est la racine de travail sauf indication contraire des paramètres : site-promo-film, la section Studio), et npm i playwright-core là-bas. La démo rend en 69 s à 16 sous-images sur 8 workers, 171 s dans un rendu tramé (night) ; mesuré en large.

Invoqué avec ? ou help, ou sans rien alors que rien dans la conversation ne nomme une version : le mode guidé, ../site-promo-film/guide.md. Il demande quelle version et parcourt le brief ; rien n'est rendu dedans. Le Studio (site-promo-film, Studio) écrit aussi un brief de version : kind: release, la version dans release.tag ; il répond aux questions du §1.

0 — Y a-t-il un film dans cette mise à jour ?

Posé uniquement une fois que l'utilisateur a demandé un film : une commande de version ne le soulève pas, et rien ici n'est proposé de sa propre initiative. Les rendus suivent les valeurs par défaut thermiques de site-promo-film §7.

  • Construisez la liste à partir du tag, jamais de mémoire : git log --oneline <tag-précédent>..<ref>, les PR fusionnées, les notes de version provisoires. Un film fait à partir de « ce que je pense qu'il contient » montre une fonctionnalité qui a glissé, ou une de la version précédente.
  • Il est qualifié quand quelque chose qu'une personne voit ou fait différemment est livré : une nouvelle surface, une nouvelle commande, une refonte, un nouveau raccourci. Les corrections, les performances et les parties internes ne le sont pas ; dites-le en une ligne et arrêtez-vous. Un film d'une version sans rien à montrer est une carte de titre avec un numéro.
  • Montrez au maximum trois changements. Le reste va dans le générique du journal des modifications, textuellement des notes, ou nulle part. Cinq changements vedettes signifient trois secondes chacun, ce qui est un diaporama.

1 — Demander, puis attendre

Regardez d'abord : les films précédents du produit (sa trousse, §5), les instructions du projet pour l'emplacement des médias de version, et son mode démo ou ses fixtures. Un actif que ni la trousse ni la source au tag ne contient (le maître de l'icône, un logo sous forme vectorielle) est demandé dans le même message, jamais inventé (site-promo-film §1). Puis demandez en un message, chacun avec une valeur par défaut :

  1. Version et ref à filmer (par défaut : le tag ; main quand il n'est pas encore tagué, puis revérifier au tag).
  2. Changements vedettes (par défaut : ma sélection dans le journal, une ligne chacun sur pourquoi il se montre bien).
  3. Durée (par défaut : ~6–8 s par changement vedette plus ~3 s de carte de version, 15–30 s ; doublez une fois qu'il y a des clics à voir, §3b). Un film de 30 s ou plus qui va sur YouTube reçoit des chapitres (§6) ; un plus court ne peut pas : YouTube en veut trois, le premier à 0:00, chacun d'au moins 10 s.
  4. Formats : un maître 16:9 (par défaut), et une coupe carrée comme deuxième disposition.
  5. Apparence (par défaut : celle de la trousse ; pour un premier film, une feuille d'apparence d'une image réelle, comme dans site-promo-film §4).
  6. Où il va (par défaut : <produit>-<version>-quoi-de-neuf/, livré comme indiqué dans site-promo-film §8, contenant uniquement les films et couvertures terminés, tandis que leur dossier -work reste dans la racine de travail (~/Downloads par défaut) ; l'emplacement propre du projet pour les médias de version lorsque ses instructions en nomment un).
  7. Musique : aucune par défaut. Les clips de version se lancent en sourdine automatique, donc le texte porte tout.

Ensuite un storyboard sur la grille rythmique quand le produit a une trousse (le style est fixé, seul le contenu est un choix), trois quand c'est son premier film. Attendez un feu vert.

2 — Source : l'application, à la ref

  • Lisez le code à la ref, pas l'arbre de travail : git show <ref>:<path>. Le code vu donne les chaînes, les symboles, l'espacement et les couleurs ; les captures d'écran scriptées du projet (mode démo, fixtures) donnent les proportions. Jamais une capture avec de vraies données dedans.
  • L'état d'avant provient de la source du tag précédent. Recréé de mémoire, il est faux exactement dans le détail que la version a changé.
  • Chaque chaîne à l'écran existe à la ref : git grep -nF -- '<chaîne>' <ref> doit trouver, pour le texte d'interface, les éléments de menu et le raccourci sur une touche (grep le binding, pas la documentation). Filmez dans la langue source.
  • Les titres sont les lignes de bénéfice des notes de version, quelques mots : pas les titres de PR, et rien que la version ne fait pas. Ce sont des affirmations publiques.
  • Un changement livré désactivé par défaut doit avoir son interrupteur à l'écran. Sinon le film annonce quelque chose que le spectateur ne peut pas trouver.

3 — Modèles de storyboard

  • Ouvrez et fermez sur la carte de version : icône, nom, « Quoi de neuf dans X.Y », la version dans la couleur d'accent. C'est l'image 0 et la dernière image, environ 1,5 s de chaque côté du point de boucle.
  • Changement en place. Montrez la surface telle qu'elle était pendant un temps, puis laissez le changement se produire dessus : la commande arrive dans la barre d'outils, la liste se réordonne, le panneau s'agrandit d'une section. Pas d'étiquettes avant/après et pas d'écran partagé : la transition est l'explication. Rapprochez la caméra alors que le changement atterrit, reculez pendant qu'il est utilisé.
  • Une nouvelle surface naît de ce qui l'ouvre : le clic, l'élément de menu, le raccourci. Un raccourci va sur des touches dans l'emplacement du titre, pressé sur le rythme auquel la surface répond.
  • Un changement vedette, un titre, une interaction. Le titre entre quand le changement atterrit, pas avant : le spectateur le voit, puis lit ce que c'était.
  • Un chapitre peut avoir sa propre couleur. Avec une apparence qui a des lumières, les keys de l'apparence les recolorient alors que chaque changement vedette atterrit et ramène les premières couleurs pour la carte de version, comme le fait la démo. Laissez tomber quand les couleurs du produit ont une signification (un compte, un état).
  • Le reste du journal des modifications comme un court générique dans l'emplacement du titre, une étiquette (« Aussi dans X.Y ») et trois à cinq lignes textuelles des notes, une par temps. Seulement quand le reste vaut la peine d'être nommé.
  • Fermez sur le chemin de mise à jour, cliqué pour de vrai : le propre itinéraire du produit vers la nouvelle version (un élément de menu Vérifier les mises à jour…, un bouton de magasin, l'URL du site). Puis l'interface se rétracte dans l'icône. Dans un menu, la ligne en surbrillance est celle sous le curseur à cet instant, calculée à partir de la propre piste du curseur, donc passer sur une ligne l'éclaire comme le ferait un vrai menu.
  • Pas de barres de progression, de compteurs de chapitres ou de badges « NOUVEAU » : le changement de titre est la coupure de chapitre.
  • Le changement en place est le format, pas le seul. Quand le dernier film de la trousse l'a déjà fait, variez : les notes s'ouvrant dans les écrans qu'elles décrivent, la surface modifiée en profondeur 3D, un wipe avant/après sur la même image, un tutoriel du nouveau flux. site-promo-film §2 a le catalogue ; un film de version en prend un et dit lequel dans son storyboard.
  • Une version majeure peut avoir un long film (1–3 min, un chapitre par changement vedette, pas une boucle) sur la timeline de site-promo-film §2b, à côté du court clip pour les réseaux sociaux.

3b — Chaque clic est vu

Un film de version est surtout des clics, et un clic est un temps que le spectateur doit voir atterrir. Un montage de 30 s a déjà été joué avec ses mouvements trop rapides et quelques clics manquants. Mesuré : deux clics sont tombés alors que l'image bougeait à 1255 et 1414 px/s, et la plupart ont atterri sur un curseur immobile à 20-45 pt de sa cible. Le montage de 60 s chronométré selon la règle ci-dessous a mesuré chaque clic sous 2 px/s et 1 pt.

  • La caméra est arrivée avant le clic. Commencez un mouvement de caméra au moins environ 1,3 s avant le clic qu'il encadre, et ne bougez plus une fois que l'interface y a répondu.
  • Le curseur se repose avant d'appuyer : donnez à chaque mouvement environ deux secondes sur des ressorts lents (f 0,85 horizontal, 0,75 vertical ; un petit saut peut être plus rapide), pour qu'il reste immobile une demi-seconde.
  • Il reste pendant la pression, maintenu assez longtemps pour être vu (vers le bas 0,05 s, vers le haut 0,14 s plus tard), avec un anneau plus large ; le mouvement suivant ne commence pas avant 0,3 s après la pression.
  • Ce qu'un clic ouvre ne recouvre jamais ce qui a été cliqué : un panneau tombe de dessous son élément, une fenêtre grandit à côté de la notification dont elle est issue, une feuille se ferme 0,15-0,2 s après que son bouton a été pressé. Le premier maître de 60 s a fait grandir la coque au-dessus de l'élément cliqué lors de la pression et l'a caché ; les images fixes à des moments précis ne l'ont jamais montré, les images extraites du mp4 l'ont fait.
  • Vérifiez-le : node clickcheck.mjs release.html avant le feu vert (il mesure la caméra sur le point cliqué, le trajet avant la pression et pendant celle-ci ; les deux modèles passent), et après le rendu, extrayez une image du mp4 à chaque temps de clic (site-promo-film §7).
  • Sur un iPhone ou un iPad (le frame du brief, site-promo-film §0), un clic est un tapotement : aucune flèche n'est dessinée, et un doigt ne se montre que pendant qu'il tape (un disque mou qui appuie, avec l'ondulation de l'apparence). La page déclare toujours CLICKS, et curX(t) / curY(t) sont là où se trouve le doigt : ils sautent au point tapoté suivant entre les tapotements et se reposent dessus avant et après chacun, donc clickcheck.mjs mesure les tapotements exactement comme il mesure les clics, et une page sans CLICKS sort toujours 2. Les règles ci-dessus tiennent, la caméra par-dessus tout.

4 — Disposition : un emplacement et une région libre

Le modèle calcule la caméra au lieu de la régler à la main. fit(rect, head) renvoie la caméra qui fait qu'un rectangle du monde remplit la région libre (à côté de l'emplacement de titre en large, en dessous en carré, ou tout l'écran sans titre), plafonné à zmax. Trois règles, chacune mesurée en construisant la démo :

  • Avec un titre affiché, un gros plan revient au bord propre de la surface du côté de l'emplacement (toEdge). Ajustez seulement le détail et le reste de la fenêtre glisse sous le titre, qui se trouve alors à moitié sur le canevas et à moitié sur la fenêtre sombre.
  • En carré, un gros plan garde la pleine largeur de la surface, sinon ses étiquettes de ligne sont coupées aux deux bords de l'écran.
  • Le titre sortant est dessiné sous la forme en mutation, donc la fenêtre grandit par-dessus. Dessiné par-dessus, ses lettres qui s'estompent s'impriment sur la fenêtre pendant une demi-seconde.

Un deuxième format est une deuxième disposition, jamais un recadrage de la première : la page lit location.hash, et PAGE='release.html#square' passe le hash via render.mjs. Le hash prend aussi l'apparence, joint avec & : PAGE='release.html#square&look=night'.

5 — La trousse : chaque film d'un produit ressemble à un seul spectacle

Le premier film pour un produit (ou son film promotionnel de site) produit une trousse : polices, jetons de couleur, l'icône sous forme vectorielle, la carte de version, la chrome de fenêtre, le langage de caméra, l'apparence (son préréglage et ses surcharges : une ligne FX.look). Commitez-la avec le produit, là où ses instructions le disent (sinon proposez un endroit, scripts/film/ jusqu'à présent), avant que le dossier de travail ne soit jeté, pour que la prochaine version parte de la trousse plutôt que du modèle : un storyboard, seul le contenu change, et la série est reconnaissable. Sur la carte de version, seul le numéro change.

Ce qu'une trousse garde est la page, pas le moteur. Le moteur est celui de la compétence et est copié à nouveau pour chaque film. La page est le travail : les surfaces du produit sous forme vectorielle, chaque chaîne sourcée à un tag, le minutage qui a survécu aux cycles de relecture, et un README de ce que ces cycles ont enseigné.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills associés