Communitygithub.com

révision et livraison

La boucle qui transforme un film monté en un film livré. Examiner les images, mesurer le son, effectuer des vérifications, montrer des brouillons et des échantillons à la personne, agir sur ses retours, générer le master, vérifier le fichier final, rédiger le compte rendu du projet et faire un rapport. À utiliser après toute construction ou modification, avant chaque rendu, et à chaque fois qu'un retour arrive.

Qu'est-ce que révision et livraison ?

Cette compétence décrit le processus complet de révision et de livraison d'un film, depuis le rendu initial jusqu'à la remise du fichier final. Elle guide l'agent utilisateur à travers une série d'étapes structurées : inspection des images via des instantanés et des feuilles de contact, vérification audio avec des mesures de loudness, création de brouillons basse qualité pour validation, présentation d'options visuelles sous forme d'images fixes, traitement des retours du client (y compris des notes courantes comme « lent », « ne semble pas réel », « je n'arrive pas à me connecter »), rendu du master, vérification finale avec ffprobe et scripts de contrôle, et mise à jour de la documentation du projet (SCRIPT.md, SPEC.md, CREDITS.md, REVIEW.md). Chaque étape est conçue pour minimiser les rendus coûteux en faisant le plus de vérifications possible en amont, et pour garantir une livraison fiable et transparente.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/shubhamnshukla/video-agent-kit/tree/main/skills/video-review-and-delivery

Demander à votre IA préférée

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

Documentation

Que fait révision et livraison ?

1. La boucle après chaque modification

  1. npx hyperframes lint. Zéro erreur.
  2. npx hyperframes snapshot --at 3.4,7.8,35.2,... aux moments que vous avez modifiés, plus un avant et un après. Ouvrez la feuille de contact et lisez-la réellement : chaque carte est-elle complète, un visage est-il caché, du texte sort-il de son cadre, quelque chose est-il à moitié dessiné alors qu'il devrait être terminé ?
  3. Corrigez et répétez jusqu'à ce que les images soient correctes.
  4. npx hyperframes check --json (ou scripts/check.sh avec une vidéo 4K). Corrigez les erreurs. Lisez les avertissements une fois et décidez : corrigez-les, ou conservez-les en indiquant pourquoi dans REVIEW.md. Avertissements à prendre en compte : rien ne change pendant plus de trois secondes, une première image vide, du texte qui sort d'un conteneur.

Les instantanés sont peu coûteux ; les rendus ne le sont pas. Faites tout le contrôle possible avant de lancer un rendu.

2. Brouillons

Un brouillon est le film entier en basse qualité : npx hyperframes render --quality draft -o renders/draft-01.mp4, une à trois minutes pour un film de 100 secondes en 1080p. Ensuite :

  • Créez une feuille du fichier rendu (scripts/sheet.sh renders/draft-01.mp4 sheet.jpg 1/2.6 8x5) et lisez-la. Elle montre le film tel qu'encodé, y compris les séquences, ce que les instantanés peuvent mal interpréter.
  • Mesurez la loudness : ffmpeg -i draft.mp4 -af ebur128=peak=true -f null -.
  • Mesurez le niveau toutes les deux secondes (scripts/levels.py draft.mp4 2) et comparez-le au plan : la partie calme est-elle calme, la montée arrive-t-elle là où le produit apparaît ?

Donnez le brouillon à la personne avec une courte note sur ce qu'il contient et sur quoi vous souhaitez attirer son attention (vue et ouïe). Le premier brouillon est fait pour être corrigé ; envoyez-le tôt plutôt que poli.

3. Présentation des options

Lorsque la question est visuelle (un style de surbrillance, une police, une mise en page, une couleur), montrez des images fixes, pas des rendus.

  • Générez chaque option, faites un instantané des trois ou quatre mêmes moments, et enregistrez les feuilles de contact côte à côte avec des noms simples (A-underline.jpg, B-band.jpg).
  • Dites en une ligne ce que sont A et B, et laquelle vous choisiriez et pourquoi.
  • Attendez la réponse uniquement sur ce point ; continuez à travailler sur tout ce qui n'en dépend pas.

Lorsque leurs paroles pourraient avoir deux sens, c'est ainsi que vous le découvrez. Cela coûte une minute. Un rendu complet erroné coûte dix minutes et leur patience.

4. Agir sur les retours

Les retours arrivent courts, informels et parfois agacés. Traitez-les ainsi :

  • Reformulez-les en une action avant d'agir, en une ligne : "Photo de Singapour : mêmes petits caractères que les autres, dans le problème et la fin."
  • Appliquez-les partout où ils s'appliquent. Si un élément était erroné, ses équivalents ailleurs dans le film le sont de la même manière.
  • Acceptez le goût comme donné. "Lent", "ennuyeux", "a l'air cheap", "trop épais" : modifiez-le ; ne le défendez pas. Si vous n'êtes pas d'accord sur un point factuel (cela cacherait un visage, une affirmation serait fausse), dites-le une fois, avec la raison.
  • Notes courantes et ce qu'elles signifient :
Ils disentFaites
lent, endormi, ennuyeuxplans plus courts, voix plus rapide, coupes de lignes, musique plus énergique ; pas plus d'effets
ne semble pas réel, semble de l'IAséquences réelles de vraies personnes ; moins de graphismes inventés
ressemble à des clips libres de droits collés ensembleun étalonnage unique sur tout ; personnes récurrentes ; cartes cohérentes
je n'arrive pas à me connecternoms, métiers, besoins spécifiques ; le problème dans leurs propres mots
le son est plat, monotonemarquez-le par ambiance ; du silence avant la montée
rendez-le accrocheurréécrivez l'accroche et la ligne de conclusion ; ajoutez un rappel
celui-ci est différent des autresfaites-le correspondre exactement à ses équivalents
plus d'attention sur ces motsun accent par ligne, montré d'abord sous forme d'images fixes
  • Plusieurs messages à la fois : traitez chacun ; dites en une ligne comment. Un message ultérieur annule un message antérieur.
  • Enregistrez les décisions dans REVIEW.md et en mémoire : ce qu'ils ont choisi, ce qu'ils ont rejeté, dans leurs mots.

5. Le rendu master

Lorsque le brouillon est approuvé ou que les modifications restantes sont mineures :

  1. Vérifiez l'espace disque libre. Un rendu 4K nécessite environ 11 Go d'espace temporaire pour 100 secondes.
  2. npx hyperframes render --quality delivery --resolution landscape-4k -o renders/<name>-4k.mp4, en arrière-plan. Ajoutez --gpu s'ils veulent de la vitesse ou l'ont demandé ; dites ce que cela coûte (environ la moitié du débit binaire).
  3. S'ils demandent combien de temps, lisez la progression du rendu et répondez avec un nombre.

Nommez les versions simplement (-v2, -v3). Lorsqu'une version est rejetée, supprimez-la pour que personne ne l'ouvre par erreur.

6. Vérifier le fichier terminé

Faites ceci sur le fichier que vous allez remettre, pas sur le projet.

  • ffprobe : résolution, fréquence d'images, durée, taille.
  • Une feuille du fichier entier : chaque section présente, pas de partie vide ou gelée, la dernière image correcte.
  • Un recadrage en taille réelle d'un texte et d'un visage : typographie nette, séquence non pixélisée.
  • Loudness : environ −16 LUFS intégré, pic réel à ou en dessous de −1 dBFS.
  • Le code QR décodé à partir d'une image tardive (scripts/scan.py) : le lien exact, en taille réelle et à demi-taille.
  • L'adresse sur la carte de fin répond lorsqu'elle est demandée.

7. Le compte rendu du projet

Mettez à jour les quatre fichiers avant de faire le rapport. templates/ contient un squelette pour chacun.

  • SCRIPT.md : le tableau du script (temps, image, voix), les personnes, d'où vient chaque ligne, les chiffres.
  • SPEC.md : objectif, résultat, plan temporel et sonore, aspect visuel, typographie, mouvement, liste des plans avec images, liste QA.
  • CREDITS.md : chaque source et sa licence.
  • REVIEW.md : décisions prises ; mesuré, examiné, non vérifié ; décisions ouvertes ; plans les plus faibles ; avertissements conservés volontairement ; comment modifier le film (quel fichier, quelle commande).

8. Le message de remise

Court, dans cet ordre :

  1. Le fichier : chemin, résolution, durée, taille.
  2. Ce qui a changé depuis la dernière version, sous forme de courte liste.
  3. Ce que vous avez vérifié et comment ; ce que vous n'avez pas vérifié (vous ne l'avez jamais entendu).
  4. Ce qui nécessite leur décision, du plus important au moins important : les éléments non présents dans le produit final, tout ce qui est à l'écran et que l'entreprise pourrait ne pas vouloir montrer, les licences à confirmer, les prononciations à écouter.

Pas d'adjectifs sur votre propre travail. Si quelque chose a échoué ou manque, c'est la première ligne.

9. Entretien

  • Conservez les téléchargements sources et les manifests à partir desquels le film est monté ; supprimez les candidats non utilisés, les anciens brouillons et caches lorsque l'espace est insuffisant ou sur demande. Regardez ce que vous allez supprimer ; ne supprimez que ce que vous avez créé.
  • Ne validez ni ne poussez jamais leur dépôt à moins qu'on vous le demande.
  • Gardez les scripts générateurs et les scripts d'aide dans le projet, pas dans un dossier temporaire qu'un redémarrage efface.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Skills associés