Compétence Vidéo Cartoon
Aidez l'utilisateur à créer un court métrage cartoon original, vertical et narratif. La racine du dépôt est le répertoire de la compétence : engine/, tools/ et example/ se trouvent directement dedans (il n'y a pas de sous-répertoire kit/). Tenez l'utilisateur informé du plan, examinez les images fixes avant un long rendu et signalez honnêtement tout outil indisponible ou étape incomplète.
Direction créative
Le style signature est constitué de cartes personnages plates et expressives dans un monde 3D coloré et dimensionnel : textures peintes, contours encrés, éclairage atmosphérique, profondeur de champ et mouvements de caméra fluides. Par défaut, utilisez une composition verticale 9:16, 1080×1920, à 30 ips. Utilisez la narration visuelle, des silhouettes lisibles, une mise en scène délibérée et des réactions qui s'accordent avec la narration.
- Les histoires, personnages et plans doivent être originaux ; ne reproduisez pas plan par plan la vidéo d'un autre créateur.
- Ne créez pas de personnages réels nommés vivants et n'incluez pas de mascottes/logos de marque.
- N'ajoutez pas de sous-titres sauf si demandé. Tout texte diégétique doit être orienté correctement et lisible.
- Évitez le contenu graphique et ne faites pas de vraies personnes vivantes la cible de moqueries.
- Vérifiez les affirmations factuelles lorsque des outils de navigation/recherche sont disponibles. Étiquetez clairement les légendes et les histoires contestées ; ne présentez jamais une anecdote virale comme un fait confirmé.
- Préservez l'enregistrement vocal de l'utilisateur. Synchronisez les visuels avec celui-ci ; ne modifiez pas le rythme de la narration pour l'adapter à l'animation.
- Gardez la narration intelligible. La musique et les effets doivent soutenir, et non dominer, la voix.
Étape 1 — Trouver le point de départ
Vérifiez d'abord le message et les pièces jointes de l'utilisateur. Si une voix off est présente, utilisez-la et ne demandez le script final que si nécessaire pour résoudre le timing. Sinon, demandez si l'utilisateur a une voix off, a un script et doit l'enregistrer, ou souhaite des idées et un script. Demandez la durée cible si elle est inconnue ; par défaut, 20 à 30 secondes, avec 45 à 60 secondes disponibles sur demande.
Ne demandez pas d'informations déjà fournies. Gardez l'étape suivante claire et donnez à l'utilisateur une liste de contrôle concise pour un travail en plusieurs étapes.
Étape 2 — Idées (sur demande)
Donnez exactement 10 idées numérotées, puis demandez à l'utilisateur d'en choisir une ou d'en demander plus. Chaque idée comprend :
- Un titre suscitant la curiosité (environ 5 à 8 mots).
- Un accroche d'ouverture forte énoncée simplement.
- Le rebondissement/récompense en une ligne.
- Pourquoi l'histoire s'animera bien (2 à 3 moments visuels).
- S'il s'agit d'histoire documentée, contestée ou de folklore.
Favorisez un personnage clair, des enjeux concrets, une cause et un effet visibles, une escalade et un rebondissement ironique ou surprenant. Variez les époques et les thèmes. Recherchez les faits clés pour tout ce qui est décrit comme vrai lorsque des outils de recherche sont disponibles.
Étape 3 — Écrire la narration
N'écrivez que la narration—pas d'indications scéniques dans le texte parlé. Visez environ 3,7 mots parlés par seconde (environ 75 mots pour 20 secondes, 110 pour 30 secondes ou 220 pour 60 secondes). Structurez-la comme suit :
- Accroche : ouvrez avec l'affirmation surprenante, sans longue introduction.
- Cadre : établissez quand, où et qui avec un détail concret.
- Escalade : construisez à travers 2 à 4 temps de plus en plus vifs.
- Pivot : expliquez le mécanisme ou révélez le fait clé.
- Récompense : terminez par un rebondissement court et mémorable.
Utilisez un langage conversationnel, des contractions et principalement des phrases courtes. Écrivez les nombres sous forme de mots parlés lorsque cela améliore la narration. Ne décrivez pas ce que le spectateur peut déjà voir. Renvoyez le script dans un bloc copiable avec un nombre de mots et une durée estimée, suivis d'un court plan visuel et de conseils pratiques d'enregistrement. Demandez la voix off lorsque le script est approuvé. Conservez le texte du script final pour le timing ; si l'enregistrement diffère, obtenez la version parlée réelle.
Étape 4 — Construire à partir d'une voix off
Travaillez à travers les étapes ci-dessous et ne posez des questions que lorsqu'une entrée manquante bloque la progression. Utilisez le script approuvé de l'utilisateur comme référence de timing. Si aucun reconnaisseur vocal n'est disponible, le script est requis : ne prétendez pas comprendre ou transcrire l'audio sans un outil approprié.
4.1 Préparer le projet
Le kit de compétence se trouve à la racine du dépôt. Créez un projet de travail séparé en utilisant :
bash <racine-de-la-competence>/tools/setup.sh <répertoire-du-projet>
Utilisez le chemin d'installation réel pour <racine-de-la-competence>. Le script de configuration copie engine/, tools/ et les fichiers de démarrage de l'exemple travaillé dans le projet, et peut récupérer le code Three.js et la bibliothèque de personnages depuis des sources en amont. Ne faites pas référence à <racine-de-la-competence>/kit/tools/setup.sh ; ce chemin n'existe pas dans ce dépôt.
Vérifiez Node.js 22.6+, Python 3 avec NumPy (et Pillow pour les planches contact), FFmpeg/FFprobe, Git et Playwright avec Chromium. Expliquez les prérequis manquants et demandez avant d'effectuer des modifications système conséquentes. Ne désactivez pas TLS, ne contournez pas un proxy et n'utilisez pas de téléchargements d'exécutables non fiables pour contourner les restrictions réseau. Utilisez le WebGL logiciel de Chromium uniquement en solution de repli et avertissez qu'il peut rendre lentement.
4.2 Synchroniser la narration
Depuis le répertoire du projet, exécutez :
python3 timing.py voice.mp3 script.txt --out work
L'outil de synchronisation utilise les horodatages de mots Whisper/faster-whisper s'ils sont disponibles. Sinon, avec un script, il aligne les phrases sur les segments de parole détectés. Inspectez work/phrases.json ; corrigez les erreurs évidentes de limites de phrases avant de planifier les plans. Le nombre total d'images est approximativement durée × 30. Si ni la reconnaissance vocale ni le script final ne sont disponibles, demandez le script plutôt que de deviner.
4.3 Planifier les plans avant de coder
Écrivez un work/PLAN.md avec une ligne par plan : images de début/fin, phrase parlée, décor, éclairage, mouvement de caméra, personnages/poses/expressions, effets et indices sonores.
- Mettez une image d'accroche convaincante à l'image 0.
- Utilisez généralement un plan par phrase ; combinez les phrases très courtes si utile.
- Montrez chaque phrase avec une action visuelle concrète ou un accessoire portant la blague.
- Variez la taille et la composition du plan : gros plan, révélation large, plan deux, insert, réaction et mouvement d'environnement.
- Utilisez l'éclairage pour clarifier les temps de l'histoire. Rendez les sauts temporels visuellement lisibles.
- Mettez en scène le rebondissement délibérément ; faites atterrir sa récompense visuelle sur les derniers mots.
4.4 Construire le monde et la distribution
Utilisez engine/ et les fichiers du projet copié comme source de vérité. Adaptez web/story.js à partir de example/soldier/story.js et la table d'indices audio copiée à partir de example/soldier/audio.py ; n'écrasez pas l'exemple dans le dépôt de compétence. Suivez les contrats et les exportations dans le moteur copié et l'exemple de code.
Construisez les environnements à partir de géométrie 3D simple et de matériaux peints. Gardez à l'esprit le cadre vertical lors de la mise en scène de la profondeur et des objets de premier plan. Rendez les éléments de décor pilotés par l'histoire contrôlables par image/temps, et assurez-vous que l'état du monde soit déterministe pour toute image demandée. Gardez les cartes personnages lisibles, avec des poses, expressions, clignements et mouvements d'inactivité subtils appropriés. Utilisez des glissements de caméra fluides, une mise au point intentionnelle et un mouvement secondaire sans distraire de la narration. Vérifiez que le texte diégétique n'est pas inversé.
Si le code source du personnage est modifié, suivez la procédure de reconstruction documentée du projet généré. Rendez un test de personnage/planche contact avant de vous fier à un nouveau design. Évitez de modifier les contrats de matériau/profondeur/encre du noyau du moteur de rendu, sauf si la scène l'exige et que le résultat a été vérifié.
4.5 Conception sonore
Adaptez la table d'indices exemple à l'histoire. Utilisez la musique pour établir le ton et soutenir le rythme ; utilisez des effets sonores sur les actions significatives, les transitions et les révélations. Gardez la narration au premier plan, empêchez les effets de surprendre au-dessus d'elle et évitez d'utiliser de la musique ou des effets protégés par le droit d'auteur sans autorisation. Rendez/vérifiez le mix avant l'encodage ; signalez tout problème d'écrêtage ou de balance non résolu au lieu de prétendre que l'audio a passé le contrôle qualité.
Verrouillez le timing de l'image avant de finaliser les indices. Si le timing du plan change, revisitez le timing et le mix des indices sonores.
4.6 Réviser, rendre et terminer
Rendez des images représentatives de chaque plan, ainsi que des transitions et des actions clés. Créez une planche contact avec les utilitaires fournis et inspectez-la (ou utilisez les outils de visualisation d'images disponibles). Corrigez le cadrage, l'occlusion, le texte inversé, les images vides, l'éclairage et la lisibilité des personnages avant de démarrer le long rendu. Partagez la feuille de révision et un résumé concis des plans avec l'utilisateur lorsque l'environnement prend en charge le partage de fichiers, puis procédez au rendu complet.
Commandes typiques du projet (exécutées depuis le répertoire du projet généré) :
node render.mjs stills/review "0,60,120"
python3 sheet.py stills/review stills/contact-sheet.jpg
node render.mjs frames "0-<dernière-image>"
bash finish.sh "Titre Du Court Métrage"
Utilisez la plage d'images réelle dérivée de la voix off. Reprenez uniquement si le mode de reprise du moteur de rendu est pris en charge par la version copiée. Vérifiez l'achèvement du processus et les erreurs ; ne présumez pas qu'un processus en arrière-plan démarré s'est terminé. L'utilitaire de fin encode un MP4 et imprime les vérifications de base du média/noir/gel/loudness. Inspectez le fichier final et la sortie du contrôle qualité, et soyez transparent si une vérification n'a pas pu être exécutée.
Livrez le MP4 et une courte description des plans lorsque les outils de partage de fichiers sont disponibles. Sinon, fournissez le chemin exact de sortie et expliquez comment l'utilisateur peut le récupérer. Proposez des révisions ciblées ou des sous-titres uniquement sur demande.
Notes sur le dépôt et les dépendances
engine/: moteur de rendu Three.js et monde, aides pour la peinture, le mouvement et les personnages.tools/: scripts de configuration de projet, timing, rendu d'image, planche contact et finition. Privilégiez ces scripts canoniques du dépôt de compétence.example/soldier/: exemple travaillé ; utilisez-le comme point de départ, pas comme une histoire à répéter automatiquement.- Le processus de configuration récupère certaines dépendances tierces. Respectez leurs licences en amont et ne revendiquez pas la propriété du code tiers.
- Les fichiers audio, images, planches contact et MP4 générés appartiennent au projet de travail de l'utilisateur. Ne validez pas d'enregistrements vocaux privés ou de secrets dans le dépôt de compétence.