/video-build
Vous êtes le coordinateur. Vous vérifiez la porte, répartissez les sous-agents étape par étape, vérifiez chaque étape par ses fichiers, réexécutez le QA vous-même, livrez et rapportez. Vous n'écrivez pas de code de composition, de spécifications ou de narration, et vous ne faites pas de rendu.
Pourquoi cette séparation : dans la production d'où viennent ces compétences, alors que l'agent principal construisait lui-même les vidéos, son contexte s'est rempli 8 fois, une fois au milieu d'une correction. Lorsqu'il se contentait de coordonner (consolider, rédiger des briefs, examiner les preuves, livrer), trois corrections ont été livrées en 70 minutes. La coordination est également l'endroit où se trouve la porte de qualité : les sous-agents ont signalé des rendus "propres" que le propre QA du coordinateur a ensuite détectés avec un flash de 0,3 s et une modale coupée.
0. Trouver le travail
PVS_HOME="$(cd "$(cd "${CLAUDE_SKILL_DIR}" && pwd -P)/../.." && pwd)"
PY="$PVS_HOME/bin/pvs-py"; S="$PVS_HOME/skills/video-build/scripts" # entre guillemets lors de l'utilisation
- Avec
<video>:videos/<video>/dans le produit actuel. - Sans : le dossier vidéo dans lequel vous vous trouvez, ou sinon chaque vidéo du produit dont les fiches sont signées et dont la version actuelle n'a pas de livraison. Affichez cette liste et confirmez-la en une question fermée avant d'envoyer quoi que ce soit.
Exécutez "$PY" "$S/stages.py" <video_dir> pour chaque vidéo et affichez le tableau. Les étapes déjà terminées sont ignorées, donc /video-build peut reprendre une construction arrêtée à mi-chemin.
1. La porte
"$PY" "$S/stages.py" <video_dir> --require signoff. Si l'une ou l'autre des signatures dans BRIEF.md est vide, arrêtez-vous et dites à l'utilisateur ce qui manque et comment signer (le relecteur écrit son nom ou vous dit d'exécuter sign.py depuis /video-new). C'est le contrôle qui empêche le type de rework le plus coûteux (une fonctionnalité que le relecteur voulait voir expliquée et que personne n'a notée) de démarrer une construction.
--draft est la seule exception, et uniquement lorsque l'utilisateur l'a tapé : un brouillon peut être construit, rendu et vérifié par QA pour que le relecteur voie quelque chose avant de signer, mais deliver.py le refuse. Dites-le dans le rapport.
Lisez également product.yaml, kit/RULES.md, BRIEF.md, COVERAGE.md et CLAIMS.md vous-même : vous en avez besoin pour rédiger les invites des sous-agents et juger leurs résultats. Ne lisez rien d'autre en profondeur.
2. Répartition
Utilisez l'outil Agent avec des sous-agents en arrière-plan. Les invites pour chaque étape se trouvent dans references/stage-prompts.md et l'invite du constructeur est references/builder-prompt.md ; lisez-les avant la première répartition et remplissez chaque espace réservé. Après chaque rapport de sous-agent, exécutez "$PY" "$S/stages.py" <video_dir> --require <stage> avant de commencer tout ce qui en dépend.
| Vague | Étape | Sous-agents | Nécessite | Écrit |
|---|---|---|---|---|
| 1 | reconnaissance | 1 par vidéo, source-recon | signature | sources.lock, SOURCES.md |
| 2 | vérité | 1 par vidéo, product-truth | reconnaissance | TRUTH.md |
| 2 | spécifications | 1 par écran, ui-spec-from-code (ou ui-reference-capture pour les écrans sans code) | reconnaissance | specs/<screen>.md |
| 3 | voix | 1 par vidéo, script-and-voice | vérité | audio/lines.tsv, clips/, timings.json |
| 4 | composer + rendu | 1 constructeur par vidéo, ui-demo-composer + seek-safe-motion | spécifications, voix | video/, renders/<video>-v<N>.mp4 |
| 5 | qa | vous | rendu | qa/REPORT.json |
| 6 | livrer | vous | qa | deliveries/ |
Les vagues s'exécutent en parallèle entre les vidéos et au sein d'une même vague (la vérité et les spécifications de chaque écran partent ensemble). Plusieurs vidéos partagent une même machine : dites dans chaque invite qu'aucun agent ne tue un processus qu'il n'a pas démarré et que les rendus peuvent être plus lents pendant que d'autres s'exécutent.
Avant la vague 3 sur la version 1, si le fournisseur de voix est payant, montrez à l'utilisateur le plan de narration en un message : la table des chapitres, l'accroche, la voix, au plus trois décisions fermées avec des valeurs par défaut. L'enregistrement de la narration consomme un quota partagé, et un ton ou un nom que le relecteur n'aime pas est moins cher à modifier avant l'enregistrement. Si l'utilisateur a déjà dit d'aller droit au but, ignorez cette étape et listez les choix pour veto dans le rapport final à la place.
Pendant que les sous-agents s'exécutent, ne les sollicitez pas avec des messages. Vérifiez la progression via les fichiers (dates de modification, $STAGES, la fin d'un journal de rendu) et répondez à leurs questions lorsqu'ils vous les envoient. Les approbations remontent à l'utilisateur, les décisions redescendent : si un sous-agent demande quelque chose que seul l'utilisateur peut autoriser (un téléchargement, une nouvelle source d'actif), posez une question fermée à l'utilisateur et relayez la réponse.
Si un sous-agent cesse de répondre, démarrez-en un nouveau avec la même invite en ajoutant "l'agent précédent s'est arrêté à <étape> ; continuez à partir des fichiers". L'état réside dans les fichiers, pas dans les agents.
3. Votre propre QA, quoi que le constructeur ait rapporté
"$PVS_HOME/bin/pvs-py" "$PVS_HOME/skills/render-qa/scripts/qa.py" <video_dir> <mp4> \
--strip <nom>:<t0>:<t1> ...
Chargez le skill render-qa pour savoir comment lire le résultat. Ajoutez un extrait autour de chaque titre de chapitre, de chaque modale et de l'écran de fin pour verrouiller le transfert (heures issues de la table des chapitres du constructeur). Ensuite, regardez vous-même qa/REPORT.md, chaque planche contact et chaque extrait. Vérifiez la narration par rapport à COVERAGE.md : chaque ligne "oui" doit être expliquée dans son chapitre.
Si quelque chose échoue, renvoyez le problème exact au constructeur (SendMessage tant qu'il est vivant, le format de correction condensé dans references/stage-prompts.md), ou, s'il a disparu, démarrez un réparateur avec l'invite dans $PVS_HOME/skills/video-review/references/fix-prompt.md (lisez le fichier ; n'invoquez pas ce skill, il est invoqué par l'utilisateur). Réexécutez cette étape sur le nouveau rendu. Ne livrez jamais un rendu que vous n'avez pas vous-même vérifié par QA.
4. Livrer
"$PVS_HOME/bin/pvs-py" "$PVS_HOME/skills/render-qa/scripts/deliver.py" <video_dir> <mp4> --archive-previous
Il refuse un brouillon, un rapport échoué ou un rapport dont le sha256 ne correspond pas au fichier. Ne contournez pas un refus : corrigez la cause. Ne jamais écraser un fichier livré ; deliver.py augmente le nom à la place et prévient, et vous le dites.
5. Rapport
Un tableau pour l'ensemble du lot, puis au plus trois décisions fermées :
| Vidéo | Version | Durée | Chapitres | Couverture expliquée | QA | Livré en tant que |
|---|
En dessous : ce qui est réel et ce qui est supposé, tout ce qui n'est pas vérifié, les noms, voix et accroche pour veto, et la prochaine étape (/video-review avec les notes du relecteur). Écrivez dans la langue de l'utilisateur, court, les tableaux en premier.
Quand lire les références
references/stage-prompts.md: avant d'envoyer les vagues 1 à 3, et pour toute demande de correction.references/builder-prompt.md: avant d'envoyer la vague 4.