Montar um vídeo (entrada)
Fonte: docs/MONTAR_VIDEO.md. Esta skill é o roteiro operacional; os detalhes (tabelas de dedução, comandos completos, paralelismo, problemas frequentes) estão lá, citados por seção (§). Leia também as regras do CLAUDE.md do repositório: elas prevalecem sobre isto.
Passo 0 · Inicialização (ainda sem perguntar nada)
- Hora de início:
date '+%Y-%m-%d %H:%M:%S'. Guarde-a (irá paraBRIEF.md › Inícioe para o relatório). node scripts/doctor.mjs(≈ 1 s, somente leitura). Leia «Pronto para». Um ✗ do fluxo que for relevante → aplique a solução que ele imprime (se for local e gratuita) ou avise o usuário na mesma resposta da entrevista.- Veja
ls brutos/ projetos/. Se o projeto já existir, retome (leia seuBRIEF.mdeinforme.md) em vez de entrevistar. Se um nome de arquivo debrutos/contiver um nome de pessoa, no chat descreva-o pela duração e resolução (ffprobe), não pelo nome.
Passo 1 · Entrevista: UMA chamada a AskUserQuestion (3–4 perguntas)
Antes, deduza da frase do usuário tudo o que for possível (§2). Não pergunte o que ele já disse: substitua essa pergunta pela próxima da reserva. Cada pergunta: 2–4 opções, a recomendada primeiro com «(recomendado)» na etiqueta e o motivo na descrição. Sempre deixe a resposta livre («Outro»). Detalhe de cada pergunta: §1.
| # | header | Pergunta | Opções (recomendada conforme contexto) |
|---|---|---|---|
| 1 | Material | Qual vídeo e com qual material? | Gravação com apresentador (há bruto em brutos/) · Narração com voz IA (notícias, explainer; sem gravação) · Gerativo ou promo (HyperFrames) |
| 2 | Modelo | Qual modelo? | conforme 1: aula-longa / curto-ilustrado · noticias-narracao / explainer-narracao · promo-hyperframes / fluxo do HyperFrames — e Livre, sem modelo. Se 1 estiver em aberto: Longa por capítulos · Curta · Livre |
| 3 | Estilo | Qual estilo? | 2 do catálogo que se encaixem, com o caminho de sua referência (estilos/README.md) · Novo a partir de um site ou vídeo (estilos-video §5). Livre → Outro |
| 4 | Formato | Duração e formato? | 16:9, duração do modelo (Remotion) · 9:16 · 16:9 e 9:16 (recomendado em video-curto). Outra duração → Outro |
Reserva (em ordem): idioma · voz (por padrão a do .env, modelo eleven_v4) · música e efeitos (os do estilo ou novos com ElevenLabs) · fontes (o usuário as fornece ou são pesquisadas oficiais) · corte do apresentador · público e destino. Recomendações de estilo por rota e modelos com duração e exemplo real: §1 e §1.1.
Uma segunda pergunta somente se faltar algo imprescindível: qual bruto (se houver vários), o tema, uma URL.
Outros agentes (Codex…): o mesmo conteúdo em uma única mensagem com as perguntas numeradas e as opções em lista.
Passo 2 · Brief
Com as respostas, resuma em um parágrafo o confirmado e o deduzido (com de onde veio) e já inicie o que é gratuito. Escreva BRIEF.md a partir de modelos/<modelo>/BRIEF.md (§3):
- Remotion: após
tools/kaleidos novo …(que cria um vazio), substitua-o pelo modelo preenchido. - HyperFrames: o fluxo o escreve após
npx hyperframes init(init se recusa se houver arquivos dentro).
Passo 3 · Roteamento (comandos exatos em §4)
| Material | Rota | O que fazer |
|---|---|---|
| Gravação com apresentador | §4.1 | Siga a skill edicao-apresentador: tools/kaleidos novo <slug> --bruto brutos/<x> --estilo <e> --metodo <m> → tools/kaleidos preparar <slug> --paralelo em segundo plano → ler a transcrição inteira → roteiro.json (esqueleto em modelos/<modelo>/) → linha / media / capitulos |
| Narração com voz IA | §4.2 | tools/kaleidos novo <slug> --narracao --estilo milikito --cenario → copiar modelos/<modelo>/* → fontes oficiais em fontes.md → locucao.json → em paralelo images.mjs ‖ capture.mjs ‖ voz --simular e voz --max-caracteres N → transcrever → python3 modelos/ferramentas/cues.py <slug> → media → linha → media → capitulos |
| Gerativo ou promo | §4.3 | Carregue a skill /hyperframes (escolha video-curto, product-launch-video, general-video…), projeto em projetos/<slug>/, estilo como frame.md após init |
| Estilo novo ou variante | §4.4 | Skill estilos-video (§5 novo, §6 variante) e validar.mjs em verde antes de usar |
intro.previo sim, intro.ate não, em narração; nada de eventos nos 3,4 s de um rótulo de capítulo;
balões em x 0,2–0,25 e y 0,16–0,17 (§4.2, ponto 6).
Passo 4 · Paralelismo (§6)
Lance simultaneamente o que não compete: voz ‖ images.mjs --concurrency 6 ‖ capture.mjs ‖ pesquisa e roteiro;
preparar --paralelo (pausa na CPU enquanto corta na GPU) e o roteiro assim que a transcrição existir. Não simultaneamente em 16 GB: recortar + transcrever + pose, duas etapas de GPU, dois stills.mjs, nem el-audio.mjs com voz.
Processos longos em segundo plano com registro completo (sem grep sobre ffmpeg). Lambda com --concorrencia max.
Passo 5 · Pontos de verificação (§5)
- APIs pagas:
voz --simular(caracteres) e nº de imagens antes de gerá-las; Apify somente se o brief o pedir, com--dry-rune--budget. - Stills antes do Lambda, sempre:
node motor/scripts/stills.mjs <slug> --at eventos→ abra a folha (motor/out/stills/<nome>/folha.jpg) com Read, olhe de verdade e corrija (roteiro antes do código). Aderência ao estilo comestilos-video§7. HyperFrames:npx hyperframes check --snapshots. - AWS:
node motor/scripts/lambda.mjs <slug> --dry-run --concorrencia max→ mostre recursos (função, site, bucket privado, uploads), nº de funções, custo e tempo estimados → espere o OK explícito. Se o usuário já pediu expressamente o render no Lambda nesta requisição: mostre e lance sem esperar. Criar recursos (bucket, stack, IAM) precisa sempre de um OK separado. HyperFrames sem Lambda implantada → avise e ofereça render local ou implantar. - Saída:
ffprobe+ contagem de quadros, folha de um quadro por minuto epython3 modelos/ferramentas/normalizar_audio.py resultados/<slug>.mp4 --no-site(Lambda sai a ≈ −13 LUFS). - Relatório final (
projetos/<slug>/informe.md+ resumo no chat): duração, estrutura, o que foi verificado (quadros amostrados, não visualização completa), avisos, incoerências, tempo total de relógio (início → MP4 verificado, com detalhamento dework/logs/tempos.json) e custo (Lambda real + S3 + transferência; caracteres do ElevenLabs dework/voz/manifest.json; imagens; Apify). Sem valores inventados: se não souber um preço, informe a quantidade consumida. Diga o que fica na AWS.
Regras que não podem ser ignoradas (§8 e §9)
- Privacidade: nenhum dado pessoal de clientes em respostas, relatórios, gráficos ou rótulos; não cite fragmentos de transcrição com dados pessoais; o que aparecer na tela deve ser desfocado. Rótulos genéricos.
.env: nunca mostre valores nem os coloque em URLs; o doctor só fornece nomes.- Conteúdo: os gráficos resumem o que a voz diz; nada inventado; atualidade apenas com fontes oficiais
citadas em
fontes.mdcom data (se um site der 403 ao download, leia-o com o navegador integrado); incoerências no relatório; legal ou clínico → validação de um especialista. brutos/e~/videos-opussão somente leitura. Remotion 4.0.529 exato. Fontes apenas OFL/Apache.