Atelier de création vidéo (video-forge)
Une bonne œuvre ne se crée pas en une phrase. Ce skill gère trois choses :
- Clarifier : Tant que le besoin est flou, on continue à poser des questions jusqu'à ce que les scènes, personnages, émotions et chaque détail soient traduits en images concrètes.
- Valider avant de produire : Style, décors, storyboard doivent être approuvés par l'utilisateur avant de lancer la production chronophage.
- Faire évaluer par un tiers : Le produit fini est soumis à un juge indépendant, qui l'évalue point par point selon la « fiche de critères de révision » validée par l'utilisateur. Pas d'auto-évaluation.
La production elle-même est confiée aux chaînes existantes (lemo-opuscar, mv-director, Remotion, Three.js pour les dioramas). Ce skill agit comme réalisateur et contrôleur qualité.
Règles absolues
- Pas de mise en production sans questions préalables. Tant que les champs obligatoires de la checklist d'entretien (
references/interview-checklist.md) ne sont pas renseignés, on ne passe pas en production. Si l'utilisateur dit « tu décides », donner des valeurs par défaut précises dans la fiche de besoins et les lui montrer. - Remplacer les mots flous par des images : « chaleureux », « haut de gamme », « agréable » ne sont pas des réponses ; proposer 2 à 4 options visuelles concrètes.
- Après chaque série de questions, afficher la fiche de besoins (
references/card-templates.md) pour que l'utilisateur voie ce qui est défini et ce qui ne l'est pas. - Ne pas sauter d'étapes : Fiche de besoins + Fiche de critères de révision → Style (échantillons) → Fiche de style / image de style → Fiche de décors → Storyboard lié → Brouillon → Boucle de révision → Archivage. Les chaînes de production peuvent déclarer qu'elles sautent une étape (ex : les dioramas n'ont pas de storyboard), mais cela doit être précisé.
- Le storyboard nécessite une validation par défaut (lemo ne valide pas par défaut, ici c'est la règle).
- Le juge est un sous-agent indépendant : on ne lui donne que l'œuvre et la fiche de critères de révision validée par l'utilisateur, pas notre conclusion. Le juge doit visionner l'intégralité (1 image toutes les 2 secondes), ne peut que mesurer le son (sans juger s'il est « beau »). L'avis de l'utilisateur prime sur celui du juge.
- Les personnages ne jouent pas la comédie : les expressions faciales et mouvements de mains générés par du code sont forcément raides. À moins que la chaîne de production n'ait la capacité d'animer des personnages, ceux-ci doivent être petits, éloignés, statiques ou avec une boucle simple.
- Les mots de l'utilisateur figurent dans les fiches : toute contrainte spécifique (ex : « pas d'éclairage écrasant ») est inscrite textuellement dans la section « interdictions » ou « exigences » de la fiche de besoins.
- Les grandes tâches sont réparties entre plusieurs agents (cf.
references/division-of-labor.md) : d'abord définir les fichiers squelette, chaque agent ne fait que référencer les numéros ; les calculs sont vérifiés par des scripts ; on ne réduit pas l'effort de réflexion pour éviter les dépassements de temps. - Archiver les œuvres dans
~/video-forge, pas dans un répertoire temporaire (perdu au redémarrage). - Réseau : Le proxy de cette machine est très lent. Pour les gros téléchargements, utiliser
curl --noproxy '*'ouenv -u http_proxy -u https_proxy -u HTTP_PROXY -u HTTPS_PROXY; sigrepest cassé dans le shell, utiliser/usr/bin/grep.
Étapes
0. Orientation
Consulter d'abord ~/video-forge/recipes/ : si l'utilisateur cite une recette précise (ex : « fais une gare avec la recette diorama 2.5D »), lire son fichier et ne poser que les questions sur les éléments non définis.
Sinon, choisir la chaîne selon le besoin :
| Besoin | Chaîne | Fichier |
|---|---|---|
| Court métrage stylisé (30–90 s), thème libre | Film stylisé | references/pipeline-style-film.md |
| Clip musical pour une chanson | Clip musical | references/pipeline-mv.md |
| Expliquer un concept, une histoire, des données | Vidéo explicative | references/pipeline-explainer.md |
| Petite scène 3D interactive (drag & rotate) | Diorama | references/pipeline-diorama.md |
Si l'utilisateur n'a aucune idée : suivre le guide débutant de references/style-picker.md (d'abord voir la galerie d'échantillons, puis proposer des idées de contenu).
1. Questions → Fiche de besoins
Déterminer d'abord le type de vidéo et la durée. Charger la fiche de genre correspondante dans references/genres/ (table de sélection dans genres/README.md). Les questions suivantes, la structure, le budget en mots, et la fiche de critères de révision partiront de cette fiche.
Poser les questions par séries selon references/interview-checklist.md. Utiliser AskUserQuestion. Maximum 4 questions par série, avec des options visuelles concrètes. Après chaque série, afficher la fiche de besoins. Quand tous les champs obligatoires sont renseignés, demander à l'utilisateur de valider la fiche.
2. Style visuel
Si l'utilisateur n'a pas choisi : recommander 2 à 3 styles avec liens d'échantillons selon references/style-picker.md, et en même temps donner la liste complète des 66 styles (en texte pur, pas avec AskUserQuestion, pour éviter de masquer la liste).
Une fois choisi, lire le fichier STYLE.md de ce style et compiler une fiche de style (valeurs numériques : teinte, épaisseur de ligne, ratio d'éclairage, police, grammaire des plans, son). La soumettre à l'utilisateur pour validation.
3. Image de style
Générer 1 à 3 images de style (un plan / un coin, avec lumière et couleurs définies) à l'aide d'un vrai code de rendu. Attendre validation avant de déployer.
4. Fiche de décors
Quand il y a des personnages, lieux ou objets, créer une fiche de décor pour chacun : apparence, proportions, palette de couleurs, costumes, accessoires clés, éléments interdits. Générer une image de décor. Valider avec l'utilisateur.
5. Storyboard lié
Assembler 6 à 9 vignettes en une planche (chaque vignette : temps, image, plan, son, sous-titre). Ne lancer l'animation qu'après validation.
6. Brouillon → Boucle de révision
Produire le brouillon selon la chaîne choisie. Ouvrir deux juges selon references/review.md. Évaluer chaque critère de la fiche (réussi / partiel / échoué + image preuve). Ne corriger que ce qui a échoué. Montrer chaque itération à l'utilisateur.
Arrêter : quand tous les critères obligatoires sont réussis ET que l'utilisateur est satisfait, ou après 3 cycles, ou si l'utilisateur stoppe.
7. Archivage
Dans ~/video-forge/works/<slug>/ : code source ou lien vers le projet, œuvre finalisée / captures d'écran, fiche de besoins, fiche de style, storyboard, scores.md. Écrire une rétrospective dans ~/video-forge/retros/. Si la recette est réutilisable, créer une nouvelle fiche à partir de recipes/_template.md et ajouter une ligne dans la table « 🎞 Œuvres » de ~/video-forge/README.md. Si de nouvelles bibliothèques externes ont été utilisées, les enregistrer dans deps.json et reconstruire index/.
Environ une semaine après la publication, demander à l'utilisateur de consulter les métriques de publication depuis le tableau de bord de la plateforme (ex : Centre de création TikTok) : taux de complétion, durée moyenne de visionnage, secondes avec le plus de perte, segments rejoués. Remplir la section « Données de publication » du fichier scores.md. Ajouter une phrase dans la rétrospective : quel élément de rétention a fonctionné, où les spectateurs ont décroché. Les prochains scripts et storyboards devront s'appuyer sur ces données réelles, pas seulement sur les avis des juges.
Fichiers de référence
| Étape | Fichier | Quand le consulter |
|---|---|---|
| 1 Questions | references/interview-checklist.md | À chaque démarrage ; avant chaque série de questions, vérifier ce qui manque |
| 1–5 Fiches | references/card-templates.md | Pour afficher la fiche de besoins, de style, de décors, et le storyboard lié |
| 2 Style | references/style-picker.md | Si l'utilisateur n'a pas choisi de style ou ne sait pas quoi faire |
| 3–6 Production | references/pipeline-style-film.md | Court métrage stylisé avec lemo-opuscar |
| references/pipeline-mv.md | Clip musical | |
| references/pipeline-explainer.md | Vidéo explicative avec Remotion | |
| references/pipeline-diorama.md | Diorama 3D Three.js | |
| 3–6 Division du travail | references/division-of-labor.md | Quand plusieurs agents écrivent un traitement ou produisent : répartition des tâches, fichiers squelette, scripts de vérification |
| Fiches de genre (par type / durée) | references/genres/README.md | Une fois le type et la durée fixés pendant les questions, charger la fiche correspondante : budget en temps, structure, normes visuelles et sonores, logique de validation, modèles de prompts |
| Musique | references/music.md | Pour choisir la méthode de composition musicale (code, bibliothèque libre de droits, modèle open source), et utiliser tools/music/code_score.py |
| Styles / Animations | ~/video-forge/index/catalog.md (lisible machine : index.json) | Tous les styles, animations, grammaire de narration, et ses propres styles dans un seul tableau ; s'il manque une bibliothèque, exécuter bash ~/video-forge/bootstrap.sh <id> |
| 1 / 6 Révision | references/review-standards.md | Pendant les questions, donner des points de contrôle par défaut selon le type de vidéo, et définir la fiche de critères de révision avec l'utilisateur |
| 6 Révision | references/review.md | Ouvrir les juges, évaluer point par point, décider d'arrêter ou non |
| Dépannage | references/troubleshooting.md | En cas de problème d'installation, de rendu, de capture d'écran ou de réseau |
| Archivage | ~/video-forge/README.md, ~/video-forge/recipes/_template.md | Après la production |