/3d-video-studio
┌──────────────────────┐
│ "Pourquoi les │ titre qui interroge un comportement, sans nommer l'invention
│ conducteurs se │
│ sont-ils mis à │
│ filmer la route" │
│ ◕‿◕ ▶ 💥 │ accroche : méfait du comploteur, payoff avant 4 s
│ faille → cupidité │ escalade, résistance impassible, deux virages "Mais"
│ type tranquille ▣ │ révélation via le propre point de vue de l'invention
│ "c'est ainsi que │ réponse au titre, dernier plan boucle sur le premier
│ ____ a été │
│ inventé." │
└──────────────────────┘
Suivez les étapes dans l'ordre. ⏸ marque une porte : arrêtez, montrez le résultat et attendez la réponse de l'utilisateur. À chaque porte, dites quelle étape vient ensuite. Ne lisez que les fichiers listés pour l'étape en cours.
SKILL_DIR="<chemin de base de cette compétence>"; ENGINE="$SKILL_DIR/engine"
KIT="$SKILL_DIR/kit"; [ -d "$KIT/node_modules/playwright" ] || KIT="$HOME/.claude/kit"
PY="$KIT/.venv/Scripts/python.exe"; [ -x "$PY" ] || PY="$KIT/.venv/bin/python"
[ -d "$ENGINE/node_modules/three" ] && [ -x "$PY" ] || bash "$SKILL_DIR/setup.sh"
Nécessite Node 18+, ffmpeg et Python 3.9+. bash "$SKILL_DIR/setup.sh" installe le reste une fois (three.js, Playwright +
Chromium, un venv Python avec le modèle de synchronisation labiale Parakeet). Exécutez chaque outil Python ci-dessous avec "$PY".
Le profil de référence est l'étalon pour chaque porte.
PROFILE="$SKILL_DIR/story/examples/dashcam"contient les mesures chiffrées (profile.json), une image par plan (frames/) et chaque image de chaque transition (transitions/).- Si l'utilisateur apporte une nouvelle référence, construisez d'abord son profil ("Apprendre d'une nouvelle référence" ci-dessous) et
pointez
PROFILEvers celui-ci. - Les images ne sont pas livrées dans le dépôt public.
story/examples/dashcam/etstory/examples/cashier/contiennent les mesures chiffrées (profile.json) et les feuilles de rythme écrites, mais pas les images de la référence (elles appartiennent à la chaîne originale). Si$PROFILE/framesest manquant, demandez à l'utilisateur la vidéo de référence (tout Short dans ce format fonctionne) et exécutez l'étape 2 de "Apprendre d'une nouvelle référence" avec$PROFILEcomme dossier de sortie, avant l'étape 4. Si l'utilisateur n'a pas de vidéo de référence, jugez uniquement par rapport àprofile.jsonet aux exemples écrits, et dites-le à chaque porte. - Ne jugez jamais nos images seules : chaque feuille de révision place la référence à côté de la nôtre.
Étape 1 · Sujet ⏸
Lisez story/topic-bank.md. Utilisez le sujet de l'utilisateur ou proposez-en trois. Passez le test des quatre questions et nommez la
vérification la plus faible.
Porte : l'utilisateur choisit un sujet.
Étape 2 · Titre et script ⏸
Lisez story/title-formula.md, story/formula.md, story/hook-rules.md, story/script-template.md, story/script-check.md.
Lisez aussi story/rig-check.md (ce que nos personnages plats peuvent et ne peuvent pas faire) et exécutez
"$PY" "$SKILL_DIR/tools/rig_check.py" <projet>/script.json avant de noter ; montrez tout drapeau avec sa note "Scénarisez-le comme".
Une ligne que le rig ne peut pas montrer doit être corrigée avant que la voix ne soit enregistrée.
Écrivez d'abord le titre, puis le script battement par battement. Notez-le (réécrivez en dessous de 9/10).
Montrez le titre, le script (une phrase par ligne, étiquettes de battement sur le côté), le nombre de mots, la durée estimée à
3,8 mots par seconde et la note.
Porte : l'utilisateur approuve ou modifie. Sauvegardez les phrases approuvées dans <projet>/script.json
(créez le projet avec cp -r "$ENGINE/template" <projet> d'abord ; <projet> ne doit pas exister).
Étape 3 · Bible visuelle ⏸
Lisez look/style-guide.md (le look maison : surfaces laquées brillantes, encre sur tout ce qui est net, lumière naturelle,
arrière-plans légèrement flous, décoration dense) et look/visual-bible.md (règles et modèle).
Générez d'abord les looks : node "$ENGINE/cast.mjs" new <projet> --chars <rôles> --cars <rôles>. Ensuite, écrivez
<projet>/visual_bible.md couvrant :
- chaque personnage (corps, tête et cheveux, couches de tenue en hexadécimal, accessoires, les expressions faciales nécessaires à l'histoire);
- chaque environnement (disposition, surfaces, sources de lumière visibles, 4 à 8 éléments de décoration par mur, gags textuels exacts, profondeur);
- les intérieurs (voitures, stands, écrans), les accessoires (l'invention vedette en détail) et les graphiques 2D;
- un plan des assets marquant chaque élément
bibliothèque + params,bibliothèque + nouveau texteounouveau. Montrez la bible avec la sortie du casting. Porte : l'utilisateur approuve, modifie ou demande une nouvelle version.
Étape 4 · Fiche de look ⏸
Montrez le design visuel construit en 3D avant tout storyboard, au niveau de détail final. Lisez look/setup-types.md.
lookdev.html,lookdev.jsetsets.jssont fournis avec le modèle. Écrivez le décor le plus chargé de l'histoire danssets.js(heroSet()est l'exemple travaillé du look maison : remplacez-le, gardez ses couches), en suivant exactement la bible. La vidéo importe le mêmesets.jsplus tard, donc ce travail n'est pas perdu.lookdev.jscrée déjà les cartes :- chaque personnage de
cast.json, en alignements de trois avec des étiquettes; - les expressions faciales du personnage principal;
- le décor principal : plan large, plan moyen avec flou d'objectif 10, et gros plan d'accessoire avec flou 14;
- la voiture principale.
Ajoutez une carte pour l'accessoire vedette et pour tout autre décor marqué
nouveaudans la bible.
- chaque personnage de
- Une carte par type de plan utilisé dans l'histoire (
interior,pov,tracking,house,twoshot,talker,device), chacune construite dans son véritable décor à son cadrage réel, avec chaque "Doit avoir" delook/setup-types.md. Le POV du tableau de bord, le mur du parleur et la vue du dispositif sont ceux qui sont souvent sautés ; construisez-les maintenant. - Associez-les à la référence :
"$PY" "$SKILL_DIR/tools/sbs_sheet.py" <projet>/review/look_pairs.jpg --ours <cartes> --ref <les mêmes types depuis $PROFILE/frames>. - Ajoutez une bande de recadrages de 400 px à 1:1 (jauges, gags muraux, carrosserie, route), pour que les détails manquants et le flou soient visibles.
node "$ENGINE/film.mjs" check <projet> 0 <cartes> 0.5 --page lookdev.html, corrigez chaque ÉCHEC (y comprisclipped-art: les cheveux, le chapeau ou la tête d'un personnage coupés nettement à leur bord), puisnode "$ENGINE/film.mjs" sheet <projet> <projet>/review/look.jpg 0.5 1.5 2.5 ... --page lookdev.html --w 360 --cols 4.- Notez-le en code :
node "$ENGINE/film.mjs" lookcheck <projet> <projet>/review/lookcheck 0.5 1.5 ... --page lookdev.html(brillance, contours, lumière, profondeur, densité, couleur, visages ; 0 à 10 par rapport àlook/targets.json). Corrigez chaqueBAS, puis regardez la fiche une fois à l'œil, pour ce que les chiffres ne peuvent pas juger (accessoires de l'histoire, attrait). Montrez les scores avec la fiche. Exécutezlookchecksur les images de chaque acte à l'étape 8 aussi. Remettezreview/look.jpgetreview/look_pairs.jpg. Porte : l'utilisateur approuve le look des personnages, du monde et de chaque type de plan, ou liste des correctifs. Chaque décor de la vidéo est construit à ce niveau de détail.
Étape 5 · Storyboard + script vocal ⏸
Deux documents en un seul passage :
- Storyboard
<projet>/storyboard.md: une ligne par plan de caméra (18 à 21) :# | phrase(s) | battement | type de plan | mouvement de caméra | action et expressions faciales | gag d'accessoire | transition (images) | acte/ambiance. Règles destory/formula.md("Image et montage") ;story/examples/dashcam.mdmontre un exemple complet.- Type de plan est l'un des noms de
look/setup-types.md; il devient letypedu plan dans le code. - Action et expressions faciales nomme une pose du moteur (
stand,walk,sitOn,point,lean,armTo…) ou un accessoire pour chaque action ; toute autre chose échoue àstory/rig-check.mdet est réécrite avant la construction. - Mouvement de caméra : chaque ligne nomme son mouvement et sa vitesse (par exemple "push-in 6%/s", "pull-back to wide", "orbit 120°") ; seule la vue du dispositif peut dire "verrouillée".
- Transition entrante : les fondus sont de 7 à 10 images (jusqu'à 16 pour la révélation), ou nommez la transition dans le monde. Les décors, personnages et accessoires proviennent de la bible visuelle approuvée : nommez-les comme dans la bible. Sous le tableau, copiez le plan des assets de la bible avec tout ce que le storyboard a ajouté.
- Tableau de continuité (sous le storyboard) : chaque accessoire ou personnage qui change de place ou d'état reçoit une ligne,
chose : état → état → état, avec le numéro de plan de chaque changement (par exempleclé : poche (1) → sol (3) → gueule du chien (5)).- Chaque changement a lieu à l'écran dans un plan nommé, ou est montré par une action à l'écran que le spectateur peut lire (elle est jetée, elle atterrit, elle est remise).
- Aucun plan ne peut commencer dans un état que le spectateur n'a jamais vu arriver. Une action ultérieure qui dépend d'un changement invisible (chercher quelque chose que personne n'a vu tomber) est un échec du storyboard : ajoutez l'action à un plan, ou ajoutez un plan. Dans un saut temporel narré, des étapes hors écran ordinaires sont autorisées (prendre un ticket dans sa cachette).
- Étiquetez chaque accessoire comme objet de l'histoire (voyage avec l'intrigue) ou accessoire gag (une cachette, un contenant ou un objet comique qui reste dans son propre battement). Un accessoire gag dans un nouvel endroit échoue sauf si la narration le nomme là.
- Vérification réaliste (
story/rig-check.md, dernière section) : chaque action et objet porté a une raison pour laquelle une vraie personne l'aurait à ce moment-là. Si la seule raison est la continuité, réécrivez la ligne.
- Type de plan est l'un des noms de
- Script vocal
<projet>/voice/cartesia.md: lisezstory/voice-cartesia.mdet écrivez les blocs étiquetés (émotion par bloc, conseil de vitesse, pauses seulement avant les virages "Mais" et la réponse).
Montrez les deux. Porte : l'utilisateur approuve le storyboard. Ensuite, demandez la voix : "Générez les blocs dans
voice/cartesia.md dans Cartesia et placez les fichiers dans <projet>/audio/ (vo_01.wav, vo_02.wav... ou un vo.wav).
Je construirai l'aperçu de 5 secondes entre-temps." N'attendez pas que l'audio soit prêt pour continuer à l'étape 6.
Étape 6 · Aperçu de 5 secondes ⏸
Construisez seulement l'accroche (les 5 premières secondes, généralement les plans 1 à 3) pour que l'utilisateur puisse juger le look avant la construction longue.
Lisez engine/API.md ; copiez des blocs depuis engine/template/video.js (n'ouvrez jamais engine/src). Construisez chaque personnage
et voiture depuis cast.json (makeChar(CAST.characters.x), buildCar(CAST.cars.x)), et utilisez les poses stand / sit.
- Timing :
sentenceStarts/captionsFromWordsavec l'estimation (estimateWords), ou le fichier de mots réel si l'audio est déjà arrivé (étape 7). - Importez les décors depuis
./sets.jset utilisezmakeStage({ mood: withLook(mood, 'indoor' | 'outdoor') }). - Le look à juger est la fiche de look approuvée : 3D propre avec surfaces brillantes, encre sur tout ce qui est net, lumière naturelle,
un arrière-plan légèrement flou, et chaque image remplie bord à bord. Si un visage est vide ou montre l'arrière de la tête, la caméra
a été placée après la pose (voir
engine/API.md, chars.js). - Donnez à chaque visage un
market à chaque plan sontype. Exécuteznode "$ENGINE/film.mjs" check <projet> 0 5 0.25; il se termine par 1 en cas d'ÉCHEC, donc corrigez-les tous. - Une fiche :
node "$ENGINE/film.mjs" sheet <projet> <projet>/review/preview.jpg 0.2 0.8 1.6 2.6 3.6 4.6 --w 180 --cols 6. Regardez-la une fois ; corrigez ce qui est clairement faux. - Rendu :
node "$ENGINE/film.mjs" render <projet> <projet>/review/preview.mp4 0 5(environ 1 minute). Si la voix est disponible, ajoutez les 5 premières secondes :ffmpeg -i review/preview.mp4 -i audio/vo.wav -map 0:v -map 1:a -c:v copy -t 5 review/preview_vo.mp4. - Comparez l'accroche avec celle de la référence :
"$PY" "$SKILL_DIR/tools/compare_video.py" <projet>/review/preview.mp4 "$PROFILE" <projet>/review/cmp_preview --range 0 5;- placez notre bande de défilement à côté de
$PROFILE/transitions/(le défilement passe le verre en environ 4 images et atterrit sur un plan large). Corrigez les ÉCHECs de mouvement, de netteté et de détail avant de montrer l'aperçu. Remettez le chemin du mp4 et la fiche de comparaison. Porte : l'utilisateur approuve le look (personnages, couleurs, caméra, sous-titres) ou demande des modifications. Les modifications des personnages ou du style sont bon marché ici et coûteuses plus tard.
Étape 7 · Voix entrante
Quand l'utilisateur dit que l'audio est dans <projet>/audio/ : suivez "Quand l'audio arrive" dans story/voice-cartesia.md
(joignez les blocs, words.py, vérifiez la longueur et le rythme).
- Le rythme est une porte sévère : en dehors de 3,5 à 4,1 mots par seconde (
film.mjs checkéchoue), demandez une nouvelle prise à une autre vitesse et ne construisez pas sur la lente. La dernière vidéo est passée à 3,4 et a duré 71 s contre 62 pour la référence. - Sinon, continuez : le montage est basé sur les numéros de phrases, donc il se retemporise lui-même. Si la voix n'est pas arrivée à la fin de l'étape 8, demandez à nouveau ; ne faites pas le rendu final sans elle.
Étape 8 · Construire le reste, acte par acte
Pour chaque acte (1 jour, 2 crépuscule/nuit, 3 pluie), dans l'ordre :
- Nouveaux décors et accessoires d'abord, dans
sets.js, construits au niveau de détail de la fiche de look approuvée et de la bible (voir "Pas encore construit" dansengine/API.md). - Blocs de plans pour chaque plan de l'acte, chacun avec son
type, les transitions comme dit le storyboard (dissolvede 7 à 10 images,burstaveccashBurst()/paperBurst(), un wipe, ou un cut sec). film.mjs checkpour la plage temporelle de l'acte doit se terminer par 0 (pas d'ÉCHEC). Les ÉCHECs les plus importants :- une caméra plus lente que la limite
slow-camera(un push-in doit zoomer de 6 à 10% par seconde); - un visage principal en dehors de sa plage de taille de type;
- un dissolve en dehors de 5 à 12 images;
- une étiquette qui dépasse de l'objet auquel elle est collée (
decal-overhang) : enregistrez les autocollants et étiquettes avecon: <surface>; - un texte clé coupé par le bord de l'image, couvert par une tête ou caché (
text-cut). Enregistrez chaque nombre, prix, écran et étiquette dont dépend la blague avecreadable(mesh, label, { key: true })quand le décor ou le plan est construit.
- une caméra plus lente que la limite
- Fiche de comparaison de l'acte : nos milieux de plan sur la ligne du bas, les plans de la référence des mêmes battements sur le dessus
(
tools/sbs_sheet.py, images de$PROFILE/frames). Ajoutez une bande de recadrages de 400 px à 1:1 de l'acte. - Révision des transitions : faites le rendu de chaque transition de l'acte en tant que court clip (
film.mjs rendersur environ 1 s autour d'elle). Faites une bande image par image et placez-la à côté de la transition de référence du même type dans$PROFILE/transitions/. Vérifiez que :- les cuts changent en une image propre;
- les dissolves suivent une courbe d'atténuation tandis que les deux plans continuent de bouger;
- un burst ne couvre jamais plus d'environ deux tiers de l'image, et le plan suivant s'estompe en dessous;
- une révélation par wipe
... [truncaturé pour la traduction traduit pour la traduction]