mrvijaykr56/youtubeshorts

Habilidad de Director Visual y Generación de Imágenes para YouTube Shorts

Esta habilidad guía al agente en la generación de escenas verticales 9:16 coherentes y cinematográficas para YouTube Shorts utilizando la capacidad nativa generate_image de Antigravity.

---

1. Marco de Coherencia Visual (Sincronización de Personajes y Mundo) 👥🌍

Al generar de 5 a 20 imágenes para un Short, es fundamental evitar la deriva estilística o de personajes. Si la cara, la ropa o el entorno de un personaje cambian aleatoriamente entre escenas, la inmersión del video se rompe.

Los 3 Pilares de la Sincronización Escena a Escena:

1. La Plantilla de ADN del Personaje:

   • Replica la misma fórmula de 5 partes para el personaje en cada escena donde aparezca: [Nombre + Edad/Género] + [Peinado y color] + [Rasgos faciales] + [Prendas de vestir y colores exactos]
   • Ejemplo: "Maya, una arqueóloga de 26 años con cabello rizado y oscuro recogido en una cola de caballo, pecas, vistiendo una camisa de safari de lino oliva y un collar de brújula de latón"
   • Nunca sustituyas con términos genéricos como "ella luce" o "la mujer".

2. El Anclaje de Mundo e Iluminación:

   • Define una declaración de entorno compartido que se anteponga a todos los prompts de escena: [Escenario] + [Fuente de luz principal y temperatura de color] + [Estilo de sombra] + [Atmósfera]
   • Ejemplo: "Tumba subterránea de arenisca del antiguo Egipto, luz cálida de antorchas proyectando sombras profundas y parpadeantes, partículas de polvo dorado flotando, fondo azul cobalto oscuro."

3. Encadenamiento de Referencias Visuales (Parámetro ImagePaths) 🔗:

   • La herramienta generate_image de Antigravity soporta de forma nativa ImagePaths (pasar imágenes previas como referencias de condicionamiento visual).
   • El Flujo de Trabajo:
     1. Genera la Escena 1 (estableciendo el personaje maestro y la iluminación).
     2. Guarda scene_1.jpg.
     3. Para las Escenas 2, 3, 4..., pasa ImagePaths: ["<ruta_a_scene_1.jpg>"] en generate_image.
     4. ¡Esto alimenta las características latentes visuales de la Escena 1 directamente a Imagen 3, anclando la forma de la cara, el color de la ropa y los tonos del entorno en todas las escenas posteriores!

---

2. Validación Previa y Aprobación del Usuario 🛑

REQUISITO CRÍTICO (Cero Desperdicio de Tokens): Antes de ejecutar cualquier llamada a generate_image:

1. Ejecuta el Validador de Guión Gráfico Prevuelo:

   .\backend\venv\Scripts\python.exe backend\scripts\storyboard_validator.py --json "ruta/al/script.json"
   

   • Debe tener 0 errores bloqueantes (por ejemplo, sin tokens de texto prohibidos, señales 9:16 válidas, dentro del límite de 60s de Shorts).
2. Presenta el Guión Gráfico y el Estilo de Arte validados al usuario con las estadísticas de validación.
3. Solicita la aprobación explícita del usuario:

   "El guión gráfico ha pasado todas las comprobaciones de seguridad previas al vuelo (0 errores, duración estimada de ~Xs). ¿Deseas que proceda a generar estas [N] imágenes 9:16, o prefieres ajustar alguna escena o parámetro de estilo primero?"

4. NO generes imágenes hasta que el usuario dé una confirmación explícita.

---

3. Generación de Imágenes con generate_image de Antigravity

Para cada escena del guión gráfico (después de recibir la aprobación del usuario):

1. Verificación de Duplicados / Caché Previa a la Generación 🛑:

   • Verifica si scene_{X}.jpg o scene_{X}.png ya existe en la carpeta de destino (backend/output/<job_id>/) y es válido (>10 KB).
   • Si ya existe, salta la regeneración para evitar desperdiciar tokens, a menos que el usuario solicite explícitamente regenerar/volver a tirar esa escena específica.

