Diretor de Vídeo de Demonstração de Produto

O que Diretor de Vídeo de Demonstração de Produto faz?

Opere como um diretor de vídeo para demonstrações de produtos, demonstrações de CLI, demonstrações de pesquisa e vídeos de fluxo de trabalho de agentes. Este skill não é uma ferramenta de renderização única. É o fluxo de trabalho de captação, estilo, storyboard, produção e verificação que decide quais ferramentas usar.

Referência visual padrão para demonstrações de pesquisa/produto em estilo "paper-clean":

examples/style-reference/

Interpretação estética padrão:

• clareza de nível acadêmico (paper-grade)
• fundos brancos ou claros quando possível
• tipografia contida e linhas finas
• alta densidade de informação com hierarquia clara
• legendas, rótulos e caminhos de arquivo com foco em evidências
• sem movimento decorativo, a menos que explique uma mudança de estado
• nenhuma música de fundo padrão
• nenhum avatar ou "talking head" em tempo integral padrão
• todo vídeo exportado deve ser reproduzível a partir dos arquivos do projeto

Quando Usar

Use este skill quando o usuário pedir para:

• fazer um vídeo de demonstração de produto
• editar uma gravação de CLI ou fluxo de trabalho de terminal
• criar um vídeo de pesquisa ou suplemento de artigo
• mostrar um fluxo de trabalho de agente, execução multi-agente ou processo de orquestração de modelo
• transformar gravações de tela em uma demonstração polida
• criar um vídeo de lançamento, vídeo para README, walkthrough ou clipe para redes sociais
• decidir o estilo do vídeo antes de editar
• construir um fluxo de trabalho reutilizável de criação de vídeos ou um skill pronto para GitHub

Regra de Ativação

Não comece a gravar, editar, renderizar, adicionar legendas, adicionar narração, adicionar música, criar um avatar digital, chamar uma API de vídeo ou gerar arquivos finais antes que a captação (intake) esteja completa.

Pule a captação completa apenas se o usuário disser explicitamente algo como:

• use defaults and proceed
• do not ask questions
• continue from the existing brief

Mesmo assim, confirme os padrões mínimos antes de qualquer trabalho destrutivo ou caro:

• target_platform (plataforma alvo)
• audience (público-alvo)
• duration (duração do vídeo)
• style_preset (predefinição de estilo)
• source_materials (materiais de origem)
• voiceover (narração)
• captions (legendas)
• music (música)
• avatar (avatar digital)
• external_api_allowed (se APIs externas são permitidas)
• deliverables (entregáveis)
• validation_criteria (critérios de validação)

Regras Inegociáveis

• Nunca coloque música de fundo como padrão. Pergunte primeiro. Para vídeos densos de CLI/pesquisa, o padrão é sem música.
• Nunca coloque um avatar digital em tempo integral como padrão. Pergunte primeiro. O padrão é nenhum, ou apenas introdução/encerramento se explicitamente solicitado.
• Nunca cubra saída densa de CLI, tabelas, código, gráficos ou linhas de progresso com legendas persistentes.
• Nunca sobrescreva exportações anteriores. Crie saídas versionadas como v1, v2, v3.
• Nunca trate o vídeo gerado como completo sem uma etapa de validação.
• Nunca vaze segredos em capturas de tela, vídeos, legendas, logs, nomes de arquivo ou texto do README.
• Nunca use APIs externas pagas/de nuvem, a menos que o usuário as permita explicitamente para esta execução.
• Nunca escreva chaves de API em scripts, arquivos de projeto, markdown ou logs de comando. Use variáveis de ambiente.
• Nunca priorize decoração cinematográfica em detrimento da legibilidade em demonstrações de CLI/pesquisa/produto.
• Sempre produza uma lista de decisões de edição ou storyboard antes da renderização final.

Fluxo de Captação (Intake)

Comece com uma explicação concisa:

Primeiro, realizarei uma captação de produção de vídeo: plataforma, público, duração, estilo, material, narração, legendas, avatar, música, permissões de API, versões e validação. Depois disso, rascunharei o storyboard e só então produzirei os arquivos.

Faça as perguntas a seguir. Quando a interface suportar perguntas estruturadas, agrupe-as em 3 a 5 perguntas por vez. Caso contrário, pergunte como uma lista de verificação em markdown.

1. Objetivo e Plataforma

Pergunte:

