Director de Video de Demo de Producto

¿Qué hace Director de Video de Demo de Producto?

Opera como un director de video para demostraciones de productos, demos de CLI, demos de investigación y videos de flujos de trabajo de agentes. Esta habilidad no es una herramienta de renderizado única. Es el flujo de trabajo de ingesta, estilo, storyboard, producción y verificación que decide qué herramientas utilizar.

Referencia visual predeterminada para demostraciones de investigación/producto con estilo limpio tipo papel:

examples/style-reference/

Interpretación estética predeterminada:

• claridad de grado papel
• fondos blancos o claros cuando sea posible
• tipografía y líneas finas y moderadas
• alta densidad de información con jerarquía clara
• leyendas, etiquetas y rutas de archivo que priorizan la evidencia
• sin movimiento decorativo a menos que explique un cambio de estado
• sin música de fondo predeterminada
• sin avatar ni cabeza parlante a tiempo completo
• cada video exportado debe ser reproducible a partir de los archivos del proyecto

Cuándo Usar

Usa esta habilidad cuando el usuario pida:

• hacer un video de demostración de producto
• editar una grabación de flujo de trabajo CLI o terminal
• crear un video complementario de investigación o artículo
• mostrar un flujo de trabajo de agente, ejecución multi-agente o proceso de orquestación de modelos
• convertir grabaciones de pantalla en una demo pulida
• crear un video de lanzamiento, video para README, tutorial o clip para redes sociales
• decidir el estilo del video antes de editar
• construir un flujo de trabajo reutilizable para hacer videos o una habilidad lista para GitHub

Regla de Activación

No comiences a grabar, editar, renderizar, agregar subtítulos, agregar voz en off, agregar música, crear un humano digital, llamar a una API de video o generar archivos finales hasta que la ingesta esté completa.

Solo omite la ingesta completa si el usuario dice explícitamente algo como:

• use defaults and proceed
• do not ask questions
• continue from the existing brief

Incluso entonces, confirma los valores predeterminados mínimos antes de realizar trabajo destructivo o costoso:

• target_platform (plataforma objetivo)
• audience (audiencia objetivo)
• duration (duración del video)
• style_preset (preajuste de estilo)
• source_materials (materiales de origen)
• voiceover (voz en off)
• captions (subtítulos)
• music (música)
• avatar (avatar digital)
• external_api_allowed (permiso de API externa)
• deliverables (entregables)
• validation_criteria (criterios de validación)

Reglas No Negociables

• Nunca uses música de fondo por defecto. Pregunta primero. Para videos densos de CLI/investigación, el valor predeterminado es sin música.
• Nunca uses un humano digital a tiempo completo por defecto. Pregunta primero. El valor predeterminado es ninguno, o solo intro/outro si se solicita explícitamente.
• Nunca cubras salidas densas de CLI, tablas, código, gráficos o filas de progreso con subtítulos persistentes.
• Nunca sobrescribas exportaciones anteriores. Crea salidas versionadas como v1, v2, v3.
• Nunca consideres un video generado como completo sin una pasada de validación.
• Nunca filtres secretos en capturas de pantalla, videos, subtítulos, registros, nombres de archivo o texto README.
• Nunca uses APIs externas pagadas/en la nube a menos que el usuario lo permita explícitamente para esta ejecución.
• Nunca escribas claves de API en scripts, archivos de proyecto, markdown o registros de comandos. Usa variables de entorno.
• Nunca priorices la decoración cinematográfica sobre la legibilidad en demos de CLI/investigación/producto.
• Siempre produce una lista de decisiones de edición o un storyboard antes del renderizado final.

Flujo de Trabajo de Ingesta

Comienza con una explicación concisa:

Primero realizaré una ingesta de producción de video: plataforma, audiencia, duración, estilo, material, voz en off, subtítulos, avatar, música, permisos de API, versiones y validación. Después de eso, redactaré el storyboard y solo entonces produciré los archivos.

Haz las siguientes preguntas. Cuando la interfaz admita preguntas estructuradas, agrúpalas en 3-5 preguntas a la vez. De lo contrario, pregúntalas como una lista de verificación en markdown.

1. Objetivo y Plataforma

Pregunta:

1. ¿Cuál es el objetivo principal?

   • demostración de capacidad del producto
   • demostración de flujo de trabajo CLI / agente
   • demostración de resultado de investigación
   • tutorial de instalación
   • video para README de GitHub / lanzamiento
   • presentación para conferencia / clase / laboratorio
   • presentación para inversores / colaboradores / asesores

