Geração de Storyboard para Livro Ilustrado Infantil
Este arquivo define apenas a camada de organização: entrada, estrutura de entrega, ordem de execução e validação. As regras específicas e modelos para criação de história, prompts de desenho, prompts de vídeo e prompts de dublagem estão todos localizados nos arquivos a seguir. Este arquivo não contém nem repete seu conteúdo.
| Arquivo | Conteúdo Responsável |
|---|---|
references/story.md | Todas as regras e etapas de execução para a fase de história, definidas pelo próprio arquivo |
references/creativity-path.md | Caminho criativo opcional (desativado por padrão): contrato de interface e fontes de valores substituíveis |
references/drawing-prompt.md | Regras para a fase de prompt de desenho, incluindo o modelo original e os termos negativos de desenho (única cópia em toda a skill) |
references/video-prompt.md | Regras para a fase de prompt de vídeo, incluindo termos negativos de vídeo e formato de frase final (única cópia em toda a skill) |
references/voice-prompt.md | Regras para a fase de prompt de dublagem, incluindo termos negativos de dublagem, formato de frase final e mapeamento de campos para três plataformas (única cópia em toda a skill) |
references/mcp-setup.md | Guia de configuração MCP para otimização de prompt de desenho, atualmente desativado e não participa da execução, lido apenas quando esse recurso é ativado |
references/example.md | Exemplo de formato final para regressão de script |
scripts/pick_direction.py | Fonte de valores para o caminho criativo (opcional) |
scripts/check_storyboard_md.py | Compara o arquivo final com os dois modelos originais, palavra por palavra |
Pré-condições
O tema do livro ilustrado é fornecido pelo usuário. Pode ser um tema simples (apenas personagem principal e cenário) ou um tema com enredo (já incluindo desejo e obstáculo). Quando o tema não for fornecido, processe as fontes candidatas de acordo com references/story.md e o usuário seleciona; se as fontes não tiverem resultados, encerre e solicite o tema. Não invente um tema nem produza exemplos primeiro.
Ponto de Entrada Externo
| Entrada do Usuário | Conteúdo de Entrega |
|---|---|
| Um tema de livro ilustrado (ex.: "A Lua e a Estrelinha") | Um pacote de storyboard, cada quadro com 6 linhas; número padrão de quadros definido por references/story.md |
| Tema não fornecido e permissão para a skill escolher | Vários temas candidatos (nome do tema, direção em uma frase, personagem principal, ambiente); não produz storyboard diretamente; após a seleção, entregue conforme a linha anterior |
Quando o usuário solicitar apenas prompts de vídeo ou prompts de geração de vídeo a partir de imagem, explique que esse conteúdo faz parte do processo interno da skill e não é entregue separadamente, e peça ao usuário que forneça o tema do livro ilustrado. Após o fornecimento do tema, o prompt de vídeo é escrito na linha seguinte a "→ Prompt de desenho:". Não deduza storyboards para atender a tais solicitações.
Estrutura de Entrega (Obrigatória, Imutável)
Cada quadro tem exatamente 6 linhas, ordem fixa:
【Quadro X】
Frase curta em inglês
→ Tradução para português
→ Prompt de desenho: <Preenchido palavra por palavra conforme o modelo original em references/drawing-prompt.md>. Negativos: <Termos negativos de desenho do mesmo arquivo>
→ Prompt de vídeo: <Conforme o formato de frase final em references/video-prompt.md, com termos negativos no final>
→ Palavras-chave: 【cor / tamanho / verbo de ação / lugar】
→ Prompt de dublagem: <Conforme o formato de frase final em references/voice-prompt.md, com termos negativos de dublagem no final>
Cinco restrições obrigatórias:
- A frase curta em inglês ocupa a primeira linha sozinha, sem aspas, parênteses, notas ou descrições do quadro.
- Os termos negativos de desenho são colocados no final da mesma linha do prompt de desenho, precedidos por "Negativos:"; sem quebra de linha, sem resumo no final do quadro.
- O prompt de vídeo segue imediatamente a linha do prompt de desenho, comprimido em um parágrafo, sem tags ①②③, sem seção separada.
- As palavras-chave são fixas na 5ª linha, ordem inalterada, cada uma correspondendo ao conteúdo específico do quadro.
- O prompt de dublagem é fixo na 6ª linha, a última do quadro. O texto para leitura deve ser idêntico, palavra por palavra, à frase curta em inglês da 1ª linha. Os parâmetros são escritos como campos que podem ser inseridos em um modelo de áudio.
Nota de nível de arquivo: Escreva uma linha de orçamento de leitura (segundos de vídeo e segundos de orçamento para cada quadro) antes do primeiro "【Quadro X】", para alinhamento com um modelo de voz independente; esta linha é uma nota de nível de arquivo, não inserida em nenhum quadro, não altera as 6 linhas de cada quadro.
Ordem de Execução
- Conclua a etapa de história de acordo com
references/story.md, produzindo as frases curtas em inglês e as traduções para o português de cada quadro. - Conclua a etapa de prompt de desenho de acordo com
references/drawing-prompt.md, produzindo a linha de prompt de desenho e a linha de palavras-chave de cada quadro. A otimização de desenho está atualmente desativada (consulte "Recurso Externo: Otimização de Prompt de Desenho"), produza diretamente, sem detectar ou chamar. - Conclua a etapa de prompt de vídeo de acordo com
references/video-prompt.md, produzindo a linha de prompt de vídeo de cada quadro. - Conclua a etapa de prompt de dublagem de acordo com
references/voice-prompt.md, produzindo a linha de prompt de dublagem de cada quadro. - Execute
python scripts/check_storyboard_md.py <arquivo_final.md> --theme "<tema>"para validação. Erros devem ser corrigidos até a aprovação. A dublagem é pós-processada por um modelo de voz independente, não sai junto com o vídeo; se os segundos de leitura reais forem obtidos, revalide com--voice-seconds "1:3.8,2:4.2". Se exceder o orçamento, encurte a frase primeiro, não estenda o vídeo.
Requisito de transição: O próximo passo baseia-se no produto do passo anterior; quando um passo subsequente entrar em conflito com a etapa anterior, reverta a etapa anterior, não force a autoconsistência no passo subsequente. O script valida apenas o formato e a consistência com os modelos. A verificação semântica, se a frase em inglês é bem representada, é responsabilidade do conteúdo de cada arquivo de referência.
Recurso Externo: Otimização de Prompt de Desenho (Opcional)
Estado Atual: Desativado. O prompt-optimizer ainda não está maduro. Por padrão, na execução, não detecta, pergunta, configura ou chama, nem lê references/mcp-setup.md. Os prompts de desenho são produzidos diretamente de acordo com references/drawing-prompt.md. As subseções a seguir são mantidas como regras para quando o recurso for ativado. A menos que o usuário solicite explicitamente "ativar otimização de prompt de desenho" na conversa, elas não serão executadas.
Quando ativado, após escrever o prompt de desenho, ele pode ser enviado a este MCP para uma otimização de redação no texto final já preenchido com os quatro slots. Este MCP é uma etapa de pós-processamento, não de geração de prompt: a lógica existente de entender o significado da frase, descrever a imagem em linguagem simples, preencher slots, montar o modelo e anexar os termos negativos é executada inalterada; o MCP apenas reescreve o texto dentro dos slots depois disso. Independentemente de estar ativado ou não, a forma de produção da etapa de desenho permanece a mesma. A falta dele significa apenas uma polidura a menos, não uma via de geração ausente.
Este recurso não é essencial; sua ausência ou indisponibilidade não bloqueia a entrega, e não se deve atrasar ou desistir da produção para usá-lo. Quando ativado, a configuração do MCP é executada pelo agente atual após confirmação do usuário: localizar o arquivo de configuração, fazer backup, mesclar entradas, validar e escrever de volta, tudo de acordo com "Etapas de configuração executadas pelo agente atual" em references/mcp-setup.md.
Contrato de Chamada (Desativado, para Referência)
A entrada do MCP é apenas uma coisa: o prompt de desenho já gerado para aquele quadro. Nenhum outro contexto é enviado.
- Entrada: O texto completo do prompt de desenho daquele quadro, do início do modelo "【Proporção da tela】" até o final dos termos negativos. Sem tags como "→ Prompt de desenho:", sem número do quadro, sem prefácio ou sufixo.
- Saída: Apenas o texto dentro dos três slots é adotado. As frases fixas do modelo e os termos negativos ainda seguem o texto original desta skill, não a versão retornada pelo MCP.
- Proibido: Tema do livro ilustrado, frase curta em inglês e tradução, linha de palavras-chave, linhas de vídeo e dublagem, conteúdo de outros quadros, cartão de história, requisitos de estilo, histórico de conversa, regras da skill. Não anexe antecedentes como "Por favor, entenda esta história primeiro" ou "Este é um livro infantil" antes ou depois do prompt, nem combine prompts de vários quadros em uma única solicitação.
- Um de cada vez: A chamada processa apenas o quadro atual; o texto retornado do quadro anterior não deve ser anexado à entrada do próximo quadro, para evitar contaminação cruzada.
- Campos Obrigatórios: Se o schema da ferramenta tiver outros campos obrigatórios, preencha apenas com valores neutros diretamente relacionados a "otimizar este prompt" (como idioma, tipo de tarefa), não use esses campos para transmitir o tema ou o conteúdo da história.
- Sem ida e volta: Uma chamada, uma adoção. Sem perguntas de acompanhamento, sem esclarecimentos de múltiplas rodadas. Se o retorno for inutilizável, reverta de acordo com "Restrições de Resultado de Otimização".
Detecção Pré-execução (Desativado, para Referência; Executado Uma Vez Antes do Início do Processo, Quando Ativado)
A detecção é concluída antes do passo 1, feita apenas uma vez para toda a rodada, sem repetir perguntas dentro dos quadros.
Obter Lista de MCPs: Leia os serviços MCP montados na sessão atual e a lista de ferramentas disponíveis, confirme se existe um prompt-optimizer (http://47.251.140.61:8081/mcp) e suas ferramentas fornecidas. Quando a lista não puder ser lida diretamente, pesquise ferramentas com a palavra-chave prompt optimizer. O julgamento é baseado em "o serviço existe e suas ferramentas podem ser chamadas", não no aparecimento da URL no diálogo, e não invente nomes de ferramentas por suposição.
| Resultado da Detecção | Ação |
|---|---|
| Montado | Não pergunte, não sugira instalação, mas informe ao usuário que este MCP será chamado para otimizar os prompts de desenho (uma linha de status, sem pop-up), depois use diretamente de acordo com o "Contrato de Chamada" |
| Não montado | Pergunte com um pop-up de confirmação se o usuário deseja instalar, explicando que este é um recurso opcional de otimização secundária de prompt de desenho e que não instalá-lo não afeta a produção do storyboard. Duas opções: Configurar agora, Não configurar agora |
| Selecionar "Configurar agora" | Leia references/mcp-setup.md, o agente atual executa a configuração de acordo com suas "Etapas de configuração executadas pelo agente atual": confirmar o cliente e a localização do arquivo de configuração, fazer backup, mesclar entradas, validar JSON; depois releia a lista de MCPs para verificar novamente. Se a verificação for aprovada, informe ao usuário "Configuração bem-sucedida. O prompt-optimizer será chamado para otimizar os prompts de desenho nas próximas etapas", então prossiga para o passo 1 e ative a otimização no passo 2 |
| Selecionar "Não configurar agora" | Não pergunte novamente nesta rodada; pule a otimização completamente e entregue os prompts de desenho originais |
- Se o agente atual não tiver permissão de escrita, não encontrar o arquivo de configuração ou se o cliente exigir reinicialização para reconhecer: envie o trecho de configuração do arquivo inteiro para o usuário, instruindo-o a executar ou reiniciar; esta sessão continua como se não estivesse montado, sem esperar ou bloquear; observe na nota de entrega.
- A recusa é lembrada apenas dentro desta sessão, não gravada em preferências de longo prazo nem altera os arquivos da skill. Na próxima execução, a detecção e a pergunta serão repetidas.
- Se a capacidade de pop-up não estiver disponível, substitua por uma pergunta curta, mantendo as duas opções.
- Se o usuário escolher "Configurar agora", mas até o passo 2 a otimização não estiver em vigor (não instalada ou não reiniciada), não faça um segundo pop-up, continue como não montado e observe na nota de entrega.
Chamada Intraquadro (Desativado, para Referência; Executado Após Cada Linha de Desenho Ser Escrita, Quando Ativado)
- Após cada linha de desenho ser escrita, faça uma chamada. Os parâmetros seguem o "Contrato de Chamada".
- A chamada deve ser visível: Não chame silenciosamente. Antes da chamada, imprima uma linha de status explicando o objeto e o quadro, por exemplo, "Chamando MCP prompt-optimizer para otimizar o prompt de desenho do Quadro 3"; após a chamada, imprima uma linha de resultado explicando se foi adotado (Adotado / Revertido, com uma breve razão).
- Chamada bem-sucedida: Extraia apenas o texto dentro dos três slots, verifique novamente de acordo com "Restrições de Resultado de Otimização" e escreva de volta na linha de desenho do quadro; as frases fixas do modelo e os termos negativos ainda seguem o texto original desta skill.
- Chamada falhou, expirou ou retornou vazia: Tente novamente no máximo mais uma vez; se ainda falhar, pule o quadro, marque como "Não otimizado (falha de conexão)", e o processo continua.
- Não pergunte ao usuário dentro de um quadro, não repita a confirmação de configuração, nem refaça o quadro anterior devido à falha de um único quadro.
Restrições de Resultado de Otimização
- Apenas otimize a redação, não redefina a imagem. Quem é o personagem principal, a quantidade, a pose, a orientação, a interação, o cenário e a iluminação não podem ser alterados. As alterações permitidas são limitadas a redação, precisão de detalhes visíveis e ordem das palavras. Não esvazie os slots, não remova informações existentes, não expanda para uma segunda ação.
- Frases fixas do modelo permanecem inalteradas, palavra por palavra. O texto original de "estilo de ilustração de livro infantil" a "luz suave, sem sombras duras, amigável para crianças pequenas, imagem sem texto interno, marcas d'água ou assinaturas" não pode ser adicionado, removido ou alterado; apenas o texto dentro dos três slots (personagem principal da cena, interação do personagem principal, ambiente/cenário) pode ser reescrito.
- Termos negativos permanecem inalterados. O texto otimizado não contém "Negativos:" e seu conteúdo subsequente; os termos negativos ainda são adicionados pela skill no final da linha.
- Restrições factuais permanecem inalteradas. Não adicione personagens, adereços ou cenários que não existem na frase curta em inglês; após a reescrita, ainda deve ser possível deduzir a frase.
- O script é a autoridade final. O quadro otimizado deve passar novamente por
check_storyboard_md.py; se falhar, reverta para o texto original do quadro antes da otimização e registre o motivo da reversão. - Os downstream usam a versão final. Os prompts de vídeo (passo 3) e os prompts de dublagem (passo 4) leem a linha de desenho otimizada. Se a otimização alterou a pose ou o cenário, a linha de vídeo do quadro deve ser reescrita, não use a versão pré-otimização.
Marcação de Entrega
Quando desativado, nenhuma marcação de otimização é feita. Quando ativado, a nota de entrega indica quais quadros foram otimizados pelo MCP, quais foram pulados e o motivo (não configurado, recusado pelo usuário, falha de conexão). Em nenhum dos casos, marcas são escritas dentro das linhas do quadro final, e a estrutura de 6 linhas não é alterada.
Produtos e Convenção de Carregamento
O custo de contexto desta skill é determinado principalmente por duas coisas: se o arquivo de referência inteiro é lido repetidamente e se os resultados intermediários existem apenas na conversa. Ambas devem ser restritas.
1. Convenção de Produtos
Um arquivo Markdown final é o único portador cumulativo ao longo de todo o processo. Cada etapa escreve apenas sua própria parte. Os downstream leem apenas o produto final e não repetem o conteúdo upstream.
| Passo | Produto | Portador |
|---|---|---|
| 1 História | Cartão de história: lista de personagens principais, ambiente, desejo, obstáculo, resolução, conclusão; uma frase curta em inglês e sua tradução para o português por quadro | Título do quadro e primeiras três linhas do arquivo final |
| 2 Desenho | Linha de prompt de desenho de cada quadro (com termos negativos), linha de palavras-chave | Mesmo arquivo, adicionado quadro por quadro |
| 3 Vídeo | Linha de prompt de vídeo de cada quadro (com termos negativos); linha de orçamento de leitura no cabeçalho do arquivo | Mesmo arquivo, inserido após a linha de desenho do quadro; a linha de orçamento é escrita apenas uma vez antes do primeiro quadro |
| 4 Dublagem | Linha de prompt de dublagem de cada quadro (com termos negativos) | Mesmo arquivo, adicionado após a linha de palavras-chave do quadro |
| 5 Validação | Saída do script | Eco do comando, não salvo em disco |
- Avance quadro por quadro: complete um quadro antes de passar para o próximo, não escreva todas as frases dos seis quadros primeiro e depois volte para preencher os prompts.
- Depois que o conteúdo intermediário for escrito no arquivo final ou no bloco de diálogo, não o repita. Ao fazer correções, altere apenas esse trecho, não reescreva o arquivo inteiro.
- O arquivo final é colocado por padrão no diretório
outputno mesmo nível do diretório da skill, ou seja,<diretório_da_skill>/../output/; nomeado comoTema - Storyboard e Prompts.md. Crie o diretório se ele não existir. Quando o usuário especificar explicitamente um caminho de saída, use o caminho especificado pelo usuário.
2. Convenção de Carregamento
Leia os trechos necessários por etapa, não carregue o arquivo inteiro. Conteúdo já lido não é relido. O modelo original é citado apenas ao escrever, não repetido na resposta.
| Passo | Leitura Obrigatória | Leitura Sob Demanda | Não Ler |
|---|---|---|---|
| 1 História | Seções 2, 5, 6, 7, 8, 9 de story.md | Seção 1 (princípios criativos), Seção 3 (três perguntas, durante a autoverificação); ao ativar o caminho criativo, leia creativity-path.md | Seção 10 (registros de exclusão); creativity-path.md quando não ativado |
| 2 Desenho | Modelo original, termos negativos de desenho, mapeamento de slots, regras de montagem de linha de drawing-prompt.md | Ordem de geração de imagem (apenas se o usuário solicitar imagens); método de correção de quebra (apenas durante retrabalho) | Parágrafo de explicação da fonte; mcp-setup.md (não lido quando a otimização está desativada) |
| 3 Vídeo | Forma final, duração do idioma e margem de tela, compreensão em duas etapas, cinco dimensões de detalhes de video-prompt.md | Lista de verbos de ação (leia apenas a parte correspondente ao tipo de personagem principal); lista de autoverificação (primeiro uso ou quando não qualificado) | Exemplos A/B (depois que o formato estiver dominado) |
| 4 Dublagem | Forma final, parâmetros, método de escrita dos quatro elementos de voice-prompt.md | Mapeamento de campos da plataforma (ao trocar de plataforma); lista de autoverificação (primeiro uso ou quando não qualificado) | Exemplos (depois que o formato estiver dominado) |
| 5 Validação | Comando de validação | example.md (apenas durante regressão de formato e apenas para comparar a estrutura da frase) | Todo o resto |
example.mdnão é lido por padrão; o formato já é definido pela estrutura de entrega deste arquivo, sem necessidade de um exemplo para confirmar o layout.- Os seis quadros compartilham o mesmo modelo e o mesmo conjunto de termos negativos; leia apenas uma vez. Ao escrever os quadros 2 a 6, não carregue novamente o mesmo arquivo.
Disciplina de Citação
- O modelo original, os termos negativos de desenho, os termos negativos de vídeo e os termos negativos de dublagem têm cada um uma única cópia, localizada no arquivo de referência correspondente. Aparecer em outros arquivos é considerado um erro.
- Ao preencher, copie todo o trecho e substitua os slots. Não reorganize a estrutura da frase. Não omita nenhuma frase fixa separada por ponto e vírgula.
- Em caso de conflito entre a frase fixa do modelo e a especificação estabelecida, o modelo prevalece. Se for necessário ajustar a especificação, modifique o próprio arquivo de modelo e execute a validação em sincronia.
- O timbre, tom e volume da dublagem são consistentes em todos os seis quadros; apenas a emoção e a ênfase variam com a frase. Ao trocar para outra plataforma de áudio, converta de acordo com a tabela de mapeamento em
voice-prompt.md, sem alterar a semântica dos campos.
Método de Entrega
- Produza o conteúdo completo diretamente na conversa (número de quadros conforme
references/story.md, cada quadro com 6 linhas). Não forneça um resumo como substituto. - Quando o usuário solicitar um arquivo, por padrão, escreva o Markdown no diretório
outputno mesmo nível do diretório da skill, nomeado comoTema - Storyboard e Prompts.md, e execute o script de validação. Exceto quando o usuário especificar explicitamente um caminho.