vibe-knowledge-video

Vibe Knowledge Video

Convierte el conocimiento en animaciones adecuadas para su propósito, comprensibles y listas para la reproducción real. Sigue el flujo de trabajo, las herramientas y los criterios de aceptación ya probados en Vibe Science Video, pero los extiende a diferentes campos y estilos. La profundidad del conocimiento, la paleta de colores, el sonido y los efectos de movimiento se seleccionan de forma independiente; tanto la expresión científica como la referencia lúdica son opciones válidas. No prometas que cualquier tema se generará con éxito a la primera, ni consideres que el código fuente de generación es un video ya entregado.

Para cada video nuevo, primero confirma el propósito y el estilo

Este es el paso de inicio del skill. Lee primero Propósito y Estilo, organiza la información ya proporcionada y luego completa con 2–3 preguntas breves:

1. Propósito y audiencia: ¿Dónde se usará, quién lo verá, cuál es su base de conocimiento, qué deberían entender al terminar?
2. Estilo y referencia: ¿Investigación/docencia, divulgación general, entretenimiento o mixto? ¿Qué características de la referencia se adoptan y cuáles no?
3. Ritmo y sonido: ¿Relajado/moderado/ajustado? ¿Presencia de música, narración y efectos de sonido? ¿Puntos de sincronización y destellos musicales: desactivados, sutiles o notorios?

Registra directamente la información ya clara; solo pregunta por lo que falta. Cuando el usuario delegue explícitamente la elección, documenta la justificación. Si el propósito o el estilo aún no están definidos, espera la respuesta antes de definir el storyboard, el diseño visual, la música y la producción; mientras tanto, puedes organizar materiales y verificar hechos. No apliques automáticamente un estilo solo por el tema, la plataforma o el video anterior; las revisiones normales del mismo video mantienen la dirección ya confirmada.

Escribe las respuestas, las fuentes confirmadas y los elementos pendientes en el brief. Todos los estilos deben mantener precisión factual, claridad causal y fuentes rastreables. Los colores vibrantes también pueden usarse en diagramas científicos; tomas sobrias pueden combinarse con música rítmica. Se permite: sin BGM, destellos desactivados, narración dominante y gráficos 2D. La evaluación concreta se basa en el propósito de este video, no en usar más brillo o más efectos como estándar de calidad.

Primero, determina en qué fase se encuentra la tarea

• Nuevo proyecto: Lee Historia y Evidencia y Diseño Visual. Crea un brief, una tabla de hechos y un storyboard.
• Continuar un proyecto existente: Primero lee los archivos del proyecto: AGENTS.md, planning/brief.md, planning/project-state.md y el índice de análisis de referencias. Si la ruta del proyecto existente es diferente, usa la entrada real. Encuentra la versión final, la pista de audio definitiva, la línea de tiempo y el último feedback del usuario. Conserva las salidas antiguas; no sobrescribas la versión final con borradores históricos.
• Analizar un video de referencia: Lee Análisis y Migración de Referencias. Registra el video fuente, el segmento temporal, la evidencia, el propósito aplicable y el método de migración. Distingue entre los métodos aprendidos y los componentes genéricos ya implementados.
• Corregir un problema específico: Lee la sección de corrección en Producción, Revisión y Corrección. Registra el punto temporal, el objeto, el fenómeno. Decide si es necesario cambiar la pista de audio, re-renderizar o reestructurar todo el video.
• Solo portada o texto promocional: Lee Materiales de Publicación. No inicies una regrabación innecesaria del video.

Al crear un nuevo video, redefinir el diseño visual o añadir/cambiar assets, revisa las referencias, imágenes, datos y modelos existentes del proyecto. Cuando se necesiten candidatos 3D, lee assets/models/README.md, inventory.json y las vistas previas existentes. Si no hay un inventario, usa la herramienta de auditoría de solo lectura del Flujo de Reutilización de Modelos para encontrar archivos reales. Selecciona según el objeto de la escena, el plano y el estilo confirmado, y registra los archivos y las decisiones en el Plan de Assets. Si solo se modifican los subtítulos, la mezcla de audio o el texto de publicación, no es necesario re-escanear la biblioteca de modelos.

