Ablation-Lab/video-review

Révision vidéo

L'outil transforme un fichier vidéo ou un projet Remotion en un dossier de révision que vous pouvez lire : images PNG, résultats audio, la ligne de narration et le texte OCRisé à l'écran pour chaque image, vérifications automatiques, et ce qui a changé depuis la dernière révision, le tout dans report.md. Votre tâche consiste à l'exécuter, puis à réviser la vidéo à partir du dossier.

1. Exécuter l'outil

Exécutez-le avec cette commande exacte (elle fonctionne à la fois depuis Bash et PowerShell), en utilisant le chemin de l'utilisateur entre guillemets :

powershell -NoProfile -ExecutionPolicy Bypass -File "${CLAUDE_SKILL_DIR}/review-video.ps1" "<fichier vidéo ou dossier de projet Remotion>" [options]

• Fichier vidéo (MP4, MOV, etc.) : images toutes les 2 s, autour de chaque changement de plan et à la fin.
• Dossier de projet Remotion : images rendues avec npx remotion still (pas besoin de rendu complet) et l'audio rendu séparément. Il utilise la première composition sauf si -Composition <id> est fourni ; la sortie liste les autres. npm install doit déjà avoir été exécuté dans le projet.

Options utiles (toutes optionnelles) :

Option	Utilisation
-Composition <id>	Remotion : quelle composition rendre.
-Frames 0,90,450	Remotion : ne rendre que ces numéros d'images.
-Interval <s>	Secondes entre les images régulières (par défaut 2). Utilisez 4 ou plus pour les longues vidéos.
-Narration <fichier>	Source de la narration si elle n'est pas trouvée automatiquement : .srt, .vtt, .csv, .md (tableau d'enregistrement) ou voiceover.json.
-Project <dossier>	Dossier où chercher la narration quand la vidéo se trouve en dehors de son projet.
-OutDir <dossier>	Où écrire le dossier de révision.
-CompareWith <dossier>	Comparer avec un ancien dossier de révision (par exemple d'un nom de fichier précédent). Par défaut, chaque exécution compare avec la dernière exécution de la même vidéo.
-ChangesPdf	Créer aussi un PDF des seules images modifiées, quand l'utilisateur veut uniquement les changements.
-KeyFramesPdf	Créer key-frames.pdf dans le dossier de révision : environ 15 à 20 images, une image entièrement construite par scène plus les images signalées, avec horodatage, scène et constatation, moins de 10 Mo. Si le dossier de révision contient déjà une révision complète, il est construit à partir de ces images et rien d'autre ne change ; sinon, la révision est d'abord exécutée. Ajoutez -NoPdf pour ignorer la planche contact complète.
-KeyFramesMaxMB <n>	Limite de taille pour key-frames.pdf (par défaut 10).
-WordsPerSecond <n>	Vitesse de lecture pour la vérification du temps de lecture (par défaut 3).
-NumberWordsFrom <n>	Les nombres prononcés sont vérifiés à partir de cette valeur (par défaut 10).
-SafeMargins h,b,g,d	Marges de zone de sécurité pour Shorts à 1080x1920 (par défaut 288,192,672,48, chiffres prudents de Google).
-WordList <fichier>	Mots supplémentaires acceptés par la vérification orthographique.
-SceneThreshold 0.3	Pour des images de caméra (la valeur par défaut 0.02 convient aux diapositives avec fondus).
-NoOcr	Ignorer les vérifications de texte à l'écran.
-NoPdf	Ignorer le PDF quand l'utilisateur veut seulement votre révision.
-NoAudio	Remotion : ignorer le rendu audio.

Les longues vidéos prennent du temps : environ 2 minutes pour 8 minutes de vidéo, et environ 4 s par image Remotion. Utilisez un délai d'attente de 10 minutes. Les dernières lignes de la sortie donnent les chemins de report.md, du dossier d'images et des PDF, plus des totaux sur une ligne pour l'audio, les vérifications de texte et les modifications. Le dossier de révision va dans <nom vidéo>-review\ à côté de la vidéo, ou dans out\<composition>-review\ à l'intérieur d'un projet Remotion, sauf si -OutDir a été fourni. Chaque exécution conserve la précédente dans previous\.

Si la sortie se termine par FAILED:, arrêtez-vous et expliquez la raison à l'utilisateur. Si ffmpeg est manquant, la correction est winget install --id Gyan.FFmpeg -e, puis un nouveau terminal. Les lignes commençant par WARNING: apparaissent également en haut du rapport. Transmettez-les.

2. Survol ou révision complète

Exécuter l'outil est peu coûteux ; c'est l'ouverture des images qui consomme l'utilisation de l'utilisateur, car chaque image ouverte est une image à lire. Une révision complète d'une vidéo de 15 minutes, avec six sous-agents Opus ouvrant chaque image, a déjà consommé toute une session d'utilisation. Donc :

• Par défaut, faites un survol, sauf si l'utilisateur demande une révision complète (avec des mots comme "révision complète", "chaque image", "parcourir tout"). Dans un survol, travaillez à partir de report.md : le résumé, les vérifications, la chronologie de la narration et le texte OCR de chaque image et ses indicateurs. Regardez les images de changement de plan (fin de scène et changement de plan) à travers leurs lignes dans le rapport, et ouvrez une image seulement là où quelque chose semble anormal : une vérification signalée, une ligne de narration qui ne correspond pas au texte à l'écran, une image modifiée, un problème audio à ce moment, ou du texte OCR vide ou déformé là où il devrait y avoir une diapositive. Dites à la fin qu'il s'agissait d'un survol et combien d'images vous avez ouvertes.
• Ouvrez toujours quelques images réelles, dans un survol, une révision textuelle seule ou un verdict basé uniquement sur la chronologie : environ une diapositive entièrement construite par scène (l'image fin de scène, une fois que tout est apparu), ou 15 à 20 réparties sur la vidéo s'il n'y a pas de scènes claires. Elles montrent le style visuel (mise en page, chevauchements, débordements de boîtes, contraste, images vides) que le texte ne peut pas montrer. Pour une longue vidéo, demandez au sous-agent Sonnet qui survole de les ouvrir. Dites toujours à la fin combien d'images ont été ouvertes.
• Révision complète uniquement sur demande. Si la vidéo dure plus de 5 minutes (voir Durée et Images dans le résumé de report.md), arrêtez-vous avant d'ouvrir des images : dites à l'utilisateur combien il y a d'images et combien vous en ouvririez, qu'une révision complète utilisera beaucoup de son crédit d'utilisation, et demandez s'il faut continuer, proposez un survol à la place, ou relancez avec un -Interval plus grand pour moins d'images (-Interval 4 divise par deux les images régulières). Attendez la réponse.
• Lors d'une révision complète : exécutez au maximum deux sous-agents à la fois et ouvrez au maximum 100 images au total, sauf si l'utilisateur a donné un autre nombre ou a dit "chaque image, sans limite". Utilisez Sonnet pour les sous-agents sauf si l'utilisateur demande Opus ; si c'est le cas, utilisez-le, mais mentionnez une fois que cela consomme beaucoup plus de crédit. Donnez à chaque sous-agent sa propre plage d'images et les lignes correspondantes de report.md, et demandez-lui de ne renvoyer que les problèmes trouvés.

Comptages approximatifs d'images : -Interval 2 (valeur par défaut) donne 30 images régulières par minute de vidéo, -Interval 4 en donne 15 et -Interval 10 en donne 6, plus jusqu'à deux par changement de plan.

Comment les utilisateurs demandent

L'utilisateur dit	Faites
"Revise C:\chemin\vers\video.mp4"	Survolez.
"Fais une révision complète de C:\chemin\vers\video.mp4"	Révision complète, jusqu'à 100 images (demandez d'abord si plus de 5 minutes).
"...révision complète..., chaque image, sans limite"	Révision complète de chaque image. Demandez d'abord si plus de 5 minutes, en disant que cela peut utiliser une session entière d'utilisation.
"...utilise des sous-agents Sonnet" / "...utilise Opus"	Ce modèle pour les sous-agents (Sonnet est le défaut de toute façon).
"Survole avec Sonnet et écris un fichier de chronologie, puis donne-moi ton avis général à partir de la chronologie"	Exécutez l'outil, puis faites survoler le dossier par un sous-agent Sonnet, ouvrez l'échantillon d'images clés (une diapositive entièrement construite par scène) et écrivez timeline.md dans le dossier de révision : une entrée par scène avec son intervalle de temps, la narration en bref, le texte à l'écran en bref, à quoi ressemblent les visuels et tout problème. Lisez uniquement ce fichier (n'ouvrez pas d'images vous-même) et donnez un avis général : structure, rythme, clarté, style visuel, et si les diapositives soutiennent la narration. Dites combien d'images ont été ouvertes.
"Crée le PDF de révision pour C:\chemin\vers\video.mp4 afin que je puisse l'attacher à un chat"	Exécutez l'outil et donnez le chemin complet du PDF. Ne révisez pas et n'ouvrez pas d'images sauf si demandé.
"Crée un fichier de chronologie et un PDF d'images clés ... pour que je puisse les attacher tous les deux à un chat"	Exécutez l'outil avec -KeyFramesPdf (voir "Partage avec une IA de chat" ci-dessous) et écrivez la chronologie comme ci-dessus.

Partage avec une IA de chat

Pour une longue vidéo, n'attachez pas le PDF de la planche contact complète (des centaines d'images). Donnez à l'utilisateur deux choses : un fichier de chronologie texte (timeline.md, comme ci-dessus) et le PDF d'images clés, créé avec -KeyFramesPdf (ajoutez -NoPdf si le PDF complet n'est pas souhaité ; sur un dossier qui contient déjà une révision, il réutilise les images et s'exécute en quelques secondes). Il contient environ 15 à 20 images : une image entièrement construite par scène plus les images que la révision a signalées, chacune étiquetée avec l'horodatage, le nom de la scène et la constatation, moins de 10 Mo, sauvegardé sous key-frames.pdf dans le dossier de révision. Donnez son chemin complet. Si l'outil n'a pas trouvé de scènes claires (pas de badge de pied de page numéroté), il répartit les images uniformément et le mentionne dans les étiquettes. Il ne peut pas repérer lui-même les problèmes visuels, donc si vous en avez trouvé (un chevauchement, une image vide), dites quels horodatages regarder lors de la remise. Le PDF complet est préférable pour les vidéos courtes comme les Shorts, ou -ChangesPdf pour seulement les images modifiées.

