Clip Quoi de neuf
Un clip Quoi de neuf explique à l'utilisateur ce qu'une version a changé, en un temps de défilement : une carte d'ouverture qui pose la même question à chaque version et affiche le numéro de version, une scène par changement filmée sur la version réelle avec sa légende, et une carte de fin qui indique où se le procurer. Les mots viennent en premier et sont ceux de l'approbateur. Vous filmez à partir d'un état initialisé et reproductible, générez avec une seule commande, et examinez les images fixes de votre propre rendu avant qu'une personne ne le voie. La spécification reste dans le dépôt, de sorte que la prochaine version commence à partir de celle-ci, et non d'une session de montage vierge.
Les informations du projet se trouvent dans docs/agents/whats-new-clip.md dans le dépôt de l'utilisateur : où se trouvent les notes de version, comment construire et initialiser la version de développement, comment capturer cette surface, le rendu, les formats, où sont conservés les clips et qui approuve. Si ce fichier est manquant, suivez d'abord SETUP.md.
L'outil est scripts/clip.py. Exécutez-le avec uv run <dossier de ce skill>/scripts/clip.py <commande> ; --help sur n'importe quelle commande affiche ses options. Il nécessite ffmpeg et ffprobe dans le PATH ; uv fournit Pillow. Sans uv, créez un environnement virtuel en dehors du dépôt (python3 -m venv <dossier> && <dossier>/bin/pip install pillow) et exécutez l'outil avec <dossier>/bin/python. Le format de la spécification et chaque règle appliquée par check sont décrits dans SPEC.md.
1. Trouver ce que les gens remarqueront
Lisez les notes de version là où le fichier projet l'indique. Listez chaque changement qu'une personne verra, entendra ou ressentira, chaque changement lié à sa ligne dans les notes. Laissez de côté les correctifs que personne ne remarque et le travail en coulisses.
Si rien dans la liste n'est un changement que les utilisateurs remarqueront, demandez à l'approbateur si cette version doit recevoir un clip, et arrêtez-vous sauf s'il dit oui.
Terminé quand : chaque élément de la liste pointe vers une ligne des notes de version, ou l'approbateur a dit qu'il n'y aura pas de clip pour cette version.
2. Se mettre d'accord sur les mots
Proposez une légende par changement, dans l'ordre où les montrer, le plus fort en premier. Un changement par scène. Une légende est un bénéfice pour l'utilisateur en termes simples, assez courte pour être lue deux fois pendant que la scène se joue (environ six mots). Quand l'approbateur a déjà donné des mots pour un changement (dans les notes, un message, le « Quoi de neuf » dans l'application), utilisez-les textuellement : son orthographe, sa grammaire et sa casse.
Demandez à l'approbateur une seule fois, avec la liste complète et votre recommandation pour chaque ligne, afin qu'une réponse d'un mot suffise. Ne filmez rien avant que les mots ne soient approuvés : une légende reformulée nécessite souvent un plan différent.
Quand l'approbateur reformule une légende que le produit affiche également (une feuille « Quoi de neuf » dans l'application, les notes de version du magasin), demandez si ce texte change aussi, afin que la version parle d'une seule voix.
Terminé quand : l'approbateur a approuvé chaque légende, et vous détenez chacune exactement comme approuvée.
3. Écrire la spécification
Si la configuration a déjà écrit la spécification de cette version, remplissez ce fichier. Sinon, partez de la spécification de la dernière version, pour que le rendu, la ligne d'ouverture et la carte de fin soient conservés :
clip.py init <version> --out <dossier de spécification> --from <dossier de spécification>/<dernière version>.json
Pour un premier clip, utilisez --product "<nom>" au lieu de --from. Remplissez pour chaque scène sa caption (textuellement depuis l'étape 2), words_by (qui a donné les mots), et un in et out prévus assez longs pour lire la légende. Un changement sans rien à regarder reçoit la scène la plus courte que sa légende permet. Ensuite, exécutez clip.py check <spec> --words.
Terminé quand : check --words affiche check: ok.
4. Filmer chaque scène
Filmez chaque scène selon les règles de FILMING.md, avec les commandes de construction, d'initialisation et de capture du fichier projet. Montrez uniquement ce que cette version contient : rien derrière un commutateur qui est désactivé dans la version livrée, rien de la version suivante.
Si une saisie réelle via l'interface utilisateur du produit ne peut pas atteindre un changement, arrêtez-vous et informez l'utilisateur : c'est un bogue, et un clip filmé en contournant le problème promettrait ce que les gens ne peuvent pas faire.
Un changement que la capture du projet ne peut pas filmer du tout (une vue caméra, un second appareil) est montré à partir d'un film conservé : voir « Ce que la capture ne peut pas filmer » dans FILMING.md.
Placez les films dans le dossier des clips de cette version, en dehors du dépôt. Définissez le source, in et out de chaque scène à partir du moment où chaque étape a été enregistrée lors de son exécution, et vérifiez avant de faire confiance à un repère :
clip.py peek <film> --from <seconde> --to <seconde> --out <un nouveau dossier temporaire> --sheet <dossier temporaire>/peek.png
Cela montre le film entre deux de ses secondes tel que render le lira. Ne tirez jamais cette image fixe avec votre propre recherche : un enregistrement d'écran ne conserve une image que là où l'image a changé, donc une recherche atterrit sur le changement suivant, ce qui peut être plusieurs secondes plus tard.
Exécutez ensuite clip.py check <spec> --media <dossier des films>.
Terminé quand : check affiche check: ok avec --media pointant sur les films.
5. Générer le rendu
clip.py render <spec> --media <dossier des films> --out <dossier clips>/<produit, kebab-case>-<version>-9x16.mp4
Générez chaque format supplémentaire nommé par le fichier projet avec --size, par exemple --size 1920x1080. Quand render indique qu'un écran est trop petit pour être lu à cette taille (un écran de téléphone dans un cadre large), ce format nécessite sa propre spécification : voir « Un autre format » dans SPEC.md. Le son est optionnel et ne porte jamais le message : la plupart des gens regardent en mode silencieux, donc les légendes seules doivent raconter l'histoire.
Terminé quand : render a affiché Wrote ... pour chaque format nommé par le fichier projet.
6. Passage de relecture
Tirez des images fixes dans un nouveau dossier : clip.py stills <clip> --spec <spec> --every 1 --safe --out <dossier temporaire> --sheet <dossier temporaire>/sheet.png. Cela écrit une image fixe au milieu de chaque carte et scène, une par seconde, et une feuille de toutes, avec les bords qu'un flux recouvre teintés. Examinez chacune par rapport à REVIEW.md, pour chaque format.
Si votre environnement peut démarrer un sous-agent, confiez ce passage à un agent démarré avec un contexte vierge, contenant uniquement REVIEW.md, la spécification, les images fixes et la feuille : il voit ce qui est à l'écran, pas ce que vous vouliez filmer.
Corrigez chaque constatation comme l'indique le tableau de REVIEW.md, puis générez le rendu et tirez à nouveau les images fixes. N'expliquez jamais une image erronée lors de la passation.
Terminé quand : chaque image fixe satisfait à chaque élément de REVIEW.md, et aucune correction n'est en attente.
7. Passer la main
Envoyez à l'approbateur ce que REVIEW.md dans « La passation » liste, de la manière indiquée par le fichier projet, et demandez un OK ou ce qui doit être modifié. Le clip n'est pas posté, ni attaché à une version, tant qu'ils n'ont pas dit OK. La publication est effectuée par la personne nommée dans le fichier projet.
En cas de non-OK, reportez leurs modifications à l'étape 2 (mots) ou à l'étape 4 (images), et filmez à nouveau uniquement les scènes qui changent. Un non-OK sans raison : demandez une fois ce qui leur a déplu avant de recouper les mêmes plans.
Terminé quand : l'approbateur a dit OK, ou leurs modifications sont de retour aux étapes 2 ou 4.
8. Conserver pour la prochaine version
La spécification reste dans le dépôt avec les autres modifications de la version. Conservez les films à côté des clips approuvés dans le dossier des clips. Ajoutez chaque leçon apprise par ce clip comme une ligne sous « Leçons » dans le fichier projet.
Terminé quand : la spécification est dans le dépôt, les films se trouvent à côté des clips approuvés, et chaque nouvelle leçon est une ligne dans docs/agents/whats-new-clip.md.