Pintor de planos

Pintor FilmForge

Você transforma a lista de planos em pinturas que pertencem a um único filme. Cada prompt é montado a partir de partes fixas (o bloqueio de estilo, o livro-razão, a lista de planos), nunca improvisado, para que o mesmo personagem seja descrito com as mesmas palavras em todos os planos. A verificação prova isso antes do dinheiro ser gasto.

Caminhos: scripts/, templates/ e config/ abaixo são pastas dentro desta skill (o diretório base mostrado quando ela carrega), colocadas lá por ./install.sh. Trabalhando a partir de um clone do repositório, eles são tools/, templates/ e config/ em sua raiz.

Entradas

shotlist.yaml (reajustado), style-lock.yaml, continuity.yaml, as folhas e chapas em art/sheets/.

Passo 1. O livro-razão, plano por plano

Para cada plano, escreva sua entrada em continuity.yaml: quais personagens estão em quadro, quais adereços (com seus portadores), quais estados (um ferimento, fuligem, uma fita no pulso). Adereços e estados carregam intervalos (from, until).

python3 scripts/ledger.py check continuity.yaml --shotlist shotlist.yaml

Ele falha em caso de desvio: um adereço faltando dentro de seu intervalo enquanto seu portador está em quadro, um adereço ou estado fora de seu intervalo, um id desconhecido, uma lista de personagens que discorda da lista de planos. Corrija o livro-razão antes de escrever um prompt.

Passo 2. Escreva cada prompt (prompts/<id>.md)

Siga a gramática do bloqueio de estilo, campo por campo (forge-style-lock, references/prompt-grammar.md):

1. LOOK: o visual para este plano (look: na lista de planos, senão o padrão), palavra por palavra.
2. REFERÊNCIAS: uma cláusula por ativo anexado, de style-lock.yaml references:, na ordem em que você os anexa; a cláusula de re-iluminação.
3. PLANO: o enquadramento da lista de planos, altura da câmera, sensação de lente, posições nos terços.
4. SUJEITO E ESCALA: por personagem, identificador + âncora + bloqueio de escala do livro-razão; contagens.
5. MOMENTO: a batida do plano como um instante.
6. CENÁRIO: lugar, clima, hora do dia, o fundo.
7. LUZ: direção, qualidade, temperatura, e sua fonte no mundo.
8. COR: as palavras do roteiro de cores da cena.
9. ÁREA DE TEXTO, quando o plano tem text_area ou narração sobre ele.
10. CONTINUIDADE: os adereços e estados do livro-razão para este plano, palavra por palavra.
11. TRAVAS: toda cláusula forbid que cobre este plano, palavra por palavra; negações específicas do plano.
12. EVITAR: a cauda, palavra por palavra.

O formato do arquivo, exatamente:

# s02: o último fósforo

Modelo: gpt-image-2.5, high, 2K, 16:9. Anexar: sheet_girl, sheet_moth.

```
<o prompt, campos 1 a 12 como parágrafos>
```

O primeiro bloco de código é o prompt; todo o resto são notas para pessoas.

Passo 3. Verificar antes de gastar

python3 scripts/ledger.py prompts continuity.yaml --prompts prompts --style style-lock.yaml --shotlist shotlist.yaml

Ele falha em um prompt que não abre com o visual, não termina com a cauda de evitar, perde o identificador ou bloqueio de escala de um personagem, uma âncora de adereço ou estado, uma cláusula de cor proibida, ou contém o nome de um personagem. production.py spend recusa gastos em estágio de pintura enquanto ele falhar. No exemplo do motor, a verificação pega o bloqueio de escala ausente de s03; a pintura feita a partir daquele prompt desenhou a mariposa com um sexto de seu tamanho.

Passo 4. Pintar em lotes de quatro

• Ordem: folhas e provas (estágio de estilo), depois quadros principais, depois o resto cena por cena. Planos reutilizados e planos de código não custam nada; pinte-os nunca.
• Lote: quatro prompts, cada um com suas referências anexadas na ordem que seu campo REFERÊNCIAS as nomeia. Registre o gasto primeiro: production.py spend 11.0 --item "lote s05-s08 2".
• Arquivos: art/film/<id>_<slug>.png (s07a_child_reaches.png style: id primeiro, depois um slug). Uma repintura é <id>_<slug>_v2.png; uma correção de código graduada é <id>_<slug>_g.png. As ferramentas escolhem a versão mais recente pelo nome.
• Após cada lote: forge-frame-qa lê cada pintura em tamanho real antes do próximo lote ser pintado. Uma falha encontrada no lote um é corrigida nos prompts do lote dois antes de repetir.

Passo 5. Repinturas

Uma repintura vem do forge-frame-qa com sua causa e um prompt corrigido. Coloque o prompt corrigido em prompts/<id>.md, verifique, registre o gasto, pinte _v2, e envie de volta para QA. Se a causa estava no livro-razão ou no bloqueio de estilo (uma trava faltando para todos), corrija lá e verifique novamente todos os prompts.

Casos especiais

• Páginas de livro ilustrado: nomeie o layout (espalhado 3:2, página 3:4, vinheta 1:1 em fundo transparente) e a área de texto em cada prompt. Todas as palavras são definidas no livro, nunca pintadas.
• Quadros-chave de vídeo: pinte o primeiro quadro (e o último quando o movimento deve terminar em algum lugar exato) através desta mesma gramática; o prompt de movimento é uma etapa separada, executada apenas depois que o quadro-chave passa na QA.
• Poses-chave (poses: 2): um prompt por pose, idênticos exceto pelo campo MOMENT, para que se encaixem perfeitamente.
• Chapas: locais vazios, sem personagens, reutilizados entre planos; eles carregam o cenário para que os prompts permaneçam curtos.

Saída

• prompts/<id>.md para cada plano pintado, todos passando na verificação.
• continuity.yaml com a entrada de cada plano, passando em ledger.py check.
• Pinturas art/film/, nomeadas por id, prontas para QA.

Lista de verificação antes de cada lote

• ledger.py check passa
• ledger.py prompts passa para este lote
• Referências anexadas na ordem de REFERÊNCIAS; as versões corretas das folhas
• Gasto registrado; lote de quatro ou menos
• O lote anterior tem seus vereditos de QA

Tabela de reparos

Achado da verificação ou QA	Qual campo corrigir
não abre com o bloqueio de estilo	1: cole o visual, sem edições
identificador ou bloqueio de escala ausente	4: cole do livro-razão; adicione a proporção para algo em quadro
âncora de adereço ou estado ausente	10: cole do livro-razão
cláusula de cor proibida ausente	11: cole o prompt da regra
usa um nome	4 e em qualquer outro lugar: substitua pelo identificador
tamanho ou contagem errada na pintura	4: bloqueio de escala e uma contagem exata; depois a barra de escala da folha
sujeito iluminado de forma plana	2: a cláusula de re-iluminação; 7: uma luz com uma fonte
texto ou letras pintados	9 e 12: a área de texto é para código; "texto" na cauda de evitar

Referências

• references/batching.md: planejamento de lotes, nomenclatura, versões e um lote trabalhado de um filme real