Storyboard Sheet
A estabilidade não vem da improvisação, mas de fixar este fluxo: Content Card → Shot List → Static Validation → Frame-by-Frame Generation → Frame-by-Frame QA → Trace Writeback → Panel Assembly with Overlays → Final Board Review and Delivery. Cada passo tem especificações fixas; troca-se o conteúdo, não a estrutura. Três portões travam a qualidade: validação falha → sem geração; frame individual falha → sem montagem; sentenças originais não reescritas → sem entrega.
Fluxo de Execução
- Preencher o Cartão de Conteúdo. Consulte prompt-templates.md para os campos: Título e Gênero, Âncoras de Personagem, Cenário, Cartão de Posicionamento, Blueprint Espacial e Tabela de Câmeras, Cartão de Estado, Iluminação e Textura, Proporção e Número de Quadros, Lista de Tomadas, Itens Proibidos. O que faltar, o Agente completa com base razoável na história, sem perguntar ao usuário sobre preferências de estilo.
- Montar a Lista de Tomadas. Divida com base em eventos de conteúdo, não em número de palavras ou estética visual; uma mudança de ação principal por quadro. Escreva como um JSON isomórfico
assets/shots.example.json, copiando estritamente os campos e nomes. Todas as sentenças reutilizadas em vários quadros são centralizadas no blocoanchorsde nível superior (fonte única de verdade):style/characters/blueprint/blocking/axis/lighting/props/negative. Opromptde cada quadro é montado a partir dessas oito sentenças originais; é proibido que cada quadro escreva suas próprias variações. - Validação Estática (não passa, não gera). Execute
scripts/validate-shots.ps1primeiro: campos obrigatórios, capacidade de quadros, continuidade de números de tomada, intervalo de tempo contíguo,in_state/out_statepassados palavra por palavra, se cadapromptde quadro contém todas as sentençasanchorsna íntegra, se a referência da câmera existe, direção do link de referência de imagem. Qualquer FAIL primeiro corrija o JSON, não entre na geração de imagem. - Gerar Storyboard Quadro a Quadro. Em uma única chamada
image_gen, todas as solicitações de quadros da mesma cena podem ser submetidas (váriasrequest_list), cada quadro 1536×864. Opromptde cada quadro segue o modelo em prompt-templates.md: Sentença de textura global + Sentença de âncora de personagem + Sentença de cenário + Sentença de âncora de posicionamento + Âncora de escala + Cartão de estado + Estado de entrada + Sentença de ação deste quadro + Estado de saída + Sentença de proibição, todas as sentenças âncora copiadas na íntegra quadro a quadro. Dentro da mesma cena, siga a cadeia de imagens de referência da ordem da tabela de câmeras: o quadro finalizado anterior é passado como imagem de referência para o próximo, com a instrução fixa "Apenas referencie o layout espacial, a proporção dos personagens, a relação de chão e direção da luz; não copie a composição." Ao mudar de cena, a cadeia é quebrada e reiniciada. Veja detalhes em continuity.md. - QA Quadro a Quadro (quadro não passa, não monta). Assim que cada quadro for gerado, confira imediatamente contra a lista de dez itens em prompt-templates.md: formato do rosto/roupas correspondem às âncoras, posicionamento nas coordenadas do blue-print, esquerda/direita seguem regra de eixo, proporção corresponde à âncora, estado de luz/cartão de estado corresponde ao significado real, temperatura de cor da luz consistente, estado de entrada conecta-se com o quadro anterior, sem marcas d'água de texto. Se reprovado, regenere no local: modifique o prompt sem reescrever sentenças âncora, apenas corrija o item com erro; se falhar duas vezes, passe o primeiro quadro finalizado como referência dupla; se ainda falhar, reduza o plano (plano fechado é mais estável que plano geral).
- Trace Writeback (não reescreve, não entrega). Após cada quadro ser finalizado, escreva quatro itens de volta no arquivo JSON da lista de tomadas, no
shotcorrespondente:prompt(a sentença completa original enviada ao modelo de geração de imagem, sem alterar uma palavra),seed(se a ferramenta retornar),ref(a cadeia de IDs das imagens de referência usadas neste quadro, ex.:"SH003"ou"SH001+SH003"),qa(conclusão da qualidade e observações). Este JSON é o único arquivo de rastreabilidade: qualquer pessoa pode reproduzir quadro a quadro e localizar a sentença responsável por erros. - Montagem e Sobreposição de Texto. Use
scripts/build-board.ps1(parametrizado: spec JSON + diretório de frames + caminho de saída), seguindo a fórmula de proporção em output-spec.md para determinar número de quadros e tela. Números de tomada, duração e nomes de tomada são sobrepostos na pós-produção em uma faixa semitransparente na parte inferior de cada quadro. Não deixe o modelo de imagem desenhar texto algum. Antes da montagem, execute novamentevalidate-shots.ps1 -PanelsDir <diretório de frames> -RequirePanels. - Revisão Final e Entrega. Após a montagem, veja o quadro completo uma vez: os quadros adjacentes se conectam? A esquerda/direita dos personagens permanece consistente em todo o quadro? A forma dos objetos fixos do cenário (linha de parada, meio-fio, moldura da porta, etc.) é consistente em todo o quadro? As informações do cartão de título estão corretas? Se encontrar problemas, volte ao passo 5 e regenere apenas os quadros problemáticos. Entregue a imagem do storyboard montada (PNG original + JPG para visualização fácil) e o JSON da lista de tomadas; quando o usuário solicitar, entregue frames individuais separadamente.
Regras Rígidas
- Três Portões: Validação estática da lista de tomadas falha → sem geração; QA de quadro individual falha → sem montagem;
prompt/seed/ref/qanão reescritos → sem entrega. - Grade n×n + Cada quadro 16:9 = Placa final estritamente 16:9. 3×3 com 1280×720 monta 3840×2160; 4 quadros com 2×2; 6 quadros com 3×2 (ultra-wide) ou 2×3 (vertical); 9 quadros com 3×3. Proporção da placa final não-quadrada =
(colunas×16):(linhas×9). - Âncoras como fonte única de verdade: Personagens, posicionamento, blueprint, luz, cartão de estado e itens proibidos têm apenas uma sentença original cada, residindo no bloco
anchorsde nível superior; ospromptsde cada quadro copiam daqui na íntegra, proibido escrever "como acima" ou "manter o mesmo estilo", proibido reescrever frases sinônimas por quadro. Personagem mudando de rosto entre quadros é a falha mais comum no storyboard. - Posicionamento baseado em objetos fixos de cena, copiado na íntegra quadro a quadro: Linha de parada, N-ésima linha branca, meio-fio, borda da mesa, moldura de porta, coluna de corrimão. Proibido usar "frente/fundo/esquerda/Lateral" para descrever posição de personagem — esses mudam com planos e ângulos de câmera, sendo a causa principal de deslocamento de posicionamento. Deslocamento só deve ser escrito como direção e distância relativa ao ponto de ancoragem ("dar um passo à frente, cruzar a linha de parada").
- Três itens de consistência de cena: Blueprint (coordenadas espaciais) + Cartão de estado (semântica do objeto variável) + Forma de objetos fixos de cena (material/cor/quantidade), copiados na íntegra quadro a quadro no grupo; só troque quando mudar de cena, e marque
scene_break: truena lista de tomadas e quebre a cadeia de referência. - Sentença de luz uniforme em todo o grupo, só altere se a narrativa realmente mudar o período; ao alterar, anote na lista de tomadas.
- Uma ação por quadro: Estado inicial → Caminho/ponto de contato → Resultado visível. Ações com múltiplos passos devem ser divididas em quadros adjacentes.
- Quadros adjacentes devem se conectar: O
out_statede cada quadro e oin_statedo próximo devem ser palavra por palavra iguais (em posição/orientação/fase de ação/ponto de contato/intensidade de expressão), proibido "basicamente o mesmo"; mude de cena comscene_break: truedeclarado explicitamente, não permitido desconectar silenciosamente. - Não cruze o eixo, mova-se conforme a tabela de câmeras: Todas as câmeras do grupo do mesmo lado; a esquerda/direita dos personagens na tela não se troca; ângulo entre câmeras adjacentes ≤ 90°, diferença de altura ≤ uma altura de pessoa, planos não pulam dois níveis consecutivos.
- Âncora de escala escrita em cada quadro: Dê um objeto de tamanho fixo na cena (linha branca 45cm, meio-fio 15cm, largura da mesa 60cm); o tamanho do personagem é convertido usando a âncora para evitar mudanças drásticas.
- Cartão de estado copiado na íntegra quadro a quadro, estado da luz deve corresponder ao significado real: Luz vermelha para pedestre = figura vermelha parada, luz verde para pedestre = figura verde andando, luz de veículo = disco colorido puro; escreva claramente qual luz está voltada para quem, e faça o fluxo de tráfego e o direito de passagem consistentes. Proibido desenhar figuras humanas dentro de discos ou misturar luz vermelha com números verdes.
- Ponto de corte: escreva claramente o que está sendo conectado. Proibido "transição natural" ou "transição suave".
- Substitua palavras vagas por descrições concretas: "Sofisticação", "impactante", "cinematográfico", "atmosfera completa" — substitua tudo por luz, material, velocidade, distância e planos específicos.
- Itens proibidos fixos incluem: Sem texto, legendas, marcas d'água, numeração, bordas; adicione conforme o gênero (ex.: sem jatos de sangue, sem armas de fogo modernas, sem cartoonização).
- Quando menos que
colunas×linhasquadros etitle_cellestá ativado, o último quadro é o cartão de título; caso contrário, espaço vazio com fundo escuro, não preencha com quadros irrelevantes para completar.
Recursos
| Arquivo | Responsabilidade |
|---|---|
| references/prompt-templates.md | Cartão de Conteúdo, Modelo de Prompt de Quadro Individual, Modelo de Prompt de Grade 3×3, Escrita de Ação e Movimento de Câmera, Portão de QA de Quadro Individual, Lista de Falhas |
| references/continuity.md | Cartão de Continuidade: Blueprint Espacial, Regras de Eixo, Tabela de Câmeras, Sucessão de Estado Final/Inicial, Cadeia de Imagens de Referência, Âncora de Escala, Rastreamento de Reescrita, Lista de Verificação |
| references/output-spec.md | Fórmula de Número de Quadros e Proporção, Resolução, Layout de Sobreposição de Texto, Especificação de Campos JSON da Lista de Tomadas (incluindo âncoras e campos de rastreamento) |
| assets/shots.example.json | Exemplo completo de JSON da Lista de Tomadas (8 quadros + cartão de título, incluindo âncoras/câmeras/campos de rastreamento) |
| assets/demo.jpg | Pré-visualização do storyboard montado a partir da lista de tomadas acima (8 quadros + cartão de título, 3×3, lado maior 2560 JPG) |
scripts/validate-shots.ps1 | Validação Estática da Lista de Tomadas: campos, sucessão, inclusão de sentenças âncora originais, referência de câmera, existência de arquivos de quadro |
scripts/build-board.ps1 | Montagem e Sobreposição de Texto: lê o JSON, produz PNG do storyboard completo e JPG de pré-visualização |
Ambos os scripts dependem do PowerShell nativo do Windows e do System.Drawing; nenhuma biblioteca adicional precisa ser instalada. Modo de execução:
# Antes de gerar: Validação estática (não passa, não gera)
& "<caminho-do-skill>\scripts\validate-shots.ps1" -SpecPath <shots.json>
# Antes de montar: Validação com arquivos de quadro (falha se algum faltar)
& "<caminho-do-skill>\scripts\validate-shots.ps1" -SpecPath <shots.json> -PanelsDir <diretório de quadros> -RequirePanels
# Montagem e sobreposição de texto
& "<caminho-do-skill>\scripts\build-board.ps1" -SpecPath <shots.json> -PanelsDir <diretório de quadros> -OutputPath <storyboard-completo.png> -PreviewPath <pre-visualização.jpg>
O script de montagem corta e preencha centralmente (cover), sem distorcer a imagem; quando o tamanho do quadro e a proporção da célula não coincidem, não deforma.
Veja o exemplo final em assets/demo.jpg: Pré-visualização do storyboard completo com 8 quadros + cartão de título, correspondendo à lista de tomadas assets/shots.example.json. Execute validate-shots.ps1 primeiro e, se passar, reproduza com o mesmo JSON para obter a mesma estrutura.