El sonido, la audiencia, la duración y la relación de aspecto se confirman para este video en particular. La versión maestra 16:9, 4K60 y la versión de reproducción 1080p60 son especificaciones de entrega opcionales basadas en la experiencia previa; las vistas previas pueden usar una resolución más baja. Si el presupuesto, el hardware o el tema no son adecuados, propón compensaciones concretas; no consideres 4K, 60 fps o 3D como sustitutos de la calidad.

Solo pregunta por información que no se pueda obtener de los materiales existentes y que cambie el resultado. Si el tema ya está decidido, no fuerces una re-selección. Cuando el usuario pida ver una muestra primero, entrega la muestra. Cuando el usuario autorice una ejecución continua, después de un control de calidad interno, continúa hasta terminar; no solicites permiso repetidamente etapa por etapa. La autorización para la producción no incluye automáticamente la publicación pública o la modificación de cuentas externas.

Restricciones centrales de este flujo de trabajo

1. Que tenga sentido a primera vista. El primer fotograma debe tener un sujeto relevante al tema; un video de investigación puede presentar directamente la pregunta de estudio, uno educativo muestra la relación a entender, y la divulgación masiva puede usar una situación humana o una contradicción contraintuitiva.
2. Cada segmento avanza una comprensión. Explica el mecanismo como "problema → cambio de condición → comportamiento del objeto → resultado visible"; responde antes de plantear la siguiente pregunta. No sustituyas las respuestas con una cadena de preguntas.
3. Hechos y metáforas por separado. Registra el objeto, la condición, la causa y efecto, la fuente, las discrepancias explicativas y las simplificaciones visuales. La investigación científica no se convierte en un sistema universal; los eventos históricos no confunden tiempo y causalidad; los gráficos matemáticos y los datos comparten el modelo. Las afirmaciones del autor de la referencia necesitan verificación independiente.
4. La respuesta audiovisual se activa según la elección. Se pueden seleccionar tres niveles (energía continua, ritmo normal, revelación clave), y cada nivel se puede desactivar. Cuando se necesiten puntos de sincronización, haz que el ataque sonoro se corresponda con un resultado visible y prepara la acción previa; no fuerces un destello en cada golpe.
5. Ajustado no significa texto recortado. Primero elimina las entradas lentas y las pausas vacías después de leer; las acciones complejas aún necesitan tiempo de observación. Los subtítulos, las acciones y los SFX se exportan desde la misma línea de tiempo.
6. La calidad visual sirve a la comprensión. Prioriza un sujeto claro, materiales, jerarquía, dirección y contacto visible sobre partículas irrelevantes. Para mecanismos que requieren oclusión frontal/trasera, inserción o envolvimiento, usa estructuras espaciales verificables.
7. Las transiciones también son storyboard. Define explícitamente la escena anterior, la continuidad del objeto o la forma, la oclusión, el fotograma de intercambio y el punto de aterrizaje de la siguiente escena. No esperes a que todo el video esté terminado para añadir fundidos genéricos.
8. Revisa el archivo final. Lo que se ve en el estudio, el PNG, el MP4 codificado y la vista previa subida pueden ser diferentes. La decodificación completa, la verificación por fotogramas, la reproducción continua y la escucha real se registran por separado; no pueden suplantarse entre sí.

Flujo de entrega ejecutable

La siguiente tabla es para un video nuevo completo. Cuando el usuario solo solicite storyboard, análisis de referencia, portada o correcciones parciales, ejecuta y entrega según el alcance correspondiente; no añadas etapas irrelevantes. Si no hay un plan de sonido, no impongas pasos musicales.

