roteirização-videoexpress-scripting

Roteirização do VideoExpress

Produza um pacote de prompts pronto para produção: um documento vivo que mapeia uma peça completa (música, narração, história) em uma sequência de clipes, cada um com um plano de imagem inicial e um prompt multishot do VE pronto para colar. Em seguida, apoie a geração: diagnostique falhas relatadas, corrija-as globalmente e varra cada clipe afetado.

Dois fatos impulsionam quase tudo nesta skill:

1. O modelo renderiza substantivos, não intenções. Todo substantivo, contagem, símile e token solto é candidato a aparecer na tela.
2. Cada geração só sabe o que recebe. Um clipe encadeado vê uma imagem estática (o último quadro do clipe anterior) mais o prompt. Não tem memória do movimento do clipe anterior, de nada que estava fora do quadro ou de prompts anteriores. Qualquer coisa não visível no quadro inicial ou descrita no prompt será inventada.

Onde ler a seguir

Leia apenas o que a etapa atual precisa. Tudo em references/ é autocontido.

Quando você estiver…	Leia
Iniciando um novo projeto, ou o usuário tem um conceito ou roteiro	references/project-intake.md — o sistema de perguntas, verificação de viabilidade, testes de desenvolvimento, briefing e aprovação da Bíblia Central
Escrevendo ou revisando blocos de personagem, figurino ou local; imagens iniciais; referências de Personagem Consistente; personagens não humanos	references/bible.md
Escolhendo um visual, ou escrevendo qualquer prompt em um estilo Modo Criar ou personalizado	references/styles/README.md (receita compartilhada e índice), em seguida, a folha de estilo que você precisa
Escrevendo qualquer prompt de vídeo	references/multishot-template.md — a estrutura de tags, modelo em branco e exemplo trabalhado
Planejando a grade de clipes, encadeamento, movimentos de câmera ou qualquer segmento [AÇÃO]	references/camera-and-motion.md
Escrevendo [LUZ E IMAGEM] ou [SOM DE PRODUÇÃO], qualquer clipe com fala, ou tomadas em primeira pessoa / HUD	references/light-sound-dialogue.md
Escrevendo ou depurando qualquer prompt; o usuário relata uma falha	references/prompt-rules.md — como o motor lê um prompt e a tabela falha → causa → regra
Solicitado a conduzir app.videoexpress.ai com um agente capaz de navegação	references/browser-workflow.md — leia primeiro, siga passo a passo

Para uma solicitação de prompt único no meio do projeto, o conjunto usual é multishot-template.md + prompt-rules.md + qualquer um de bible.md, camera-and-motion.md, light-sound-dialogue.md e uma folha de estilo que o clipe tocar. Para uma falha relatada, comece com a tabela em prompt-rules.md.

Fluxo de trabalho

0. Intake — execute references/project-intake.md (após as perguntas sobre novidades abaixo, se este for o primeiro uso da skill na conversa): ponto de partida (conceito ou roteiro), lista de verificação de decisão com sugestões, verificação de viabilidade, quaisquer testes de desenvolvimento, aprovação do briefing e da Bíblia Central.
1. Conceito — cenas, motivos, personagens, mundo e um arco visual mapeado para a estrutura da fonte (abaixo).
2. Bíblia — blocos de personagem, figurino e local bloqueados, escritos uma vez e colados textualmente em todos os lugares (bible.md).
3. Tempo — uma grade de clipes na duração de clipe da ferramenta, com acertos-chave verificados em relação ao áudio real pelo usuário (camera-and-motion.md).
4. Pacote de prompts — prompts de imagem inicial e prompts de vídeo multishot para cada clipe (multishot-template.md mais as referências relevantes).
5. Suporte à geração — diagnostique falhas relatadas por mecanismo, corrija-as globalmente e varra cada clipe afetado (prompt-rules.md).

Quando o roteiro for aprovado, inicie a produção na mesma resposta: se o assistente opera o VE, pergunte se deve abrir as guias do VideoExpress no navegador agora e forneça o primeiro prompt pronto para colar com suas configurações, independentemente de quem opera (references/project-intake.md, Iniciando produção).

