Music MV (Música MV)

O que Music MV (Música MV) faz?

Organiza os materiais do usuário em um MV 2D desenhado à mão, com performance de personagens, sincronização de letras e transições, entregando um MP4 reproduzível. Utiliza o motor p5.js + p5.brush de animação pintada, exemplos e um empacotamento para Windows; não depende de outro skill instalado nem de uma API externa de geração de vídeo.

Parâmetros atuais do usuário:

$ARGUMENTS

Análise da Solicitação

Aceita linguagem natural em chinês ou key=value. Obrigatórios: imagem do personagem image, áudio da música audio, letra lyrics, início start, fim end, estilo style. Caminhos com espaços devem usar aspas. O tempo aceita segundos, M:SS ou H:MM:SS. Se faltar algo, lista todos os itens ausentes de uma vez; não pergunta novamente por informações já fornecidas.

Padrão: 1920×1080, 24fps, letras linha por linha, todos os personagens claramente distinguíveis na imagem em cena, saída em um novo diretório sob outputs/music-mv do projeto atual. Quando o usuário especificar um único protagonista, sem legendas ou outra taxa de quadros, segue a solicitação. Para imagens complexas de personagens, primeiro define uma tabela de modelos e desenha quadros de teste; a imagem é referência de identidade e estilo, não pode ser apenas平移 (deslocamento) ou slide estático.

Quando o estilo for "小镇姑娘", lê references/styles.md e consulta assets/painted-animation/docs/xiaozhen-sheet.jpg. Este nome indica o exemplo de papel aquarela, tinta nanquim, performance com quadros limitados, imagens líricas e transições coerentes, sem copiar a história original da música. Outros estilos são mapeados para linguagens de desenho 2D realizáveis; necessidades de fotorealismo ou 3D devem primeiro explicar os limites deste motor.

Produção

1. Verifica os três arquivos de entrada e analisa a imagem do personagem. Primeiro, gera um resumo breve: personagem, linha narrativa principal, estilo visual, localização dos arquivos; segue os requisitos de aprovação existentes do projeto. Quando o usuário já autorizou a geração completa, continua até o produto final; apenas se o modo for "ver storyboard primeiro" para após o storyboard.
2. Lê assets/painted-animation/template/ANIMATION_GUIDE.md e references/production.md. Se necessário para arranjo musical, lê references/music-video.md; suas sugestões de extensão por compasso não podem substituir o intervalo exato definido pelo usuário. Se o modo for "ver storyboard primeiro", lê apenas a imagem e a letra, mede o BPM e escreve o storyboard; pula instalação do projeto, criação de cenas e renderização, parando após entregar o storyboard.
3. Usa a ferramenta de arquivos para escrever o JSON normalizado em .cache/music-mv-request.json do projeto atual. Deve fornecer um caminho absoluto que ainda não exista no projeto atual. Prepara os materiais e o projeto com o script:

   python "${CLAUDE_SKILL_DIR}/scripts/prepare_mv.py" --request "<caminho absoluto do JSON de solicitação>" --install
   

   Dependências Windows, cache e navegador: veja references/windows.md. O script auxiliar apenas prepara o projeto; as cenas ainda são criadas por você.
4. Lê o arquivo mv-task.json e analysis/lyrics.json gerados; confirma o BPM e beat_offset. Em caso de falha, corrige dependências e mede novamente, ou usa o BPM fornecido pelo usuário; não pode usar valores estimados como medição. Mantém o intervalo de áudio especificado, sem adicionar introdução, alterar velocidade ou fade out. LRC comum só fornece timestamps por linha; a coloração das letras é estimada dentro da linha, não pode afirmar alinhamento palavra por palavra preciso.
5. Escreve o STORYBOARD.md completo: para cada cena, o tempo, a letra, a ação, a composição, a transição. Cria arquivos de cena em src/scenes e os registra no studio.html; remove cenas de demonstração. Os personagens devem ter expressões, poses de preparação, mudanças de centro de gravidade, movimentos de acompanhamento e uma performance legível. Cada quadro é uma função pura do tempo t.
6. Usa scripts/render_mv.mjs para renderizar quadros representativos de cada cena, barras de ação e emendas; abre as imagens para verificar e corrigir. Quando não houver legendas, remove o carregamento de karaoke.js no studio.html.
7. Renderiza o vídeo completo; a validação confere duração, dimensões, taxa de quadros e trilha de áudio. Verifica o início, o fim e todas as transições, então entrega os caminhos absolutos reais do MP4, do storyboard e das imagens de pré-visualização. Após modificar cenas, re-renderiza os quadros afetados para evitar reutilizar quadros antigos. Não pode alegar qualidade confirmada sem ter aberto a pré-visualização ou verificado/reproduzido o vídeo.

Ordem padrão: verificação de materiais → storyboard → criação de cenas → pré-visualização e correção → MP4. Não peça aprovação repetidamente entre os passos normais. Use subagentes apenas quando explicitamente solicitado pelo usuário.

Exemplo de Chamada

/music-mv personagem="D:/mv/character.png" música="D:/mv/song.mp3" letra="D:/mv/song.lrc" intervalo="00:39-01:07" estilo="小镇姑娘"

Pode adicionar: modo personagem=apenas protagonista laranja, legenda=nenhuma, modo=ver storyboard primeiro. Quando houver vários personagens claramente distinguíveis na imagem, todos entram em cena por padrão, e a produção continua até o produto final.

Fonte e licença: veja references/credits.md.