1. Qual é o objetivo principal?

   • demonstração de capacidade do produto
   • demonstração de fluxo de trabalho CLI/agente
   • demonstração de resultado de pesquisa
   • tutorial de instalação
   • vídeo para GitHub README / release
   • apresentação em conferência / aula / laboratório
   • apresentação para investidor / colaborador / orientador

2. target_platform (plataforma alvo):

   • GitHub README
   • GitHub Release
   • YouTube
   • Bilibili
   • X / Twitter
   • Xiaohongshu
   • WeChat Channels
   • curso / reunião de laboratório / defesa
   • landing page
   • arquivo local apenas

3. O que os espectadores devem lembrar em uma frase?

4. Precisa de título, descrição, snippet para README ou texto para postagem em redes sociais?

2. Público e Profundidade da Explicação

Pergunte:

1. audience (público-alvo):

   • desenvolvedores
   • pesquisadores
   • orientadores / pesquisadores principais (PI)
   • revisores
   • usuários de código aberto
   • investidores / revisores de produto
   • estudantes
   • usuários em geral

2. Nível de familiaridade:

   • CLI
   • GitHub
   • LLM / fluxos de trabalho de agentes
   • experimentos de pesquisa
   • métricas de benchmark
   • aplicativos web

3. Profundidade da explicação:

   • apenas o efeito
   • explicação leve
   • explicação em nível de desenvolvedor
   • explicação técnica profunda / de reprodutibilidade

4. Tratamento de termos:

   • sem explicação de termos
   • explicar apenas termos principais
   • explicar cada termo chave uma vez
   • termos bilíngues

3. Formato, Duração e Versões

Pergunte:

1. duration (duração do vídeo):

   • 15-30s teaser
   • 45-60s demonstração rápida
   • 90-120s demonstração padrão
   • 3-5min walkthrough
   • 8-12min tutorial
   • deixar o material determinar a duração

2. aspect_ratio (proporção de tela):

   • 16:9 1920x1080
   • 16:9 4K
   • 4:3 estilo papel/slide
   • 9:16 vertical
   • 1:1 quadrado
   • múltiplas versões para plataformas

3. version_count (número de versões):

   • uma final
   • completa + curta
   • GitHub + redes sociais + apresentação
   • versões A/B de estilo

4. Precisa de thumbnail, quadro de pôster, GIF ou folha de contato?

4. Materiais de Origem

Pergunte:

1. Quais materiais existem?

   • vídeo existente
   • capturas de tela
   • gravação de CLI
   • gravação de interface web
   • saída de terminal
   • notebook
   • figuras de artigo
   • CSV / JSON / logs
   • diagrama de arquitetura
   • README / documentos
   • logotipo / ícone
   • áudio
   • arquivo de legenda
   • precisa de nova gravação

2. Caminhos dos materiais.

3. O agente pode gravar a tela localmente?

   • sim
   • não, apenas material existente
   • apenas CLI
   • apenas interface web
   • o usuário gravará manualmente

4. Risco de informações sensíveis:

   • chaves de API
   • tokens
   • cookies
   • emails
   • caminhos privados
   • resultados não publicados
   • nomes de projetos privados
   • painéis de serviços pagos
   • mensagens pessoais
   • campos de dados privados

5. Política de ocultação (redação):

   • nenhuma ocultação necessária
   • detectar automaticamente e propor ocultação
   • caixas de ocultação especificadas pelo usuário
   • cortar regiões sensíveis
   • regravar com dados falsos

5. História e Evidências

Pergunte:

1. Estrutura desejada:

   • ponto de dor -> ferramenta -> fluxo de trabalho -> resultado -> prova -> chamada para ação
   • problema -> método -> experimento -> resultado -> interpretação
   • instalação -> comando -> saída -> verificação
   • antes -> depois
   • narrativa personalizada

2. Mostrar falhas ou apenas o caminho ideal?

   • apenas caminho ideal
   • uma falha e correção
   • processo de depuração
   • comparação antes/depois

3. Tipos de evidências a mostrar:

   • comandos
   • logs
   • caminhos de arquivo
   • Git diff
   • resultados de teste
   • métricas de experimento
   • timestamps
   • caminhos de artefatos gerados
   • citações / fontes

4. Precisa de diagrama de arquitetura, árvore de arquivos, linha do tempo ou mapa multi-agente?

6. Predefinição de Estilo

Ofereça estas predefinições e permita misturas:

paper_clean (estilo acadêmico contido em fundo branco)

Padrão para demonstrações de pesquisa/produto.

• fundo branco ou branco-quente
• eixos, grades e separadores finos
• cores de destaque contidas
• títulos pequenos, rótulos tipo legenda
• alta densidade de informação
• evidências legíveis de gráficos/tabelas/terminal
• nenhuma música persistente
• nenhum avatar por padrão
• transições lentas e propositais
• melhor para demonstrações de pesquisa, vídeos de benchmark, suplementos de artigo, prova de reprodutibilidade

cli_product (estilo de ferramenta CLI precisa)

• terminal é o herói
• fundos mistos escuros/claros
• destaques de comando e recortes focados
• legendas tipo cápsula esparsas
• nenhuma música de fundo por padrão
• narração opcional apenas na introdução/encerramento
• melhor para ferramentas CLI, fluxos de trabalho de agentes, utilitários de código aberto

launch_minimal (estilo de lançamento minimalista)

• estrutura de lançamento de produto com contenção
• títulos maiores que paper_clean, mas sem poluição de hype
• 2 a 4 cards de seção
• movimento sutil e transições limpas
• narração curta opcional
• música muito baixa opcional apenas se o usuário aprovar

social_punchy (estilo de ritmo acelerado para redes sociais)

• cortes mais rápidos
• gancho forte nos primeiros 3 segundos
• legendas maiores
• zooms mais agressivos
• música e design de som opcionais
• não é o padrão para pesquisa/CLI, a menos que o usuário escolha

documentary (estilo documentário contido)

• sem música ou ambiente muito baixo
• narração esparsa
• pausas mais longas em evidências
• títulos mínimos
• melhor quando confiança e seriedade importam mais do que chamar atenção

explainer_animated (estilo de animação explicativa)

• usar Manim/Remotion para diagramas de sistema
• revelação progressiva
• um conceito por cena
• movimento explica mudança de estado
• melhor para arquitetura, algoritmos, mecanismos de modelo, diagramas de coordenação multi-agente

Perguntas de acompanhamento:

• Usar o caminho de referência padrão totalmente, parcialmente ou apenas como inspiração?
• visual_density (densidade de informação): baixa / média / média-alta / alta
• motion_level (intensidade de animação): nenhuma / contida / moderada / alta
• title_card_style (estilo do cartão de título): legenda acadêmica / card CLI / card de lançamento / nenhum

7. Legendas, Narração, Avatar, Música

Pergunte:

1. captions (legendas):

   • nenhuma
   • apenas rótulos de capítulo
   • legendas-chave esparsas
   • legendas completas
   • bilíngue
   • apenas SRT externo

2. voiceover (narração):

   • nenhuma
   • apenas introdução/encerramento
   • narração guiada esparsa
   • narração completa
   • áudio fornecido pelo usuário
   • TTS permitido

3. avatar (avatar digital):

   • nenhum (padrão)
   • apenas introdução/encerramento
   • janela pequena no canto para segmentos selecionados
   • "talking head" em tempo integral

4. music (música):

   • nenhuma (padrão para CLI/pesquisa)
   • apenas sons de UI sutis
   • ambiente muito baixo
   • música de lançamento de produto
   • música fornecida pelo usuário

5. external_api_allowed (se APIs externas são permitidas):

   • nenhuma API externa
   • apenas TTS
   • apenas avatar
   • geração de vídeo permitida
   • análise de vídeo em nuvem permitida
   • perguntar antes de cada ação paga ou externa

Especificações de Estilo Predefinido

paper_clean

• Fundo: #ffffff, #fbfbf8 ou #f7f7f2
• Texto: quase preto, sem brilho, sem gradientes pesados
• Destaque: um azul frio mais um contraste quente com baixa saturação
• Tipografia: letras maiúsculas pequenas com moderação; pesos regular/médio; evitar títulos de marketing gigantes
• Linhas: 1px-1.5px; gráficos e separadores são finos
• Legendas: rótulos tipo legenda, canto superior esquerdo ou abaixo da figura, não barras de largura total
• Transições: corte, fade de 0.2s-0.45s, wipe apenas quando semanticamente significativo
• Áudio: nenhuma música por padrão; narração apenas se esclarecer
• Avatar: nenhum por padrão
• Validação: todas as figuras/texto do terminal legíveis quando pausados

cli_product