3. Réviser la vidéo

1. Lisez report.md. Dans l'ordre : avertissements ; modifications depuis la dernière révision (uniquement s'il y a eu une exécution précédente : les images modifiées, avec un lien vers l'ancienne image et les mots ajoutés et supprimés) ; un résumé ; résultats audio ; la chronologie de la narration (chaque ligne avec son début, sa fin et son score de correspondance) ; les vérifications du texte à l'écran (orthographe, temps de lecture, nombres, zones de sécurité Shorts) ; puis un tableau de chaque image avec son heure, pourquoi elle a été prise, son fichier dans frames/, la narration à ce moment, son texte OCR et ses indicateurs. "(pause ; dernière ligne)" signifie que personne ne parle et que la ligne affichée était celle qui vient d'être prononcée.
2. Si l'utilisateur a demandé ce qui a changé, ou si une section de modifications est présente, commencez par les images modifiées : ouvrez chacune à côté de son image précédente et dites ce qui a changé.
3. Comparez chaque diapositive avec sa ligne de narration. Dans un survol, faites-le à partir du texte OCR dans le rapport et ouvrez uniquement les images qui semblent erronées (voir section 2). Dans une révision complète, ouvrez les images avec l'outil de lecture, dans la limite convenue : d'abord les images marquées fin de scène (chacune est une diapositive terminée juste avant son changement) et changement de plan (chacune est la diapositive suivante une fois stabilisée), puis chaque image signalée, puis les images régulières là où la ligne de narration change ou quelque chose se construit à l'écran.
4. Traitez les vérifications automatiques comme des pistes, pas des verdicts, et confirmez chacune dans l'image :
   • Orthographe : l'OCR peut mal lire les textes petits, pâles ou à chasse fixe, et certains mots signalés sont délibérés (noms, mots mal entendus montrés exprès). Ne signalez que ceux que l'image confirme.
   • Temps de lecture : les diapositives signalées contiennent plus de nouveaux mots que ne le permet leur temps au rythme de mots par seconde donné. Les diagrammes narrés avec de nombreuses étiquettes le déclenchent facilement ; dites quelles diapositives ont vraiment besoin de plus de temps.
   • Nombres : un nombre prononcé non trouvé à l'écran est soit une vraie incohérence (la diapositive montre un chiffre différent), soit un nombre manqué par l'OCR, souvent de grands chiffres de titre. Vérifiez l'image.
   • Zones de sécurité : texte à l'intérieur des marges de recouvrement YouTube sur les vidéos verticales. Les marges par défaut sont les plus prudentes publiées, donc priorisez le texte près des bords inférieur et droit.
