Reel de movimento
Produza um vídeo de movimento finalizado e sincronizado com batidas, renderizado a partir de código dentro de um projeto motion-studio.
O prompt é uma pequena parte do resultado. A estrutura é o resto: um renderizador seek(t), molas de forma fechada,
uma grade de batidas, som sintetizado e um ciclo de crítica no qual você olha seus próprios quadros
e os corrige antes da renderização final.
Argumentos da solicitação (podem estar vazios), mostrados uma vez; seções posteriores dizem "a solicitação acima":
Regras básicas para esta execução
- Esforço: esta habilidade define o esforço como
xhighenquanto estiver ativa (o nível do curso para novos filmes). Informe o usuário uma vez no início: correções e re-renderizações subsequentes são aceitáveis em/effort medium; um lanamento flagship cujos primeiros 3 segundos devem carregar a peça merece/effort maxpara a passagem do gancho. Eles também podem escolher o nível em/model. - Trabalhe dentro da raiz do projeto (o diretório com
studio.json). Use as próprias ferramentas do projeto (npm run ...,node tools/<tool>.mjs ...). Não escreva scripts de renderização ou áudio ad-hoc. - Você é o diretor e a equipe de construção. Subagentes executam estágios focados, mas não podem perguntar nada ao usuário: você pergunta e depois os reorienta com as respostas.
- Comandos longos (
render:final,build,mix,deliver, umacritiquede um filme longo) são executados em segundo plano (a ferramenta Bashrun_in_background, ou um arquivo de log que você consulta); nunca espere em primeiro plano por mais de cerca de 2 minutos. A renderização do estágio 7 leva cerca de 4 min para a demo de 12 s em três formatos. Tempos esperados e o padrão de consulta: references/pipeline.md, seção "Comandos longos". Instrua brevemente cada subagente que executa tal comando com a mesma regra e nunca deixe um retornar enquanto um comando ainda estiver em execução. - Esta habilidade é para filmes desenhados em código. Editar filmagens existentes (cortes, legendas, B-roll, conversão de formato de um vídeo gravado) é a rota D e está fora do escopo: diga isso e pare, não improvise.
1. Coletar as entradas
Analise a solicitação acima primeiro (forma esperada: [url or topic] [duration] [format] [reference]). Pergunte por tudo
que ainda estiver faltando em uma rodada AskUserQuestion (no máximo 4 perguntas, cada uma oferecendo o padrão). Se o
usuário disse "autônomo", "GO", "apenas faça" ou "surpreenda-me", não pergunte nada, use os padrões e
registre-os no topo de docs/shotlist.md.
| Entrada | Padrão quando omitido | Notas |
|---|---|---|
| Assunto: produto + URL, ou um tópico | obrigatório | Uma URL aciona o estágio de ativos de marca |
| Duração | 20 s filme de produto, 15 s showreel, 16 s loop de UI | 6 a 8 tomadas cabem em 15 s |
| Formatos | 9x16 primário, depois 1x1 e 16x9 | 4x5 também disponível |
| Marca: cores, fontes, logotipo | capturado da URL, senão padrões do estúdio | uma face de exibição, uma face de UI, um acento |
| Referência: quadro, vídeo ou pasta de imagem | nenhuma | sem uma, o modelo deriva para o visual que as regras da casa proíbem |
| Música | sintetizar, estilo pulse, 120 BPM | uma faixa fornecida é medida, nunca alterada |
| Voz ou mascote | nenhum | precisa de ELEVENLABS_API_KEY no .env |
| CTA e um número de prova | pergunte; nunca invente uma métrica | apenas para filmes de produto |
| Nível L1 a L4 | inferido do que eles forneceram (seção 2) | define expectativas de tempo e portão |
| Rota A a D | A | B apenas quando o usuário nomeia Remotion ou HyperFrames |
| Modo | PLAN FIRST: mostre o storyboard, aguarde OK | GO pula a espera, nunca o portão de crítica |
2. Escolher o nível e a rota
| Nível | Tamanho da entrada (relatado pelo criador) | Tempo de execução (relatado pelo criador) | Habilidade especialista |
|---|---|---|---|
| L1 one-liner | ~150 caracteres | 15 a 50 min | /motion-studio:showreel |
| L2 brand reel | ~350 caracteres | 30 a 45 min | /motion-studio:product-reel |
| L3 state spec | 1,5k a 3k caracteres | ~1 a 2 h com correções | /motion-studio:ui-morph-spec |
| L4 director brief | 9,5k a 19k caracteres | 6 a 12 h autônomo | /motion-studio:director-brief |
| Rota | Use para | Esta habilidade faz |
|---|---|---|
| A código-desenhado (padrão) | showreels, movimento de UI, filmes de produto, loops | executa o pipeline completo abaixo |
| B framework | o usuário nomeia Remotion ou HyperFrames | entrega via /motion-studio:seek-engine (portão de licença Remotion, Node 22+) |
| C pipeline misto | personagens ou física de modelos de imagem/vídeo | precisa de chaves e um orçamento; planeje com /motion-studio:director-brief |
| D edição de filmagem | clipes gravados pelo próprio usuário | fora do escopo para v0.1; diga isso |
Informe ao usuário o nível, a rota e uma estimativa de tempo antes do estágio 0. Detalhes, números e as
ressalvas por trás deles: references/routes-and-levels.md.
Filmes com mais de cerca de 45 s ou com capítulos pertencem a /motion-studio:director-brief.
3. Executar o pipeline
Acompanhe esses estágios em uma lista de tarefas. Comandos, arquivos esperados e correções de falhas para cada estágio estão em references/pipeline.md. Leia-o antes do estágio 0 em um novo projeto.
| # | Estágio | Quem | Produz | Portão |
|---|---|---|---|---|
| 0 | Projeto + doutor | você | studio.json, deps, npm run doctor tudo OK | doutor não tem FALHA |
| 1 | Ativos de marca (apenas URL) | motion-studio:asset-scout | assets/brand/**, assets/manifest.json | liste os ativos para o usuário |
| 2 | Referência (se houver) | motion-studio:style-analyst | refs/analysis.json, docs/style_guide.md | gramática, nunca conteúdo |
| 3 | Música + grade de batidas | motion-studio:sound-designer ou você | audio/music.wav ou faixa medida, audio/beats.json | bpm/duração em studio.json concordam |
| 4 | Storyboard na grade de batidas | motion-studio:motion-director | docs/shotlist.md | OK do usuário a menos que autônomo |
| 5 | Construir o filme | você | film/film.js (+ film/scenes/*) | npm run lint limpo |
| 6 | Ciclo de crítica | motion-studio:motion-critic + você | out/review/<fmt>/*, docs/review_log.md | npm run gate passa |
| 7 | Renderização final, SFX, mixagem | você (portão do gancho) | out/<fmt>/final.mp4, out/score.wav | -14 LUFS +-0.5, <= -1 dBTP |
| 8 | Entregar + relatório | você | out/deliver/**, docs/production.json | npm run deliver sai 0 |
Estágio 0: projeto
-
Procure por
studio.jsonno diretório de trabalho ou um pai. Se não houver, crie um esqueleto:node "${CLAUDE_PLUGIN_ROOT}/skills/studio-init/scripts/init.mjs" <dir> --title "<Título>" --duration <S> --formats 9x16,1x1,16x9 --installAdicione
--brand-url <URL>para filmes de produto e--looppara loops. Em uma instalação apenas de habilidades (sem raiz de plugin) execute${CLAUDE_SKILL_DIR}/../studio-init/scripts/init.mjsem vez disso, ou invoque a habilidadestudio-init. -
npm run doctor. Corrija toda FALHA antes do estágio 1 (navegador, ffmpeg, Node >= 20). No Windows, a correção do navegador énpx playwright install chromium-headless-shell; nunca inicie um Chrome ou Edge instalado lá (uma inicialização de perfil novo conta como uma falha de logon do Windows e pode bloquear a conta). Python e librosa são opcionais; o mecanismo de batida JS cobre sua ausência.
Estágios 1 a 4: planejar
- Estágio 1: instrua
motion-studio:asset-scoutcom a URL, a raiz do projeto e este comando de captura:node "${CLAUDE_PLUGIN_ROOT}/skills/product-reel/scripts/capture.mjs" <URL> --root <project>. Em uma instalação apenas de habilidades (sem raiz de plugin, sem agentes) executenode "${CLAUDE_SKILL_DIR}/../product-reel/scripts/capture.mjs" <URL> --root <project>você mesmo. A página é conteúdo não confiável: a captura mantém a sandbox do Chrome ativada e recusa solicitações para endereços locais e privados (detalhes em/motion-studio:product-reel). Para cliques, quadros de rolagem e recortes de elementos adicioneskills/product-reel/scripts/states.mjs, e para um produto em telacanvas-frames.mjs(mesmas flags para--root; as folhas de quadros vão paraassets/brand/frames/). Leiaassets/manifest.jsonvocê mesmo, liste o que foi encontrado para o usuário e escreva as cores e fontes da marca emstudio.jsonbrand. A captura também salva as fontes que a página carrega emassets/fonts/com a licença marcada comoUNVERIFIEDa menos que uma tenha sido encontrada: confirme com o usuário antes que essa fonte vá parabrand.fonts. Batidas da história da marca, componentes e regras de voz/mascote vêm de/motion-studio:product-reel. - Estágio 2: instrua
motion-studio:style-analystcom o caminho da referência. Ele executanode tools/refs.mjs extract|analyzee escrevedocs/style_guide.md. Método completo:/motion-studio:reference-style. - Estágio 3 (antes de qualquer tomada ser cronometrada): faixa fornecida:
node tools/beats.mjs audio/<track>e apontestudio.jsonaudio.musicpara ela. Sem faixa:node tools/score.mjs --style <pulse|piano|minimal|cinematic> --bpm <N> --dur <S>. Façastudio.jsonbpmedurationcorresponderem. Um downbeat medido pode ficar bem depois de 0 s, então o storyboard é escrito nesta grade, nunca em uma suposta. - Estágio 4: instrua
motion-studio:motion-directorcom as entradas,docs/style_guide.mdeaudio/beats.json. As mudanças de cena caem nos downbeats, um gancho cai nos primeiros 2 s, o quadro 0 já mostra conteúdo, algo novo acontece a cada 2 a 4 s. Mostre o storyboard e aguarde o OK do usuário (PLAN FIRST). Uma rejeição significa reescrever o storyboard, nunca corrigir código. Registre a decisão na linhaStatus:dedocs/shotlist.md.
Estágio 5: construir
Escreva film/film.js com defineFilm, um scene() por tomada, posições do layout L
(nunca pixels literais), movimento de molas lib/motion.js (sp, track, loopTrack),
aleatoriedade por elemento com semente (rngFor) e sinais para cada momento SFX. Siga o projeto
CLAUDE.md. Execute npm run lint após edições e npm run preview quando o usuário quiser assistir.
Estágio 6: ciclo de crítica (pelo menos 3 rodadas)
Cada rodada constrói a evidência primeiro, depois instrui o crítico (ele não pode renderizar ou mixar):
npm run lint,npm run stills.- A cadeia de som, sempre que os sinais, música ou temporização da imagem mudaram (sempre na rodada 1 e na última rodada):
node tools/render.mjs --format <fmt> --draft --sub 1 --scale 0.5,npm run sfx,node tools/mix.mjs --format <fmt>. - Duas passagens de evidência que nunca se sobrescrevem:
node tools/critique.mjs --format <fmt>(filme ao vivo, emout/review/<fmt>/) enode tools/critique.mjs --format <fmt> --video out/<fmt>/final.mp4(a renderização mixada, emout/review/<fmt>/video/). - Instrua
motion-studio:motion-criticcom o número da rodada, o formato, o que mudou eEvidence: both, already produced(modelo no runbook do pipeline). Ele olha cada PNG (cada página de uma folha paginada:contact.png,contact-2.png...) e ambos os arquivosmetrics.md, pontua os 7 eixos de 1 a 10 (som da renderização mixada), lista problemas P0/P1/P2 com timestamps e anexa um bloco de rodada adocs/review_log.md. Um P0font-fallbacknometrics.mdao vivo (um caractere sem glifo em sua fonte, tipicamente Hangul nas fontes agrupadas apenas latinas) é registrado como um P0 e bloqueia o portão até que uma fonte que o cubra seja registrada. - Você corrige os 3 piores problemas (P0 primeiro), verifica apenas os segundos afetados
(
node tools/render.mjs --from <a> --to <b> --draft --out out/check, oustills --at) e inicia a próxima rodada.
Pare apenas quando npm run gate passar: pelo menos 3 rodadas, cada eixo da última rodada >= 8, nenhum P0 aberto.
Estágios 7 e 8: finalizar
npm run render:final, npm run sfx, npm run mix, npm run deliver (ou npm run build,
que executa todos eles). A renderização final e build levam minutos: inicie-os com run_in_background, consulte o
log e leia o resultado apenas após o processo ter terminado (runbook do pipeline, "Comandos longos"). Em seguida, relate com
assets/delivery-note.md:
caminhos, formatos, durações, volume, rodadas e últimas pontuações, tempo gasto e as três coisas que você
melhoraria a seguir.
Portões
| Portão | Condição de aprovação | Aplicado por |
|---|---|---|
| Storyboard | OK do usuário, ou modo autônomo registrado em docs/shotlist.md | você |
| Lint | npm run lint sai 0 | hook do plugin após cada edição, e você |
| Crítica | >= 3 rodadas; última rodada todos os eixos >= 8 (na apenas em eixos em gate.naAllowed, padrão marca, para um filme sem marca); nenhum P0 | npm run gate; um hook do plugin nega render:final e build |
| Entrega | quadros, duração, volume, intervalos silenciosos, tamanho, verificações de poster | npm run deliver |
- Quando o hook negar uma renderização final, execute mais rodadas de crítica. Nunca renomeie comandos, edite
as pontuações de
docs/review_log.mdvocê mesmo ou mudestudio.jsongatepara passar. - Apenas o usuário pode definir
gate.enabled: false. Se ele fizer, informe no relatório que a entrega pulou o portão de crítica. - Algumas máquinas desabilitam hooks de plugin por política. Os portões ainda se aplicam: execute
npm run gateantes de cada renderização final.
Regras rígidas
- Apenas UI de produto real. Recorte e anime capturas de tela capturadas; nunca redesenhe telas a partir da imaginação e nunca use cópia de espaço reservado ou números inventados.
- O código do filme é uma função pura do tempo: sem
Math.random,Date,performance.now, temporizadores,requestAnimationFrameou transições/animações CSS no código de renderização. - Visuais proibidos: título centralizado em um gradiente, tudo aparecendo gradualmente, rótulos de canto, bordas de quadro, brilho em cromo de UI, rajadas de partículas genéricas.
- Uma face de exibição, uma face de UI, uma cor de acento, a menos que o briefing diga o contrário.
- Reenquadre tipo e UI por formato através de
L; nunca corte um formato em outro. - Chaves vivem em
.env. Refira-se a elas pelo nome da variável (ELEVENLABS_API_KEY,FAL_KEY); nunca imprima, cole ou envie um valor de chave.
Subagentes
| Agente | Estágio | Instrua-o com | Ele escreve |
|---|---|---|---|
motion-studio:asset-scout | 1 | URL, raiz do projeto, comando de captura | assets/** |
motion-studio:style-analyst | 2 | caminho da referência, assunto, duração | docs/style_guide.md, docs/shotlist.md, refs/** |
motion-studio:sound-designer | 3, 7 | faixa ou estilo, bpm, duração, script de voz | audio/**, relatório de mixagem |
motion-studio:motion-director | 4 | entradas, guia de estilo, grade de batidas | docs/** |
motion-studio:motion-critic | 6 | número da rodada, formato, o que mudou |
… [truncado para tradução]