2. Sintetiza el Prompt Final (Asegurando un Encuadre de Cámara Distinto):

   [Ancla de Mundo] + [Ancla de Personaje] + [Acción de la Escena y ÁNGULO DE CÁMARA DISTINTO] + [Plantilla de Estilo de Arte Global] + [Composición Vertical 9:16]
   

   • Asegúrate de que el plano de cámara (ej. gran angular vs. macro vs. reacción) difiera de la escena anterior para evitar generar imágenes visualmente idénticas.

3. Invoca la Herramienta: Llama a generate_image con:

   • AspectRatio: "9:16"
   • ImageName: scene_1, scene_2, scene_3, etc. (estrictamente único por escena).
   • Prompt: El prompt sintetizado.
   • ImagePaths: Para las escenas 2..N, pasa ["<ruta_a_scene_1.jpg>"] para el condicionamiento visual.

4. Generación por Lotes: Genera las escenas de forma secuencial o en grupos de escenas (hasta 20 por short).

---

4. Despliegue de Activos al Pipeline de YTShorts

Una vez que las imágenes son generadas por Antigravity:

1. Antigravity almacena las imágenes generadas en el directorio de artefactos de la conversación: C:\Users\<usuario>\.gemini\antigravity-ide\brain\<id-conversacion>\*.png

2. Copia o enlaza las imágenes al directorio de trabajo/salida de YTShorts: d:\WorkSpace\YTShorts\backend\output\<job_id>\ Nomenclatura estándar requerida por el backend:

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

3. Empareja con el JSON del guión gráfico: Guarda script.json en el mismo directorio: d:\WorkSpace\YTShorts\backend\output\<job_id>\script.json

---

5. Activación del Renderizado de Video 🚀

Una vez que las imágenes y script.json están preparados en backend/output/<job_id>/, ejecuta la herramienta de ensamblaje independiente:

.\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 automáticamente:

1. Sintetiza narración TTS de alta definición (Edge-TTS / KittenTTS).
2. Genera subtítulos ASS sincronizados a nivel de palabra mediante Whisper.
3. Renderiza el video final .mp4 en 1080p/4K con transiciones ópticas (xfade), movimiento de paneo/zoom Ken Burns, música de fondo con ducción de audio y subtítulos quemados, todo en un solo paso!

---

6. Marca del Canal y Generación de Activos para la Comunidad 🎨📊

Más allá de las escenas verticales 9:16, el director visual también produce activos de marketing utilizando la herramienta nativa generate_image de Antigravity:

1. Imágenes para Encuestas de la Pestaña Comunidad (Cuadrado 1:1):

   • Genera o recorta imágenes de personajes a tarjetas cuadradas de 1024x1024.
   • Prepara las tarjetas en backend/output/community_poll_assets/ (ej. poll_1_character.jpg).
   • Las encuestas con imágenes generan entre 3 y 5 veces más alcance en canales nuevos que las publicaciones de texto estándar.

2. Mascota del Avatar del Canal (Cuadrado 1:1):

   • Genera un retrato de personaje 3D Pixar centrado de 1024x1024 con ojos expresivos y brillantes, sosteniendo un libro de cuentos resplandeciente.
   • Guarda en backend/output/channel_branding/channel_avatar_1024x1024.jpg.

3. Banner Panorámico del Canal (Paisaje 16:9):

   • Genera un paisaje cinemático panorámico 16:9 del mundo recurrente del canal.
   • Escala con filtro Lanczos a 2560x1440.
   • Guarda en backend/output/channel_branding/channel_banner_2560x1440.jpg.

4. Mandato Cero API Externa:

   • Prioriza siempre la herramienta nativa generate_image de Antigravity. Nunca recurras a APIs de imágenes externas gratuitas no verificadas.