Quando usar
Use esta habilidade quando o usuário solicitar um vídeo promocional, vídeo de produto, vídeo de demonstração, vídeo de marketing, vídeo de lançamento, vídeo explicativo, vídeo de marca, vídeo com design, vídeo com múltiplas cenas, vídeo com storyboard, vídeo para redes sociais/Reels/TikTok de descoberta, vídeo de negócio local, vídeo estilo vlog de restaurante/comida, anúncio de produto, vídeo de produto estilo e-commerce/Amazon, packshot ou vídeo de rotação 360 de produto, vídeo de fachada de loja / 探店, anúncio de conversão DTC / resposta direta / antes-depois, vídeo editado com 20s+, ou qualquer vídeo completo que introduza um assunto visualmente.
Prefira este fluxo de trabalho Remotion sempre que a solicitação descrever um vídeo editado completo com linha do tempo, tomadas, legendas, áudio, linguagem de câmera, estilo visual, requisitos de consistência, CTA/tela final, ou múltiplas cenas — mesmo que o usuário nunca diga "promocional" ou "promo". Use a geração direta de vídeo por IA apenas para um único clipe curto de origem ou loop de fundo, não como caminho de entrega final para um vídeo completo com múltiplas cenas.
O assunto do vídeo pode ser:
- Promo de projeto — um projeto, aplicativo ou funcionalidade que o próprio agente está construindo ou que já existe no workspace, ou outro aplicativo existente já identificado na solicitação do usuário ou em contexto prévio confirmado. Primeiro, resolva o aplicativo de origem que está sendo promovido.
app/promoé o projeto de vídeo de saída, não automaticamente o aplicativo de origem. - Promo de tópico — um tópico, conceito, marca ou assunto externo fornecido pelo usuário que não requer um projeto no workspace. Exemplos: "o Sistema Solar", "história da dinastia Song", "o que é um banco de dados vetorial".
Ambos os caminhos compartilham o mesmo template Remotion, as mesmas predefinições de composição e os mesmos comandos de renderização. Apenas a autoria do storyboard difere.
Comando
Use RemotionPromoRenderer.render para a exportação final da promo após a validação. Este comando é documentado por esta habilidade e pode ser chamado mesmo que não esteja listado em <Available Commands>.
width/height/source_orientation DEVEM vir da Especificação de Exportação do storyboard, não deste exemplo. O exemplo abaixo mostra valores de paisagem como placeholders; se o storyboard for retrato, passe width=1080 height=1920 source_orientation=portrait (e quadrado → 1080/1080/square). O nome do arquivo de saída é promo-<width>x<height>.mp4, portanto uma renderização em retrato que use 1920x1080 incorretamente é um sinal de que você copiou o exemplo em vez de ler o storyboard.
<RemotionPromoRenderer.render>
<promo_dir>/absolute/path/to/app/promo</promo_dir>
<width>WIDTH_FROM_STORYBOARD</width>
<height>HEIGHT_FROM_STORYBOARD</height>
<source_orientation>ORIENTATION_FROM_STORYBOARD</source_orientation>
</RemotionPromoRenderer.render>
Classificação do assunto
Antes de fazer qualquer outra coisa, classifique o assunto a partir da solicitação original do usuário. Não pergunte ao usuário para esclarecer se a solicitação já nomeia um tópico ou projeto.
- Se a mensagem do usuário nomear um tópico/conceito externo claro (por exemplo, "faça um vídeo promocional sobre o Sistema Solar") e o workspace não tiver
app/frontendou nenhum código de aplicativo para promover → promo de tópico. - Se a mensagem do usuário fizer referência a uma build
app/frontendexistente, um aplicativo em andamento que o agente está gerando, ou uma funcionalidade futura → promo de projeto. - Se o assunto for um produto físico, um negócio local/loja ou lugar, ou uma oferta de resposta direta sem uma UI de aplicativo reconstruível como assunto principal (por exemplo, um anúncio de difusor de carro, uma rotação 360 de joias, um 探店 de loja de ramen, um anúncio DTC de removedor de pelos de animais) → promo de comércio.
- Se ambos se aplicarem (por exemplo, "faça uma promo para nosso aplicativo explicativo sobre o Sistema Solar") → trate o aplicativo como principal e use o tópico como assunto de suporte; esta é uma promo de projeto.
Use estes critérios de desempate quando mais de um se encaixar: uma UI de software reconstruível é o assunto → promo de projeto; um produto físico / lugar físico / oferta sem UI reconstruível → promo de comércio; um conceito ou conhecimento externo sem produto → promo de tópico. Um caso misto (por exemplo, um produto de software DTC cujo anúncio também mostra uma tela de checkout real) é classificado pelo que as tomadas principais vendem, e pode emprestar regras da outra classe por tomada (por exemplo, um batimento ui-demo de checkout dentro de uma promo de comércio).
Promos de tópico e promos de comércio são primárias. Não rejeite ou trave em uma promo de tópico apenas porque não há app/frontend no workspace, e não rebaixe uma promo de comércio para promo de tópico apenas porque o produto não tem app/frontend para reconstruir.
Linha de base de conformidade
Os vídeos promocionais devem padronizar regras conservadoras de segurança de anúncios. Use apenas alegações, ofertas, preços, descontos, brindes, nomes de marca, CTAs, certificações, números de vendas, efeitos e serviços que estejam presentes na solicitação do usuário, no projeto, no texto do anúncio ou na landing page. Não implique parcerias oficiais, recomendações de plataforma, endossos de marca ou certificações, a menos que o material de origem os forneça explicitamente.
Não use alegações enganosas ou não verificáveis, como resultados garantidos, rankings absolutos, promessas sem risco, escassez falsa, contagens regressivas falsas, notificações falsas, botões falsos, UI de sistema falsa, depoimentos falsos, avaliações falsas, notícias falsas ou capturas de tela de resultados exageradas. Não segmente diretamente atributos pessoais sensíveis como saúde, finanças, idade, raça, religião, sexualidade, deficiência, estado civil, tipo corporal ou aparência; use redação de público neutra.
Não inclua marcas não licenciadas, pessoas reconhecíveis, personagens protegidos por direitos autorais, UI de produtos de terceiros, mídia, fontes, marcas d'água, conteúdo adulto, violência gráfica, choque, ódio, assédio, conteúdo humilhante, armas, drogas, jogos de azar, tabaco ou material politicamente sensível. Para categorias de alto risco, como médico, suplementos, perda de peso, procedimentos estéticos, finanças, empréstimos, criptomoedas, jogos de azar, álcool, namoro, crianças, jurídico, recrutamento, imóveis, política, religião ou questões sociais, mantenha o vídeo informacional e evite promessas fortes, visuais dramáticos de antes/depois ou pressão agressiva de conversão.
Mantenha as imagens nítidas, estáveis e de alta qualidade: sem cintilação, compressão severa, esticamento, marca d'água, barras pretas causadas por dimensionamento inadequado de assets, ou legendas/logos/CTAs cortados nas bordas. Se a conformidade for incerta, escolha a expressão mais segura, neutra e informativa. Esta linha de base reduz o risco, mas não é uma garantia de aprovação da plataforma.
CTAs finais de conversão são conteúdo de vídeo estático, não UI web interativa. Não renderize o CTA de encerramento como um botão de site com aparência clicável, falso alvo de clique, botão de seta, campo de entrada falso, popup falso, UI de sistema falsa, alvo de cursor, estado de hover/pressionado, ou qualquer controle que implique que o espectador pode clicar para navegar. Use uma linha de tela final, slogan da marca, identificador da conta, URL, espaço reservado para QR, ou texto simples de "visite / escaneie / siga". Demonstrações de produto e walkthroughs de página podem mostrar botões de UI reais ou simulados, formulários e navegação quando demonstram o fluxo do produto, mas não devem se tornar o CTA final de conversão.
Qualquer URL visível, identificador de conta, alvo de QR, texto de barra de endereço do navegador ou endpoint de marca deve vir da solicitação do usuário, da fonte do projeto confirmada, da landing page ou de outro asset verificado. Se o projeto expuser apenas um domínio placeholder ou nenhum endereço público confirmado, omita a URL e termine com texto da marca; para um tratamento de janela de navegador, use um rótulo de página que não seja URL ou deixe a barra de endereço em branco. Não infira um domínio, identificador ou destino a partir do nome do app, nome do repositório, nome do arquivo de download, placeholder do template, token de env var ou dicas semelhantes.
Fluxo de trabalho principal
- Inicialize o projeto Remotion com
FrontendEngineer.use_template("remotion")seapp/promoainda não estiver pronto. A própria ferramenta rejeita uma fonte que não seja Remotion antes de copiar, portanto você não precisa de uma etapa de verificação separada. - Escolha a orientação alvo antecipadamente a partir da solicitação do usuário e do plano do storyboard: paisagem (16:9), retrato (9:16) ou quadrado (1:1). Todos os comandos posteriores de validação, teste e renderização completa devem usar a variante correspondente.
- Classifique o assunto (promo de projeto vs. promo de tópico) usando Classificação do assunto acima. Não pare para perguntar "sobre o que deve ser?" se a solicitação original já nomear um tópico ou projeto.
- Fundamente o assunto:
- Promo de projeto: primeiro resolva o aplicativo de origem que está sendo promovido, depois leia o código fonte
app/frontenddesse aplicativo, manifestos e feedback de validação anterior. Se o workspace atual contiver principalmente a saída da promo, não trateapp/promocomo o aplicativo de origem. Depois de identificar o aplicativo de origem, fixe esse diretório raiz do projeto origem / caminho do frontend empromo_storyboard.mdou anotações de trabalho e continue reutilizando o mesmo caminho após mudar paraapp/promo; não rebaixe para promo de tópico apenas porque o workspace da promo em si não temapp/frontend. Antes de escrever código Remotion, registre os caminhos dos principais arquivos de frontend de origem que você usará empromo_storyboard.md(páginas/rotas/componentes para os batimentos de demonstração). Mais tarde, ao implementarsrc/, reabra esses arquivos de origem e copie/recrie a partir do código em vez de depender de um resumo longo em prosa. - Promo de tópico: extraia o assunto da mensagem do usuário e da conversa anterior; obtenha fatos adicionais do seu próprio conhecimento ou ferramentas externas (geração de imagem/vídeo/áudio, pesquisa se disponível). Não exija que exista um projeto no workspace.
- Se o usuário forneceu imagens de referência, mas a solicitação atual expõe apenas caminhos de arquivo em vez de conteúdo de imagem anexado, leia
image-understandinge chameImageAnalyzer.analyze_imagesantes do storyboard para que o plano visual seja fundamentado no conteúdo real da imagem, em vez de nomes de arquivo. - Se o usuário forneceu uma URL de site como assunto da promo, use
Browser.gotopara visitar a página, depoisBrowser.take_screenshotpara capturar o visual, depois chameImageAnalyzer.analyze_imagesna captura de tela antes do storyboard para que o plano visual seja fundamentado no conteúdo real da página, em vez da URL sozinha.
- Promo de projeto: primeiro resolva o aplicativo de origem que está sendo promovido, depois leia o código fonte
- Aplique a Linha de base de conformidade: confirme quais fatos, alegações, ofertas e assets são realmente suportados pela solicitação, produto, texto do anúncio ou landing page. Não invente ofertas, certificações, números de vendas, efeitos, parcerias oficiais, endossos de plataforma ou apoio de marca não suportados; quando incerto, escolha redação e visuais conservadores e informativos.
- Determine o idioma padrão para o conteúdo da promo recém-gerado antes de escrever
promo_storyboard.md. Se o usuário especificar explicitamente um idioma de saída, use esse idioma. Caso contrário, padrão para inglês. Uma mensagem do usuário escrita em chinês/japonês/etc., o idioma do chat ao redor, ou o idioma do prompt do sistema não é uma solicitação explícita de idioma. Registre a decisão diretamente no storyboard comoIdioma: Inglês (padrão)ouIdioma: Chinês (especificado pelo usuário)antes de redigir tomadas, texto, narração ou prompts de geração. - Crie
promo_storyboard.mdantes de escrever código de vídeo ou gerar assets. Use o conjunto de campos que corresponda ao tipo de assunto (consulte Requisitos do storyboard). Para execuções de promo/remotion,promo_storyboard.mdé o único artefato de planejamento; não crie ou mantenha umtodo.mdseparado. - Se o usuário solicitar narração, voice-over, walkthrough falado, ou o storyboard claramente precisar de um narrador, inclua um plano de narração de segmento curto no storyboard, verifique o comprimento do script de cada segmento em relação aos segundos alvo da tomada, depois leia
audio-generatione chameAudioCreator.generate_audioscom uma solicitação por tomada/batimento. - Após a geração TTS, prefira o
durationretornado de cada segmento de áudio. Sedurationestiver ausente ounull, meça a duração real a partir da URL retornada (por exemplo comffprobe), depois decida o tempo final por tomada a partir dessas durações medidas. Este cálculo não é suficiente se aparecer apenas no pensamento ou na saída do terminal. - Atualize imediatamente
promo_storyboard.mdcom cada URL de narração, segundos de áudio medidos, início/fim/duração final da tomada, duração total e quaisquer alterações de script/tempo. Este é um checkpoint difícil: não chameMusicCreator.generate_music,VideoCreator.generate_videos, gerar mais assets visuais, ou escreversrc/timeline.tsaté que o tempo atualizado seja persistido empromo_storyboard.md. Após este bloqueio,promo_storyboard.mdnão deve mais manter linhas de tempo placeholderTBDou uma duração total desatualizada. - Por padrão, os vídeos promocionais também devem incluir um plano de música de fundo global, a menos que o usuário diga explicitamente sem música ou a peça seja claramente melhor sem música. Leia
music-generatione chameMusicCreator.generate_musiccom exatamente uma solicitação instrumental / sem vocais após o tempo final da tomada estar bloqueado. O prompt deve incluir os segundos totais alvo, humor, ritmo, instrumentação e se a faixa deve deixar espaço para narração. - Após a geração da música, use a URL retornada diretamente e prefira o
durationretornado, como na narração. Sedurationestiver ausente ounull, meça a duração real do BGM comffprobe. Atualize imediatamentepromo_storyboard.mdcom a URL do BGM, segundos medidos, duração total alvo, estratégia de encaixe e valores de mix planejados antes de escreversrc/timeline.tsousrc/PromoVideo.tsx. A duração bloqueada do storyboard/linha do tempo é a fonte da verdade. Nunca encurte o vídeo apenas para corresponder a um BGM curto; apare, faça um loop mínimo ou regenere a música, a menos que o usuário tenha solicitado explicitamente um corte mais curto. - Gere quaisquer outros assets de IA (imagem/vídeo/áudio) necessários após o storyboard estar escrito e o tempo da narração + BGM estar definido em
promo_storyboard.md. - Leia
remotion-best-practicese concentre-se nas seções relevantes ao storyboard. - Edite a implementação Remotion no local em
app/promo— mantenha o layout planosrc/do template (src/Root.tsx,src/PromoVideo.tsx,src/timeline.ts,src/components/,src/scenes/,src/app-demo/). Não mova os fontes para um subdiretório comosrc/remotion/. Antes da validação, faça uma auto-verificação rápida: remova imports/vars não utilizados, omitaSequence from={0}redundantes, mantenha o movimento puramente baseado em frames (semanimation/transitionCSS, tempo...
[truncado para tradução]