JohnsonZhangCN/music-mv-skill

Clip Musical MV

Orchestrez les éléments de l'utilisateur en un clip 2D dessiné à la main avec performances, synchronisation des paroles et transitions, livrant un MP4 lisible. Intègre le moteur p5.js + p5.brush de painted-animation, des exemples et un wrapper Windows ; ne dépend d'aucune autre compétence installée ni d'API externe de génération vidéo.

Paramètres actuels de l'utilisateur :

$ARGUMENTS

Analyse de la requête

Accepte le langage naturel chinois ou clé=valeur. Obligatoires : image du personnage image, chanson audio, paroles lyrics, début start, fin end, style style. Les chemins contenant des espaces supportent les guillemets. Le temps accepte les secondes, M:SS ou H:MM:SS. En cas d'absence, liste les éléments manquants en une fois ; ne répète pas les informations déjà fournies.

Par défaut : 1920×1080, 24 ips, paroles ligne par ligne, tous les personnages clairement distincts dans l'image apparaissent, sortie dans un nouveau répertoire sous outputs/music-mv du projet courant. Lorsque l'utilisateur spécifie un protagoniste unique, pas de sous-titres, ou une autre fréquence d'images, suivre ses instructions. Pour une image complexe de personnages, définir d'abord une table des modèles et dessiner des images de test ; l'image est une référence d'identité et de style, elle ne peut pas se limiter à un déplacement de texture ou à un diaporama statique.

Lorsque style=小镇姑娘, lire references/styles.md et consulter assets/painted-animation/docs/xiaozhen-sheet.jpg. Ce nom indique le style aquarelle, traits à l'encre, performance en images limitées, imagerie des paroles et transitions cohérentes de l'exemple, sans copier l'intrigue de la chanson originale. Les autres styles sont mappés à un langage pictural 2D réalisable ; les besoins en photoréalisme ou 3D doivent d'abord expliquer les limites de ce moteur.

Production

1. Vérifier les trois fichiers d'entrée, examiner l'image du personnage. Produire d'abord un plan succinct : personnages, fil narratif principal, style visuel, emplacements des fichiers ; respecter les exigences d'approbation existantes du projet. Lorsque l'utilisateur a autorisé la génération complète, continuer jusqu'au produit fini ; ne s'arrêter après le storyboard que si "voir le storyboard d'abord" est demandé.
2. Lire assets/painted-animation/template/ANIMATION_GUIDE.md et references/production.md. Si nécessaire pour l'arrangement musical, lire references/music-video.md ; ses suggestions d'extension par mesure ne peuvent pas remplacer l'intervalle de coupure précis de l'utilisateur. Si mode=先看分镜, lire uniquement l'image et les paroles, mesurer le rythme et écrire le storyboard ; sauter l'installation du projet, la création des scènes et le rendu, livrer le storyboard puis s'arrêter.
3. Écrire le JSON normalisé dans .cache/music-mv-request.json du projet courant à l'aide de l'outil de fichiers. Doit attribuer à output un chemin absolu qui n'existe pas encore dans le projet courant. Préparer les matériaux et le projet avec le script :

   python "${CLAUDE_SKILL_DIR}/scripts/prepare_mv.py" --request "<chemin absolu du JSON de requête>" --install
   

   Voir references/windows.md pour les dépendances Windows, le cache et le navigateur. Les scripts auxiliaires ne préparent que le projet ; les scènes restent à votre charge créative.
4. Lire le fichier mv-task.json généré, analysis/lyrics.json ; confirmer le BPM et beat_offset. En cas d'échec de détection, réparer les dépendances et mesurer, ou utiliser le BPM fourni par l'utilisateur ; ne pas prendre une estimation pour une mesure. Conserver la plage audio spécifiée, sans ajouter d'introduction, de changement de tempo ou de fondu. Un LRC simple ne fournit que des temps par ligne ; le coloriage des paroles est une estimation intra-ligne, ne peut prétendre à un alignement mot par mot précis.
5. Écrire un STORYBOARD.md complet : temps de chaque plan, paroles, action, composition, transition. Créer les fichiers de scène dans src/scenes, les enregistrer dans studio.html ; supprimer les scènes de démonstration. Les personnages doivent avoir des expressions, des actions préparatoires, des changements de centre de gravité, des actions de suivi et une performance lisible. Chaque frame est une fonction pure du temps t.
6. Rendre les images représentatives de chaque plan, les barres d'action et les coutures avec scripts/render_mv.mjs, ouvrir les images pour inspection et correction. En l'absence de sous-titres, retirer le chargement de karaoke.js dans studio.html.
7. Rendre la vidéo complète ; le packaging vérifiera la durée, les dimensions, la fréquence d'images et la piste audio. Vérifier le début, la fin et toutes les transitions, puis livrer les chemins absolus réels du MP4, du storyboard et des aperçus. Après modification d'une scène, re-rendre les frames affectées, éviter de réutiliser d'anciennes frames. Ne pas prétendre à une qualité confirmée sans avoir ouvert les aperçus ou lu/vérifié la vidéo.

Ordre par défaut : vérification des matériaux → storyboard → création des scènes → correction des aperçus → MP4. Ne pas demander d'approbation répétée entre les étapes normales. Utiliser un sous-agent uniquement si l'utilisateur le demande explicitement.

Exemple d'appel

/music-mv 角色="D:/mv/character.png" 歌曲="D:/mv/song.mp3" 歌词="D:/mv/song.lrc" 截取="00:39-01:07" 风格="小镇姑娘"

Peut être complété par : 角色模式=仅橙色主角, 字幕=无, 模式=先看分镜. Lorsque l'image contient plusieurs personnages clairement distincts, tous apparaissent par défaut, et la production continue jusqu'au produit fini.

Source et licence dans references/credits.md.