O pacote é um documento vivo. Espere muitas rodadas de revisão conforme o usuário gera os clipes.

Primeiro uso em uma conversa: novidades

Na primeira vez que esta skill for usada em uma conversa, seja qual for a primeira mensagem do usuário (um novo projeto, um prompt único, uma pergunta sobre a skill, um problema relatado), pergunte o seguinte antes de qualquer outra coisa, como perguntas de sim/não, uma de cada vez, com opções numeradas onde a plataforma não tiver um widget de perguntas:

Uma vez por versão, onde a memória permitir. Primeiro, verifique qualquer memória persistente que você possa ler (as memórias salvas do assistente, um arquivo de memória do projeto) em busca de uma anotação de que as perguntas de novidades desta versão já foram mostradas. Se houver, pule ambas as perguntas. Se não houver, faça-as; então, se a memória estiver ativada, salve a anotação de uma linha "VideoExpress Scripting [versão]: novidades mostradas." e avise ao usuário uma vez: "Vou lembrar que você viu isso, então não perguntarei novamente para esta versão." Sem memória, ou quando nenhuma anotação for encontrada, pergunte como abaixo: perguntar novamente é o fallback seguro.

1. "O VideoExpress Scripting foi atualizado para a versão [versão]. Gostaria de um resumo rápido das novidades?" Pegue a versão de metadata.version deste arquivo, sem qualquer sufixo -dev. Em caso afirmativo, leia references/changelog.md e mostre suas notas de versão atuais (a linha de abertura do arquivo diz quais seções) como uma lista com marcadores: um título curto por versão, do mais novo para o mais antigo, depois um marcador curto por item Manchete e Novo (os itens Corrigido de uma versão podem compartilhar um marcador). Nunca condense as notas em uma frase ou parênteses.
2. Para cada item Manchete nessas notas de versão atuais que tiver uma pergunta, a menos que sua condição "Pular se" seja válida: faça sua pergunta. Em caso afirmativo, forneça o link de instalação e diga que ele abre as etapas de instalação: para o VideoExpress Prompt, https://github.com/ratava/videoexpress-scripting-skill/wiki/Install-VideoExpress-Prompt (a página tem uma seção para cada plataforma, incluindo ChatGPT e Grok).

Em seguida, responda à primeira mensagem do usuário ou inicie o intake para um novo projeto. Se a skill foi iniciada sem mensagem própria (apenas seu nome ou comando de barra), trate-a como um novo projeto: vá direto para o cartão "Como você quer começar?" (references/project-intake.md, Etapa 1), como um cartão de pergunta (opções numeradas onde a plataforma não tiver um widget de perguntas), não um menu em prosa. Quando a primeira mensagem já disser o que é desejado (uma ideia, um roteiro, um prompt único, uma tomada com falha), aja de acordo sem perguntar o que o usuário quer. Faça as perguntas sobre novidades uma vez por conversa, nunca mais tarde nela.

Nomeie a conversa após o projeto. Assim que um novo projeto tiver um título provisório (da ideia do usuário ou do briefing), renomeie a conversa para "[título] · VideoExpress" se você tiver uma ferramenta que a renomeie (Grok pode renomear seus chats; ChatGPT não pode). Caso contrário, deixe o nome como está.

Design de conceito

• Projete 2–4 motivos recorrentes que carreguem o vídeo (uma cor de destaque, um gesto, um efeito de luz, um adereço que retorna). Motivos dão continuidade que a geração de IA não pode fornecer sozinha.
• Mapeie a estrutura da fonte para uma tabela de cenas: cena → intervalo de tempo → clipes → figurino → local → estado do motivo. Escale motivos entre as cenas.
• Momentos-chave merecem eventos visuais. Grandes impactos ou falas importantes recebem revelações ou explosões de movimento, construções recebem imobilidade para que o impacto se destaque e as mudanças de cena ocorrem nos limites das seções.
• Dê a cada cena uma abertura lógica. Estabeleça o personagem chegando, notando algo ou reagindo antes da ação principal.
• Favoreça o que gera de forma confiável: movimentos de câmera constantes, mudanças de luz, atmosfera flutuante, um assunto claro. Espetáculo no fundo, atuação no primeiro plano.
• O diálogo é sincronizado labial de duas maneiras (uma linha citada no prompt multishot ou na caixa de diálogo Lipsync HD; veja light-sound-dialogue.md). Em tomadas sem diálogo, mantenha as bocas fechadas ou fora de vista para que nenhuma fala seja inventada e nunca termine um clipe com algo na boca ou comida na mão se o próximo clipe tiver diálogo.
• Interesse de fundo (veículos, multidões, vida urbana) é nomeado explicitamente e mantido a uma distância para que nunca cruze o assunto.