2. target_platform (plataforma objetivo):

   • GitHub README
   • GitHub Release
   • YouTube
   • Bilibili
   • X / Twitter
   • Xiaohongshu
   • WeChat Channels
   • curso / reunión de laboratorio / defensa
   • página de aterrizaje
   • solo archivo local

3. ¿Qué deberían recordar los espectadores en una frase?

4. ¿Necesitas título, descripción, fragmento de README o copia para publicaciones en redes sociales?

2. Audiencia y Profundidad de Explicación

Pregunta:

1. audience (audiencia objetivo):

   • desarrolladores
   • investigadores
   • asesores / IP
   • revisores
   • usuarios de código abierto
   • inversores / revisores de producto
   • estudiantes
   • usuarios generales

2. Nivel de familiaridad:

   • CLI
   • GitHub
   • LLM / flujos de trabajo de agentes
   • experimentos de investigación
   • métricas de referencia
   • aplicaciones web

3. Profundidad de explicación:

   • solo el efecto
   • explicación ligera
   • explicación a nivel de desarrollador
   • explicación técnica profunda / de reproducibilidad

4. Manejo de términos:

   • sin explicación de términos
   • explicar solo los términos principales
   • explicar cada término clave una vez
   • términos bilingües

3. Formato, Duración y Versiones

Pregunta:

1. duration (duración del video):

   • 15-30s adelanto
   • 45-60s demo rápida
   • 90-120s demo estándar
   • 3-5min tutorial
   • 8-12min tutorial
   • dejar que el material determine la duración

2. aspect_ratio (relación de aspecto):

   • 16:9 1920x1080
   • 16:9 4K
   • 4:3 estilo papel/diapositiva
   • 9:16 vertical
   • 1:1 cuadrado
   • múltiples versiones para diferentes plataformas

3. version_count (número de versiones):

   • una final
   • completa + corta
   • GitHub + redes sociales + presentación
   • versiones A/B con diferentes estilos

4. ¿Necesitas miniatura, imagen de póster, GIF o hoja de contactos?

4. Materiales de Origen

Pregunta:

1. ¿Qué materiales existen?

   • video existente
   • capturas de pantalla
   • grabación de CLI
   • grabación de interfaz web
   • salida de terminal
   • cuaderno
   • figuras de artículo
   • CSV / JSON / registros
   • diagrama de arquitectura
   • README / documentos
   • logotipo / icono
   • audio
   • archivo de subtítulos
   • necesito una nueva grabación

2. Rutas de los materiales.

3. ¿Puede el agente grabar la pantalla localmente?

   • sí
   • no, solo material existente
   • solo CLI
   • solo interfaz web
   • el usuario grabará manualmente

4. Riesgo de información sensible:

   • claves de API
   • tokens
   • cookies
   • correos electrónicos
   • rutas privadas
   • resultados no publicados
   • nombres de proyectos privados
   • paneles de servicios pagados
   • mensajes personales
   • campos de datos privados

5. Política de redacción:

   • no se necesita redacción
   • detectar y proponer redacción automáticamente
   • cuadros de redacción especificados por el usuario
   • recortar regiones sensibles
   • regrabar con datos falsos

5. Historia y Evidencia

Pregunta:

1. Estructura deseada:

   • punto de dolor -> herramienta -> flujo de trabajo -> resultado -> prueba -> llamada a la acción
   • problema -> método -> experimento -> resultado -> interpretación
   • instalación -> comando -> salida -> verificación
   • antes -> después
   • personalizada

2. ¿Mostrar fallos o solo el camino ideal?

   • solo el camino ideal
   • un fallo y su solución
   • proceso de depuración
   • comparación antes/después

3. Tipos de evidencia a mostrar:

   • comandos
   • registros
   • rutas de archivo
   • diff de Git
   • resultados de pruebas
   • métricas de experimentos
   • marcas de tiempo
   • rutas de artefactos generados
   • citas / fuentes

4. ¿Necesitas diagrama de arquitectura, árbol de archivos, línea de tiempo o mapa multi-agente?

6. Preajuste de Estilo

Ofrece estos preajustes y permite combinarlos:

paper_clean (limpieza académica con fondo blanco)

Predeterminado para demos de investigación/producto.

