Communitygithub.com

MV Code généré par les paroles

Utilisez cette compétence pour créer ou améliorer des clips musicaux animés en pixel art, avec des personnages, une narration de jeu/interface, des motifs récurrents ou un calage musical. Ne pas utiliser pour les vidéos de paroles seules ou les karaokés ; utilisez plutôt music-to-video.

Qu'est-ce que MV Code généré par les paroles ?

Cette compétence permet de transformer les émotions d'une chanson en un spectacle interactif de type jeu vidéo : les paroles dictent ce qui est dessiné, la musique détermine quand les éléments sont accentués. Elle est conçue pour les agents IA (Claude Code, Cursor, Codex) et prend en charge la création complète de clips musicaux en pixel art, de l'analyse audio à la vidéo finale. Le processus commence par une phase de recherche et de narration : l'agent utilise la recherche en ligne pour vérifier le contexte d'une chanson (interviews, notes d'album) et crée un personnage et une histoire qui en découlent, en distinguant clairement faits réels et fiction. Ensuite, l'agent établit une double chronologie (paroles et musique) et conçoit les éléments visuels (personnages, décors, HUD) en respectant des règles strictes d'accessibilité visuelle et de séquence de dessin. Enfin, le rendu est produit via un template HTML/JavaScript ou React (Remotion), avec des outils de vérification de la qualité (cohérence des pixels, synchronisation audio, sécurité des sous-titres) et un système de classification de la preuve musicale (illustrative, brouillon, vérifiée). L'agent ne peut pas promouvoir une synchronisation non vérifiée avec une chanson réelle.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/zizhengLI4/lyric-driven-code-mv-skill/tree/main/skills/lyric-driven-code-mv

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait MV Code généré par les paroles ?

Transformez les émotions d'une chanson en un spectacle de jeu vidéo regardable : les paroles déterminent ce qui est dessiné, la musique décide quand l'accentuer. Utilisez les objectifs, les actions, les retours et les résultats des personnages pour exprimer le sens ; les barres de progression, les objets et les transitions servent cette chaîne causale.

Du contexte de la chanson aux personnages et à l'histoire

Pour une nouvelle création ou une réécriture narrative, si le personnage ou l'intrigue n'est pas spécifié, utilisez activement l'outil de recherche en ligne de l'assistant actuel, sans exiger de l'utilisateur qu'il invente d'abord une histoire. Si seul le personnage est spécifié, gardez-le et complétez l'intrigue ; si seule l'intrigue est spécifiée, gardez-la et créez un personnage. Si les deux sont spécifiés, ou si vous ne faites que modifier des sous-titres, mixer ou exporter sur un projet existant, ne lancez pas cette étape.

  1. Identifiez l'œuvre. Croisez le titre de la chanson, les paroliers/compositeurs, les interprètes et la version d'enregistrement, puis cherchez « titre + genèse/interview » ainsi que les mots-clés dans la langue d'origine. Distinguez le contexte original de l'interprétation du repreneur ; en cas d'homonymie impossible à différencier qui modifierait l'intrigue, demandez la version. Ne recherchez que des informations publiques, ne téléchargez pas d'enregistrements privés ou de paroles non publiées ; si l'utilisateur désactive la connexion, ne cherchez pas.
  2. Trouvez des faits citables. Ouvrez les interviews des créateurs, les notes officielles de l'album ou les reportages contemporains ; n'utilisez pas les résumés de recherche comme source. Dans les notes de production du projet, enregistrez le titre, le lien, les faits retenus et la séquence qui les utilise. Si aucune source ne relie une expérience réelle à l'œuvre, ne la présentez pas comme une motivation créative ; le « je » dans les paroles n'est pas non plus automatiquement le chanteur.
  3. Laissez le contexte guider l'action. Commencez par relier en une phrase l'objectif, l'obstacle, le choix et la fin du protagoniste, puis disposez les actions et conséquences visibles au fil des couplets de la chanson. Par défaut, vous pouvez utiliser des personnages originaux pour transposer le contexte réel, en distinguant clairement les faits de l'adaptation. Par exemple, si seule une création liée à un déménagement est confirmée, on peut faire en sorte que le personnage fictif emballe ses affaires dans le premier couplet, essaie de renvoyer les clés dans le refrain et décide finalement de les garder dans la conclusion. Le déménagement a une source, les clés sont un accessoire de scénariste, pas une anecdote réelle.
  4. Passez au film. Écrivez le personnage dans actors, et l'action et ses conséquences dans les champs objective, action, feedback, outcome de chaque plan, et montrez-les réellement dans la méthode de dessin correspondant à scene.id ; les refrains répétés doivent montrer les changements causés par le choix précédent. Continuez avec les étapes de démonstration, de rendu et de validation ci-dessous, livrez selon la durée demandée par l'utilisateur, ne vous arrêtez pas au résumé contextuel. Si vous ne pouvez pas vous connecter ou ne trouvez pas de matériel fiable, expliquez les limites et créez en vous basant sur les paroles ou l'ambiance instrumentale, en mentionnant « interprétation originale, non basée sur une expérience réelle ».

Les modèles détaillés pour les personnages, les notes de recherche et l'arc narratif se trouvent dans D'une chanson à un storyboard continu. Pour l'analyse de la chanson, les invites progressives, la démonstration d'action et la livraison, continuez avec Production MV pixel art par étapes. Si un film existant présente des problèmes de personnage, de climax, de clarté ou de transition, lisez d'abord Révision avancée et optimisation ciblée, puis modifiez et réévaluez avec la même échelle.

Flux de travail

Faites d'abord la vérification des dépendances. Pillow est utilisé uniquement par les scripts Python dans scripts/ et est déclaré dans requirements.txt du répertoire de la compétence. Lancez d'abord python -c "import PIL" pour vérifier et signaler son absence ; si l'installation est nécessaire, expliquez d'abord à l'utilisateur Pillow, sa version, son utilité et la commande d'installation, puis exécutez-la après son accord ; n'intégrez pas pip install dans la vérification automatique.

Côté Node, zéro dépendance tierce : les fichiers .mjs sous scripts/, assets/scenes/, assets/templates/starter/ n'importent que des modules internes node:, le répertoire de la compétence n'a pas de package.json, aucun besoin de npm install, utilisable hors ligne – validate-storyboard.mjs, hud-density.mjs idem. FFmpeg/FFprobe sont des binaires système, vérifiés à l'étape 4.

  1. Corrigez l'entrée et les preuves. Confirmez le fichier audio et sa version, vérifiez les paroles, la plage à découper, le format d'image, les personnages et le périmètre de livraison. Lorsque vous cherchez vous-même une chanson, lisez d'abord Audio et droits pour vérifier les conditions d'utilisation de l'œuvre et de l'enregistrement. Lors de l'analyse d'une référence visuelle, enregistrez séparément les faits visibles, les résultats de la vérification audio et les déductions d'implémentation ; ne dites « avoir vu le film entier » qu'après avoir effectué une vérification complète sur toute la durée. Si un outil n'a pas de code source ou de preuve de déclaration, marquez-le comme inconnu.
  2. Établissez deux chronologies. Notez les débuts et fins de phrases, les sections, les accents importants et les silences ; la table sémantique enregistre les relations entre les personnages, les images et les actions. Lisez Temps et storyboard pour unifier les coordonnées du film final et le décalage de la piste originale. Pour la musique instrumentale avec sous-titres narratifs originaux, expliquez le rôle du texte, ne le traitez pas comme une transcription de chant. Si FFmpeg est déjà présent, utilisez d'abord scripts/analyze-audio.mjs pour générer hors ligne des candidats pour l'énergie, les pauses, les attaques et le BPM/phase ; pour vérifier les plans et sous-titres dans le même axe, lisez Candidats de synchronisation. Ne considérez pas les candidats comme un alignement des paroles ; vous pouvez également produire un brouillon d'annotation transparent sans pouvoir écouter.
  3. Passez d'abord par la reconnaissabilité des personnages, puis choisissez les dispositifs et les décors. Pour trois personnages principaux ou plus, établissez d'abord des fiches personnages et une silhouette noire pure à la même échelle pour comparaison ; après avoir retiré le nom, la palette de couleurs et les petits accessoires, chaque personne doit encore être distinguable par au moins deux éléments parmi le contour tête/vêtement, la proportion du corps ou la posture. Testez la taille minimale d'affichage réelle pour les plans de groupe et les plans rapprochés individuels ; en cas d'échec, redessinez d'abord le personnage, ne masquez pas le problème avec un changement de couleur, de petits accessoires ou un filtre.
  4. Choisissez d'abord le dispositif, puis le décor. Déterminez d'abord le système de chat, de jeu, la timeline, le compteur, les cartons de chapitre, le point de vue ou la scène matériau, puis écrivez pour chaque plan Objectif → Action → Retour → Résultat. Utilisez chapters[] pour enregistrer les cartons de titre, les étapes de relation et le bilan ; utilisez scene.hud[] pour exprimer les valeurs, l'état, la remise à zéro, les dégâts ou le retour émotionnel de l'échec ; pour les mêmes compositions changeant de saison, matériau ou époque, écrivez materialVariant. La durée du plan est déterminée par la densité d'information, sans limite fixe ; suggérez au moins un changement lisible toutes les 8 à 12 secondes ; les longs plans peuvent aussi servir à l'attente et aux silences. Référez-vous à Dispositifs et chapitres et HUD et sous-titres ; pour une structure prête à l'emploi, choisissez et adaptez l'un des cinq JSON (DM, chargement, inventaire, bilan, curseur double) du Modèle de dispositif, ne partez pas de zéro. Disposez les motifs récurrents en première apparition, changement et réapparition ; les refrains répétés ajoutent des informations ou des conséquences. Gardez la trace de l'identité du personnage, de sa tenue et de ses accessoires. Pour le pixel art, la caméra, les sous-titres et la narration à deux personnages, lisez Monde pixel art et mise en scène.
  5. Choisissez une voie d'implémentation. Utilisez le framework spécifié par l'utilisateur et le projet existant. S'il n'y a pas de framework et qu'un projet minimal fonctionnel est nécessaire, copiez tout assets/templates/starter/ ; il contient déjà le noyau partagé et les fichiers d'exécution. Après copie, il peut être exécuté indépendamment avec node export.mjs --help. Les projets d'effets HTML peuvent utiliser HyperFrames, les projets React privilégient Remotion. Avant l'implémentation, lisez Dépendances et livraison et listez les éléments nécessaires, déjà présents et optionnels ; avant d'installer des paquets, de télécharger un navigateur/modèle/police, d'utiliser une API ou un service payant, expliquez et utilisez les licences existantes.
  6. Réalisez un segment représentatif. Pour une nouvelle œuvre, livrez d'abord les fiches personnages/tableau de silhouettes, une bande d'action à l'échelle réelle et un échantillon d'environ 10 à 15 secondes ; s'il y a trois personnages principaux ou plus, l'échantillon doit contenir à la fois un plan d'identification individuelle et un plan de groupe, confirmant que l'on peut toujours reconnaître le même personnage après être passé d'un plan rapproché à un plan de groupe. L'échantillon doit également inclure une tâche d'imagerie de paroles, un changement de feedback et une transition ; si l'utilisateur spécifie une autre durée ou modifie un projet existant, suivez son périmètre. Le JSON du storyboard est la source de vérité pour la durée, les paroles, les limites de scène, les transitions et l'état musical ; le code fournit les méthodes de dessin via scene.id. Chaque image est évaluée directement à partir du temps, les particules ont une graine fixe. La transition de sortie occupe la fin du plan précédent, le plan suivant fixe local=0 comme pré-roulage, sans augmenter la durée totale. Effectuez une validation structurelle et une comparaison de pixels pour les répétitions, les inversions et le désordre avec scripts/qa.mjs.
  7. Extension et validation. Prévisualisez d'abord le segment représentatif, vérifiez les pics d'action, les fins de phrase, les transitions, le panneau de paroles et les bords de la caméra, puis étendez le périmètre autorisé. En cas de référence à une vidéo de paroles en pixels, utilisez captionStyle.mode:"scene-panel" au niveau racine du storyboard, pour que l'aperçu navigateur, l'export ASS et les cartons de chapitre conservent les mêmes paramètres de panneau blanc chaud/bordé/pixels ; s'il n'est pas fourni, gardez un sous-titre bas standard pour la compatibilité avec les anciens projets. Après l'export, effectuez une vérification FFprobe, un décodage complet, un tableau des contacts et une vérification des images clés ; si la lecture est possible, lisez intégralement et enregistrez chaque vérification réellement effectuée. S'il est impossible d'écouter, livrez draft, en précisant clairement les points d'impact à vérifier, sans prétendre que l'audio et l'image ont été vérifiés.

Preuve musicale et phases de livraison

music.statusConditionDevoir de livraison
illustrativePoints temporels auto-générés, piste sonore de substitution ou démo originaleAffichez "points temporels de démonstration" au début, enregistrez presentationNotice:true ; expliquez qu'il ne s'agit pas d'un résultat aligné sur la chanson réelle correspondante
draftAudio existant, annotation par analyse machine ou sans écouteevidence.method écrit la méthode d'estimation, limitations écrit les sources d'erreur ; pendingChecks[] enregistre les intervalles de temps spécifiques et les éléments non confirmés, autorise la livraison du film brouillon
verifiedVérification humaine de l'audio, des paroles et des points clés effectuéeEnregistrez evidence.reviewer, le timestamp complet avec fuseau horaire reviewedAt (ex : 2026-11-17T08:00:00Z), le résumé de livraison indique le périmètre de vérification

L'analyse automatique ne peut pas être promue en verified. Lorsque les points temporels mot à mot sont répartis uniformément par longueur de phrase, les sous-titres sont décrits comme un remplissage visuel ; les ambiguïtés de moitié/double vitesse du BPM, les attaques d'accompagnement, les traînées et les décalages de source peuvent tous provoquer des erreurs. En l'absence d'audio, livrez d'abord un storyboard illustrative ou une démonstration, n'attendez pas indéfiniment. L'état et les droits sont deux conditions indépendantes ; un état brouillon ne remplace pas une autorisation de publication.

Spécifications de dessin

Les scènes en pixels sont dessinées dans l'ordre : Fond → Décor/Auras → Sujet → Objet devant. Le décor doit être posé avant le sujet, évitez que les auras, reflets ou particules ne recouvrent le contour du sujet ; dans le starter, utilisez fb.layer({ glow: layer => ..., subject: layer => ... }) pour fixer cet ordre, fb.glow(x, y, radius, color) ne dessine que l'aura de fond. La composition de l'image doit vérifier la proportion du sujet, la luminosité globale et la surface monochrome ; scripts/qa.mjs signalera pour les images analysables une proportion estimée du sujet inférieure à 0,5 %, une luminosité moyenne inférieure à 30/255 ou une couleur unique dépassant 60 %. Ce sont des indices de criblage, ils ne remplacent pas l'inspection d'images échantillonnées.

Par exemple, un plan d'enseigne au néon commence par le ciel nocturne, puis dessine l'aura et l'enseigne, et enfin ajoute l'obstacle devant. Les deux callbacks de layer reçoivent la même instance de FB, d'abord glow, puis subject :

fb.rect(0, 0, 384, 216, nightSky); // Fond
fb.layer({
  glow: layer => layer.glow(258, 72, 32, [255, 62, 164], { alpha: 0.65 }),
  subject: layer => {
    layer.rect(231, 52, 54, 38, [28, 26, 42]); // Panneau enseigne
    layer.rect(237, 59, 42, 4, [255, 110, 194]); // Texte enseigne
    layer.rect(250, 92, 16, 42, coat); // Personnage
  },
});
fb.rect(0, 190, 384, 26, foreground); // Objet devant

Modèles et commandes

Copiez le storyboard de 12 secondes original et remplacez le contenu. Voir README du starter pour le projet minimal, qui inclut un bateau en papier, des lumières de rivage, une transition finale, des sous-titres haute résolution et un rythme original généré localement. export.mjs --storyboard lit la configuration du storyboard ; pour une chanson réelle, mettez d'abord à jour project.audio et les preuves, --audio ne peut que relocaliser le même matériau ; ajustez ou enregistrez les méthodes de dessin via scene.id. L'export enregistre le hash de la piste audio réelle et l'historique de la source ; si la piste externe a un credit, générez un court générique de fin, mais vérifiez quand même les obligations complètes de crédit avant publication. Les sous-titres et les indications d'état musical sont générés par le JSON.

Les commandes suivantes s'exécutent depuis la racine du projet vidéo ; remplacez <SKILL_DIR> par le chemin absolu du répertoire d'installation de la compétence, et les entrées du storyboard/matériau avec les chemins correspondants ; toutes les sorties work/ sont relatives à la racine du projet vidéo. N'exécutez pas de commandes qui écrivent des fichiers depuis le répertoire d'installation de la compétence :

node "<SKILL_DIR>/scripts/analyze-audio.mjs" chemin/vers/song.wav --start 37.2 --duration 12 --out work/audio-analysis.json
node "<SKILL_DIR>/scripts/validate-storyboard.mjs" "<SKILL_DIR>/assets/storyboard-example.json"
node "<SKILL_DIR>/scripts/validate-storyboard.mjs" chemin/vers/storyboard.json --delivery
node "<SKILL_DIR>/scripts/visualize-sync.mjs" chemin/vers/storyboard.json work/audio-analysis.json --out work/sync-review.svg
node "<SKILL_DIR>/scripts/qa.mjs" "<SKILL_DIR>/assets/templates/starter/frame.mjs" --duration 12 --fps 30 --storyboard "<SKILL_DIR>/assets/storyboard-example.json" --out work/qa.json
node "<SKILL_DIR>/scripts/verify-sfx.mjs" --audio work/mixed.wav --storyboard work/storyboard.json --window-ms 50 --out work/sfx-evidence.json
node "<SKILL_DIR>/scripts/lrc.mjs" --lrc work/song.lrc --offset 12 --storyboard work/storyboard.json --out work/lyrics.json
node "<SKILL_DIR>/scripts/new-storyboard.mjs" --preset narrative-12 --duration 90 --lyrics work/lyrics.json --out work/storyboard.json
node "<SKILL_DIR>/assets/templates/starter/export.mjs" --storyboard "<SKILL_DIR>/assets/storyboard-example.json" --out work/demo.mp4
node "<SKILL_DIR>/assets/templates/starter/export.mjs" --frame-time 5.55 --frame-out work/world-frame.png
node "<SKILL_DIR>/assets/templates/starter/export.mjs" --storyboard chemin/vers/storyboard.json --audio chemin/vers/song.wav --out work/mv.mp4

Mesurez le rythme, vérifiez l'audio-vidéo, testez la zone de sécurité, fabriquez des cartons titres pixellisés :

node "<SKILL_DIR>/scripts/hud-density.mjs" chemin/vers/storyboard.json --max-gap 12        # Densité de changements lisibles et fenêtre vide
python "<SKILL_DIR>/scripts/sync-audit.py" chemin/vers/storyboard.json \
  --analysis work/audio-analysis.json --video work/mv.mp4               # Une seule commande avant export pour tous les problèmes temporels
python "<SKILL_DIR>/scripts/layout-check.py" chemin/vers/storyboard.json \
  --hud "Dossier:56,44,596,200" --hud "Divinité:1256,44,1794,200" \
  --log "56,700,640,880" --subtitle-band "360,930,1560,988" \
  --safe "right=124,bottom=92" --scenes "s09-ledger:full-ui"
python "<SKILL_DIR>/scripts/timeline-sync.py" song.wav --storyboard storyboard.json -o work/timeline.png
python "<SKILL_DIR>/scripts/safe-area.py" --video work/mv.mp4 --at 3 10 -o work/check.png
python "<SKILL_DIR>/scripts/film-sheet.py" shots/<titre> -o sheet.jpg --cols 3
python "<SKILL_DIR>/scripts/pixel-font.py" --sample work/title-sample.png
python "<SKILL_DIR>/scripts/minimal-renderer.py" chemin/vers/storyboard.json --probe 0 120 300 --out work/probe
node "<SKILL_DIR>/scripts/sfx.mjs" --from-storyboard chemin/vers/storyboard.json --out work/sfx.wav --report work/sfx-report.json
node "<SKILL_DIR>/scripts/sfx.mjs" --list
node "<SKILL_DIR>/assets/templates/starter/export.mjs" --storyboard chemin/vers/storyboard.json --audio chemin/vers/song.wav --sfx --out work/mv.mp4

scripts/lrc.mjs ajoute les points temporels LRC au chronomètre du segment selon --offset secondes, en calculant end ligne par ligne ; avec --storyboard, il ajoute allowSceneSplit et la raison pour les paroles traversant plusieurs plans. scripts/new-storyboard.mjs génère un squelette de 12 plans à remplir, les paroles peuvent être importées directement depuis un JSON. 12 actifs de dessin se trouvent dans assets/scenes, chaque usine est configurable pour la position du sujet, la palette et la durée du plan. --sfx-script PATH permet au starter copié d'utiliser un module d'effets sonores personnalisé sans modifier le code source. Le film final n'a pas de filigrane brouillon par défaut : le draft n'écrit pas de texte sur l'image, l'avancement de la vérification est enregistré via musicStatus/draftMark et music.pendingChecks dans la liste des actifs exportés ; pour une indication visible dans le film, écrivez explicitement project.draftMark:true (texte avec project.draftMarkText).

hud-density.mjs répartit sur la timeline six types de changements (coupure, matériau, HUD, événement, son, sous-titre) et rapporte la plus longue fenêtre vide et la fenêtre vide interne à un plan ; avec --strict, une fenêtre vide entraîne une sortie non nulle. sync-audit.py est le contrôle final avant export, une commande vérifie cinq types de problèmes temporels : si la grille du storyboard et la grille d'analyse ont le même BPM, si les coupures tombent sur les temps, si les événements de scène avec sync:"beat" tombent sur les temps, si les paroles tombent sur les attaques fortes, si les limites des chapitres et sections sont identiques et toutes sur les coupures ; avec --video, mesurez les pixels réels entre le bas du sous-titre et le bord inférieur/droit de l'image. Vous devez passer --analysis : ne regarder que les « coupures vs grille du storyboard » donne une conclusion parfaite de 0 ms, car les coupures sont justement accrochées à cette grille — si la grille elle-même est fausse, les coupures aussi alignées soient-elles ne veulent rien dire (un ancien storyboard avait dans evidence « 98.8, 144.1 sont d'autres candidats forts non retenus », c'est exactement ce genre de boucle auto-référentielle). Sans --analysis, les paroles ne sont notifiées que par rapport aux temps, le critère est plus faible, et aucune erreur n'est signalée. L'écart entre les paroles et les attaques fortes n'est qu'une notification, pas une erreur : la détection d'attaque cherche des transitions énergétiques (coups de batterie, plosives, débuts de consonnes), mais les voix avec des phrases longues liées entrent en douceur, sans transition détectable ; cet écart est une limite du détecteur, pas une erreur de synchronisation — dans un film test, 9 lignes sur 13 étaient à 100-800 ms de l'attaque forte la plus proche, mais le décalage de phase entre la piste audio et le début LRC n'était que de 1,2 ms ; c'est le critère qui est erroné, pas la timeline. Les LRC sont annotés manuellement, plus fiables sur ce point que la détection heuristique, donc les lignes en dehors de la tolérance ne sont listées qu'en tant que candidats (incluant les candidats dans la direction opposée), la décision finale revient à l'oreille humaine. timeline-sync.py extrait l'enveloppe d'énergie et estime les temps de la piste audio, les dessine sur le même graphique avec les coupures et les sous-titres ; les BPM marqués speculative ne peuvent être utilisés que pour détecter un décalage complet sur une section, pas pour proclamer une synchronisation. --align beats utilise d'abord les music.beats du storyboard comme points de référence, sinon utilise ses propres temps estimés. safe-area.py superpose les zones de sécurité de la plateforme (haut, bas 8,5 %, droite 6,5 %, 4:3, 9:16) ; le bord inférieur du sous-titre et le HUD doivent les éviter ; la limite inférieure pour 1080p est de 92 px. layout-check.py vérifie les chevauchements entre HUD, entre HUD et bande de sous-titres, et les rectangles sortant de la zone de sécurité ; les rectangles sont écrits sous la forme nom:x,y,x1,y1 (coin supérieur gauche + coin inférieur droit, en pixels absolus, pas en largeur/hauteur) ; --subtitle-band passe le rectangle le plus extérieur incluant la bande inférieure et le contour ; --scenes "s09-ledger:full-ui" peut exonérer cette scène de la vérification HUD, mais la bande de sous-titres reste soumise à la zone de sécurité. minimal-renderer.py est un renderer minimal pour le placement et la validation de la maquette (carton titre + HUD de valeurs + sous-titres bilingues), ne contient pas de dessin de scène et ne sert pas de renderer final ; pour une finition visuelle, utilisez le starter ou le propre projet de l'utilisateur. sfx.mjs synthétise huit types d'effets sonores (tick/type/click/whoosh/confirm/error/riser/chime), avec une durée strictement égale à project.duration, pour le mixage ; les relations d'alignement à deux niveaux sont décrites dans Couche sonore et points d'impact — l'image est sur le temps, le son suit la même image que l'image, le son n'est pas sur le temps.

Le validateur expose validateStoryboard(data) → errors[], fournit analyzeStoryboard(data,{beatToleranceMs,delivery}) → {errors,warnings}. Les notifications simples ne changent pas le code de sortie ; --strict ne fait que considérer les avertissements de la validation structurelle comme des échecs, ne prouve pas que le film est publiable ou verified. --delivery vérifie les enregistrements de licence, les preuves musicales et la liste de contrôle du brouillon ; les règles de champ sont décrites dans la référence temporelle et du storyboard. Les notifications sont localisables pour les paroles traversant plusieurs plans, les événements sur temps explicites, le support HUD, la couverture des dispositifs/chapitres et les lacunes d'autorisation ; l'outil ne prouve pas l'exactitude sémantique, la validité de la licence ou la synchronisation réelle audio-vidéo.

Critères de complétion

  • Sans les sous-titres, l'action explique toujours le sens du passage ; les changements de HUD sont traçables jusqu'à l'action, les objets sont d'abord obtenus puis utilisés.
  • Les personnages principaux restent reconnaissables entre silhouette noire pure, taille minimale de groupe et plan rapproché individuel, et pas seulement par la couleur, le nom ou un petit accessoire ; les plans rapprochés utilisent des actifs de détail indépendants, ne pas agrandir directement un sprite de groupe basse résolution.
  • Les passages répétés montrent une progression, l'attente, l'échec, l'achèvement et le silence correspondent à l'ambiance de la chanson.
  • Pas de répétitions sur la même image ni d'évaluations désordonnées, pas de dérive d'état entre le début et la fin, chaque plan et chaque transition ; le mouvement de la caméra ne laisse pas de noir, les sous-titres sont clairs.
  • Le bord inférieur des sous-titres et le HUD sont dans la zone de sécurité de la plateforme : vérifiez avec safe-area.py sur une image, ne vous fiez pas à l'œil.
  • La plus longue fenêtre vide signalée par hud-density.mjs ne dépasse pas 12 secondes ; si c'est le cas, ajoutez d'abord des changements, pas de plans.
  • Les effets sonores tombent sur les événements visuels (pas sur les temps), project.sfx[]/scene.sfx[] passent la validation, le signal mixé n'est pas écrêté en haut.
  • Les flux audio et vidéo, la durée, le format d'image et la fréquence d'images du film final sont corrects ; l'état de la preuve musicale et le périmètre réel de la vérification sont écrits clairement.
  • Livrez les fichiers source modifiables, les données du storyboard et de l'analyse, les sources/ licences/ crédits des actifs, le fichier verrou des dépendances choisies (si des dépendances sont utilisées), le film final et un court rapport de validation. Si seul un rapport, un storyboard ou un brouillon est demandé, livrez la phase correspondante, n'étendez pas arbitrairement à la chanson entière.

Skills associés