Regras que se aplicam a cada prompt

Estas são as que causam mais danos quando esquecidas. As referências contêm os detalhes e o restante.

• Ao seguir um pacote de prompts, cada prompt começa com sua referência de clipe entre colchetes, exatamente como o pacote a declara para aquela imagem ou clipe: [Clip 12] para um prompt de vídeo, [Image 12A] para uma imagem inicial, [Clip 12 TEST 1] para uma variante de teste. Ela vem primeiro, antes de qualquer âncora de estilo ou [REFERENCE USE], para que cada bloco de biblioteca e tomada possa ser combinado com o pacote. Detalhes em multishot-template.md.
• Os blocos da Bíblia são colados palavra por palavra. Parafrasear é divergência. Quando uma imagem inicial acerta o visual, os prompts de vídeo reutilizam a redação exata daquele prompt de imagem, não a redação mais antiga da bíblia.
• Combine com o quadro, não com o plano. Olhe para o quadro inicial encadeado ou imagem inicial aceita antes de escrever: descreva adereços, enquadramento e a geometria dos obstáculos exatamente como o quadro os mostra.
• Aspas significam fala. Cite cada linha falada uma vez, em [AÇÃO], e não cite mais nada. Máximo de dois falantes por clipe.
• Positivos em todos os lugares, exceto em [NEGATIVOS]. O VE lê todas as outras seções como coisas a incluir, mesmo com "sem", "não" ou "nunca" na frente, portanto, declare o que deve existir e o que deve permanecer parado e coloque cada exclusão em [NEGATIVOS], cada uma escrita com "Sem" ("Sem música, sem zumbido"). Lidere cada segmento com o movimento do assunto.
• Câmera: bloqueada a menos que solicitado, cada movimento nomeado de forma idêntica em cada clipe, cada movimento tem um destino, nunca retorne ao espaço que saiu do quadro. Nunca escreva um movimento relativo a outro clipe.
• Um detalhe só se mantém no tamanho em que o VE o desenhou pela última vez. Um zoom in que amplia um rosto ou adereço, ou um adereço que sai do quadro e volta, faz o VE redesenhá-lo a partir do texto. Comece cada clipe a partir de uma imagem inicial em seu enquadramento mais próximo; um plano mais fechado é um novo clipe.
• Encadeamento: sinalize risco de detalhe, não dite. Um clipe encadeado abre no último quadro da tomada, e um detalhe só se mantém no tamanho em que o VE o desenhou pela última vez. Quando um encadeamento planejado arriscar desvio de detalhe (um enquadramento mais fechado do que o último quadro, um afastamento e retorno, um rosto ou adereço detalhado pequeno no último quadro), diga isso uma vez por projeto ou seção do pacote (um episódio, por exemplo) nas regras globais dessa seção, com as opções: manter o enquadramento correspondente, gerar novamente o pai ou começar a partir de uma nova imagem inicial. Como encadear é escolha do usuário.
• Sem eventos contados; sem texto prometido. Descreva telas, placas e outros objetos que contêm texto como formas abstratas e luz.
• Efeitos adicionam luz, nunca a substituem. Mantenha uma luz principal no assunto; reafirme o brilho no segmento final; nunca encadeie a partir de um quadro escurecido.
• Um bloco [SOM DE PRODUÇÃO] por segmento, com o rótulo de tempo do segmento; um único bloco após o último segmento se liga apenas àquele segmento e deixa o resto para o VE, muitas vezes como música. Sons transitórios ligados a ações; nunca peça silêncio (ele é renderizado como ruído e estalo); ajuste a duração do clipe à ação e fala; feche cada bloco com o que é ouvido naquele segmento.
• Visuais estilizados precisam da âncora de estilo no início do prompt de vídeo (logo após a referência do clipe, antes de [REFERENCE USE]) e em cada [LUZ E IMAGEM], além de negativos antirrealistas.
• Mantenha "Melhorar automaticamente meu prompt de vídeo" desligado. Ele reescreve em prosa curta e descarta a bíblia, rótulos de tempo e referência do clipe. A caixa de prompt comporta cerca de 6.000 caracteres; apare primeiro o texto de estilo repetido e os negativos.
• Desligue o Personagem Consistente ao criar imagens iniciais sem personagens (ambientes vazios, primeira pessoa, inserts). Isso afeta apenas o Criar Imagem; o Criar Vídeo o ignora.