Etapa	Resultados verificables obligatorios	Criterios para el siguiente paso
1. Recibir entrada	brief: propósito, audiencia, estilo, ritmo/imagen y sonido, materiales, especificaciones, alcance de entrega	Las direcciones clave tienen base confirmada; los elementos pendientes y los objetivos de visualización están claros
2. Contenido y narrativa	Tabla de hechos, línea argumental de una frase, cadena de preguntas, diseño de los primeros 15 segundos	Las conclusiones clave son rastreables; la apertura tiene acción y promesa; las preguntas se pueden responder
3. Storyboard visual y sonoro	Tabla de storyboard, Plan de assets, plan de sonido, cues opcionales, transiciones	Los objetos coinciden con los hechos; las relaciones son visibles; el estilo y la intensidad se ajustan al propósito
4. Muestra de calidad	Corte real codificado corto: apertura + la toma del mecanismo más difícil + una transición representativa	Los assets clave alcanzan la calidad final; las acciones clave y el sonido están alineados correctamente
5. Producción completa	Proyecto editable, línea de tiempo unificada, subtítulos, eventos de sonido, registro de assets	Cada capítulo se explica con claridad, las tomas fluyen naturalmente, los subtítulos no tienen pausas vacías o lecturas apresuradas
6. Salida y corrección	Video completo, QA correspondiente, versiones revisadas y sus diferencias	Archivo, imagen, sonido e identidad de versión pasan la verificación por separado
7. Paquete de publicación	Portada, título, descripción, etiquetas, lista de entrega, instrucciones de reproducción	Las promesas externas coinciden con el contenido; el recorte de la plataforma y la selección de archivos son correctos

Lee las referencias según sea necesario para la tarea:

• Historia y Evidencia: Conversión de artículo a guion, ganchos, cadenas de preguntas, duración de subtítulos, ejemplos narrativos completos.
• Propósito y Estilo: Preguntas de inicio, dimensiones de estilo independientes, límites de confirmación y revisión.
• Análisis y Migración de Referencias: Métodos específicos de 8 referencias, códigos de tiempo y límites de evidencia, flujo de extracción de fotogramas y migración para nuevas referencias.
• Diseño Visual: Sistema de diseño, selección de assets, materiales y espacio, recetas de movimiento, transiciones y verificación de clipping.
• Biblioteca de Modelos y Reutilización entre Sesiones: Descubrimiento de assets locales, verificación de estructura, partes, tamaño y licencia; diseño de tomas; cómo crear puntos de entrada para proyectos nuevos o existentes.
• Música y Sincronización: Música opcional, envolventes y transitorios, fotogramas de resultado, mezcla y alineación.
• Producción, Revisión y Corrección: Implementación reproducible, presupuesto de renderizado, verificación de archivos finales, corrección localizada, estructura de entrega.
• Materiales de Publicación: Composición de portada, relación de aspecto de la plataforma, título y descripción, fuentes de assets y paquete de publicación.
• Caso de Estudio y Corrección de Errores Reales: Resultados finales de "Convertir bacterias en medicina", feedback, motivos de corrección y límites de aplicabilidad.
• Herramientas Portátiles: Comandos reales y limitaciones para analizar BGM, verificar líneas de tiempo, decodificar completamente y generar informes de extracción de fotogramas.

Verificación inicial y arranque del proyecto

Al crear un nuevo proyecto, puedes copiar el starter de Remotion + Three.js al proyecto del usuario y luego seguir sus instrucciones para instalar, previsualizar y renderizar. No modifiques directamente las plantillas de un skill ya instalado. Es un experimento de aproximadamente 12 segundos sobre movimiento espacial condicionado, utilizado para verificar el entorno, el movimiento, el sonido y la cadena de exportación; no es una introducción fija que convierta automáticamente cualquier tema en un video completo.

La música de referencia y el registro de fuentes incluidos conservan entradas de prueba opcionales del experimento técnico original; no deciden la selección musical para un nuevo video. El starter admite archivos personalizados y silencio explícito; después de cambiar la música, actualiza el análisis y los momentos de los eventos. La línea de tiempo de la plantilla timeline.json es un ejemplo de estructura independiente, no una tabla de sincronización fija para la música de referencia o el starter.

Ejecuta tools.md para el análisis de música, la verificación de la línea de tiempo y la verificación del archivo multimedia final en proyectos reales. Lee las advertencias en los informes y combínalas con el juicio visual; no elimines condiciones científicas ni desactives las advertencias solo para que el script se muestre en verde. Las herramientas no pueden determinar automáticamente si el mecanismo es correcto, si el resultado realmente aparece en el fotograma especificado, o si el tono de aviso es audiblemente prominente; esto aún requiere una revisión visual y auditiva.

Las herramientas y plantillas relacionadas deben basarse en las instrucciones reales del repositorio; no adivines los nuevos tiempos musicales a partir de los valores de los casos de ejemplo. Incluso sin un modelo de imagen específico, GPU o skill adicional, puedes ejecutar este flujo de trabajo con las herramientas disponibles. Los proyectos Remotion existentes deben priorizar el uso de su versión bloqueada; si se necesita llamar a su nueva API, consulta la documentación oficial actual. Si ya existe un skill oficial de Remotion, se puede usar en combinación; este skill no depende de otro skill específico para entender el flujo de trabajo central.

