Encenação com ManimGX
Apenas colocação. Esta skill não escreve história, diálogo ou atuação, e não está vinculada a nenhum sistema de câmara, gerador de vídeo ou ferramenta de produção. Ela responde a uma pergunta: onde estão todas as coisas e pessoas, como se movem, de onde vem a luz, e onde cada câmara está e para onde olha? A saída é um vídeo curto no estilo de uma planta baixa de diretor: o mapa finalizado mostra por um segundo, depois o mapa é construído, depois os caminhos de movimento, depois as câmaras aparecem uma a uma com seus cones de campo de visão, depois o eixo de 180° e as linhas de visão.
A pessoa pode ser um profissional com uma lista de planos completa ou um iniciante com uma frase. Ambos devem terminar com a mesma qualidade de mapa. O que difere é o caminho até lá: um briefing completo vai direto para um layout proposto; um briefing enxuto passa primeiro por uma breve ronda de perguntas guiadas, para que a pessoa decida a colocação em vez de você adivinhar. As perguntas também ensinam a um iniciante o que um briefing de encenação precisa. Todo caminho termina com um plano que a pessoa aprova ou corrige antes de qualquer renderização.
A arte da encenação — planos, altura da câmara, sensação de lente, leis de colocação, continuidade espacial e como descrever cada plano — está em references/staging-craft.md. Leia-o antes de escolher câmaras, escrever o plano ou executar a verificação final.
Trabalhe apenas a partir da cena à sua frente. Os modelos de perguntas, a tabela de tamanhos e o exemplo de especificação abaixo mostram formas e sintaxe, não conteúdo: nunca carregue suas localizações, adereços, nomes, posições ou cores para uma cena real.
O briefing completo — sete campos
Um briefing está completo quando responde a estes sete. Verifique cada briefing recebido em relação a eles antes de fazer qualquer outra coisa.
| # | Campo | O que define | Por que o mapa precisa |
|---|---|---|---|
| 1 | Localização | tipo, tamanho e caráter do lugar (pequeno ou grande, apertado ou aberto, estilo ou época) e sua geometria fixa: paredes, portas, janelas, os objetos que importam para o bloqueio | define a escala de todo o mapa e quais adereços existem |
| 2 | Posições | quem está onde, sua postura (em pé, sentado, deitado, ajoelhado…), quem enfrenta quem, a que distância | os pontos, etiquetas de postura e setas de direção; o eixo de 180° é desenhado a partir daqui |
| 3 | Orientação | de que lado de um personagem está a característica chave (janela, porta, parede, estrada), declarada em relação a um personagem: "janela à sua direita" | sem ela, o mapa pode sair espelhado e todos os fundos ficam errados |
| 4 | Luz | cada fonte que importa, onde está fisicamente, de que lado vem, dura ou suave | decide que lado de cada rosto está iluminado e quais planos olham para a luz |
| 5 | Arredores | o que está nos outros lados da ação | torna-se o fundo de cada plano reverso |
| 6 | Planos | quantos, em que ordem, e o tamanho, lente e ângulo de cada um (close-up no A, dois planos centrados, sobre o ombro de A para B…) | estas são as câmaras |
| 7 | Batidas | quem se move, de onde para onde e quando (levanta-se, atravessa, entra, sai, vira-se), e o que acontece em cada plano | o movimento altera posições, direções e às vezes o eixo no meio da cena; os movimentos são desenhados como caminhos |
Um campo conta como preenchido quando o briefing o declara ou o torna inequívoco ("eles sentam-se em lados opostos de uma cabine" preenche Posições). O campo 7 só importa quando alguém se move: se cada batida é uma linha de diálogo e ninguém se mexe, não precisa de pergunta.
Ronda de perguntas — quando o briefing é enxuto
- Avalie o briefing em relação aos sete campos, silenciosamente. Nunca mostre a lista de verificação à pessoa.
- Tudo preenchido → salte a ronda de perguntas e vá para Fluxo de Trabalho. Também salte quando a pessoa disser que não quer perguntas ("sorma", "direkt yap", "apenas faça"): preencha as lacunas com valores predefinidos; eles estão listados no plano (Passo 4 do Fluxo de Trabalho).
- Algo em falta → pergunte, no idioma da pessoa:
- No máximo 3 perguntas por mensagem e no máximo 2 mensagens. Ordem: Localização → Posições → Planos primeiro, porque decidem a estrutura do mapa; depois Orientação → Luz → Arredores; Batidas por último.
- Se Localização e Posições estiverem ambos em falta, pergunte apenas esses dois na primeira mensagem: as opções de todas as outras perguntas dependem das suas respostas.
- Cada pergunta é de múltipla escolha: 2–4 opções escritas para esta cena, construídas a partir do que o briefing já diz, mais uma opção final "Você decide" (no idioma da pessoa, por exemplo, "Sen öner"). A pessoa pode sempre escrever a sua própria resposta.
- Marque a opção que escolheria como (recomendado) com algumas palavras de motivo, para que um iniciante possa simplesmente escolhê-la.
- Cada pergunta traz uma linha curta sobre por que importa para o mapa.
- Se o seu ambiente tiver uma ferramenta de perguntas de múltipla escolha estruturada, use-a; caso contrário, escreva perguntas numeradas com opções com letras em texto simples.
- Nunca pergunte o que o briefing já responde. Nunca pergunte sobre história, diálogo ou atuação: esse não é o trabalho desta skill.
- Quando a pessoa escreve como um profissional (lentes, tamanhos de plano, "sobre o ombro de A", eixo), aceite cada escolha declarada exatamente como dada. Pergunte apenas sobre campos que estão genuinamente em falta, e nunca reabra uma decisão que eles tomaram.
- Após as respostas, qualquer coisa ainda em aberto ou respondida com "Você decide" recebe um valor predefinido sensato. Depois vá para Fluxo de Trabalho; o plano no passo 4 é onde a pessoa confirma ou corrige esses valores predefinidos.
Modelos de perguntas
Estes mostram a forma de cada pergunta. Reescreva a redação e as opções para a cena à sua frente; nunca as cole na íntegra.
- Localização — "Onde isto acontece, e como é o lugar?" → opções construídas a partir do briefing, por exemplo, interior pequeno e apertado · interior grande e aberto · exterior · Você decide. Porquê: define a escala e quais adereços existem.
- Posições — "Como estão colocados?" → opções que se ajustam ao lugar e às pessoas no briefing, combinando posição e postura (ambos sentados, frente a frente · lado a lado · um sentado, um em pé · Você decide). Porquê: o eixo de 180° é desenhado entre os dois personagens principais.
- Orientação — "De que lado de está a <janela / porta / parede>?" → à esquerda de · à direita de · atrás de · atrás de . Porquê: sem ela o mapa pode sair espelhado e todos os fundos mudam.
- Luz — "De onde vem a luz principal?" → fontes que existem neste lugar (do lado da <janela / porta> · de luminárias suspensas · de um prático em cena · de trás de um deles (contraluz) · Você decide). Pergunte sobre dura ou suave apenas se nomearam uma fonte. Porquê: decide que lado de cada rosto está iluminado.
- Arredores — "O que está do outro lado deles?" → opções que se ajustam à localização. Porquê: é o fundo de cada plano reverso.
- Planos — "Como quer cobrir a cena?" → Vou dar-lhe uma lista (contagem, ordem, tamanho) · cobertura clássica: um plano aberto, dois sobre o ombro, dois close-ups · um plano contínuo · Você decide. Porquê: estas são as câmaras.
- Batidas (apenas quando o movimento é plausível) — "Alguém se move durante a cena?" → não, todos ficam parados · <um movimento que esta cena sugere, escrito para ela> · sim (diga-me quem, de onde para onde e quando) · Você decide. Porquê: os movimentos são desenhados como caminhos e podem deslocar o eixo.
Fluxo de Trabalho
-
Leia a cena — o briefing mais quaisquer respostas da ronda de perguntas. Extraia:
- a localização, sua geometria fixa e os adereços que importam para o bloqueio (paredes, portas, janelas, móveis, veículos, caminhos);
- cada personagem: onde estão, postura, o que enfrentam;
- cada movimento: quem, de onde, por onde, para onde, a direção e postura no final;
- cada fonte de luz que importa (sol, janela, candeeiro, prático): onde está fisicamente, de que lado vem, quem atinge;
- a relação principal — o par que mais fala ou se olha. Esse par define o eixo de 180°. Se um movimento muda a geometria, decida o eixo para os planos depois dele;
- os planos. Se a pessoa os deixou para si ou escolheu cobertura clássica, construa-os você mesmo (veja Cobertura).
Depois responda a três perguntas para si mesmo antes de dispor qualquer coisa: o que muda fisicamente durante a cena (quem se move, o que é pego, o que abre); o que o público deve ver ao mesmo tempo (duas pessoas no mesmo quadro, um rosto e a porta atrás dele); o que deve permanecer fixo entre planos (a janela iluminada, a mesa, o objeto em que a cena se baseia). As respostas decidem quais adereços ganham nomes, quais planos devem ser dois-planos e onde o eixo deve ser mantido.
-
Disponha em metros com tamanhos do mundo real (tabela abaixo). Convenção do mapa: +y é "para dentro da cena" visto da câmara principal/de abertura, +x é direita. Coloque a câmara principal ao sul da ação olhando para norte.
-
Escreva a especificação da cena (JSON, esquema abaixo; JSON Schema completo em
references/scene.schema.json) para o diretório de trabalho, depois valide-a sem renderizar:uv run <skill-dir>/scripts/staging_render.py scene.json --check(<skill-dir>é a pasta que contém este SKILL.md). Imprime o relatório resolvido (posições da câmara, avisos) ou uma única linhaspec error: ...; corrija e verifique novamente até passar. -
Pré-visualize e obtenha aprovação — antes de qualquer renderização. Execute
uv run <skill-dir>/scripts/staging_render.py scene.json -o <nome>.mp4 --preview(alguns segundos). Escreve<nome>.preview.png, o mapa finalizado, e<nome>.report.json. Olhe para a pré-visualização primeiro e corrija problemas óbvios (se não conseguir ver imagens, verifique o relatório e diga à pessoa que não pôde inspecionar a imagem). Depois mostre à pessoa a imagem de pré-visualização e um plano compacto no seu idioma:- Ambiente — tamanho do espaço, os objetos-chave e onde estão (palavras relativas mais metros);
- Personagens — posição, postura, direção; depois cada movimento por ordem;
- Luz — cada fonte, onde está, que lado de quem ilumina;
- Câmaras — uma tabela: número, tamanho, lente, onde está (por exemplo, "2.9 m frente-direita de A, altura dos olhos"), o que vê, e uma linha sobre por que esta câmara (seu trabalho na cobertura);
- Descrições dos planos — para cada câmara, uma curta descrição em linguagem simples do quadro, construída a partir da especificação e dos dados
framedo relatório com o modelo emreferences/staging-craft.md: quem e o que está no quadro e de que lado, o que está atrás deles, de que lado a luz vem, direção da linha de visão e lado do eixo. Neutra e factual: sem palavras de estilo ou humor, sem redação para qualquer ferramenta de imagem ou vídeo específica; - Eixo de 180° — qual par, de que lado as câmaras permanecem, qualquer plano que seja espelhado ou cruze;
- Suposições — cada valor que escolheu em vez da pessoa, marcado como tal;
- Alternativas — duas ou três opções de câmara que a pessoa não mencionou, uma linha cada com sua troca (veja "Oferecer alternativas" em
references/staging-craft.md). Aplique uma apenas se eles a escolherem. Peça-lhes que aprovem ou corrijam qualquer coisa ("coloque a porta na outra parede", "faça o plano 3 um close-up", "ela fica sentada"). Aplique correções à especificação, pré-visualize novamente e mostre o plano alterado; repita até aprovarem. Renderize apenas após a aprovação. Salte este passo apenas se a pessoa pediu explicitamente para renderizar sem revisão; então liste as suposições na entrega.
-
Renderize com o motor incluído,
scripts/staging_render.py(caminho relativo à pasta desta skill; não reescreva nem copie):uv run <skill-dir>/scripts/staging_render.py scene.json -o <nome>.mp4 --quality h. Use--quality lpara um rascunho rápido. O vídeo abre no mapa finalizado por 1 segundo (--poster 1.0, o padrão), depois faz cross-fade para a construção passo a passo. Esse primeiro quadro é também a miniatura em plataformas sociais, por isso deve mostrar o resultado completo; use--poster 0apenas se a pessoa pedir uma construção simples. Imprime um relatório JSON com cada personagem, luz e câmara (posição, distância, campo de visão horizontal, e um blocoframelistando quem e o que está à vista em que lado do quadro e de que lado do quadro cada luz vem) ewarnings(também guardado como<nome>.report.json), e guarda<nome>.last.png, o mapa finalizado. -
Verifique o resultado antes de entregar. Abra
<nome>.last.pnge olhe para ele (se não conseguir ver imagens, baseie-se no relatório e diga-o): cada etiqueta legível, nenhum ícone de câmara em cima de uma pessoa, cones apontando para o sujeito certo, caminhos de movimento legíveis, legenda não cortada. Depois execute a verificação espacial final emreferences/staging-craft.md: esquerda/direita e linhas de visão consistentes entre planos, cada entrada e saída possível, objetos fixos e a luz chave no mesmo lugar físico em todos os planos, nenhuma travessia de eixo não marcada. Leiawarnings— um plano espelhado automaticamente ou uma câmara a cruzar o eixo deve ser mencionado à pessoa. Corrija a especificação e re-renderize (no máximo duas rondas). -
Entregue o vídeo mais o JSON da especificação (para que o layout possa ser editado alterando números) e as descrições de plano aprovadas, atualizadas para a especificação final. No idioma da pessoa, diga em duas ou três linhas quais predefinições permanecem (apenas o que a ronda de perguntas deixou em aberto ou a pessoa devolveu), e qualquer aviso de eixo. As etiquetas do mapa são em inglês, a menos que a pessoa peça o contrário.
Cobertura (quando os planos são deixados para si)
Construa o conjunto mais pequeno que cobre a cena, por ordem de script de filmagem, máximo 8:
- Plano aberto de estabelecimento — todos no quadro (
target: lista de todos os nomes,size: "wide",lens: 35,from: "S"). - Para o par principal A/B: um sobre o ombro de cada um (
over_shoulder: B, target: Ae o inverso). Escolha os ombros de modo que ambas as câmaras fiquem no mesmo lado do eixo; o motor espelha qualquer uma que não fique e reporta-o. - Planos individuais para as batidas chave:
size: "cu"ou"mcu",lens: 85/50,from: "frente-esquerda"/"frente-direita"(relativo à direção do personagem), mesmo lado do eixo. - Inserts para qualquer adereço de que a ação dependa (
size: "insert",lens: 85,height: "high"para coisas numa mesa). - Após um movimento: cubra a posição final (
target: "A@1"), e dê aos planos após o movimento o seu próprio eixo ("axi…