Taller de Producción Audiovisual (video-forge)
Una buena obra no se genera con una sola frase. Este skill se encarga de tres cosas:
- Preguntar hasta aclarar: si los requisitos son vagos, sigue preguntando hasta que cada detalle (escena, personajes, emoción) se traduzca en imágenes concretas.
- Confirmar antes de producir: el estilo visual, la configuración y el storyboard deben ser aprobados por el usuario antes de pasar a la producción, que consume tiempo.
- Que otros evalúen: el producto terminado se entrega a jueces independientes, quienes lo evalúan punto por punto según la «Tarjeta de Criterios de Revisión» aprobada por el usuario. No se sustituye la revisión externa por una autoevaluación.
La producción en sí misma se delega a las líneas de producción existentes (lemo-opuscar, mv-director, Remotion, three.js para miniatura). Este skill actúa solo como director y control de calidad.
Reglas de Hierro
- No empezar con una sola frase. Si no se han preguntado todos los elementos obligatorios de la lista de verificación (
references/interview-checklist.md), no se pasa a producción. Cuando el usuario dice «tú decides», proporciona valores predeterminados concretos, escríbelos en la tarjeta de requisitos y muéstralos al usuario. - Reemplazar palabras vagas por imágenes. «Acogedor», «profesional», «con estilo» no son respuestas válidas. Ofrece 2–4 opciones de imágenes concretas para que el usuario elija.
- Después de cada ronda de preguntas, mostrar la tarjeta de requisitos (
references/card-templates.md), para que el usuario pueda ver de un vistazo lo que está definido y lo que no. - El orden de las fases no puede saltarse. Tarjeta de requisitos + Tarjeta de criterios de revisión → Estilo visual (muestras) → Tarjeta de estilo / fotograma de estilo → Tarjeta de configuración → Tabla de storyboard → Borrador → Ciclo de revisión → Archivo. Las líneas de producción pueden declarar que omiten una fase (por ejemplo, las miniaturas no tienen storyboard), pero debe estar especificado.
- El storyboard debe confirmarse por defecto (lemo no lo confirma por defecto; aquí se cambia a confirmación por defecto).
- Los jueces son agentes independientes. Solo reciben la obra y la tarjeta de criterios de revisión aprobada por el usuario, no mi conclusión. Los jueces ven el video completo (1 fotograma cada 2 segundos), solo pueden medir el sonido, pero no evaluar si «suena bien». La opinión del usuario prevalece sobre la del juez.
- Los personajes no actúan. Las expresiones faciales y los movimientos de manos generados por código siempre resultan rígidos. A menos que la línea de producción tenga capacidad de rigging de personajes, los personajes deben ser pequeños, estar lejos, quietos o con bucles simples.
- Las palabras textuales del usuario van a la tarjeta. Las solicitudes específicas del usuario (por ejemplo, «que la luz no aplaste») se escriben textualmente en la sección de restricciones o requisitos estrictos de la tarjeta de requisitos.
- Las tareas grandes se dividen entre varios agentes según su responsabilidad (
references/division-of-labor.md): primero se definen los archivos esqueleto, cada rol solo referencia los números de ID; los cálculos se verifican con scripts; no se reduce la intensidad del razonamiento para evitar tiempos de espera. - Las obras se archivan en
~/video-forge, no en directorios temporales; los directorios temporales se pierden al reiniciar. - Red: El proxy de esta máquina es muy lento. Para descargas grandes, usa
curl --noproxy '*'oenv -u http_proxy -u https_proxy -u HTTP_PROXY -u HTTPS_PROXY. Sigrepfalla en el shell, usa/usr/bin/grep.
Pasos
0. Derivación
Primero, revisa ~/video-forge/recipes/: si el usuario menciona un plan específico (por ejemplo, «haz una estación con el plan de miniatura 3D con renderizado 2D»), lee el archivo del plan y solo pregunta sobre los elementos que el plan no haya definido.
De lo contrario, selecciona la línea de producción según la necesidad:
| Necesidad | Línea de producción | Archivo |
|---|---|---|
| Un cortometraje con un estilo visual específico (30–90 segundos), tema libre | Video estilizado | references/pipeline-style-film.md |
| Hacer un videoclip para una canción | Videoclip musical | references/pipeline-mv.md |
| Explicar un tema, historia o datos | Animación educativa | references/pipeline-explainer.md |
| Una escena 3D pequeña que se pueda arrastrar y rotar | Miniatura | references/pipeline-diorama.md |
Si el usuario no tiene ni idea: sigue la guía para principiantes de references/style-picker.md (primero mira la galería de muestras, luego da ideas de contenido).
1. Preguntas → Tarjeta de requisitos
Primero, define el tipo de video y la duración, carga la tarjeta de tipo correspondiente de references/genres/ (la tabla de selección está en genres/README.md). Las preguntas posteriores, la estructura, el presupuesto de palabras y la tarjeta de criterios de revisión se basarán en esta tarjeta.
Sigue references/interview-checklist.md para hacer preguntas ronda por ronda. Usa AskUserQuestion, con un máximo de 4 preguntas por ronda, y las opciones deben escribirse como imágenes concretas. Después de cada ronda, muestra la tarjeta de requisitos. Cuando todos los campos obligatorios estén completos, pide al usuario que confirme la tarjeta de requisitos.
2. Estilo visual
Si el usuario no ha elegido un estilo: según references/style-picker.md, recomienda 2–3 opciones con enlaces a muestras, y al mismo tiempo muestra la lista completa de los 66 estilos (como texto plano, sin usar AskUserQuestion, para no ocultar la lista con demasiadas opciones).
Una vez seleccionado, lee el STYLE.md de ese estilo y organízalo en una Tarjeta de estilo (valores numéricos: códigos de color, grosor de línea, relación de luz, tipografía, gramática de cámara, sonido). Pégala para que el usuario la confirme.
3. Fotograma de estilo
Usa el código de dibujo real para generar 1–3 fotogramas de estilo (un plano o una esquina, con luz y color definidos). El usuario debe confirmarlos antes de continuar.
4. Tarjeta de configuración
Cuando haya personajes, lugares u objetos, crea una tarjeta de configuración para cada uno: apariencia, proporciones, paleta de colores, vestuario, accesorios clave, elementos que no deben aparecer. Genera una ilustración de configuración y que el usuario la confirme.
5. Tabla de storyboard
Crea una imagen con 6–9 viñetas (cada viñeta: tiempo, imagen, cámara, sonido, subtítulos). El usuario debe confirmarla antes de proceder a la animación.
6. Borrador → Ciclo de revisión
Siguiendo la línea de producción, crea un borrador. Según references/review.md, abre dos jueces y evalúa punto por punto según la tarjeta de criterios de revisión (Aprobado / Parcial / No aprobado + fotograma de evidencia). Solo modifica los elementos no aprobados. Después de cada iteración, muestra el resultado al usuario.
Criterios de parada: todos los elementos obligatorios aprobados y el usuario satisfecho, o después de 3 rondas, o cuando el usuario lo solicite.
7. Archivo
En ~/video-forge/works/<slug>/, guarda: enlace al código fuente o proyecto, producto final / capturas de pantalla, tarjeta de requisitos, tarjeta de estilo, storyboard, scores.md. En ~/video-forge/retros/, escribe una retrospectiva. Si el enfoque es reutilizable, crea un nuevo plan a partir de recipes/_template.md y añade una fila a la tabla «🎞 Obras» en ~/video-forge/README.md. Si se usa una nueva biblioteca externa, regístrala en deps.json y reconstruye index/.
Aproximadamente una semana después de la publicación, pide al usuario que revise las métricas desde el panel de la plataforma (por ejemplo, Centro de Servicios para Creadores de Douyin): tasa de visualización completa, tiempo medio de visualización, en qué segundos se pierden más espectadores, qué segmento se rebobina más. Rellena estos datos en la sección «Datos de publicación» de scores.md de esta obra, y escribe una frase en la retrospectiva: qué elemento de retención funcionó y dónde se perdió audiencia. La próxima vez que escribas el guion y el storyboard, usa estos datos reales, no solo las opiniones de los jueces.
Archivos de referencia
| Fase | Archivo | Cuándo consultarlo |
|---|---|---|
| 1 Preguntas | references/interview-checklist.md | Cada vez que se inicia; antes de cada ronda de preguntas, comprobar qué falta |
| 1–5 Tarjetas | references/card-templates.md | Al mostrar tarjetas de requisitos, estilo, configuración y storyboard |
| 2 Estilo visual | references/style-picker.md | Si el usuario no ha elegido un estilo o no sabe qué contenido hacer |
| 3–6 Producción | references/pipeline-style-film.md | Para hacer cortometrajes con el estilo lemo-opuscar |
| references/pipeline-mv.md | Para hacer videoclips musicales | |
| references/pipeline-explainer.md | Para hacer videos educativos/informativos con Remotion | |
| references/pipeline-diorama.md | Para hacer escenas en miniatura 3D con three.js | |
| 3–6 División del trabajo | references/division-of-labor.md | Al usar múltiples agentes para escribir el Treatment o para producción: división de roles, archivos esqueleto, scripts de verificación |
| Tarjetas de tipo (por tipo / duración) | references/genres/README.md | Al definir el tipo y la duración durante las preguntas, carga la tarjeta correspondiente para obtener el presupuesto de duración, estructura, normas visuales y de sonido, lógica de validación y plantillas de prompt |
| Música | references/music.md | Para seleccionar el enfoque musical (composición por código / tarjeta de ritmo, biblioteca libre de regalías, modelos de código abierto), uso de tools/music/code_score.py |
| Seleccionar estilo / seleccionar efectos | ~/video-forge/index/catalog.md (index.json legible por máquina) | Tabla única con todas las bibliotecas de estilos, tarjetas de efectos, sintaxis de narración y estilos propios; si falta una biblioteca, ejecuta bash ~/video-forge/bootstrap.sh <id> |
| 1 / 6 Revisión | references/review-standards.md | Durante las preguntas, dar elementos de revisión predeterminados según el tipo de video, y definir la tarjeta de criterios de revisión junto con el usuario |
| 6 Revisión | references/review.md | Para abrir jueces, evaluar punto por punto y decidir si parar |
| Solución de problemas | references/troubleshooting.md | Cuando surjan problemas con la instalación de dependencias, renderizado, capturas de pantalla o red |
| Archivo | ~/video-forge/README.md, ~/video-forge/recipes/_template.md | Después de terminar la obra |