Oficina de Vídeo (video-forge)
Um bom trabalho não é gerado com uma frase. Esta skill cuida de três coisas:
- Perguntar até esclarecer: se os requisitos são vagos, continua perguntando até que cada detalhe – cena, personagem, emoção – se traduza em imagens concretas.
- Confirmar antes de produzir: estilo, configurações e storyboard precisam da aprovação do usuário antes de iniciar a produção pesada.
- Revisão por terceiros: o resultado final é entregue a avaliadores independentes, que julgam item por item com base no "cartão de critérios de avaliação" aprovado pelo usuário. Não se aceita autoavaliação como substituto.
A produção em si é delegada aos pipelines existentes (lemo-opuscar, mv-director, Remotion, three.js para miniaturas); esta skill atua apenas como diretor e ponto de controle.
Regras de Ferro
- Não comece o trabalho com uma única frase. A lista de perguntas obrigatórias (
references/interview-checklist.md) deve ser completamente verificada antes de entrar em produção. Se o usuário disser "você decide", forneça valores padrão específicos no cartão de requisitos e mostre-os ao usuário. - Substitua palavras vagas por imagens: "aconchegante", "sofisticado", "com clima" não são respostas; dê 2–4 opções visuais concretas para o usuário escolher.
- Após cada rodada de perguntas, exiba o cartão de requisitos (
references/card-templates.md) para que o usuário veja rapidamente o que está definido e o que ainda não está. - A ordem das etapas é fixa: Cartão de Requisitos + Cartão de Critérios de Avaliação → Estilo (exemplos) → Cartão de Estilo / Quadro de Estilo → Cartão de Configuração → Tabela de Storyboard → Rascunho → Ciclo de Avaliação → Arquivamento. Pipelines podem declarar saltos (ex.: miniatura não tem storyboard), mas devem justificá-los por escrito.
- O storyboard deve ser confirmado por padrão (no lemo o padrão é não confirmar; aqui muda-se para confirmar).
- Os avaliadores são subagentes independentes: recebem apenas o trabalho e o cartão de critérios aprovado pelo usuário, nunca minhas conclusões. O avaliador deve assistir ao vídeo completo (1 quadro a cada 2 segundos), só pode medir áudio (não avaliar se é "bom" ou não). A palavra do usuário tem prioridade sobre a do avaliador.
- Personagens não atuam: expressões faciais e movimentos de mão gerados por código sempre parecem rígidos. A menos que o pipeline tenha capacidade de rigging de personagens, mantenha-os pequenos, distantes, estáticos ou com loops simples.
- Palavras do usuário vão para o cartão: exigências específicas do usuário (ex.: "a iluminação não pode achatar") devem ser copiadas literalmente no cartão de requisitos, como restrições ou exigências.
- Tarefas grandes devem ser divididas entre vários agentes (
references/division-of-labor.md): primeiro defina os arquivos esqueleto, cada agente referencia apenas os IDs, e a aritmética é validada por scripts. Não reduza o esforço de pensamento para evitar timeouts. - Arquive o trabalho em
~/video-forge, não em diretórios temporários; diretórios temporários são perdidos ao reiniciar. - Rede: o proxy desta máquina é muito lento. Para downloads grandes, use
curl --noproxy '*',env -u http_proxy -u https_proxy -u HTTP_PROXY -u HTTPS_PROXYpara contornar; segrepfalhar no shell, use/usr/bin/grep.
Passos
0. Roteamento
Primeiro, verifique ~/video-forge/recipes/: se o usuário mencionar uma solução específica (ex.: "faça uma estação com a solução de miniatura 3D em 2D"), leia o arquivo da solução e faça perguntas apenas sobre itens não definidos pela solução.
Caso contrário, selecione o pipeline com base na necessidade:
| Necessidade | Pipeline | Arquivo |
|---|---|---|
| Curta-metragem com um estilo específico (30–90 s), tema próprio | Vídeo Estilizado | references/pipeline-style-film.md |
| Criar videoclipe para uma música | MV | references/pipeline-mv.md |
| Explicar um conceito, história ou dados | Animação Explicativa | references/pipeline-explainer.md |
| Cena 3D pequena, arrastável e girável | Miniatura | references/pipeline-diorama.md |
Se o usuário não sabe o que quer: siga o guia para iniciantes em references/style-picker.md (primeiro veja exemplos, depois receba sugestões de conteúdo).
1. Entrevista → Cartão de Requisitos
Primeiro, defina o tipo de vídeo e a faixa de duração. Carregue o cartão de tipo correspondente em references/genres/ (tabela de seleção em genres/README.md). Todas as perguntas, estrutura, orçamento de palavras e cartão de critérios de avaliação partem deste cartão.
Siga o references/interview-checklist.md rodada por rodada. Use AskUserQuestion, com ≤ 4 perguntas por rodada, e opções escritas como imagens concretas. Após cada rodada, exiba o cartão de requisitos. Quando todas as perguntas obrigatórias forem respondidas, peça confirmação do cartão ao usuário.
2. Estilo Visual
Se o usuário não escolheu: siga o references/style-picker.md para recomendar 2–3 estilos com links de exemplos, e liste todos os 66 estilos disponíveis (pergunta em texto puro, sem AskUserQuestion, para não esconder a lista).
Após a escolha, leia o STYLE.md do estilo escolhido e organize um cartão de estilo (valores: paleta de cores, espessura de linha, relação de luz, fontes, gramática de câmera, som). Exiba para confirmação.
3. Quadro de Estilo
Use o código de renderização real para gerar 1–3 quadros de estilo (uma cena / um canto, com luz e cor definidas). O usuário confirma antes de prosseguir.
4. Cartão de Configuração
Quando houver personagens, locais ou objetos, crie um cartão de configuração para cada um: aparência, proporções, paleta de cores, figurino, adereços importantes, itens proibidos. Gere uma imagem de configuração e peça confirmação.
5. Tabela de Storyboard
Uma grade de 6–9 miniaturas (cada uma: tempo, imagem, câmera, som, legenda). O usuário confirma antes de animar.
6. Rascunho → Ciclo de Avaliação
Produza um rascunho conforme o pipeline. Siga o references/review.md para convocar dois avaliadores, que julgam cada item do cartão de critérios (Aprovado / Parcial / Reprovado + quadro de evidência). Apenas itens reprovados são corrigidos. A cada rodada, mostre ao usuário.
Critérios de parada: todos os itens obrigatórios aprovados E o usuário satisfeito, ou após 3 rodadas, ou se o usuário interromper.
7. Arquivamento
Em ~/video-forge/works/<slug>/: colocar o código-fonte ou link do projeto, o trabalho final / capturas de tela, cartão de requisitos, cartão de estilo, storyboard, scores.md. Em ~/video-forge/retros/, escreva uma retrospectiva. Se a abordagem for reutilizável, crie uma nova receita a partir de recipes/_template.md e adicione uma linha na tabela "🎞 Trabalhos" em ~/video-forge/README.md. Se usar novas bibliotecas externas, registre em deps.json e reconstrua index/.
Cerca de uma semana após a publicação, peça ao usuário para verificar, no painel da plataforma (ex.: Centro de Criadores do Douyin), a taxa de conclusão, o tempo médio de exibição, em quais segundos há mais perda de audiência e quais partes foram revistas. Preencha esses dados na seção "Dados de Publicação" do scores.md do trabalho e escreva na retrospectiva: qual elemento de retenção funcionou, onde houve perda. Da próxima vez, ao escrever o roteiro e o storyboard, use esses dados reais, não apenas as opiniões dos avaliadores.
Arquivos de Referência
| Etapa | Arquivo | Quando consultar |
|---|---|---|
| 1 Entrevista | references/interview-checklist.md | No início de cada trabalho; antes de cada rodada de perguntas, verifique o que ainda falta |
| 1–5 Cartões | references/card-templates.md | Ao exibir cartões de requisitos, estilo, configuração e storyboard |
| 2 Estilo | references/style-picker.md | Quando o usuário não escolheu o estilo ou não sabe o que fazer |
| 3–6 Produção | references/pipeline-style-film.md | Para fazer curtas com o estilo lemo-opuscar |
| references/pipeline-mv.md | Para fazer videoclipes | |
| references/pipeline-explainer.md | Para fazer vídeos informativos/explicativos com Remotion | |
| references/pipeline-diorama.md | Para fazer cenas em miniatura 3D com three.js | |
| 3–6 Divisão de Trabalho | references/division-of-labor.md | Ao usar vários agentes para escrever o Treatment ou produzir: divisão de responsabilidades, arquivos esqueleto, scripts de validação |
| Cartões de Tipo (por tipo / faixa de duração) | references/genres/README.md | Ao definir o tipo e a faixa de duração durante a entrevista: carregar o cartão correspondente para orçamento de tempo, estrutura, especificações visuais e sonoras, lógica de validação, modelos de prompt |
| Música | references/music.md | Para escolher a abordagem musical (composição por código / biblioteca livre de royalties / modelo open source) e uso de tools/music/code_score.py |
| Selecionar Estilo / Efeitos | ~/video-forge/index/catalog.md (index.json legível por máquina) | Todos os estilos, cartões de efeitos, sintaxe de explicação, fusão de estilos em uma tabela; se faltar uma biblioteca, execute bash ~/video-forge/bootstrap.sh <id> |
| 1 / 6 Avaliação | references/review-standards.md | Durante a entrevista, dê itens de verificação padrão com base no tipo de vídeo e defina o cartão de critérios de avaliação com o usuário |
| 6 Avaliação | references/review.md | Convocar avaliadores, julgar item por item, decidir se para |
| Solução de Problemas | references/troubleshooting.md | Quando surgirem problemas com instalação de dependências, renderização, captura de tela ou rede |
| Arquivamento | ~/video-forge/README.md, ~/video-forge/recipes/_template.md | Após terminar o trabalho |