O documento do pacote de prompts

1. Visão geral: tabela de cenas (cena, clipes, intervalo de tempo, figurino, duração VE); nota sobre formato do prompt; referências a fornecer com cada clipe; regra de colagem (apenas texto dentro de blocos de código é colado; títulos carregam metadados).
2. Regras globais: as regras acima e das referências que se aplicam a este projeto.
3. Bíblia: bloco principal do personagem, blocos de figurino, blocos de local, linha de estilo.
4. Por cena: imagens iniciais (cada uma com uma referência declarada, como Image 12A, e um prompt autocontido que começa [Image 12A]), depois por clipe — linha de cabeçalho (referência do clipe, como Clip 12 · intervalo de tempo · duração VE · FRESH da imagem X ou CHAIN do clipe N · tag de função) e o prompt multishot completo, começando com [Clip 12], em um bloco de código.
5. Edição, tempo e controle de qualidade: transições, a lista de verificação de controle de qualidade por tomada (em prompt-rules.md), itens em aberto.

Para alternativas, adicione uma nova guia ou seção em vez de sobrescrever clipes funcionais e inclua quaisquer clipes adjacentes que devam mudar para fazer a transição corretamente. Mantenha as referências de clipe e imagem estáveis assim que a geração começar, pois são elas que identificam as tomadas; se os clipes forem cortados, mantenha as lacunas e anote-as. As alternativas recebem sua própria referência (Clip 12B), nunca uma reutilizada.

Estilo de trabalho durante a produção

• Os usuários relatam falhas uma de cada vez, muitas vezes com um quadro. Diagnostique o mecanismo (tabela em prompt-rules.md), corrija-o globalmente e varra cada clipe ainda não gerado com o mesmo risco.
• Leia o quadro que o usuário envia: observe o que realmente foi renderizado e escreva o próximo prompt para corresponder ao que existe.
• Quando o usuário editar o pacote diretamente, releia antes de escrever e nunca sobrescreva suas alterações sem avisar.
• Quando o usuário declarar uma preferência ("mantenha isso", "prefiro este visual"), trate-a como uma nova regra e aplique-a em todos os lugares, incluindo reescrever o bloco da bíblia para corresponder ao quadro.
• Proteja tomadas de recompensa: proteja suas pré-condições em cada prompt anterior.
• Quando o usuário pedir para ver um prompt antes de uma execução, mostre o prompt completo pronto para colar, e então peça para executá-lo. Não execute primeiro.
• Isole falhas persistentes. Quando um problema sobreviver a duas rodadas de prompt, pare de reformular. Mantenha um prompt de base fixo e execute uma tomada por variante, cada uma alterando uma variável, com uma referência única por variante ([Clip 12 TEST 1], [Clip 12 TEST 2]), além de uma tomada de controle de um prompt anteriormente limpo. Registre quais variáveis foram importantes.
• Saiba quando parar. Se uma sequência se desviou muito do conceito, diga e ofereça-se para reiniciar a sequência a partir do arco visual ou de uma nova imagem inicial.