Al comenzar la producción, completa estas evaluaciones primero

Narrativa: Escribe una razón de visualización concreta; elige las 3–5 preguntas que mejor puedan formar una respuesta visible como punto de partida, no como un requisito fijo. Decide qué escena es la mayor revelación y qué segmentos necesitan una explicación tranquila.

Assets: Primero, haz un inventario de los candidatos locales y registra la correspondencia entre cada objeto visible y los hechos. Reutiliza cuando sea apropiado; cuando el objeto, la época, la estructura, las partes o el efecto visual no sean adecuados, explica el motivo y elige gráficos 2D, modificación del asset o la creación de uno nuevo. El hecho de que una cadena esté coloreada no significa que pueda moverse de forma independiente; un modelo existente no significa que la animación del mecanismo ya esté hecha. Primero, lleva una toma representativa al nivel de finalización deseado, y luego generaliza los materiales y las acciones.

Sonido: Elige música, narración, efectos de sonido o silencio según la confirmación de este video. Cuando uses música, registra el archivo real, la duración y la versión; después de editar, hacer loop o cambiar la velocidad, vuelve a analizar. Detectar transitorios no es lo mismo que tener golpes de batería confirmados; la mezcla del video de referencia tampoco es solo BGM.

Ingeniería: Archiva la entrada, los assets, el código fuente, la salida y el QA dentro del proyecto; el estado del mismo fotograma debe ser reproducible. Usa semillas aleatorias explícitas; evita que las animaciones dependan del reloj real, el historial de reproducción o recursos asíncronos no terminados.

Tomas de riesgo: Primero prueba el proceso completo de lo más difícil de explicar. Los conteos de gráficos y las curvas comparten datos; las etiquetas de los mapas siguen la ubicación correcta; las tomas de inserción mantienen el estado de la imagen principal al regresar. Cuando involucran movimiento espacial, verifica agujeros, barridos rotacionales, estructuras internas/externas y contactos. Las relaciones específicas se basan en los materiales de este proyecto.

Definición de finalización

Después de cada entrega importante o feedback del usuario, actualiza planning/project-state.md: archivos oficiales, verificaciones reales, elementos pendientes de revisión, elementos confirmados por el usuario / a la espera de evaluación, puntos de entrada de assets y referencias, y próximos pasos. La inicialización y la instalación de herramientas proporcionan el punto de entrada para la continuación del proyecto; consulta el manual de herramientas. Escribe los métodos estables en el registro de referencias; la duración, la frecuencia de cuadros, la paleta de colores y las preferencias de obras específicas mantienen su ámbito de aplicación; el estado de las muestras, los videos completos y los componentes genéricos se registran por separado.

Para videos sin sonido, el ítem de sonido se puede marcar como "no aplica"; no crees picos de sonido ni impongas música para la revisión. Los videos de referencia y sus pistas de audio no se proporcionan con este paquete; solo se incluyen los métodos de análisis transferibles; el BGM del caso original se indica por separado con su fuente y alcance de licencia.

Usa la Lista de Verificación de QA para marcar "verificado / no verificado / no aplica" con evidencia; no marques un estado de finalización que no se haya ejecutado. La entrega de una tarea de video completo incluye: video reproducible, proyecto editable, guion/subtítulos finales, registro de sonido y eventos realmente utilizados, texto de portada y descripción dentro del alcance, método de previsualización/renderizado, fuentes de assets y limitaciones conocidas. Si la tarea es solo storyboard, análisis o corrección parcial, entrega los resultados correspondientes según la solicitud.

Si el entorno no puede renderizar realmente, especifica claramente hasta qué paso se ha llegado, qué comando o recurso está bloqueando, y conserva el proyecto ejecutable; no escribas "generado MP4" para un enlace de vista previa o un video que es "teóricamente renderizable". El agrado del usuario por la obra, la aprobación de una revisión automática y los datos de visualización de la plataforma son evidencias diferentes; ninguna de ellas debe escribirse automáticamente como "alta retención garantizada".