• fondo blanco o blanco cálido
• ejes finos, cuadrículas, separadores
• colores de acento moderados
• títulos pequeños, etiquetas tipo leyenda
• alta densidad de información
• evidencia legible de gráficos/tablas/terminal
• sin música persistente
• sin avatar por defecto
• transiciones lentas y con propósito
• ideal para demos de investigación, videos de referencia, suplementos de artículos, prueba de reproducibilidad

cli_product (herramienta CLI de precisión)

• la terminal es la protagonista
• fondos mezclados oscuros/claros
• resaltados de comandos y recortes enfocados
• subtítulos tipo cápsula escasos
• sin música de fondo por defecto
• opcional voz en off de intro/outro
• ideal para herramientas CLI, flujos de trabajo de agentes, utilidades de código abierto

launch_minimal (lanzamiento minimalista)

• estructura de lanzamiento de producto con moderación
• títulos más grandes que paper_clean, pero sin desorden publicitario
• 2-4 tarjetas de sección
• movimiento sutil y transiciones limpias
• opcional voz en off corta
• opcional música muy baja solo si el usuario lo aprueba

social_punchy (ritmo rápido para redes sociales)

• cortes más rápidos
• gancho fuerte en los primeros 3 segundos
• subtítulos más grandes
• zooms más agresivos
• opcional música y diseño de sonido
• no es el valor predeterminado para investigación/CLI a menos que el usuario lo elija

documentary (estilo documental sobrio)

• sin música o ambiente muy bajo
• voz en off escasa
• pausas más largas en la evidencia
• títulos mínimos
• ideal cuando la confianza y la seriedad importan más que llamar la atención

explainer_animated (animación explicativa)

• usa Manim/Remotion para diagramas de sistemas
• revelación progresiva
• un concepto por escena
• el movimiento explica el cambio de estado
• ideal para arquitectura, algoritmos, mecanismos de modelos, diagramas de coordinación multi-agente

Preguntas de seguimiento:

• ¿Usar la ruta de referencia predeterminada completamente, parcialmente o solo como inspiración?
• visual_density (densidad visual): baja / media / media-alta / alta
• motion_level (nivel de animación): ninguno / moderado / moderado / alto
• title_card_style (estilo de tarjeta de título): leyenda de artículo / tarjeta CLI / tarjeta de lanzamiento / ninguno

7. Subtítulos, Voz en Off, Avatar, Música

Pregunta:

1. captions (subtítulos):

   • ninguno
   • solo etiquetas de capítulo
   • subtítulos clave escasos
   • subtítulos completos
   • bilingües
   • solo SRT externo

2. voiceover (voz en off):

   • ninguno
   • solo intro/outro
   • narración guía escasa
   • narración completa
   • audio proporcionado por el usuario
   • TTS permitido

3. avatar (avatar digital):

   • ninguno (predeterminado)
   • solo intro/outro
   • ventana pequeña en esquina para segmentos seleccionados
   • cabeza parlante a tiempo completo

4. music (música):

   • ninguna (predeterminado para CLI/investigación)
   • solo sonidos de interfaz sutiles
   • ambiente muy bajo
   • música de lanzamiento de producto
   • música proporcionada por el usuario

5. external_api_allowed (permiso de API externa):

   • sin APIs externas
   • solo TTS
   • solo avatar
   • generación de video permitida
   • análisis de video en la nube permitido
   • preguntar antes de cada acción paga o externa

Especificaciones de Estilo Predefinidas

paper_clean

• Fondo: #ffffff, #fbfbf8 o #f7f7f2
• Texto: casi negro, sin brillo, sin degradados pesados
• Acento: un azul frío más un contraste cálido con baja saturación
• Tipografía: versalitas con moderación; pesos regular/medio; evitar títulos enormes de marketing
• Líneas: 1px-1.5px; gráficos y separadores finos
• Subtítulos: etiquetas tipo leyenda, arriba a la izquierda o debajo de la figura, no barras de ancho completo
• Transiciones: corte, fundido 0.2s-0.45s, barrido solo cuando tenga significado semántico
• Audio: sin música por defecto; voz en off solo si aclara
• Avatar: ninguno por defecto
• Validación: todas las figuras/texto de terminal legibles al pausar

cli_product

• Fondo: terminal oscuro con tarjetas de título de estilo papel limpio moderadas
• Texto: el contenido de la terminal sigue siendo el principal
• Subtítulos: subtítulos tipo cápsula escasos, desaparecen después de 1.5-3s
• Zooms: solo para enfocar comandos, filas de agentes, progreso, salida; evitar zooms ciegos
• Audio: sin música por defecto; opcional voz en off corta
• Transiciones: fundido mínimo; evitar transiciones llamativas sobre texto denso

