/video-review
Un tour de relecture : collectez l'intégralité du lot, consolidez-le par vidéo, corrigez chaque vidéo ayant reçu des notes en même temps, vérifiez chaque résultat vous-même, livrez les versions suivantes, faites un rapport.
Pourquoi le lot et le parallélisme : dans la production d'où viennent ces compétences, trois notes sont arrivées à cinq minutes d'intervalle et l'agent a commencé à corriger la première dans son propre contexte. Le contexte s'est rempli, le relecteur a dû l'arrêter, et a dit que le traitement d'une note à la fois n'était pas efficace. Consolidées en un seul tableau et confiées à trois sous-agents parallèles, les trois mêmes corrections ont été relues et livrées 70 minutes plus tard. Une correction n'est jamais qu'un rendu : édition, narration, rendu, QA et le rapport prenaient 50 à 90 minutes par vidéo, donc les corrections séquentielles se multiplient.
0. Configuration
PVS_HOME="$(cd "$(cd "${CLAUDE_SKILL_DIR}" && pwd -P)/../.." && pwd)"
PY="$PVS_HOME/bin/pvs-py"
Trouvez le produit (le fichier product.yaml le plus proche au-dessus du répertoire courant) et listez ses vidéos avec leur version actuelle et leur statut de livraison (skills/video-build/scripts/stages.py sur chacune).
1. Obtenir le lot complet
Si l'argument est un fichier, lisez-le ; si c'est du texte, utilisez-le. Puis demandez une fois : "Est-ce que c'est tout le feedback pour ce tour, pour chaque vidéo ? Les vidéos sans note restent telles quelles." Attendez la réponse avant de corriger quoi que ce soit. Si des notes continuent d'arriver pendant que vous consolidez, ajoutez-les au même tour ; ne commencez pas une correction par message.
2. Consolider en un tableau par vidéo
"$PY" "$PVS_HOME/skills/video-review/scripts/feedback_table.py" <product_dir> <notes file or -> \
--out <product_dir>/reviews/round-<date>.md
Il trie chaque note, textuellement, sous la vidéo qu'elle nomme (par id, titre ou en-tête), place les notes concernant "toutes les vidéos" dans une section partagée, et liste les notes qu'il ne peut pas placer. Ensuite, vous remplissez, par ligne : Sens (votre interprétation, y compris ce qui ne doit pas changer), Acceptation (comment vous allez le vérifier : un intervalle de temps, une séquence, une image), et Règle pour toutes les vidéos ?
Lisez references/review-protocol.md avant de le remplir : il couvre les erreurs de dictée, les notes qui sont en fait des règles, et les notes qui entrent en conflit avec le produit.
Trois questions à poser pour chaque note :
- S'agit-il vraiment d'une règle ? Alors elle s'applique à toutes les vidéos de ce tour, pas seulement à celle que le relecteur a désignée. Un relecteur a un jour donné une règle de couverture sur une vidéo et a dû demander à nouveau, des heures plus tard, pour qu'elle soit appliquée à toutes.
- Le produit fait-il réellement cela ? Vérifiez le code avant de promettre une correction. Si ce n'est pas le cas, une question fermée avec une option recommandée ("n'afficher que ce qui existe").
- S'agit-il d'une fonctionnalité qui manquait dans COVERAGE.md ? Alors la correction ajoute la ligne.
Montrez les tableaux consolidés à l'utilisateur avec au maximum trois décisions fermées (avec les valeurs par défaut indiquées). Le silence signifie les valeurs par défaut. Les vidéos sans note sont listées comme non modifiées.
3. Ouvrir la version suivante de chaque vidéo avec des notes
"$PY" "$PVS_HOME/skills/video-review/scripts/bump_version.py" <video_dir> --note "<quote>" ...
Il sauvegarde lines.tsv, timings.json et video/src en tant que v, augmente la version BRIEF à N+1 et ouvre une section de changelog avec les citations. Il refuse lorsque v n'a jamais été rendue (cela sauterait une version). Le rendu v reste intact : c'est la référence de parité, et un fichier que le relecteur a peut-être partagé n'est jamais écrasé.
4. Un sous-agent de correction par vidéo, tous en même temps
Remplissez references/fix-prompt.md pour chaque vidéo (les mots du relecteur textuellement, votre sens et votre critère d'acceptation, ce que vous avez déjà trouvé dans le code avec file:line, les règles partagées) et lancez chaque correcteur dans le même tour avec l'outil Agent, en arrière-plan. Effectuez vous-même les recherches de code qui alimentent "ce que j'ai déjà trouvé" avant de lancer, brièvement ; elles évitent à chaque correcteur la même recherche et repèrent les notes que le produit ne peut pas satisfaire.
Pendant qu'ils s'exécutent, ne corrigez rien vous-même et ne les sollicitez pas avec des messages. Surveillez les fichiers (stages.py, les dates de modification, les journaux de rendu). Si un correcteur a besoin d'une approbation, posez à l'utilisateur une question fermée et relayez la réponse. Si un correcteur s'arrête, démarrez-en un nouveau avec le même prompt plus l'endroit où il s'est arrêté : l'état est dans les fichiers.
5. Vérifier chaque résultat vous-même
Pour chaque vidéo, quoi que le correcteur ait rapporté :
- Parité avec la version précédente, en dehors des passages modifiés intentionnellement :
"$PY" "$PVS_HOME/skills/render-qa/scripts/parity.py" <old mp4> <new mp4> --skip a:b .... Un passage approuvé qui a changé est une régression : renvoyez-le. - QA :
"$PY" "$PVS_HOME/skills/render-qa/scripts/qa.py" <video_dir> <new mp4> --strip ...avec des strips sur chaque mesure modifiée. Chargezrender-qapour savoir comment le lire ; examinez les feuilles et les strips vous-même. - Chaque vérification d'acceptation de note depuis votre tableau. Une note que le rendu ne satisfait pas est renvoyée au même correcteur (SendMessage : le problème, l'intervalle de temps, "ne rien changer d'autre").
- La section de changelog dans BRIEF.md est remplie.
6. Livrer et clôturer le tour
"$PY" "$PVS_HOME/skills/render-qa/scripts/deliver.py" <video_dir> <new mp4> --archive-previous
Puis clôturez le tour, ensemble : les notes devenues des règles vont dans kit/RULES.md (avec la date et les mots du relecteur) afin que la prochaine construction les hérite ; chaque changelog BRIEF est complet. Un fichier de règles qui cesse d'être mis à jour devient erroné, et les règles sont alors répétées à la main dans chaque prompt. Si le relecteur a déjà téléversé les versions précédentes quelque part, dites quels fichiers doivent être téléversés à nouveau.
7. Rapport
| Vidéo | De | À | Notes appliquées | Où la voir | Parité | QA | Livrée en tant que |
|---|
Ensuite : vidéos non modifiées, règles ajoutées à kit/RULES.md, tout ce qui n'est pas vérifié, au maximum trois décisions fermées. Dans la langue de l'utilisateur, court, les tableaux en premier.
Références
references/review-protocol.md: avant de remplir les tableaux consolidés.references/fix-prompt.md: avant de lancer les correcteurs.