mrvijaykr56/youtubeshorts

Habilidade de Diretor Visual e Geração de Imagens para YouTube Shorts

Esta habilidade orienta o agente a gerar cenas verticais 9:16 coesas e cinematográficas para YouTube Shorts usando a capacidade nativa generate_image do Antigravity.

---

1. Estrutura de Consistência Visual (Sincronia de Personagem e Mundo) 👥🌍

Ao gerar de 5 a 20 imagens para um Short, evitar desvios estilísticos ou de personagem é crítico. Se o rosto, a roupa ou o ambiente de um personagem mudar aleatoriamente entre as cenas, a imersão do vídeo é quebrada.

Os 3 Pilares da Sincronização Cena a Cena:

1. O Blueprint do DNA do Personagem:

   • Replique exatamente a mesma fórmula de 5 partes do personagem em toda cena que o apresente: [Nome + Idade/Gênero] + [Estilo e cor do cabelo] + [Traços faciais] + [Peças e cores exatas da roupa]
   • Exemplo: "Maya, uma arqueóloga de 26 anos com cabelo escuro cacheado e bagunçado preso em um rabo de cavalo, sardas, vestindo uma camisa safari de linho verde-oliva e um colar de bússola de latão"
   • Nunca substitua por termos genéricos como "ela parece" ou "a mulher".

2. A Âncora do Mundo e da Iluminação:

   • Defina uma declaração de ambiente compartilhado, prefixada a todos os prompts das cenas: [Cenário] + [Fonte de luz primária e temperatura de cor] + [Estilo de sombra] + [Atmosfera]
   • Exemplo: "Túmulo subterrâneo de arenito do Egito antigo, luz âmbar quente de tochas projetando sombras profundas e tremeluzentes, partículas de poeira dourada flutuantes, fundo azul cobalto escuro."

3. Encadeamento de Referência Visual (ImagePaths) 🔗:

   • A ferramenta generate_image do Antigravity suporta nativamente ImagePaths (passagem de imagens anteriores como referências visuais condicionantes).
   • O Fluxo de Trabalho:
     1. Gere a Cena 1 (estabelecendo a iluminação e o personagem mestre).
     2. Salve scene_1.jpg.
     3. Para as Cenas 2, 3, 4..., passe ImagePaths: ["<caminho_para_scene_1.jpg>"] para generate_image.
     4. Isso alimenta as características visuais latentes da Cena 1 diretamente para o Imagen 3, ancorando formato do rosto, cor da roupa e tons ambientais em todas as cenas subsequentes!

---

2. Validação Pré-Voo e Aprovação do Usuário 🛑

REQUISITO CRÍTICO (Zero Desperdício de Tokens): Antes de executar qualquer chamada generate_image:

1. Execute o Validador de Storyboard Pré-Voo:

   .\backend\venv\Scripts\python.exe backend\scripts\storyboard_validator.py --json "caminho/para/script.json"
   

   • Deve ter 0 erros bloqueantes (ex.: sem tokens de texto proibidos, sinais 9:16 válidos, dentro do limite de 60s do Shorts).
2. Apresente o Storyboard Validado e o Estilo de Arte ao usuário com as estatísticas da validação.
3. Peça aprovação explícita do usuário:

   "O storyboard passou em todas as verificações de segurança pré-voo (0 erros, duração estimada de ~Xs). Gostaria que eu prosseguisse com a geração destas [N] imagens 9:16, ou gostaria de ajustar alguma cena ou parâmetro de estilo primeiro?"

4. NÃO gere imagens até que o usuário dê confirmação explícita.

---

3. Geração de Imagens com Antigravity generate_image

Para cada cena do storyboard (após receber aprovação do usuário):

1. Verificação Pré-Geração de Duplicata / Cache 🛑:

   • Verifique se scene_{X}.jpg ou scene_{X}.png já existe na pasta de destino (backend/output/<job_id>/) e é válido (>10 KB).
   • Se já existir, pule a regeneração para evitar desperdício de tokens, a menos que o usuário peça explicitamente para regenerar/rolar novamente aquela cena específica.

