Cuándo usarlo
Usa esta habilidad cuando el usuario solicite un video promocional, video de producto, video demo, video de marketing, video de lanzamiento, video explicativo, video de marca, video diseñado, video de múltiples tomas, video con guion gráfico, video de descubrimiento para redes sociales/Reels/TikTok, video de negocio local, video estilo vlog de restaurante/comida, video editado de 20 segundos o más, o cualquier video completo que presente un tema visualmente.
Prefiere este flujo de trabajo de Remotion siempre que la solicitud describa un video editado completo con línea de tiempo, tomas, subtítulos, audio, lenguaje de cámara, estilo visual, requisitos de consistencia, CTA/pantalla final o múltiples escenas, incluso si el usuario nunca dice "promo" o "promocional". Usa la generación directa de video con IA solo para un clip de origen único corto o un bucle de fondo, no como la ruta de entrega final para un video completo de múltiples tomas.
El tema del video puede ser:
- Promo de proyecto — un proyecto, app o función que el propio agente está construyendo o que ya existe en el espacio de trabajo, u otra aplicación existente ya identificada en la solicitud del usuario o en el contexto previo confirmado. Primero resuelve la aplicación de origen que se está promocionando.
app/promoes el proyecto de video de salida, no es automáticamente la aplicación de origen. - Promo de tema — un tema, concepto, marca o asunto externo proporcionado por el usuario que no requiere un proyecto en el espacio de trabajo. Ejemplos: "el Sistema Solar", "historia de la dinastía Song", "qué es una base de datos vectorial".
Ambas rutas comparten la misma plantilla de Remotion, los mismos ajustes preestablecidos de composición y los mismos comandos de renderizado. Solo varía la creación del guion gráfico.
Comando
Usa RemotionPromoRenderer.render para la exportación final de la promo después de la validación. Este comando está documentado por esta habilidad y puede ser llamado incluso si no está listado en <Available Commands>.
<RemotionPromoRenderer.render>
<promo_dir>/absolute/path/to/app/promo</promo_dir>
<width>1920</width>
<height>1080</height>
<source_orientation>landscape</source_orientation>
</RemotionPromoRenderer.render>
Clasificación del tema
Antes de hacer cualquier otra cosa, clasifica el tema a partir de la solicitud original del usuario. No le pidas al usuario que aclare si la solicitud ya nombra un tema o proyecto.
- Si el mensaje del usuario nombra un tema/concepto externo claro (p. ej., "haz un video promocional sobre el sistema solar") y el espacio de trabajo no tiene
app/frontendo ningún código de aplicación que promocionar → promo de tema. - Si el mensaje del usuario hace referencia a una compilación de
app/frontendexistente, una aplicación en proceso que el agente ha estado generando o una función próxima → promo de proyecto. - Si aplican ambos (p. ej., "haz una promo para nuestra app explicativa del sistema solar") → trata la aplicación como principal y usa el tema como tema secundario; esto es una promo de proyecto.
Las promos de tema son de primera clase. No rechaces ni te detengas en una promo de tema solo porque no haya app/frontend en el espacio de trabajo.
Para promos de proyecto, resuelve la identidad de la aplicación de origen antes de leer el código. La aplicación de origen puede ser la aplicación actual del espacio de trabajo, una aplicación construida anteriormente en la misma conversación u otro proyecto existente al que el usuario haya hecho referencia explícitamente. No asumas que el espacio de trabajo actual app/promo es lo que se está promocionando.
Base de cumplimiento normativo
Los videos promocionales deben predeterminarse a reglas conservadoras de seguridad publicitaria. Usa solo afirmaciones, ofertas, precios, descuentos, regalos, nombres de marca, CTA, certificaciones, cifras de ventas, efectos y servicios que estén presentes en la solicitud del usuario, proyecto, texto publicitario o página de destino. No impliques asociaciones oficiales, recomendaciones de plataformas, respaldos de marca o certificaciones a menos que el material de origen las proporcione explícitamente.
No uses afirmaciones engañosas o no verificables como resultados garantizados, clasificaciones absolutas, promesas sin riesgo, escasez falsa, cuentas regresivas falsas, notificaciones falsas, botones falsos, interfaz de usuario falsa del sistema, testimonios falsos, reseñas falsas, noticias falsas o capturas de pantalla de resultados exagerados. No te dirijas directamente a atributos personales sensibles como salud, finanzas, edad, raza, religión, sexualidad, discapacidad, estado civil, forma del cuerpo o apariencia; en su lugar, usa un lenguaje de audiencia neutral.
No incluyas marcas no licenciadas, personas reconocibles, personajes protegidos por derechos de autor, interfaz de usuario de productos de terceros, medios, fuentes, marcas de agua, contenido para adultos, sangre, impactante, odio, acoso, contenido humillante, armas, drogas, juegos de azar, tabaco o material políticamente sensible. Para categorías de alto riesgo como médicas, suplementos, pérdida de peso, procedimientos cosméticos, finanzas, préstamos, criptomonedas, juegos de azar, alcohol, citas, niños, asuntos legales, reclutamiento, bienes raíces, política, religión o problemas sociales, mantén el video informativo y evita promesas contundentes, imágenes dramáticas de antes/después o presión agresiva de conversión.
Mantén las imágenes claras, estables y de alta calidad: sin parpadeos, compresión severa, estiramiento, marcas de agua, barras negras causadas por un mal dimensionamiento de los activos o subtítulos/logos/CTA recortados en los bordes. Si la conformidad es incierta, elige la expresión más segura, neutral y basada en información. Esta base reduce el riesgo, pero no es una garantía de aprobación de la plataforma.
Las CTA de conversión finales son contenido de video estático, no interfaz de usuario web interactiva. No renderices la CTA de cierre como un botón de sitio web con apariencia de clic, objetivo de clic falso, botón de flecha, entrada falsa, ventana emergente falsa, interfaz de usuario falsa del sistema, objetivo del cursor, estado de desplazamiento/presión o cualquier control que implique que el espectador puede hacer clic para navegar. Usa una línea de pantalla final, eslogan de marca, nombre de cuenta, URL, marcador de posición de código QR, o texto simple de "visita / escanea / sigue" en su lugar. Las demostraciones de productos y los recorridos de página pueden mostrar botones de UI, formularios y navegación reales o simulados cuando demuestran el flujo del producto, pero no deben convertirse en la CTA de conversión final.
Cualquier URL visible, nombre de cuenta, destino de código QR, texto de barra de direcciones del navegador o punto final de marca debe provenir de la solicitud del usuario, la fuente del proyecto confirmada, la página de destino u otro activo verificado. Si el proyecto solo expone un dominio de marcador de posición o no tiene una dirección pública confirmada, omite la URL y finaliza con texto de marca; para un tratamiento de ventana de navegador, usa una etiqueta de página que no sea una URL o deja la barra de direcciones en blanco. No infieras un dominio, nombre de cuenta o destino a partir del nombre de la aplicación, nombre del repositorio, nombre del archivo de descarga, marcador de posición de la plantilla, token de variable de entorno o sugerencias similares.
Flujo de trabajo principal
- Inicializa el proyecto de Remotion con
FrontendEngineer.use_template("remotion")siapp/promoaún no está listo. La herramienta misma rechaza una fuente que no sea de Remotion antes de copiar, por lo que no necesitas un paso de verificación separado. - Elige la orientación objetivo desde el principio a partir de la solicitud del usuario y el plan del guion gráfico: horizontal (16:9), vertical (9:16) o cuadrado (1:1). Todas las validaciones posteriores, pruebas de humo y comandos de renderizado completo deben usar la variante correspondiente.
- Clasifica el tema (promo de proyecto vs. promo de tema) usando la Clasificación del tema anterior. No te detengas para preguntar "¿de qué debería tratar?" si la solicitud original ya nombra un tema o proyecto.
- Fundamenta el tema:
- Promo de proyecto: primero resuelve la aplicación de origen que se está promocionando, luego lee el código fuente de
app/frontendde esa aplicación, los manifiestos y los comentarios de validación previos. Si el espacio de trabajo actual contiene principalmente la salida de la promo, no tratesapp/promocomo la aplicación de origen. Una vez que identifiques la aplicación de origen, bloquea esa ruta raíz del proyecto / frontend enpromo_storyboard.mdo las notas de trabajo y sigue reutilizando la misma ruta después de cambiar aapp/promo; no degrades a promo de tema solo porque el espacio de trabajo de la promo en sí no tengaapp/frontend. Antes de escribir código de Remotion, registra las rutas de archivos fuente de frontend clave en las que confiarás enpromo_storyboard.md(páginas/rutas/componentes para los momentos de la demo). Más tarde, al implementarsrc/, vuelve a abrir esos archivos fuente y cópialos/recréalos a partir del código en lugar de basarte en un resumen extenso en prosa. - Promo de tema: extrae el tema del mensaje del usuario y la conversación anterior; obtén datos adicionales de tu propio conocimiento o herramientas externas (generación de imágenes / video / audio, búsqueda si está disponible). No requieras que exista un proyecto en el espacio de trabajo.
- Si el usuario proporcionó imágenes de referencia pero la solicitud actual solo expone rutas de archivo en lugar de contenido de imagen adjunto, lee
image-understandingy llama aImageAnalyzer.analyze_imagesantes de crear el guion gráfico para que el plan visual se base en el contenido real de la imagen en lugar de los nombres de archivo. - Si el usuario proporcionó una URL de sitio web como tema de la promo, usa
Browser.gotopara visitar la página, luegoBrowser.take_screenshotpara capturar lo visual, luego llama aImageAnalyzer.analyze_imagesen la captura de pantalla antes de crear el guion gráfico para que el plan visual se base en el contenido real de la página en lugar de solo la URL.
- Promo de proyecto: primero resuelve la aplicación de origen que se está promocionando, luego lee el código fuente de
- Aplica la Base de cumplimiento normativo: confirma qué hechos, afirmaciones, ofertas y activos están realmente respaldados por la solicitud, el producto, el texto publicitario o la página de destino. No inventes ofertas, certificaciones, cifras de ventas, efectos, asociaciones oficiales, respaldos de plataforma o apoyo de marca no respaldados; cuando sea incierto, elige palabras e imágenes conservadoras basadas en información.
- Determina el idioma predeterminado para el contenido promocional recién generado antes de escribir
promo_storyboard.md. Si el usuario especifica explícitamente un idioma de salida, usa ese idioma. De lo contrario, el inglés por defecto. Un mensaje de usuario escrito en chino/japonés/etc., el idioma del chat circundante o el idioma del mensaje del sistema no es una solicitud de idioma explícita. Registra la decisión directamente en el guion gráfico comoIdioma: Inglés (por defecto)oIdioma: Chino (especificado por el usuario)antes de redactar tomas, texto, narración o indicaciones de generación. - Crea
promo_storyboard.mdantes de escribir código de video o generar activos. Usa el conjunto de campos que coincida con el tipo de tema (consulta Requisitos del guion gráfico). Para ejecuciones de promo/remotion,promo_storyboard.mdes el único artefacto de planificación; no crees ni mantengas untodo.mdseparado. - Si el usuario solicita narración, voz en off, recorrido hablado o el guion gráfico claramente necesita un narrador, incluye un plan de narración de segmentos cortos en el guion gráfico, verifica la longitud del guion de cada segmento con respecto a los segundos de toma objetivo, luego lee
audio-generationy llama aAudioCreator.generate_audioscon una solicitud por toma/momento. - Después de la generación de TTS, prefiere la
duracióndevuelta de cada segmento de audio. Si falta laduracióno esnull, mide la duración real desde la URL devuelta (por ejemplo, conffprobe), luego decide la sincronización final por toma a partir de esas duraciones medidas. Este cálculo no es suficiente si solo aparece en el pensamiento o la salida del terminal. - Actualiza inmediatamente
promo_storyboard.mdcon cada URL de narración, segundos de audio medidos, inicio/fin/duración final de la toma, duración total y cualquier cambio de guion/sincronización. Este es un punto de control estricto: no llames aMusicCreator.generate_music,VideoCreator.generate_videos, generes más activos visuales o escribassrc/timeline.tshasta que la sincronización actualizada esté persistida enpromo_storyboard.md. Después de este bloqueo,promo_storyboard.mdya no debe mantener filas de sincronizaciónTBDde marcador de posición ni una duración total desactualizada. - Por defecto, los videos promocionales también deben incluir un plan de música de fondo global a menos que el usuario diga explícitamente que no quiere música o que la pieza claramente sea mejor sin música. Lee
music-generationy llama aMusicCreator.generate_musiccon exactamente una solicitud instrumental / sin voces después de que se haya bloqueado la sincronización final de la toma. La indicación debe incluir los segundos totales objetivo, el estado de ánimo, el ritmo, la instrumentación y si la pista debe dejar espacio para la narración. - Después de la generación de música, usa la URL devuelta directamente y prefiere la
duracióndevuelta, al igual que con la narración. Si falta laduracióno esnull, mide la duración real del BGM conffprobe. Actualiza inmediatamentepromo_storyboard.mdcon la URL del BGM, los segundos medidos, la duración total objetivo, la estrategia de ajuste y los valores de mezcla planificados antes de escribirsrc/timeline.tsosrc/PromoVideo.tsx. La duración bloqueada del guion gráfico/línea de tiempo es la fuente de verdad. Nunca acortes el video solo para que coincida con un BGM corto; recorta, repite mínimamente o regenera la música en su lugar, a menos que el usuario haya solicitado explícitamente un corte más corto. - Genera cualquier otro activo de IA de imagen/video/audio necesario después de que el guion gráfico esté escrito y la sincronización de narración + BGM esté resuelta en
promo_storyboard.md. - Lee
remotion-best-practicesy los archivos de reglas relevantes para el guion gráfico. - Edita la implementación de Remotion en el lugar bajo
app/promo— mantén la disposición plana desrc/de la plantilla (src/Root.tsx,src/PromoVideo.tsx,src/timeline.ts,src/components/,src/scenes/,src/app-demo/). No muevas las fuentes a un subdirectorio comosrc/remotion/. Antes de la validación, haz una autoverificación rápida: elimina importaciones/variables no utilizadas, omiteSequence from={0}redundante, mantén el movimiento puramente basado en fotogramas (sinanimation/transitionde CSS, temporizadores u otros patrones no deterministas) y actualiza cualquier contrato modificado desrc/timeline.ts/src/PromoVideo.tsx/src/scenes/*en la misma pasada. - Ejecuta la validación en orden:
verify:versions,lint,verify:compositions. Pasarverify:compositionssolo prueba que Remotion puede ver las composiciones; no es un entregable ni un punto de parada válido. - Ejecuta
RemotionPromoRenderer.renderpara la resolución objetivo registrada en el guion gráfico/especificación de exportación; realiza internamente una prueba de humo y un renderizado completo. Para videos verticales/9:16, usawidth=1080,height=1920ysource_orientation=portraiten lugar de copiar un ejemplo horizontal. La tarea solo está terminada cuandoout/promo-<ancho>x<alto>.mp4existe y no está vacío. No le digas al usuario que el video está listo para exportar, pídele que lo exporte, llama aRoleZero.reply_to_humano usa<end></end>antes de que esta herramienta tenga éxito.
Requisitos del guion gráfico
promo_storyboard.md debe ser específico para el tema. Elige el conjunto de campos que coincida con el tipo de tema:
Cada guion gráfico debe incluir:
- Notas de cumplimiento: afirmaciones/ofertas/activos compatibles, si el tema es de alto riesgo, las elecciones de redacción conservadoras y los riesgos visuales/de texto/activos a evitar.
- Tratamiento de CTA: registrar si la CTA final es video estático...