Producción de vídeo con Remotion
Convierte el material fuente en un vídeo coherente y editable. Autoría del vídeo en React; renderizado a partir de medios guardados. Sigue las etapas siguientes, adaptándote a las instrucciones del usuario y al proyecto existente. Mantén un registro breve de producción para que otro agente pueda continuar sin reconstruir las decisiones.
1. Inspeccionar el resumen, los recursos y las capacidades
Identifica la audiencia, el mensaje previsto, el formato de entrega, el tono y los recursos disponibles. Distingue los hechos fuente, la interpretación editorial y la información no resuelta; no inventes pasos, capacidades o resultados faltantes. Extrae los recursos en línea de gran tamaño antes de leer el documento en contexto. Conserva una asignación de fuente a escena en el proyecto de producción.
Inspecciona las imágenes y grabaciones relevantes, no solo los nombres de archivo. Observa el encuadre, las etiquetas incrustadas, el sonido y las acciones realmente visibles. Comprueba si este agente puede inspeccionar imágenes, escuchar audio, ejecutar código y proporcionar una vista previa accesible para el usuario. La falta de capacidad perceptual requiere la alternativa en references/runtime.md; un script no puede determinar esas capacidades del modelo ni reemplazar el juicio humano.
Para un proyecto Node existente, opcionalmente ejecuta node <skill-dir>/scripts/doctor.mjs <project-dir>. Este inventaria dependencias; no prueba la preparación para el renderizado. Usa el gestor de paquetes y el archivo de bloqueo del proyecto. Sigue la habilidad de mejores prácticas actual de Remotion cuando esté disponible; si no, consulta la documentación oficial.
2. Proponer una dirección y aclarar solo la incertidumbre significativa
Ofrece una dirección recomendada: audiencia/mensaje, duración aproximada y relación de aspecto, progresión de escenas, tono visual y enfoque narrativo. Explica cómo la fuente y el propósito de visualización lo fundamentaron. Para las opciones de estructura y estilo, usa references/editorial.md.
Plantea un pequeño número de preguntas enfocadas cuando las respuestas cambiarían el contenido factual, la audiencia, la dirección o el uso de recursos no disponibles. No repitas preguntas ya respondidas ni requieras un cuestionario para cada trabajo. Continúa con el trabajo independiente mientras esperas; los hechos esenciales no resueltos no deben inventarse. Si las preferencias opcionales siguen sin especificarse, indica suposiciones razonables y procede dentro de la autorización del usuario.
3. Escribir un storyboard compacto
Para cada escena, registra su propósito, la evidencia fuente, las palabras habladas, el énfasis en pantalla, el estilo visual/movimiento pretendido y la duración aproximada. Mantén la narración separada de los encabezados y los subtítulos. Enumera los hechos no resueltos por separado. Trata el storyboard como un documento editorial, no como un nuevo lenguaje de programación. Prueba una secuencia representativa temprano si la dirección visual o de audio es incierta.
4. Preparar medios y tiempos medidos
Asigna a cada tipo de medio un adaptador apropiado. Una solicitud de voz y una solicitud de generación de vídeo no necesitan compartir una forma de entrada. Normaliza sus resultados a archivos guardados y metadatos útiles, incluyendo duración, dimensiones, configuración de generación, procedencia y atribución requerida cuando corresponda.
Resuelve la generación de medios antes de la previsualización o el renderizado. Almacena en caché las salidas según el contenido de entrada y la configuración efectiva del proveedor, y verifica los archivos en caché. No actives generación paga o no determinista desde funciones de renderizado de React o evaluación de metadatos.
Para la narración, cuando sea necesario, mantén el texto mostrado separado del texto de pronunciación. Mide la duración real del audio y luego permite suficiente tiempo para que la imagen y el texto asociados se comprendan. Usa la sincronización de frases u oraciones cuando sea suficiente. El resaltado de palabras requiere marcas de tiempo o alineación fiables; distribuir caracteres uniformemente no es una alineación precisa.
Para grabaciones existentes, conserva o recorta deliberadamente el sonido original y deriva los subtítulos de una transcripción o transcrito. Considera los desplazamientos de escena, la entrada de audio, las pausas y las transiciones superpuestas. Usa references/pipeline.md para los contratos de adaptador, tiempo, caché y revisión. Los ayudantes opcionales incluidos extraen imágenes en línea y validan rangos de subtítulos; el uso y las limitaciones están en references/runtime.md.
5. Implementar en React/TypeScript ordinario
Reutiliza componentes pequeños para tratamientos recurrentes y permite React arbitrario para escenas específicas del tema. Los datos pueden contener texto, rutas de medios, tiempos, referencias fuente y tokens de diseño. Introduce un esquema de plantilla solo cuando la salida repetida de un formato conocido lo justifique. No crees un intérprete de línea de tiempo general, un registro de complementos o un servicio de orquestación para un vídeo local.
Impulsa el movimiento a partir de números de fotograma; evita los temporizadores de reloj de pared y la aleatoriedad no controlada. Carga las fuentes y los recursos requeridos localmente. El estilo puede cambiar la tipografía, la composición, el movimiento, el texto de énfasis, el ritmo y el audio; cambiar solo una paleta no es un cambio de estilo completo. Reutiliza los medios y tiempos aprobados cuando solo cambie la presentación.
Ejecuta verificaciones enfocadas de tipo, recurso, duración y subtítulos. Usa check-captions.mjs incluido solo para su contrato de tiempo documentado. Las pruebas deben estar alrededor de la lógica reutilizable de tiempo, importación y caché, no en cada decisión estética. Prefiere componentes existentes y cambios pequeños y verificados cuando el agente tiene capacidad de codificación limitada.
6. Previsualizar antes de invertir tiempo en la exportación final
Prefiere Remotion Studio cuando el usuario pueda acceder a él. Muestra la composición y explica qué necesita revisión: fidelidad a la fuente, estilo, recorte de texto/asunto, legibilidad de subtítulos, movimiento y sonido. Inspecciona escenas representativas, los límites y el final tú mismo cuando sea compatible. Cuando el usuario haya solicitado una revisión antes de la exportación, proporciona la vista previa y espera esa revisión antes de la exportación final. La aprobación existente o una solicitud explícita de renderizado puede autorizar a continuar; no agregues una compuerta de confirmación incondicional.
Si el Studio interactivo no está disponible, produce imágenes fijas representativas y, cuando el movimiento/audio necesite revisión, un borrador breve de baja resolución. La URL localhost de un entorno remoto puede ser inaccesible para el usuario; entrega una vista previa o un artefacto local alcanzable. Las imágenes fijas no establecen la calidad del movimiento o el audio. Aplica las alternativas de revisión humana en references/runtime.md e informa exactamente qué se revisó y qué no.
7. Exportar, verificar y entregar
Después de completar cualquier revisión solicitada, usa la CLI de Remotion instalada en el proyecto para la exportación rutinaria. Consulta references/runtime.md para los comandos npx. Usa la API de renderizado solo cuando la integración programática o el procesamiento por lotes lo justifique. Conserva las ediciones del usuario y regenera solo los medios afectados al revisar.
Verifica las dimensiones, la frecuencia de fotogramas, la duración, la presencia de audio, el primer/último fotograma, los cambios de subtítulos y los límites de escena del archivo exportado. Reproduce el resultado completo cuando la revisión perceptual esté disponible; de lo contrario, identifica la revisión humana restante. Un renderizado o decodificación de audio exitoso no establece la calidad editorial, la pronunciación correcta o una mezcla agradable. La revisión de la vista previa y la verificación del archivo final son evidencias separadas.
Entrega el proyecto editable, la ubicación de la vista previa/exportación, los comandos de reproducción y un estado conciso: implementado, vista previa verificada, usuario revisó, exportado, archivo final verificado. Solo reclama las etapas completadas. Mantén el registro de producción junto con la producción.
Mantener la guía reutilizable independiente de las producciones
Las habilidades y los ejemplos distribuibles deben ser autocontenidos y neutrales en cuanto al tema. Mantén el texto fuente privado, las imágenes, el audio, los nombres, los enlaces, los identificadores, las rutas de archivo y las instrucciones específicas de producción dentro del proyecto de producción. No los incluyas en una habilidad reutilizable, sus metadatos, referencias, accesorios o recursos. Usa ejemplos recién inventados si es necesario un ejemplo.
Documenta los métodos y criterios de decisión aprendidos de una producción sin codificar su tema como un requisito universal. Verifica el contenido real del paquete de la habilidad antes de compartirlo o instalarlo.