2. Sintetize o Prompt Final (Garantindo Enquadramento de Câmera Distinto):

   [Âncora do Mundo] + [Âncora do Personagem] + [Ação da Cena e ÂNGULO DE CÂMERA DISTINTO] + [Modelo de Estilo de Arte Global] + [Composição Vertical 9:16]
   

   • Certifique-se de que o plano da câmera (ex.: aberto vs macro vs reação) difere da cena anterior para evitar gerar imagens visualmente idênticas.

3. Invoque a Ferramenta: Chame generate_image com:

   • AspectRatio: "9:16"
   • ImageName: scene_1, scene_2, scene_3, etc. (estritamente único por cena).
   • Prompt: O prompt sintetizado.
   • ImagePaths: Para as cenas 2..N, passe ["<caminho_para_scene_1.jpg>"] para condicionamento visual.

4. Geração em Lote: Gere as cenas sequencialmente ou em grupos (até 20 por short).

---

4. Implantação de Ativos no Pipeline YTShorts

Após as imagens serem geradas pelo Antigravity:

1. O Antigravity armazena as imagens geradas no diretório de artefatos da conversa: C:\Users\<usuário>\.gemini\antigravity-ide\brain\<id-da-conversa>\*.png

2. Copie ou vincule as imagens ao diretório de saída/trabalho do YTShorts: d:\WorkSpace\YTShorts\backend\output\<job_id>\ Nomenclatura padrão exigida pelo backend:

   • scene_1.png
   • scene_2.png
   • scene_3.png
   • ...

3. Emparelhe com o storyboard JSON: Salve script.json no mesmo diretório: d:\WorkSpace\YTShorts\backend\output\<job_id>\script.json

---

5. Acionando a Renderização do Vídeo 🚀

Assim que as imagens e o script.json estiverem preparados em backend/output/<job_id>/, execute a ferramenta de montagem independente:

.\backend\venv\Scripts\python.exe backend\scripts\assemble_short.py --job_dir "backend/output/<job_id>" --voice in_female --caption_style tiktok --music lofi --resolution 1080p --transition dynamic

Este único comando automaticamente:

1. Sintetiza narração TTS de alta definição (Edge-TTS / KittenTTS).
2. Gera legendas ASS sincronizadas em nível de palavra via Whisper.
3. Renderiza o vídeo .mp4 final em 1080p/4K com transições ópticas (xfade), movimento panorâmico/zoom Ken Burns, música de fundo com redução automática de volume (audio ducking) e legendas incorporadas em um único processo!

---

6. Branding do Canal e Geração de Ativos Comunitários 🎨📊

Além das cenas verticais 9:16 da história, o diretor visual também produz ativos de marketing usando a ferramenta nativa generate_image do Antigravity:

1. Imagens para Enquetes da Comunidade (Quadrado 1:1):

   • Gere ou recorte (centralizado) personagens em cartões quadrados de 1024x1024.
   • Organize os cartões em backend/output/community_poll_assets/ (ex.: poll_1_character.jpg).
   • Enquetes com imagens geram 3x–5x mais alcance em novos canais do que postagens de texto padrão.

2. Mascote/Avatar do Canal (Quadrado 1:1):

   • Gere um retrato de personagem 3D estilo Pixar centralizado em 1024x1024 com olhos brilhantes e expressivos, segurando um livro de histórias luminoso.
   • Salve em backend/output/channel_branding/channel_avatar_1024x1024.jpg.

3. Banner Panorâmico do Canal (Paisagem 16:9):

   • Gere uma paisagem cinematográfica panorâmica 16:9 do mundo recorrente do canal.
   • Faça upscale com filtro Lanczos para 2560x1440.
   • Salve em backend/output/channel_branding/channel_banner_2560x1440.jpg.

4. Mandato Zero API Externa:

   • Sempre priorize a ferramenta nativa generate_image do Antigravity. Nunca recorra a APIs de imagem externas gratuitas não verificadas.