Communitygithub.com

故事板拼板

将任意故事、脚本或短剧段落拆解为镜头单元,逐格生成统一风格的分镜画面,并自动拼接成带镜头号与时长的故事板(多格拼板图)。

O que é 故事板拼板?

该技能专为需要将文字故事、影视段落或AI视频脚本转化为可视化分镜预览的用户设计。它通过一套严格定义的八步流程:从填写内容卡、拆解镜头单元,到静态校验、逐格生成图像、逐格质检、溯源回写、拼板叠字,最后整板终审交付,确保每一步的质量。技能的核心在于“三道门”的硬性规则:校验不过不开图、单格不过不拼板、原句不回写不交付。它支持多种格数布局(如3×3、2×2、3×2等),每格画面严格保持16:9比例,整板最终也为16:9。通过锚点块(anchors)实现单一事实源,确保角色、场景、光影等在全板中一致,避免常见的人物变形、位置漂移等问题。该技能特别适用于Claude Code、Cursor、Codex等AI开发工具,通过提供的PowerShell脚本(validate-shots.ps1和build-board.ps1)完成自动校验和拼板,输出带完整溯源信息的镜头单JSON和最终拼板图像。

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/freedonplus/storyboard-sheet/tree/HEAD

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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

  1. 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.
  2. 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 bloco anchors de nível superior (fonte única de verdade): style/characters/blueprint/blocking/axis/lighting/props/negative. O prompt de cada quadro é montado a partir dessas oito sentenças originais; é proibido que cada quadro escreva suas próprias variações.
  3. Validação Estática (não passa, não gera). Execute scripts/validate-shots.ps1 primeiro: campos obrigatórios, capacidade de quadros, continuidade de números de tomada, intervalo de tempo contíguo, in_state/out_state passados palavra por palavra, se cada prompt de quadro contém todas as sentenças anchors na í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.
  4. Gerar Storyboard Quadro a Quadro. Em uma única chamada image_gen, todas as solicitações de quadros da mesma cena podem ser submetidas (várias request_list), cada quadro 1536×864. O prompt de 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.
  5. 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).
  6. 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 shot correspondente: 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.
  7. 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 novamente validate-shots.ps1 -PanelsDir <diretório de frames> -RequirePanels.
  8. 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/qa nã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 anchors de nível superior; os prompts de 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: true na 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_state de cada quadro e o in_state do 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 com scene_break: true declarado 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×linhas quadros e title_cell está 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

ArquivoResponsabilidade
references/prompt-templates.mdCartã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.mdCartã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.mdFó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.jsonExemplo completo de JSON da Lista de Tomadas (8 quadros + cartão de título, incluindo âncoras/câmeras/campos de rastreamento)
assets/demo.jpgPré-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.ps1Validaçã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.ps1Montagem 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.

Habilidades Relacionadas