Produção de vídeo Remotion
Transforme material de origem em um vídeo coerente e editável. Crie o vídeo em React; renderize a partir da mídia salva. Siga as etapas abaixo, adaptando-se às instruções do usuário e ao projeto existente. Mantenha um breve registro de produção para que outro agente possa continuar sem reconstruir decisões.
1. Inspecione o briefing, os ativos e as capacidades
Identifique o público, a mensagem desejada, o formato de entrega, o tom e os ativos disponíveis. Distinga fatos da fonte, interpretação editorial e informações não resolvidas; não invente etapas factuais, capacidades ou resultados ausentes. Extraia ativos inline grandes antes de ler o documento para o contexto. Retenha um mapeamento fonte-para-cena no projeto de produção.
Inspecione imagens e gravações relevantes, não apenas nomes de arquivo. Observe enquadramento, rótulos incorporados, som e ações realmente visíveis. Verifique se este agente pode inspecionar imagens, ouvir áudio, executar código e fornecer uma prévia acessível ao usuário. A falta de capacidade perceptiva requer o fallback em references/runtime.md; um script não pode determinar essas capacidades do modelo nem substituir o julgamento humano.
Para um projeto Node existente, opcionalmente execute node <skill-dir>/scripts/doctor.mjs <project-dir>. Ele inventaria dependências; não comprova prontidão para renderização. Use o gerenciador de pacotes e o arquivo de lock do projeto. Siga a prática recomendada atual do Remotion quando disponível, caso contrário, a documentação oficial.
2. Proponha uma direção e esclareça apenas incertezas significativas
Dê uma direção recomendada: público/mensagem, duração aproximada e proporção de aspecto, progressão de cenas, tom visual e abordagem de narração. Explique como a fonte e o propósito de visualização a informaram. Para escolhas de estrutura e estilo, use references/editorial.md.
Faça um pequeno número de perguntas focadas quando as respostas mudariam o conteúdo factual, o público, a direção ou o uso de ativos indisponíveis. Não repita perguntas já respondidas nem exija um questionário para cada trabalho. Continue o trabalho independente enquanto espera; fatos essenciais não resolvidos não devem ser inventados. Se preferências opcionais permanecerem não especificadas, declare suposições razoáveis e prossiga dentro da autorização do usuário.
3. Escreva um storyboard compacto
Para cada cena, registre seu propósito, evidência da fonte, palavras faladas, ênfase na tela, visual/movimento pretendido e duração aproximada. Mantenha a narração distinta de cabeçalhos e legendas. Liste fatos não resolvidos separadamente. Trate o storyboard como um documento editorial, não uma nova linguagem de programação. Teste uma sequência representativa no início se a direção visual ou de áudio for incerta.
4. Prepare a mídia e a medição de tempo
Dê a cada tipo de mídia um adaptador apropriado. Uma solicitação de fala e uma solicitação de geração de vídeo não precisam compartilhar uma forma de entrada. Normalize seus resultados para arquivos salvos e metadados úteis, incluindo duração, dimensões, configurações de geração, proveniência e atribuição necessária quando relevante.
Resolva a geração de mídia antes de visualizar ou renderizar. Armazene em cache as saídas pelo conteúdo de entrada e configurações efetivas do provedor, e verifique os arquivos em cache. Não acione geração paga ou não determinística a partir de funções de renderização React ou avaliação de metadados.
Para narração, mantenha o texto de exibição separado do texto de pronúncia quando necessário. Meça a duração real do áudio e, em seguida, permita tempo suficiente para que a imagem e o texto associados sejam compreendidos. Use tempo de frase ou sentença quando isso for suficiente. Destaque de palavras requer timestamps ou alinhamento confiáveis; distribuir caracteres uniformemente não é alinhamento preciso.
Para gravações existentes, preserve ou apare deliberadamente o som original e derive legendas a partir de uma transcrição ou transcrição. Considere deslocamentos de cena, lead-in de áudio, pausas e transições sobrepostas. Use references/pipeline.md para contratos de adaptador, tempo, cache e revisão. Os helpers opcionais incluídos extraem imagens inline e validam intervalos de legenda; uso e limitações estão em references/runtime.md.
5. Implemente em React/TypeScript comum
Reutilize componentes pequenos para tratamentos recorrentes e permita React arbitrário para cenas específicas do assunto. Os dados podem conter texto, caminhos de mídia, tempo, referências de fonte e tokens de design. Introduza um esquema de template apenas quando a saída repetida de um formato conhecido o justificar. Não crie um interpretador de linha do tempo geral, registro de plugin ou serviço de orquestração para um vídeo local.
Conduza o movimento a partir de números de frame; evite timers de parede e aleatoriedade não controlada. Carregue fontes e ativos necessários localmente. O estilo pode alterar tipografia, composição, movimento, texto de ênfase, ritmo e áudio; alterar apenas uma paleta não é uma mudança de estilo completa. Reutilize mídia e tempo aprovados quando apenas a apresentação mudar.
Execute verificações focadas de tipo, ativo, duração e legenda. Use o check-captions.mjs incluído apenas para seu contrato de tempo documentado. Testes pertencem em torno de lógica reutilizável de tempo/importação/cache, não em cada decisão cosmética. Prefira componentes existentes e mudanças pequenas e verificadas quando o agente tiver capacidade limitada de codificação.
6. Visualize antes de gastar tempo na exportação final
Prefira o Remotion Studio quando o usuário puder acessá-lo. Mostre a composição e explique o que precisa de revisão: fidelidade à fonte, estilo, corte de texto/assunto, legibilidade de legendas, movimento e som. Inspecione cenas representativas, limites e o final você mesmo quando suportado. Quando o usuário solicitou revisão antes da exportação, forneça a prévia e aguarde essa revisão antes da exportação final. Aprovação existente ou uma solicitação explícita para renderizar pode autorizar a continuação; não adicione uma barreira de confirmação incondicional.
Se o Studio interativo estiver indisponível, produza stills representativos e, quando movimento/áudio precisar de revisão, um rascunho curto de baixa resolução. A URL localhost de um ambiente remoto pode ser inacessível ao usuário; entregue uma prévia acessível ou artefato local. Stills não estabelecem qualidade de movimento ou áudio. Aplique os fallbacks de revisão humana em references/runtime.md e relate exatamente o que foi e não foi revisado.
7. Exporte, verifique e entregue
Após qualquer revisão solicitada estar completa, use o Remotion CLI instalado do projeto para exportação de rotina. Veja references/runtime.md para comandos npx. Use a API de renderização apenas quando a integração programática ou o loteamento o justificar. Preserve edições do usuário e regenere apenas mídia afetada ao revisar.
Verifique as dimensões do arquivo exportado, taxa de quadros, duração, presença de áudio, primeiro/último quadro, mudanças de legenda e limites de cena. Reproduza o resultado completo quando a revisão perceptiva estiver disponível; caso contrário, identifique a revisão humana restante. Uma renderização ou decodificação de áudio bem-sucedida não estabelece qualidade editorial, pronúncia correta ou uma mixagem agradável. Revisão de prévia e verificação de arquivo final são evidências separadas.
Entregue o projeto editável, local da prévia/exportação, comandos de reprodução e um status conciso: implementado, prévia verificada, usuário revisou, exportado, arquivo final verificado. Reivindique apenas estágios concluídos. Mantenha o registro de produção junto com a produção.
Mantenha a orientação reutilizável independente das produções
Skills e exemplos distribuíveis devem ser autocontidos e neutros em relação ao assunto. Mantenha texto de fonte privado, imagens, áudio, nomes, links, identificadores, caminhos de arquivo e instruções específicas da produção no projeto de produção. Não os inclua em uma skill reutilizável, seus metadados, referências, fixtures ou ativos. Use exemplos recém-inventados se um exemplo for necessário.
Documente métodos e critérios de decisão aprendidos a partir de uma produção sem codificar seu assunto como um requisito universal. Verifique o conteúdo real do pacote da skill antes de compartilhá-lo ou instalá-lo.