Vídeo demo de navegador
Você escreve o script do vídeo como código, então as tomadas são repetíveis: uma mudança de voz ou um rótulo corrigido significa uma regravação automática, não uma regravação manual. O pipeline:
script.cjs ──tts.cjs──▶ audio/*.wav + durations.json
│ │
└──────────record.cjs◀───────────┘ Chrome + overlay, CDP screencast → takes/<target>/frames + timeline.json
│
post.py ──▶ MP4 (cortes removidos, narração + sons de clique, −16 LUFS, capítulos)
│
review.py ──▶ folhas de contato + verificação de volume/capítulos → você inspeciona, então entrega
Engine: scripts/ nesta skill. Projeto por vídeo: ~/Movies/Demos/<slug>/ (nunca /tmp, que é limpo), contendo video.config.cjs, script.cjs, audio/ e takes/. Exemplo executável: examples/hello-orders/ (uma pequena página incorporada em um shell hospedeiro; use para verificar sua configuração). Leia references/lessons.md antes da primeira tomada.
Requisitos: Chrome, Node com Playwright (record.cjs o encontra, ou defina playwright na configuração), ffmpeg/ffprobe, Python 3 e a CLI da AWS para Polly.
1. Acorde o vídeo (antes de qualquer código)
Confirme e proponha um esboço ao qual o usuário possa reagir:
- Público-alvo. Vídeos internos cobrem papéis, permissões, controles e limites conhecidos, e terminam com um capítulo "Coisas a saber". Vídeos para liderança e clientes cobrem resultados e apenas o caminho feliz.
- O fluxo completo, como capítulos, e a duração alvo. Cerca de 10 a 12 minutos funcionaram para um mergulho interno.
- Onde gravar (decisão). O walkthrough clica em botões reais e escreve estado real, então nunca executa em dados reais e compartilhados. Recomende uma cópia, um workspace de teste ou um ambiente de desenvolvimento com dados realistas, além de uma maneira de redefini-lo entre tomadas. Se criar essa cópia escreve em produção, precisa de um sim explícito.
- Identidades (decisão). Se o fluxo precisa de duas pessoas (criador e revisor), um colega de equipe real faz login em uma segunda janela, ou uma pessoa faz ambos os papéis e o vídeo diz isso na tela. Nunca crie usuários ou lide com senhas; se uma conta de teste for necessária, o usuário a cria.
- Voz (decisão). O padrão é Polly generativa "Amy" (en-GB), que se saiu bem com espectadores reais. Ofereça uma amostra de ~30 s de cada voz candidata antes de gerar tudo:
aws polly synthesize-speech --profile <dev profile> --region eu-west-2 --engine generative --voice-id Amy --output-format mp3 --text "<passagem com o jargão do produto>" sample-Amy.mp3Use uma conta AWS não produtiva. O macOSsayfunciona offline, mas soa sintético. A própria voz do usuário é a opção mais natural. - Enquadramento. Apenas o produto está no quadro: sem painéis laterais do host, listas ou banners. Configure isso no hook
setupda configuração.
2. Configure o projeto
P=~/Movies/Demos/<slug>; K=~/.claude/skills/browser-demo-video
mkdir -p "$P" && cp $K/templates/video.config.cjs $K/templates/script.cjs "$P"/
Em video.config.cjs, preencha: a url do ambiente descartável, frame se o produto roda em um iframe, ready, setup (enquadramento), theme (cor de destaque do produto e rodapé), voice e helpers.waitLoaded (o sinal de carregamento do produto).
Mapeie a interface antes de escrever os passos. Abra-a, liste seletores estáveis (ids, roles, data-*, texto visível) e anote carregamentos lentos. Prefira seletores baseados em texto exibido (tr:has-text("-1.250,00") [data-resolve]) em vez de chaves geradas.
3. Escreva o roteiro da cena
Cada passo tem { id, chapter?, pre?, say?, act?, gap? }. A API h está documentada no topo de templates/script.cjs.
- Narração dita o tempo.
actexecuta enquanto o clipe toca, eh.at(0.6)alinha uma segunda ação com as palavras. Mantenha cadasayem uma ou duas frases faladas. - Escreva números como são falados ("noventa e sete por cento", "catorze de setembro").
- Use decisões reais de usuários reais onde existirem, para que os números na tela correspondam ao que a equipe conhece.
- Coloque um cartão de capítulo (
h.card) antes de cada capítulo, e adicione anéis com rótulos de 3 a 6 palavras. Usenote()apenas onde um ponto precisa ser destacado, como uma propriedade de segurança, uma ressalva ou "no uso real…". - Envolva cada carregamento lento em
h.cut(() => h.waitLoaded(), 'Carregando …'). Esse intervalo é removido na pós-produção. - Diga cada simplificação na tela e na narração. Por exemplo, uma pessoa faz dois papéis: mostre o controle bloqueando, mostre a configuração sendo alterada "apenas para esta gravação", então explique o que acontece no uso real.
- Aponte para downloads; não clique neles (veja lições).
4. Gere a narração
node $K/scripts/tts.cjs "$P". Apenas linhas alteradas são regeneradas. Claude não pode ouvir o resultado, então nomeie as palavras arriscadas (siglas, nomes) e peça ao usuário para verificá-las. Com macOS say, soletre siglas como letras ("S A P").
5. Teste, faça login e grave
- Teste. Aponte
TARGET=previewcompreviewUrlpara uma build local, se existir. Caso contrário, execute segmentos curtos no ambiente descartável:ONLY='^(c1|load0|where1)$' node $K/scripts/record.cjs "$P" record. Verifique alguns quadros com a ferramenta Read (takes/prod/frames/*.jpg,failure.pngem erros) e verifique com ffprobe se os quadros são 1920×1080. Redefina o ambiente depois. - Faça login. Execute
node $K/scripts/record.cjs "$P" logincomrun_in_background. O usuário faz login na janela que abrir e a fecha. Se ele disser que terminou mas a janela ainda estiver aberta,pkill -INT -f "record.cjs.* login". - Tomada completa. Redefina o ambiente, então execute
node $K/scripts/record.cjs "$P" recordcomrun_in_background. Antes de começar, informe ao usuário que leva aproximadamente a duração da narração mais um terço, em uma janela visível do Chrome que ele não deve clicar. Aguarde a notificação de conclusão; não faça polling com sleep. Verifique o log para cada passooke nenhuma linhaFAILEDouCRASHED.
6. Monte e revise
python3 $K/scripts/post.py "$P/takes/prod" "$P/takes/prod/walkthrough.mp4" # run_in_background; ~10 min para um vídeo de 10 min
python3 $K/scripts/review.py "$P/takes/prod" "$P/takes/prod/walkthrough.mp4" "$P/review" # opcional: step_id:0.8 picks
Leia cada folha review/s*.jpg. Procure por rótulos cortados ou sobrepostos, anéis no elemento errado, estados de carregamento que não foram cortados e sobreposições restantes. O volume deve estar em torno de −16 LUFS, e a contagem de capítulos deve corresponder ao roteiro. Corrija problemas no roteiro, redefina o ambiente e faça uma nova tomada. Novas tomadas são baratas.
7. Entregue e limpe
- Entregue. Copie o vídeo para
$P/<slug>.mp4e executeopen. Se uma versão anterior existir, mantenha-a renomeada (por exemplo,antigo-<voz>-<slug>.mp4), não sobrescrita. - Relate. Forneça a duração, resolução, capítulos, a voz, onde foi gravado, cada simplificação mostrada, o que você não pôde verificar (o áudio) e quaisquer falhas visuais restantes.
- Pergunte antes de limpar. Obtenha a autorização do usuário antes de remover a cópia descartável ou o ambiente, e antes de deletar
takes/(quadros consomem GBs). Mantenhascript.cjs, a configuração eaudio/para que o vídeo possa ser regravado depois. - Registre. Se o trabalho pertence a um ticket ou arquivo de notas, anote a localização do vídeo lá e que a exclusão da cópia está pendente. Faça commit apenas desse arquivo.