5. Dans les images que vous ouvrez, vérifiez aussi visuellement le texte à l'écran, les nombres, les noms ou les étiquettes qui ne concordent pas avec la narration, le texte tronqué ou chevauchant, le faible contraste, les images vides ou noires, et le contenu d'espace réservé ou résiduel ; les lignes de narration marquées "non trouvée" ; et les problèmes audio dans le rapport (écrêtage, crête vraie au-dessus de -1 dBTP, clics ou pops, silences en milieu de vidéo, volume sonore loin d'environ -14 LUFS).
6. Rapportez brièvement : d'abord les problèmes, chacun avec le numéro d'image et l'horodatage (par exemple #14 00:22.00) et ce qui ne va pas, puis les résultats audio, puis tout ce que l'outil n'a pas pu vérifier. Dites clairement si tout correspond. Ne modifiez pas le projet sauf si l'utilisateur le demande ; si un mot signalé est correct, vous pouvez suggérer de l'ajouter à review-words.txt dans le dossier du projet.

Les PDF

<nom>-review.pdf se trouve dans le même dossier : une page de couverture avec les résultats audio, les vérifications et les éventuelles modifications, puis 6 à 9 images par page, chacune étiquetée avec son horodatage, les problèmes trouvés (en rouge), la ligne de narration et le texte OCR (en bleu, les fautes d'orthographe soulignées). Il est maintenu en dessous de 20 Mo. Avec -ChangesPdf, il y a aussi <nom>-changes.pdf avec uniquement les images modifiées. Quand l'utilisateur veut quelque chose à attacher à un chat Claude ou à envoyer à quelqu'un, donnez-lui le chemin complet. Utilisez -MaxPdfMB <n> pour une limite plus petite. key-frames.pdf (avec -KeyFramesPdf) est celui à attacher pour les longues vidéos.