• Fundo: escuro de terminal com cartões de título contidos estilo paper-clean
• Texto: conteúdo do terminal permanece primário
• Legendas: legendas tipo cápsula esparsas, desaparecem após 1.5-3s
• Zooms: apenas para focar comandos, linhas de agente, progresso, saída; evitar zooms cegos
• Áudio: nenhuma música por padrão; narração curta opcional
• Transições: fade mínimo; evitar slides chamativos sobre texto denso

launch_minimal

• Fundo: painéis simples escuros ou claros
• Títulos: cards de seção de 3 a 6 palavras
• Legendas: declarações curtas de benefício
• Movimento: ease-in/out contido, sem decoração de partículas/orbes
• Áudio: música baixa opcional apenas se aprovado

social_punchy

• Gancho primeiro
• Legendas grandes
• Planos curtos
• Fortes momentos de antes/depois
• Mais zooms, mas validar legibilidade do texto
• Música e efeitos sonoros permitidos apenas após aprovação

documentary

• Planos suficientemente longos para ler
• Legendas esparsas
• Narração pode substituir legendas
• Sem música, a menos que o usuário peça explicitamente
• Melhor para alegações técnicas ou de pesquisa sérias

explainer_animated

• Usar Manim para matemática/gráficos/transições de estado
• Usar Remotion ou HTML-to-video para cards de interface e diagramas
• Manter cada animação provando um ponto
• Evitar filmagens cinematográficas genéricas

Guia de Seleção de Ferramentas

Use camadas de ferramentas, não uma ferramenta fixa:

• ffmpeg: sondagem, corte, recorte, concatenação, multiplexação, volume, extração de quadros, detecção de quadro preto, codificação final
• MoviePy: montagem local legível em Python quando os gráficos do ffmpeg se tornam difíceis de manter
• Playwright / ui-demo: gravação de interface web e captura de demonstração com script
• Remotion: composição avançada, legendas, cards de interface animados, variantes de plataforma
• HTML-to-video / fluxo estilo HyperFrames: cartões de título leves e protótipos visuais rápidos
• Manim: algoritmos, gráficos, arquitetura, mecanismos de modelo, explicadores de pesquisa
• VideoDB: compreensão opcional de vídeo, indexação de transcrições, operações de linha do tempo na nuvem
• APIs TTS/avatar: opcionais apenas após permissão explícita; nunca persistir segredos

Fluxo de Produção

Fase 0: Captação (Intake)

Conclua a captação. Salve as respostas em um arquivo de briefing se a tarefa produzir arquivos.

Arquivo recomendado:

video_brief.md

Fase 1: Auditoria de Material

Crie:

• source_inventory.md (inventário de materiais)
• sensitive_info_audit.md (auditoria de informações sensíveis)
• arquivos proxy ou miniaturas, se necessário
• folha de contato de quadros para vídeos existentes

Não prossiga se material sensível estiver visível e não resolvido.

Fase 2: Storyboard e EDL

Crie antes de editar:

• storyboard.md (storyboard)
• edit_decision_list.json (lista de decisões de edição)
• style_contract.md (contrato de estilo)

As entradas do EDL devem incluir:

• arquivo de origem
• timestamp de entrada/saída da origem
• nome do segmento de destino
• regra de corte/requadro
• regra de velocidade
• regra de legenda/narração
• motivo da existência deste segmento

Fase 3: Versões de Protótipo

Gere pelo menos o número solicitado de versões.

Padrão:

• v1_complete: completa, legível, com foco em evidências
• v2_release: mais curta e mais polida

Nunca sobrescreva versões anteriores.

Fase 4: Polimento

Polir apenas após a estrutura ser aprovada ou claramente aceitável.

Possíveis polimentos:

• remover quadros desconhecidos / cortes acidentais
• corrigir quadros escuros/pretos
• reduzir holds estáticos
• melhorar posições de corte
• reduzir obstrução de legendas
• normalizar áudio, se presente
• refinar cartões de título
• criar quadro de pôster ou GIF

Fase 5: Verificação

Antes de relatar a conclusão, execute as verificações aplicáveis:

• ffprobe duração, fps, resolução, verificação de stream
• folha de contato de quadros
• detecção de quadro preto/escuro
• detecção de segmento estático
• verificação de legibilidade de legendas
• verificação OCR de texto importante, quando possível
• verificação de volume de áudio, se existir
• re-verificação de informações sensíveis
• caminho e tamanho do arquivo final