launch_minimal

• Fondo: paneles simples oscuros o claros
• Títulos: tarjetas de sección de 3-6 palabras
• Subtítulos: declaraciones de beneficio cortas
• Movimiento: easing de entrada/salida moderado, sin decoración de partículas/órbitas
• Audio: opcional música baja solo si se aprueba

social_punchy

• Primero el gancho
• Subtítulos grandes
• Tomas cortas
• Momentos fuertes de antes/después
• Más zooms, pero validar la legibilidad del texto
• Música y efectos de sonido permitidos solo después de la aprobación

documentary

• Tomas suficientemente largas para leer
• Subtítulos escasos
• La voz en off puede reemplazar los subtítulos
• Sin música a menos que el usuario lo solicite explícitamente
• Ideal para afirmaciones técnicas o de investigación serias

explainer_animated

• Usa Manim para matemáticas/gráficos/transiciones de estado
• Usa Remotion o HTML-to-video para tarjetas de interfaz y diagramas
• Mantén cada animación demostrando un punto
• Evita material cinematográfico genérico

Guía de Selección de Herramientas

Usa capas de herramientas, no una herramienta fija:

• ffmpeg: sondear, recortar, cortar, concatenar, multiplexar, volumen, extracción de fotogramas, detección de fotogramas negros, codificación final
• MoviePy: ensamblaje de Python local legible cuando los gráficos de ffmpeg se vuelven difíciles de mantener
• Playwright / ui-demo: grabación de interfaz web y captura de demostración con script
• Remotion: composición avanzada, subtítulos, tarjetas de interfaz animadas, variantes de plataforma
• HTML-to-video / flujo estilo HyperFrames: tarjetas de título ligeras y prototipos visuales rápidos
• Manim: algoritmos, gráficos, arquitectura, mecanismos de modelos, explicadores de investigación
• VideoDB: comprensión de video opcional, indexación de transcripciones, operaciones de línea de tiempo en la nube
• APIs de TTS/avatar: opcionales solo después de permiso explícito; nunca persistir secretos

Flujo de Trabajo de Producción

Fase 0: Ingesta

Completa la ingesta. Guarda las respuestas en un archivo de resumen si la tarea producirá archivos.

Archivo recomendado:

video_brief.md

Fase 1: Auditoría de Material

Crea:

• source_inventory.md (inventario de materiales)
• sensitive_info_audit.md (auditoría de información sensible)
• archivos proxy o miniaturas si es necesario
• hoja de contactos de fotogramas para videos existentes

No continúes si el material sensible es visible y no está resuelto.

Fase 2: Storyboard y EDL

Crea antes de editar:

• storyboard.md (storyboard)
• edit_decision_list.json (lista de decisiones de edición)
• style_contract.md (contrato de estilo)

Las entradas de EDL deben incluir:

• archivo de origen
• marca de tiempo de entrada/salida del origen
• nombre del segmento de destino
• regla de recorte/reenfoque
• regla de velocidad
• regla de subtítulos/voz en off
• razón por la que existe este segmento

Fase 3: Versiones de Prototipo

Genera al menos el número solicitado de versiones.

Predeterminado:

• v1_complete: completo, legible, primero la evidencia
• v2_release: más corto y más pulido

Nunca sobrescribas versiones anteriores.

Fase 4: Pulido

Pulir solo después de que la estructura esté aprobada o sea claramente aceptable.

Posible pulido:

• eliminar fotogramas desconocidos / cortes accidentales
• corregir fotogramas oscuros/negros
• reducir pausas estáticas
• mejorar posiciones de recorte
• reducir obstrucción de subtítulos
• normalizar audio si está presente
• refinar tarjetas de título
• crear imagen de póster o GIF

Fase 5: Verificación

Antes de informar que está completo, ejecuta las comprobaciones aplicables:

• ffprobe duración, fps, resolución, comprobación de flujo
• hoja de contactos de fotogramas
• detección de fotogramas negros/oscuros
• detección de segmentos estáticos
• comprobación de legibilidad de subtítulos
• comprobación OCR de texto importante cuando sea posible
• comprobación de volumen de audio si existe audio
• nueva comprobación de información sensible
• ruta y tamaño del archivo final

Salida

...

[truncado para traducción]