Escritor de Roteiro de Vídeo
Escreva roteiros de vídeo para demonstrações de produtos, tutoriais de funcionalidades e vídeos de lançamento. Lida com ritmo, direções visuais, temporização e comprimentos adequados para cada plataforma.
Resolução de Entrada
Resolva o argumento (se fornecido) nesta ordem:
- Caminho para um briefing de marketing existente (
.mdcontendo "Sumário Executivo" ou "Mensagens-chave") -> briefing de marketing - Caminho para um post de blog existente (
.mdcom estrutura de post de blog) -> post de blog - Caminho para um changelog existente -> changelog
- Caminho para uma newsletter existente -> newsletter
- Corresponde a URL do GitHub ou padrão
#\d+-> PR - Contém
...ou..-> intervalo de refs git - Resolve para arquivo/diretório existente -> funcionalidade do código
- Caso contrário -> texto livre
Se nenhum argumento for fornecido, pergunte: "Sobre o que deve ser o vídeo? Você pode fornecer um briefing de marketing, post de blog, changelog, URL/número de PR, intervalo de refs git, caminho de arquivo/diretório, ou apenas descrever a funcionalidade."
Se múltiplas interpretações coincidirem, confirme com o usuário.
Fluxo do Processo
digraph video_script {
rankdir=TB;
"Resolver entrada" [shape=box];
"Fase 1: Descoberta" [shape=box];
"Fase 2: Configuração" [shape=box];
"Fase 3: Esboço" [shape=box];
"Esboço aprovado?" [shape=diamond];
"Fase 4: Escrever" [shape=box];
"Fase 5: Revisão" [shape=box];
"Aprovado?" [shape=diamond];
"Fase 6: Saída" [shape=box];
"Resolver entrada" -> "Fase 1: Descoberta";
"Fase 1: Descoberta" -> "Fase 2: Configuração";
"Fase 2: Configuração" -> "Fase 3: Esboço";
"Fase 3: Esboço" -> "Esboço aprovado?";
"Esboço aprovado?" -> "Fase 3: Esboço" [label="não, revise"];
"Esboço aprovado?" -> "Fase 4: Escrever" [label="sim"];
"Fase 4: Escrever" -> "Fase 5: Revisão";
"Fase 5: Revisão" -> "Aprovado?";
"Aprovado?" -> "Fase 4: Escrever" [label="revisões"];
"Aprovado?" -> "Fase 6: Saída" [label="sim"];
}
NÃO pule fases. Faça perguntas em um ritmo natural. Se o usuário responder várias de uma vez, aceite respostas agrupadas e pule adiante.
Se o usuário disser "apenas use os padrões" ou similar, escolha padrões razoáveis, declare o que escolheu e peça uma única confirmação.
Fase 1: Descoberta
Passo 1 - Analise a entrada
| Tipo de entrada | O que ler |
|---|---|
| Briefing de marketing | Extrair declaração do problema, proposta de valor, público, mensagens-chave. Pule para o Passo 3. Ainda faça o Passo 2 se o briefing não tiver contexto do produto. |
| Post de blog | Extrair título, pontos principais, público, CTA. Pule para o Passo 3. |
| Changelog | Extrair entradas principais, foque nas mudanças mais impactantes. Pule para o Passo 3. |
| Newsletter | Extrair assunto, principais atualizações, CTA. Pule para o Passo 3. |
| PR | Diff, descrição do PR, comentários de revisão, mensagens de commit. Para PRs grandes (20+ arquivos), foque em mudanças voltadas ao usuário. |
| Refs git | git diff e git log entre as refs. Priorize mudanças voltadas ao usuário. |
| Funcionalidade do código | Leia os arquivos/diretórios especificados. |
| Texto livre | Analise a descrição do usuário. Se faltar detalhes, peça ao usuário para fornecer mais detalhes ou apontar para um arquivo/PR específico. |
Mudanças voltadas ao usuário incluem: novas funcionalidades, mudanças de UI, mudanças de API, melhorias de desempenho, correções de bugs e atualizações de documentação. Mudanças internas incluem: refatorações, adições de testes, mudanças de CI e atualizações de dependências.
Tratamento de erros:
ghnão disponível -> informe o usuário, ofereça entrada alternativa- PR/ref inválido -> peça ao usuário para verificar
- Arquivo não encontrado -> peça o caminho correto
Passo 2 - Leia contexto mais amplo do produto
Leia se existirem: README, docs/, package.json (ou equivalente).
Se nada for encontrado, pergunte: "Você pode descrever brevemente o produto e para quem ele é?"
Passo 3 - Apresente o entendimento
"Aqui está no que basearei o roteiro do vídeo:"
- Funcionalidade A - descrição curta
- Funcionalidade B - descrição curta
"Algo para adicionar, remover ou corrigir?"
NÃO prossiga até que o usuário confirme o escopo.
Passo 4 - Verificação de conteúdo sensível
Antes de prosseguir, verifique por conteúdo potencialmente sensível: patches de segurança, preços internos, credenciais, itens de roadmap não lançados ou conteúdo marcado como confidencial. Sinalize qualquer coisa questionável ao usuário.
Fase 2: Configuração
Faça estas perguntas:
P1 - Duração do vídeo:
- Curta (30-90 segundos) - mídias sociais (Reels, Shorts, TikTok)
- Média (3-5 minutos) - YouTube, demonstrações de produto, tutoriais
P2 - Tipo de roteiro:
- Narração - texto de narração lido sobre gravações de tela/imagens
- Duas colunas - coluna esquerda: direções visuais/ações na tela, coluna direita: narração
- Apresentador - palestrante na câmera, entrega conversacional
P3 - Tom: Leia o conteúdo existente do repositório para detectar a voz. Confirme:
"Com base no seu conteúdo existente, o tom parece [ex.: conversacional e amigável para desenvolvedores]. Devo manter esse ou seguir uma direção diferente?"
Se não houver conteúdo para analisar, pergunte diretamente.
P4 - CTA: Infira do contexto:
- Open source -> "Dê uma estrela no repositório", "Experimente"
- SaaS -> "Inscreva-se grátis", "Inicie seu teste"
- Atualização de funcionalidade -> "Experimente agora", "Veja a documentação"
"Sugiro que o CTA seja: [CTA inferido]. Quer usar esse ou algo diferente?"
Fase 3: Esboço
Gere um esboço estruturado com temporização. Use o template apropriado com base na duração do vídeo:
Curta (30-90 segundos) - 3-4 seções:
## [Título de trabalho] - [duração total]
1. **Gancho** (0:00-0:05) - [abordagem]
- Ponto principal
- Visual: [o que mostrar]
2. **Problema** (0:05-0:15) - [ponto de dor a estabelecer]
- Visual: [o que mostrar]
3. **Solução** (0:15-0:45) - [tutorial da funcionalidade]
- Ponto principal A
- Visual: [o que mostrar]
- Ponto principal B
- Visual: [o que mostrar]
4. **CTA** (0:45-0:60) - [ação a tomar]
- Visual: [tela final]
Total estimado: ~X palavras (~Y segundos a 135 PPM)
Média (3-5 minutos) - 5-8 seções:
## [Título de trabalho] - [duração total]
1. **Gancho** (0:00-0:10) - [abordagem]
- Visual: [o que mostrar]
2. **Problema** (0:10-0:30) - [ponto de dor, contexto, por que isso importa]
- Visual: [o que mostrar]
3. **Visão geral da solução** (0:30-1:00) - [visão geral do que foi construído]
- Visual: [o que mostrar]
4. **Aprofundamento: [Funcionalidade A]** (1:00-2:00) - [tutorial]
- Pontos principais
- Visual: [passos da gravação de tela]
5. **Aprofundamento: [Funcionalidade B]** (2:00-3:00) - [tutorial]
- Pontos principais
- Visual: [passos da gravação de tela]
6. **Aprofundamento: [Funcionalidade C]** (3:00-3:45) - [tutorial]
- Pontos principais
- Visual: [passos da gravação de tela]
7. **Recapitulação** (3:45-4:30) - [resumir benefícios principais]
- Visual: [slide de resumo ou lado a lado]
8. **CTA** (4:30-5:00) - [ação a tomar]
- Visual: [tela final]
Total estimado: ~X palavras (~Y segundos a 135 PPM)
Escalone o número de segmentos de aprofundamento para corresponder às funcionalidades sendo cobertas.
Apresente o esboço e aguarde aprovação antes de escrever.
Fase 4: Escrever
Referência de ritmo
| Duração do vídeo | Palavras alvo | PPM |
|---|---|---|
| 30 segundos | ~65 palavras | 130 |
| 60 segundos | ~135 palavras | 135 |
| 90 segundos | ~200 palavras | 135 |
| 3 minutos | ~400 palavras | 135 |
| 5 minutos | ~675 palavras | 135 |
Alvo de 130-145 PPM para entrega conversacional. Sinalize qualquer seção que exceda seu tempo alocado.
Formato do roteiro por tipo
Roteiro de narração:
## [Título]
### Gancho (0:00-0:05) - ~15 palavras
VISUAL: [Descrição do que está na tela]
[Texto da narração aqui.]
### Nome da seção (0:05-0:20) - ~30 palavras
VISUAL: [Descrição do que está na tela]
[Texto da narração aqui.]
Roteiro de duas colunas:
| Tempo | Visual | Narração |
|---|---|---|
| 0:00-0:05 | [Tela: página inicial carrega] | [Texto da narração] |
| 0:05-0:15 | [Tela: clique no menu de configurações] | [Texto da narração] |
| 0:15-0:30 | [Tela: ativar modo escuro] | [Texto da narração] |
Roteiro com apresentador:
## [Título]
### Gancho (0:00-0:05) - ~15 palavras
CÂMERA: [Apresentador na câmera, plano médio]
[Texto do apresentador aqui. Conversacional, direto para a câmera.]
### Nome da seção (0:05-0:20) - ~30 palavras
CÂMERA: [Corte para gravação de tela]
NARRAÇÃO: [Narração sobre gravação de tela]
CÂMERA: [Volta para o apresentador]
[Texto do apresentador aqui.]
Gancho
Os primeiros 3-5 segundos determinam se os espectadores continuarão assistindo. O gancho deve:
- Abordar um ponto de dor ou fazer uma pergunta provocativa
- NÃO começar com o nome da sua empresa/produto
- NÃO começar com "Neste vídeo, vou mostrar a você..."
- Criar curiosidade imediata ou ressonância emocional
Direções visuais
Sempre inclua direções visuais inline, independentemente do tipo de roteiro:
VISUAL:/TELA:para gravações de tela e imagensCÂMERA:para direções de câmera do apresentador- Seja específico: "TELA: Clique no botão de exportar, mostre PDF baixando" não "TELA: Mostre a funcionalidade"
- Inclua notas de transição entre as cenas
Temporização por seção
Inclua duração estimada e contagem de palavras para cada seção:
### Nome da seção (0:15-0:30) - ~30 palavras- Sinalize se alguma seção exceder seu orçamento de tempo
- A contagem total de palavras do roteiro deve corresponder à duração alvo a 135 PPM
Regras de escrita
- Conversacional, não com som de roteiro. Escreva como as pessoas realmente falam.
- Frases curtas. Máximo de 10-15 palavras por frase.
- Uma ideia por frase.
- Voz ativa sempre.
- Nunca use travessões no conteúdo gerado. Sem caracteres "---". Use vírgulas, dois pontos, pontos finais ou parênteses.
- Mostre, não conte. "Veja como isso carrega rápido" > "Carrega muito rapidamente"
- Para vídeos de formato médio, use a regra de três: três benefícios, três funcionalidades, três exemplos. Para formato curto, foque em um único benefício principal.
CTA
- Últimos 5-10 segundos do vídeo
- Ação única e clara
- Inclua direção visual para a tela final (botão de inscrição, sobreposição de link, código QR)
Fase 5: Revisão
Apresente o roteiro completo com a divisão de temporização:
"Aqui está o roteiro:"
[Roteiro completo]
Divisão de temporização:
- Gancho: 5s (~15 palavras)
- Problema: 10s (~25 palavras)
- Solução: 30s (~70 palavras)
- CTA: 10s (~20 palavras)
- Total: 55s (~130 palavras a 135 PPM)
"Quer alguma alteração?"
Aguarde aprovação. Só prossiga para a saída quando o usuário confirmar.
Fase 6: Saída
Sempre imprima o roteiro final aprovado no terminal.
Depois pergunte: "Quer que eu salve isso em scripts/<slug>.md? Ou um caminho diferente?"
Crie o diretório se não existir. Se o arquivo já existir, pergunte se deve sobrescrever ou criar uma cópia versionada.
Tratamento de Erros
ghnão disponível -> informe o usuário, ofereça entrada alternativa- PR/ref inválido -> peça ao usuário para verificar
- Sem contexto do produto -> peça ao usuário para descrever o produto
- Roteiro excede duração alvo -> sinalize e sugira cortes antes da revisão
O que esta habilidade NÃO faz
- Gravar ou editar vídeo
- Gerar miniaturas ou assets visuais
- Criar animações ou motion graphics
- Escrever posts de blog ou cópia para redes sociais (use
/blog-postou/social-copy)