MotionCraft — Compétence Universelle pour Agent pour Vidéos Explicatives & Shorts en 16 Catégories
Compétence autonome (zero dépendance applicative) qui transforme 1 phrase d'idée d'histoire en recommandation d'orientation visuelle, script par étapes (HOOK → SCÈNE 1 → SCÈNE 2 → etc. jusqu'à 10 minutes), fichier autonome <slug>.html (double-clic, s'exécute directement dans le navigateur avec bouton de changement de rapport 9:16 ↔ 16:9 & effets sonores WebAudio), package de code source <slug>-source.zip, ainsi qu'un rendu vidéo .mp4.
Flux de Travail Obligatoire (5 Étapes)
Étape 1 — Recommandation Visuelle & Plan de Script (HOOK → SCÈNE 1..N)
Quand l'utilisateur donne une idée d'histoire (si le rapport ou la durée ne sont pas précisés, utiliser par défaut 9:16 Shorts 30–45 s pour des faits brefs, ou 16:9 Vidéo 60–600 s pour un sujet approfondi) :
- Choisir 1 Catégorie la plus adaptée parmi les 16 Catégories Officielles :
3D·Isométrique·Vue éclatée de maison·Stickman 3D·Astronomie·Monde animal·Océan·Science & Nature·Histoire·Cartes·Islamique·Géographie·Anatomie·Contes folkloriques·Dessin animé·Animation 2D. - Formuler une Recommandation Visuelle Spécifique :
- Objets & Accessoires (
objets) : sujet principal texturé/articulé + au moins 3 accessoires de comparaison d'échelle/preuve. - Caméra & Transitions (
camera) : motif multi-plans (large→gros plandétail →orbite/whipTo/pull-back). - Ambiance & Éclairage (
ambiance) : atmosphère de ciel/espace, brouillard/lumière volumétrique, palette de couleurs, et ton narratif.
- Objets & Accessoires (
- Composer le Script par Étapes (
0àDURsecondes sans intervalle vide) :- La première partie OBLIGATOIRE est
HOOK(3–10 secondes d'ouverture pour susciter la curiosité). - Suivent
SCÈNE 1,SCÈNE 2, etc., et se termine par une conclusion factuelle solide (~2,2 mots/seconde). - Pour les durées longues (> 60 s jusqu'à
600s / 10 minutes), lire Guide de Durée Longue 10 Minutes.
- La première partie OBLIGATOIRE est
Étape 2 — Lire la Recette de Catégorie & le Standard d'Excellence du Code Exemple (OBLIGATOIRE !)
N'ÉCRIVEZ PAS sceneCode à partir d'une supposition vide ! Avant d'écrire du code d'animation :
- Lire le tableau des catégories et l'ID de
styledans Catalogue des 16 Catégories ainsi que la liste des fonctions runtime dans Référence API Moteur v4 (MF). - Lire les exemples de code source officiels les plus proches dans Standard d'Excellence du Code de Référence.
- Loi d'Équivalence de Qualité : La densité des objets, le détail des textures (
CanvasTexture/ SVG multicouche / lignes de côteworld-atlas/ shader GLSL), l'éclairage, et la fluidité de la caméra DOIVENT ÊTRE ÉQUIVALENTS aux exemples degolden-showcases.md. Il est interdit de dessiner des carrés/cercles simples sans texture ou sans accessoire !
Étape 3 — Règles d'Or pour l'Écriture de sceneCode
sceneCode est exécuté comme le corps de la fonction (MF, stage, tl, W, H, DUR) :
- Double Responsivité (
9:16Shorts &16:9Vidéo) : Toujours utiliser les proportionsWetH(W * 0.5,H * 0.45,size: W < H ? 50 : 56,labelX: W < H ? W * 0.08 : W * 0.54) pour que l'animation s'affiche entièrement sans être coupée en1080×1920ni en1920×1080. - Ne pas Surcharger la Variable
H: Ne jamais écrireconst { H } = MF;car cela surchargerait la hauteur de la scèneH! Toujours appeler via le préfixeMF.(MF.H,MF.S,MF.T). - Déterministe à 100% : Interdiction d'utiliser
Math.random(),Date.now(),setTimeout, ousetInterval. UtiliserMF.rng('seed-fixe'), des interpolations surtl, etMF.onTick((t) => ...)comme fonction pure du tempst. - Frame 0 Directement Actif : Les éléments de la scène et le titre d'ouverture
HOOKdoivent utiliserat: 0pour que la première image ne soit pas vide/sombre. - Anti-PPT : Maximum 1 titre d'accroche (
MF.highlightHeadline) + 1 callout/chiffre (MF.leaderCallout/MF.bigStat) à la fois. L'histoire doit être portée par les changements d'action du monde/objets et les mouvements de caméra, pas par une suite de cartes de texte !
Étape 4 — Assembler le Fichier Autonome (.html, -source.zip, -script.md)
Créer un fichier de spécifications JSON (ex. spec.json) :
{
"title": "Titre de la Vidéo",
"idea": "Idée originale de l'histoire de l'utilisateur",
"style": "stickman-3d",
"aspectRatio": "9:16",
"duration": 30,
"visualRecommendation": {
"objets": "...",
"camera": "...",
"ambiance": "..."
},
"scenes": [
{ "label": "HOOK", "title": "...", "start": 0, "end": 7, "narration": "...", "visualBeat": "..." },
{ "label": "SCÈNE 1", "title": "...", "start": 7, "end": 18, "narration": "...", "visualBeat": "..." }
],
"sceneCode": "const view = MF.H('div', { className: 'mf-view' }, stage); ..."
}
Puis exécuter le script de construction autonome (pur Node.js intégré, 0 dépendance npm !) :
node "<chemin-vers-la-competence>/scripts/build.mjs" --spec chemin/vers/spec.json --out-dir chemin/destination
Ce script valide la syntaxe et le déterminisme du sceneCode, intègre ./assets/motion-engine.js, ./assets/sfx-synth.mjs, ainsi que ./assets/land-110m.json (si utilisation de cartes), puis produit :
<slug>.html— 1 fichier autonome prêt à être visionné dans n'importe quel navigateur (auto-loop + barre de défilement + bouton de changement de rapport9:16↔16:9+ effets sonores WebAudio).<slug>-source.zip— archive complète du code source (index.html,src/scene.js,src/project.json,SCRIPT-ET-STORYBOARD.md,engine/).<slug>-script.md— document du script et recommandation visuelle bien présentée.
Solution de Rechange Sans Shell / Web Chat : Si l'environnement de l'agent n'a pas accès à un terminal Node.js, copier le contenu de
./assets/starter-template.html, remplacer les placeholders/*__MOTION_ENGINE__*/,/*__SFX_SYNTH__*/, et/*__PROJECT_JSON__*/ nulldirectement pour produire le fichierindex.htmlcomplet.
Étape 5 — Vérification des Images & Export Vidéo MP4 (Optionnel / Si Navigateur Headless Disponible)
Si l'environnement dispose de Chrome/Edge + puppeteer-core (ou puppeteer), exécuter une vérification automatique pour s'assurer 0 erreur d'exécution et vérifier les captures d'écran :
# Vérification rapide (vérifier 0 erreur + sauvegarder la capture d'écran HOOK & intermédiaire) :
node "<chemin-vers-la-competence>/scripts/export-mp4.mjs" --html chemin/destination/<slug>.html --verify-only
# Rendu complet en vidéo MP4 (H.264 + AAC SFX automatique, optionnel + --vo narration.mp3) :
node "<chemin-vers-la-competence>/scripts/export-mp4.mjs" --html chemin/destination/<slug>.html --fps 30 --scale 1
Si des erreurs ou des textes superposés sont détectés sur les captures de vérification, corriger sceneCode, reconstruire avec scripts/build.mjs, puis soumettre le résultat à l'utilisateur.