Storyboard de Série Curta Vertical
Transforme roteiros de episódios finalizados e aprovados por verificação automatizada em um storyboard de dois níveis (segmento → tomada) que pode ser filmado e auditado, mantendo simultaneamente entradas mínimas de ativos visuais e uma tabela de continuidade entre episódios.
Quando usar / não usar
- Use este skill: para dividir
drama/{series}/episodes/ep{NNN}.mdem um storyboard; criar entradas mínimas de ativos ou variantes para personagens, locais e adereços que aparecem neste episódio; manter o estado de continuidade entre episódios; e atualizar storyboards existentes após a finalização de revisões de roteiro. - Escrever ou editar roteiros de episódios (incluindo edição de falas, preenchimento de linhas de mapeamento, finalização): encaminhe para
fiction-short-drama. Este skill nunca altera o texto do roteiro ou as falas; se o roteiro não estiver finalizado, as linhas de mapeamento estiverem faltando, houver bloqueios na verificação automatizada ou ações que não podem ser filmadas, ele retorna para a etapa anterior. Sefiction-short-dramanão estiver instalado, liste o estado não finalizado, as linhas de mapeamento faltantes ou os erros específicos com números de linha, e peça ao autor para corrigir manualmente antes de continuar. - Preencher a aparência completa do ativo e palavras de bloqueio, escrever slots de imagens de referência, escrever prompts de imagem/vídeo, fazer confirmação pré-paga: encaminhe para
fiction-visual-prompts. Este skill nunca escrevepalavra de bloqueio, não escreve prompts ou parâmetros de modelo no storyboard e não chama nenhuma interface de geração. - Determinar o estágio do projeto: encaminhe para
fiction-workflow; se não estiver instalado, pergunte diretamente ao autor sobre a série alvo e o número do episódio.
Se fiction-visual-prompts downstream estiver faltando, entregue o storyboard verificado, a biblioteca de ativos e a tabela de continuidade, anotando claramente que prompt-check não foi executado (este skill não o executa), e entregue uma lista de tarefas manuais downstream: preencher a aparência completa do ativo e palavra de bloqueio, escrever slots de imagens de referência e prompts de imagem/vídeo do episódio em drama/{series}/prompts/, e, após verificar a correspondência por número de segmento e tomada, deixar o autor decidir se deve gerar.
Antes de começar
Primeiro, leia AGENTS.md na raiz do livro (especialmente a seção 'Escopo deste Livro'), .fiction/config.json, bible/sources.md (registro de entrada principal de escrita, veja SB §5). Em seguida, leia na ordem mínima obrigatória com base na tarefa (SB §4.1):
- Criar storyboard: Roteiro do episódio
drama/{series}/episodes/ep{NNN}.md→ saída destoryboard-check.mjs --brief→drama/{series}/visual/assets.md→drama/{series}/visual/continuity.md; leia conforme necessário o último segmento do storyboard do episódio anterior e a entrada debible/characters.mddos personagens que aparecem; para séries originais (series.mdcomOrigem: Original), leia também## Conta de Suspenseemdrama/{series}/series.md. - Criar / modificar ativos visuais:
drama/{series}/series.md→bible/characters.md(personagens principais e que aparecem neste episódio) →drama/{series}/visual/assets.md→ locais e adereços que aparecem no roteiro escrito; quando envolver prenúncios, artefatos ou padrões de época, leia conforme necessáriobible/inventory.md,bible/foreshadows.md,bible/timeline.md,bible/world-rules.md.
Antes de escrever ou modificar qualquer arquivo legível por máquina, abra primeiro o trecho de formato correspondente na tabela de documentos de referência no final, escreva de acordo com o texto original, não confie na memória.
A cadeia visual de séries curtas segue a precedência upstream (SB §3): características estáveis em characters.md > visual/assets.md > storyboard > prompts; roteiro > storyboard > prompts. Se um erro for encontrado upstream, corrija-o primeiro upstream, não crie uma descrição alternativa no storyboard.
Se a estrutura do projeto estiver faltando, sugira usar fiction-init primeiro; se fiction-init não estiver instalado, peça ao autor para preencher manualmente AGENTS.md (incluindo ## Escopo deste Livro), .fiction/config.json, bible/sources.md, bible/characters.md e os arquivos necessários em drama/{series}/ de acordo com SB §2, SB §5 e SB §8. Se apenas .fiction/config.json estiver faltando, o script será executado com valores padrão do contrato (SB §8), informando o autor.
Convenção de caminho: caminhos que começam com bible/, drama/{series}/ são relativos à raiz do livro; as abreviações visual/..., storyboards/..., episodes/... no texto são relativas a drama/{series}/. Todos os scripts são executados a partir da raiz do livro; caminhos com espaços devem ser colocados entre aspas.
Fluxo de sete etapas
1. Verificação pré-início: confirmar finalização e mapeamento, depois executar verificação de roteiro e resumo
Antes de iniciar o corte de tomadas (incluindo sincronização após revisões de roteiro subsequentes), verifique os três portões de entrada um por um:
- Roteiro finalizado: Abra
drama/{series}/episodes/ep{NNN}.md(SB §9.3), confirme que os metadados são- status: finalizado(finalizado pelo autor). - Linhas de mapeamento completas: Abra
drama/{series}/adaptation-map.md(SB §9.2), confirme que existe uma linha correspondente para o episódio alvo e que as colunas de personagens e prenúncios foram preenchidas de acordo com este episódio (embora linhas faltantes apenas emitam uma sugestãomap-missing, elas farão com que o resumo perca os personagens mapeados deste episódio e seus segredos). - Verificação automatizada de roteiro totalmente verde: Execute (veja
drama-check.mjs --helppara uso):
node <diretório deste skill>/scripts/drama-check.mjs <series> --ep <N>
Deve ter código de saída 0, e zero block tanto no nível da série quanto no episódio alvo (código de saída 2 é erro de parâmetro, configuração ou leitura, não é considerado aprovado); ao mesmo tempo, verifique se fiction-short-drama relatou que o lint --series mais recente para este drama teve código de saída 0. Se qualquer item não for atendido, pare e retorne para fiction-short-drama; se o relatório lint estiver faltando, peça para ele executá-lo e relatar (se não estiver instalado, liste as lacunas e números de linha de erro e peça ao autor para corrigir manualmente). Se houver sugestões unshootable, dialogue-run etc., continue se puder ser resolvido pelo corte de tomadas; se realmente não puder ser filmado, peça ao autor para modificar o roteiro primeiro.
Após passar pelos portões de entrada, execute o resumo do storyboard (veja storyboard-check.mjs --help para uso):
node <diretório deste skill>/scripts/storyboard-check.mjs <series> --ep <N> --brief
Leia todas as cinco seções seção por seção: ## Fonte, ## Verdades que não podem ser desenhadas neste episódio (derivado de qualquer linha de adaptation-map.md ou prenúncio não pago antecipadamente em qualquer ativo revelar prenúncio), ## Segredos do personagem (derivado da coluna personagem do mapeamento deste episódio e aqueles em personagens principais de series.md que têm verdade do autor preenchida), ## Ativos ainda não disponíveis, ## Status da continuidade. Se series.md tiver Origem: Original, o resumo não escaneará os suspenses originais, então deve-se ler manualmente ## Conta de Suspense em drama/{series}/series.md e incluí-los na lista de anti-spoiler.
2. Criar ativos visuais mínimos e registrar alterações líquidas de continuidade
Atualize drama/{series}/visual/assets.md de acordo com SB §9.4 e SB §6.1 (para criação inicial, consulte o modelo de ativo visual):
- Princípio da entrada mínima: Crie apenas entradas
### {chave do ativo}com uma linha visível- aparência:para personagens, locais e adereços que precisam aparecer na tela neste episódio (para locais, pode-se complementarponto de ancoragem; para adereços com entrada correspondente embible/inventory.md, complemente- item: Ixxx; para entradas confidenciais, complemente- revelar prenúncio:ou- episódio de revelação:). Não escrevapalavra de bloqueio, deixe o refinamento da aparência completa e os slots de imagem de referência parafiction-visual-prompts. Ao criar pela primeira vez, escrevaproporção de telaapenas se a proporção for diferente dovisual.aspect_ratiodo config, e confirme com o autor oestilo de artebásico de todo o drama. - Nome padrão e variantes: Use o nome padrão de
bible/characters.mdpara## Personagens; não crie entradas para figurantes sem arquivo; não repita o mesmo nome em grupos diferentes; usenome@variantepara mudanças de aparência ou estado (deve haver uma entrada base primeiro no mesmo grupo). Não misture os três níveis; veja o guia de escrita de ativos visuais para detalhes. - Atualizar resumo: Se esta etapa adicionou ou modificou qualquer
revelar prenúncio/episódio de revelação, execute imediatamentenode <diretório deste skill>/scripts/storyboard-check.mjs <series> --ep <N> --briefnovamente para sincronizar as novas verdades de prenúncio e ativos de acesso restrito na lista de verificação deste episódio.
Se este episódio tiver mudanças de estado que continuarão para episódios subsequentes (troca de roupa, ferimentos/ sujeira contínuos, transferência/ destruição/ saída de cena de adereços, mudança permanente de local), escreva diretamente a alteração líquida deste episódio em drama/{series}/visual/continuity.md de acordo com SB §9.5 (para criação inicial da tabela, consulte o modelo de tabela de continuidade entre episódios), para que a verificação automatizada na etapa 6 possa ser aprovada de uma só vez. Se houver inconsistências entre continuity.md e bible/inventory.md no resumo, com exceção das adaptações já aprovadas pelo autor e registradas em adaptation-map.md, liste todas as outras diferenças e peça ao autor para decidir, nunca reescreva bible/inventory.md do romance; veja o guia de continuidade entre episódios para detalhes.
3. Primeiro segmentar, depois cortar tomadas
Abra SB §9.6 e SB §6.1, e escreva drama/{series}/storyboards/ep{NNN}.md de acordo com o modelo de storyboard, inicialmente escrevendo - status: rascunho.
- Primeiro segmente (
## SEG01|Cena 1): Um segmento = uma geração de vídeo, nunca cruze cenas. Normalmente, divida em segmentos de 9–15 segundos com base nas unidades de história (tomadas curtas de transição podem ser menores que 9 segundos), a duração total não deve excederstoryboard.segment.max_seconds(padrão 15 segundos, veja SB §8). Preencha obrigatoriamentelocal, e opcionalmenteposicionamento,som ambiente,música de fundo. - Cortar tomadas dentro do segmento (
### SH001|3s): Uma tomada deve ser cortada em torno de 3 segundos, dentro destoryboard.shot.seconds(padrão 2–5 segundos), a duração não pode ser 0. Preencha obrigatoriamenteenquadramento(conjunto fechado de 6 itens) eimagem, e opcionalmentemovimento de câmera(conjunto fechado de 8 itens, padrãofixo),transição(conjunto fechado de 4 itens, padrãocorte),personagens,adereços,fundamento,som,observações. - Reivindicação textual de falas e ações:
- Falas: Copie cada fala da cena na ordem do roteiro exatamente como está no bloco da tomada (incluindo pontuação e
(OS)/(VO)aplicáveis), não mude palavras, não delete palavras. Se uma única fala, convertida em segundos pela taxadrama.chars_per_minute(padrão 250 pontos de código/minuto, sem arredondamento), não couber em uma única tomada, divida-a em linhas de fala legais em tomadas adjacentes, que, quando combinadas, devem ser idênticas caractere por caractere à fala original. - Ações e linhas de câmera: Extraia trechos do texto original das linhas de ação
△e linhas de câmera【…】em- fundamento:(pelo menos 4 pontos de código por segmento, use;para separar vários), e certifique-se de queimagemrealmente representa a ação.
- Falas: Copie cada fala da cena na ordem do roteiro exatamente como está no bloco da tomada (incluindo pontuação e
- Linguagem visual e enquadramento vertical: A primeira tomada de todo o episódio deve ter um sujeito em movimento; os enquadramentos devem alternar entre perto e longe, a duração deve alternar entre curta e longa; para diálogos, corte em plano/contraplano e deixe tomadas de reação, para ações importantes, insira closes curtos; corte no meio da ação (corte em movimento); cada segmento pode ter no máximo 1–2 movimentos de câmera não-fixos, o padrão é
fixo; para tela vertical 9:16, evite planos abertos vazios, use primeiro, segundo e terceiro planos para criar profundidade, use as ações dos personagens para mostrar o ambiente, escreva a posição da câmera, ângulo e distância focal emimagem. Veja a gramática de segmentação e corte de tomadas e enquadramento vertical e escrita de imagem para detalhes. - Manter numeração estável: Para inserir tomadas, use novos números ou sufixos de letras (por exemplo,
SH003a), não altere números antigos para estender a sequência, não reutilize números excluídos.
4. Escrever imagem claramente com base no princípio do instante único
Organize imagem de cada tomada como "ponto de partida → ação → ponto final", para que, ao escrever o prompt do primeiro quadro, fiction-visual-prompts downstream congele apenas o instante do ponto de partida, sem se antecipar ao processo ou resultado. Apenas quando a composição final de uma tomada ou a postura de passagem deve ser fixada, anote em observações uma sugestão para adicionar um prompt de quadro final downstream. Veja o guia de instante único e limites de primeiro/último quadro para detalhes.
5. Verificação anti-spoiler tomada por tomada
Compare com a lista --brief mais recente (e ## Conta de Suspense de series.md para séries originais), verifique tomada por tomada, juntamente com os campos de nível de segmento posicionamento, som ambiente, música de fundo e os campos de nível de tomada imagem, som, observações:
- Não faça referência direta a
ativos ainda não disponíveis(gatilho de bloqueiosb-spoiler), nem use outras palavras para vazarverdades que não podem ser desenhadas neste episódio,segredos do personagemouconta de suspenseoriginal no texto da imagem; prenúncios marcados como "revelados neste episódio" também devem ser escondidos antes da tomada de revelação. - Quando algo precisa aparecer na tela mais cedo, mas não pode ser mostrado, use costas, obstrução de primeiro plano, silhueta contra a luz de fontes de luz existentes ou enquadramento parcial; quando o assunto estiver sob restrição de acesso, crie uma variante de obstrução com
episódio de revelação: 1e entregue afiction-visual-promptscom um lembrete para não anexar imagens de referência do assunto e para limpar campos herdados (SB §9.9). Quando não tiver certeza sobre o escopo, pare e pergunte ao autor. Veja o guia de verificação anti-spoiler tomada por tomada para detalhes.
6. Executar verificação automatizada, verificar cobertura, finalizar e sincronizar após revisão do roteiro
Depois de escrever o storyboard e as alterações líquidas de continuidade deste episódio, execute a partir da raiz do livro (use --json para verificar a cobertura e o resumo de duração, veja storyboard-check.mjs --help para uso):
node <diretório deste skill>/scripts/storyboard-check.mjs <series> --ep <N>
node <diretório deste skill>/scripts/storyboard-check.mjs <series> --ep <N> --json
- Confirme que a verificação completa foi realmente executada: Não apenas código de saída 0 e zero
block, mas também verifique na saída queassets.existsétrue(semva-missing, caso contrário, a verificação de ativos, anti-spoiler e continuidade será pulada) e que o episódio alvoNaparece emepisodes[](confirma que o storyboard do episódio alvo foi realmente validado). Código de saída 2 não é considerado aprovado. - Trate cada sugestão
suggestindividualmente: Decida modificar ou manter e documente o motivo. Qualquerobservaçõesnão vazia fará com que as verificaçõessb-peopleesb-continuitydessa tomada sejam puladas; só escrevaobservaçõescom um motivo real e verifique manualmente o número de pessoas na tela e a continuidade tomada por tomada (guia de continuidade entre episódios). [Modelo] - Finalização e reversão em caso de falha: Depois de limpar todos os
block, verificar que não há falas ou cenas não reivindicadas, e obter a confirmação do autor sobre itens duvidosos e finalização, altere ostatusparafinalizadoe executestoryboard-check.mjsuma última vez. Sobfinalizado,sb-dialogue-missingesb-scene-uncoveredserão elevados parablock; se qualquerblockou código de saída não zero aparecer na reexecução, reverta imediatamente ostatuspararascunhooumodificação, corrija e revalide, nunca entregue com erros. - Processo de sincronização durante revisões posteriores do roteiro:
- Após o roteiro revisado ser finalizado novamente e as linhas de mapeamento atualizadas, revalidar todos os portões de entrada da etapa 1.
- Execute
node <diretório deste skill>/scripts/storyboard-check.mjs <series> --ep <N>para localizar falas efundamentodesatualizados, primeiro corrija o storyboard mantendo a numeração não modificada estável. - Se as alterações do roteiro afetarem o estado entre episódios, primeiro revise a linha original deste episódio em
drama/{series}/visual/continuity.md(SB §9.5), depois executenode <diretório deste skill>/scripts/storyboard-check.mjs <series> --ep <N>-<último episódio>para os episódios subsequentes afetados e corrija em sincronia. - Depois que tudo for aprovado, entregue a lista de
SEG/SHmodificados deste episódio e dos episódios subsequentes afetados parafiction-visual-promptspara sincronizar prompts (SB §4.2), a ordem não pode ser invertida.
7. Relatório e entrega
Relate ao autor no formato abaixo e indique claramente se está sendo entregue a fiction-visual-prompts.
Lista de verificação de entrega
-
drama-check.mjs <series> --ep Ncódigo de saída 0, zeroblockno nível da série e no episódio alvo, linha do episódio emadaptation-map.mdcompleta (semmap-missing).[Script] - Relatório recebido de
fiction-short-dramade que olint --seriesmais recente para este drama teve código de saída 0.[Modelo] - Roteiro do episódio alvo finalizado pelo autor (
status: finalizado).[Autor] - Este skill não modificou nenhuma fala, ação ou história do roteiro; as alterações necessárias no roteiro foram retornadas upstream.
[Modelo] -
storyboard-check.mjs --ep N --brieffoi executado antes do início e todas as cinco seções foram lidas; o resumo foi atualizado após a modificação dos campos de revelação; para séries originais,## Conta de Suspenseemseries.mdfoi verificado manualmente.[Modelo] -
visual/assets.mdtem entradas mínimas para personagens (nome padrão), locais, adereços e variantes necessárias que aparecem na tela neste episódio, sem escreverpalavra de bloqueio.[Modelo] -
storyboard-check.mjs <series> --ep Ncódigo de saída 0, zeroblock, e a saída confirmaassets.exists: true, episódio alvo emepisodes[]; reexecução após finalização aprovada.[Script] - Todas as
suggestforam tratadas individualmente; as tomadas comobservaçõesforam verificadas manualmente quanto ao número de pessoas na tela e continuidade; as alterações líquidas de continuidade deste episódio foram escritas emvisual/continuity.md, sem reescreverinventory.mdouforeshadows.mddo romance.[Modelo] - A primeira tomada tem um sujeito em movimento; o enquadramento e a duração têm variação; cada segmento tem ≤2 movimentos de câmera não-fixos; as linhas de ação do roteiro são realmente realizadas como performance em
imagem(não apenas colocadas emfundamento);imagemé escrita como um instante único "ponto de partida → ação → ponto final"; a profundidade vertical da tela vertical é clara.[Modelo] - Verificação tomada por tomada, juntamente com campos de nível de segmento, contra a lista de imagens proibidas, sem vazamentos usando outras palavras.
[Modelo] - Tom visual, método de filmagem de cenas-chave, dúvidas anti-spoiler, diferenças de adereços entre mídias e finalização do storyboard foram todos aprovados pelo autor.
[Autor]
Saída e relatório
Saída ou atualização: drama/{series}/storyboards/ep{NNN}.md, drama/{series}/visual/assets.md, atualize drama/{series}/visual/continuity.md conforme necessário. Relatório em cinco pontos:
- Escopo e duração do storyboard: Pegue o número do episódio, caminho,
status,segments,shots,secondserangedeepisodes[]emstoryboard-check.mjs --ep N --json(serangefornull, relate "Duração alvo não definida"; se estiver fora do intervalo, é um item de sugestão, explique o motivo do ajuste ou manutenção). - Resultados da verificação automatizada: Códigos de saída e contagens de
blockdedrama-checkestoryboard-check(ambos devem ser 0), confirmeassets.exists: truee que o episódio alvo foi verificado; liste quaisquersuggestnão resolvidas e o motivo de cada uma. - Alterações de ativos e continuidade: Novas entradas mínimas e variantes criadas desta vez em
visual/assets.md(incluindo itens de herança de variante de obstrução que requerem atenção downstream); linhas adicionadas ou revisadas emvisual/continuity.md. - Escopo de sincronização de revisão (apenas durante revisão): Lista de números
SEG/SHmodificados deste episódio e dos episódios subsequentes afetados parafiction-visual-promptssincronizar. - Pendente confirmação do autor: Dúvidas anti-spoiler, diferenças de itens entre mídias, método de filmagem de cenas-chave ou itens que precisam ser retornados para modificação do roteiro; se não houver, escreva "Nenhum".
Documentos de referência
| Quando encontrar... | Leia este documento |
|---|---|
| Verificar caminhos de diretório, resolução de conflitos de cadeia visual, ordem mínima de leitura obrigatória e escrever de volta por evento | SB §1–§5: Estrutura do projeto e regras de leitura/escrita |
| Verificar formato de roteiro de episódio, cabeçalho de cena, linhas de fala e tabela de mapeamento | SB §6.1, §9–§9.3: Roteiro de série curta |
| Escrever ativos visuais, tabela de continuidade entre episódios, campos de storyboard, lista de palavras de conjuntos fechados e regras anti-spoiler | SB §6.1, §9.4–§9.6, §9.9: Ativos visuais e storyboard |
| Verificar proporção de tela, duração de segmento/tomada, limite de pessoas, velocidade de fala e outros valores padrão de configuração | SB §8: Configuração do projeto |
| Segmentação e corte de tomadas, divisão de falas entre tomadas, contagem de movimento de câmera não-fixo, demonstração do episódio 3 | Gramática de segmentação e corte de tomadas |
Composição de tela vertical 9:16, profundidade de primeiro/segundo/terceiro plano, escrever posição da câmera/ângulo/distância focal em imagem | Enquadramento vertical e escrita de imagem |
| Escrever "ponto de partida → ação → ponto final", distinguir instante único do primeiro quadro e quando marcar quadro final | Instante único e limites de primeiro/último quadro |
| Escrever três limites de ativos, posição relativa e ponto de ancoragem de local, filtragem de adereços e regras de caligrafia | Guia de escrita de ativos visuais |
Usar --brief e conta de suspense original para verificação anti-spoiler tomada por tomada, quatro métodos de ocultação, variante de obstrução | Verificação anti-spoiler tomada por tomada |
Escrever alterações líquidas entre episódios, resolução de variantes, isenção de flashback, tratamento de diferenças com inventory.md | Guia de continuidade entre episódios |
| Criar novo esqueleto de storyboard, biblioteca de ativos ou tabela de continuidade entre episódios | Modelo de storyboard, Modelo de ativo visual, Modelo de tabela de continuidade entre episódios |