Cuándo usar
Usa esta habilidad cuando el usuario solicite un video promocional, video de producto, video de demostración, video de marketing, video de lanzamiento, video explicativo, video de marca, video diseñado, video con múltiples tomas, video con guión gráfico, video de descubrimiento para redes sociales/Reels/TikTok, video de negocio local, video estilo vlog de restaurante/comida, anuncio de producto, video de producto tipo e-commerce/Amazon, packshot o video de giro de producto de 360°, video de escaparate/探店, anuncio DTC/de respuesta directa/antes-después, video editado de 20s+, o cualquier video completo que introduzca 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/tarjeta 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 corto de origen único o bucle de fondo, no como la ruta de entrega final para un video completo con múltiples tomas.
El tema del video puede ser:
- Promoción de proyecto — un proyecto, aplicación o característica 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 contexto confirmado previamente. Primero resuelve la aplicación fuente que se promociona.
app/promoes el proyecto de video de salida, no automáticamente la aplicación fuente. - Promoción de temática — un tema, concepto, marca o sujeto 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, las mismas preconfiguraciones de composición y los mismos comandos de renderizado. Solo difiere la creación del guión gráfico.
Comando
Usa RemotionPromoRenderer.render para la exportación final de la promoción después de la validación. Este comando está documentado por esta habilidad y puede ser llamado incluso si no aparece en <Available Commands>.
width/height/source_orientation DEBEN provenir de la Especificación de Exportación del guión gráfico, no de este ejemplo. El ejemplo a continuación muestra valores de apaisado como marcadores de posición; si el guión gráfico es vertical, pasa width=1080 height=1920 source_orientation=portrait (y cuadrado → 1080/1080/square). El nombre del archivo de salida es promo-<width>x<height>.mp4, por lo que un renderizado vertical que use erróneamente 1920x1080 es una señal de que copiaste el ejemplo en lugar de leer el guión gráfico.
<RemotionPromoRenderer.render>
<promo_dir>/absolute/path/to/app/promo</promo_dir>
<width>WIDTH_FROM_STORYBOARD</width>
<height>HEIGHT_FROM_STORYBOARD</height>
<source_orientation>ORIENTATION_FROM_STORYBOARD</source_orientation>
</RemotionPromoRenderer.render>
Clasificación del tema
Antes de hacer cualquier otra cosa, clasifica el tema 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 (por ejemplo, "做一个介绍太阳系的宣传视频") y el espacio de trabajo no tiene
app/frontendni código de aplicación para promocionar → promoción de temática. - 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 característica próxima → promoción de proyecto. - Si el tema es un producto físico, un negocio/menorista local o lugar, o una oferta de respuesta directa sin una interfaz de aplicación reconstruible como tema principal (por ejemplo, un anuncio de ambientador para coche, un giro de 360° de joyería, un 探店 de tienda de ramen, un anuncio DTC de quitapelusas para mascotas) → promoción de comercio.
- Si ambos se aplican (por ejemplo, "haz una promo para nuestra aplicación explicativa del sistema solar") → trata la aplicación como principal y usa el tema como tema de apoyo; esto es una promoción de proyecto.
Usa estos desempates cuando más de uno pueda encajar: una interfaz de software reconstruible es el tema → promoción de proyecto; un producto físico / lugar físico / oferta sin interfaz reconstruible → promoción de comercio; un concepto o conocimiento externo sin producto → promoción de temática. Un caso mixto (por ejemplo, un producto de software DTC cuyo anuncio también muestra una pantalla de pago real) se clasifica por lo que venden las tomas principales, y puede tomar prestadas las reglas de la otra clase por toma (por ejemplo, un tiempo de ui-demo de pago dentro de una promoción de comercio).
Las promociones de temática y las promociones de comercio son de primera clase. No rechaces ni te detengas en una promoción de temática solo porque no hay app/frontend en el espacio de trabajo, y no degrades una promoción de comercio a una promoción de temática solo porque el producto no tiene app/frontend que reconstruir.
Línea de base de cumplimiento
Los videos promocionales deben tener como valor predeterminado 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 aterrizaje. No impliques asociaciones oficiales, recomendaciones de plataformas, respaldos de marca o certificaciones a menos que el material fuente 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, UI de sistema falsa, 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; usa en su lugar una redacción de audiencia neutral.
No incluyas marcas no licenciadas, personas reconocibles, personajes con derechos de autor, UI de productos de terceros, medios de comunicación, fuentes, marcas de agua, contenido para adultos, sangre, impacto, 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, legales, reclutamiento, bienes raíces, política, religión o problemas sociales, mantén el video informativo y evita promesas fuertes, 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 una mala dimensión de activos o subtítulos/logos/CTAs recortados en los bordes. Si el cumplimiento es incierto, elige la expresión más segura, neutral e informativa primero. Esta línea de 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 una interfaz web interactiva. No renderices la CTA de cierre como un botón de sitio web que parezca cliqueable, un destino de clic falso, un botón de flecha, un campo de entrada falso, una ventana emergente falsa, una UI de sistema falsa, un destino de cursor, un estado de hover/presionado o cualquier control que implique que el espectador puede hacer clic para navegar. Usa en su lugar una línea de tarjeta final, un eslogan de marca, un identificador de cuenta, una URL, un marcador de posición de código QR o un texto simple de "visita / escanea / sigue". Las demostraciones de productos y los recorridos de página pueden mostrar botones de UI, formularios y navegación reales o simulados cuando demuestren el flujo del producto, pero no deben convertirse en la CTA de conversión final.
Cualquier URL visible, identificador 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 aterrizaje u otro activo verificado. Si el proyecto solo expone un dominio de marcador de posición o ninguna 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 sin URL o deja la barra de direcciones en blanco. No infieras un dominio, identificador o destino a partir del nombre de la aplicación, nombre del repositorio, nombre del archivo de descarga, marcador de posición de plantilla, variable de entorno, o sugerencias similares.
Flujo de trabajo central
- Inicializa el proyecto Remotion con
FrontendEngineer.use_template("remotion")siapp/promoaún no está listo. La herramienta misma rechaza una fuente que no sea 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 guión gráfico: apaisado (16:9), vertical (9:16) o cuadrado (1:1). Todos los comandos posteriores de validación, prueba y renderizado completo deben usar la variante correspondiente.
- Clasifica el tema (promoción de proyecto vs. promoción de temática) usando la sección Clasificación del tema anterior. No te detengas a preguntar "¿de qué debería tratar esto?" si la solicitud original ya nombra un tema o proyecto.
- Fundamenta el tema:
- Promoción de proyecto: primero resuelve la aplicación fuente que se promociona, luego lee el código fuente de
app/frontendde esa aplicación, los manifiestos y los comentarios de validación anteriores. Si el espacio de trabajo actual contiene principalmente la salida de la promoción, no tratesapp/promoen sí misma como la aplicación fuente. Una vez que identifiques la aplicación fuente, bloquea esa raíz del proyecto fuente / ruta de frontend enpromo_storyboard.mdo notas de trabajo y sigue reutilizando la misma ruta después de cambiar aapp/promo; no degrades a promoción de temática solo porque el espacio de trabajo de la promoción no tengaapp/frontend. Antes de escribir código Remotion, registra las rutas de archivos fuente de frontend clave en las que confiarás enpromo_storyboard.md(páginas/rutas/componentes para los tiempos de demostración). Más tarde, al implementarsrc/, vuelve a abrir esos archivos fuente y copia/recrea a partir del código en lugar de confiar en un resumen extenso en prosa. - Promoción de temática: extrae el tema del mensaje del usuario y la conversación anterior; obtén hechos 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 hacer el guión 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 promoción, usa
Browser.gotopara visitar la página, luegoBrowser.take_screenshotpara capturar la imagen visual, luego llama aImageAnalyzer.analyze_imagesen la captura de pantalla antes de hacer el guión gráfico para que el plan visual se base en el contenido real de la página en lugar de la URL sola.
- Promoción de proyecto: primero resuelve la aplicación fuente que se promociona, luego lee el código fuente de
- Aplica la Línea de base de cumplimiento: confirma qué hechos, afirmaciones, ofertas y activos están realmente respaldados por la solicitud, el producto, el texto publicitario o la página de aterrizaje. No inventes ofertas, certificaciones, cifras de ventas, efectos, asociaciones oficiales, respaldos de plataformas o apoyo de marca no respaldados; cuando no estés seguro, elige redacción y elementos visuales conservadores e informativos primero.
- 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, elige 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 guión gráfico comoIdioma: Inglés (predeterminado)oIdioma: Chino (especificado por el usuario)antes de redactar tomas, texto, narración o mensajes 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 guión gráfico). Para ejecuciones de promoción/remotion,promo_storyboard.mdes el único artefacto de planificación; no crees ni mantengas untodo.mdseparado. - Si el usuario solicita narración, locución, recorrido hablado o el guión gráfico claramente necesita un narrador, incluye un plan de narración de segmentos cortos en el guión gráfico, verifica la longitud del guión de cada segmento en relación con sus segundos de toma objetivo, luego lee
audio-generationy llama aAudioCreator.generate_audioscon una solicitud por toma/tiempo. - Después de la generación de TTS, prefiere la
durationdevuelta de cada segmento de audio. Si faltadurationo esnull, mide la duración real a partir de la URL devuelta (por ejemplo, conffprobe), luego decide el tiempo 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 guión/tiempo. Este es un punto de control estricto: no llames aMusicCreator.generate_music,VideoCreator.generate_videos, generes más activos visuales ni escribassrc/timeline.tshasta que el tiempo actualizado esté persistido enpromo_storyboard.md. Después de este bloqueo,promo_storyboard.mdya no debe mantener filas de tiempoTBDde marcador de posición ni una duración total desactualizada. - De forma predeterminada, 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 el tiempo final de la toma esté bloqueado. El mensaje 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
durationdevuelta, igual que con la narración. Si faltadurationo 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 guión gráfico/línea de tiempo es la fuente de verdad. Nunca acortes el video solo para que coincida con un BGM corto; en su lugar, recorta, repite mínimamente o regenera la música, a menos que el usuario haya solicitado explícitamente un corte más corto. - Genera cualquier otro activo de IA (imagen/video/audio) necesario después de que el guión gráfico esté escrito y el tiempo de narración + BGM esté establecido en
promo_storyboard.md. - Lee
remotion-best-practicesy concéntrate en las secciones relevantes para el guión gráfico. - Edita la implementación de Remotion en el lugar dentro de
app/promo— mantén el diseño plano 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 la animación puramente impulsada por fotogramas (sinanimation/transitionde CSS, tim...