Compétence de Vidéo Explicative (Hellboy)
Vous transformez un sujet technique en une vidéo MP4 1080×1920 de 2 à 3 minutes qu'une personne non technique comprend dès la première visualisation. Le style visuel, le rythme et la structure du script sont clonés à partir d'une chaîne de référence (analysée dans docs/01-style-bible.md). Deux éléments sont délibérément les nôtres : le personnage (Hellboy) et la voix.
Vous écrivez uniquement des fichiers texte (un script et un storyboard.json). Le moteur dans engine/ gère la voix, les sous-titres, l'animation, le personnage, la musique et le rendu.
Lorsque l'utilisateur donne juste un sujet
Faites tout le travail sans poser de questions supplémentaires :
- Créez un slug à partir du sujet (
how-dns-works) et exécutezpython engine/make_video.py new videos/<slug>. - Écrivez
videos/<slug>/script.md(docs/02), puisvideos/<slug>/storyboard.json(docs/03 + docs/04). Copiez les modèles deexamples/upi-explained/. - Exécutez
python engine/validate_storyboard.py videos/<slug>. Corrigez chaque ERREUR et répétez jusqu'à ce que la sortie affiche0 error(s). - Exécutez
python engine/make_video.py preview videos/<slug>. Si vous voyez des images, vérifiezbuild/preview.pngpar rapport à la section B de docs/06 et corrigez. - Exécutez
python engine/make_video.py render videos/<slug>. Répondez avec le cheminoutput/<slug>.mp4, la durée et un résumé de 2 lignes.
Les non-négociables
- Hellboy n'est jamais redessiné. Il provient uniquement de
character/hellboy/hellboy.js. Vous pouvez définirshow,arm(down/point/explain) etexpression, rien d'autre. Lisezcharacter/hellboy/CHARACTER_BIBLE.mdune fois. - La voix est fixe dans
engine/config.json. Ne la modifiez pas par vidéo. - Longueur : 360–470 mots de narration, 2:00–2:50. Phrases ≤ 20 mots.
- Chaque phrase change quelque chose à l'écran. Les éléments apparaissent sur leur mot-clé parlé (
"at"). - Correct plutôt que simple. Simplifiez en omettant des éléments, jamais en disant quelque chose de faux.
- Le validateur doit passer (
0 erreurs) avant le rendu.
Flux de travail (à faire dans l'ordre)
| # | Étape | Lire | Sortie |
|---|---|---|---|
| 1 | Échafauder | – | python engine/make_video.py new videos/<slug> |
| 2 | Planifier + écrire le script | docs/02-script-writing.md | videos/<slug>/script.md (360–470 mots, 7 temps) |
| 3 | Planifier les visuels | docs/03-visual-planning.md | liste des scènes : narration → type, titre, personnage |
| 4 | Écrire le storyboard | docs/04-storyboard-reference.md | videos/<slug>/storyboard.json (ou meta.json + scenes.jsonl → assemble) |
| 5 | Valider | – | python engine/validate_storyboard.py videos/<slug> → corriger jusqu'à 0 erreurs |
| 6 | Prévisualiser + QA | docs/06-qa-checklist.md | make_video.py preview videos/<slug> → inspectez build/preview.png, corrigez |
| 7 | Rendre | docs/05-production.md | make_video.py render videos/<slug> → output/<slug>.mp4 |
| 8 | QA final | docs/06-qa-checklist.md | score ≥ 85, tous les éléments OBLIGATOIRES passent |
Petit modèle local ? Suivez docs/07-small-model-playbook.md au lieu des étapes 2–5. Il découpe le travail en invites d'une scène à la fois.
Le script en 7 temps (à mémoriser)
Accroche (≤ 22 mots : "X expliqué." / "Comment fonctionne X en réalité ?" / affirmation surprenante / action relatable) → Tension (le mystère) → Feuille de route ("Suivons…") → Corps (3–6 chapitres : concept → sens simple → exemple quotidien → conséquence ; UN exemple récurrent avec une personne nommée) → Rebondissement ("Mais voici la partie intéressante…") → Récapitulation ("Souvenez-vous-en comme ceci." une ligne par chapitre) → Chute (fragments qui font écho à l'accroche : "Un scan. Quatre acteurs. Deux secondes.").
Recette de scène (à mémoriser)
- 1 scène = 1–3 phrases (8–28 mots, 3–8 s) ; 20–32 scènes par vidéo.
- Choisissez
visual.typedans la table de décision dansdocs/03-visual-planning.md. Utilisez 7–12 types différents par vidéo. - Montrez Hellboy dans 40–70 % des scènes (toujours : première scène, rebondissement, récapitulation, dernière scène). Cachez-le pour
sequence,hub,diagram,compare. - Construisez de grands diagrammes sur 2–4 scènes avec
"continue": true+ objets"shown": trueet le même titre. - Titres de 2–6 mots avec un mot
*accentué*. Étiquettes à l'écran de 1–4 mots.
Commandes (depuis la racine du dépôt)
# activer d'abord : source .venv/bin/activate | Windows : .\.venv\Scripts\Activate.ps1
python engine/make_video.py new videos/<slug> # modèles
python engine/make_video.py assemble videos/<slug> # meta.json + scenes.jsonl -> storyboard.json
python engine/validate_storyboard.py videos/<slug> # doit être 0 erreurs
python engine/make_video.py preview videos/<slug> # build/preview.png (1 image par scène)
python engine/make_video.py render videos/<slug> [--fast]
Première fois sur une machine : ./setup.sh (Linux/macOS) ou setup.ps1 (Windows). Les vidéos terminées atterrissent dans output/<slug>.mp4.
Documentation de référence
examples/upi-explained/(papier chaud) etexamples/load-balancer-explained/(plan) — exemples complets. Copiez leurs modèles.templates/—script.template.md,storyboard.template.json.docs/01-style-bible.md— ce que fait la référence, mesuré (pourquoi les règles existent).engine/icon_names.txt— tous les 2 359 noms d'icônes autorisés (Lucide).