Communitygithub.com

Tech7516/Inventaire_PCP16

Se usa al crear un video editado completo — promocional, demo de producto, explicativo, temático, para redes sociales/Reels/TikTok, 探店/local, e-commerce/packshot/360, DTC/antes-después, o cualquier pieza de 20s+ con múltiples tomas o guión gráfico — para el proyecto actual o un tema proporcionado por el usuario. También se usa cuando el video se empareja con narración/locución o una pista de audio separada, o debe sincronizarse con una duración de audio medida (incluso un solo clip de imagen a video más una línea de locución), ya que solo la línea de tiempo de Remotion evita que el audio se corte.

¿Qué es Inventaire_PCP16?

Esta habilidad de agente de IA está diseñada para la creación de videos promocionales completamente editados utilizando Remotion, una biblioteca de videos programáticos en React. Cubre una amplia gama de tipos de videos, incluyendo promociones, demostraciones de productos, videos explicativos, contenido para redes sociales como Reels y TikTok, y piezas de comercio electrónico con vistas de 360 grados. La habilidad maneja dos flujos de trabajo principales: 'promoción de proyecto' para promocionar una aplicación o función existente construida por el agente, y 'promoción de temática' para temas externos o conceptos sin una aplicación de respaldo. También incluye un modo de 'promoción de comercio' para productos físicos y negocios locales, asegurando cobertura para todos los casos de uso. El proceso de creación es altamente estructurado: primero clasifica el tema, luego crea un storyboard detallado, genera narración y música de fondo, y finalmente procesa el video en Remotion. La habilidad se adhiere a estrictas reglas de cumplimiento para evitar afirmaciones engañosas, material con derechos de autor y contenido sensible, y garantiza que todos los elementos visuales y de audio estén sincronizados correctamente dentro de la línea de tiempo de Remotion para evitar cortes de audio. Las plataformas compatibles incluyen herramientas como Claude Code, Cursor y otras terminales con capacidad de ejecución de comandos XML y acceso a herramientas de generación de activos.

Compatible con✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Tech7516/Inventaire_PCP16/tree/HEAD/.atoms/skills/promo-video-production

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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:

  1. 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/promo es el proyecto de video de salida, no automáticamente la aplicación fuente.
  2. 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/frontend ni 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/frontend existente, 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

  1. Inicializa el proyecto Remotion con FrontendEngineer.use_template("remotion") si app/promo aú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.
  2. 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.
  3. 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.
  4. Fundamenta el tema:
    • Promoción de proyecto: primero resuelve la aplicación fuente que se promociona, luego lee el código fuente de app/frontend de 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 trates app/promo en 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 en promo_storyboard.md o notas de trabajo y sigue reutilizando la misma ruta después de cambiar a app/promo; no degrades a promoción de temática solo porque el espacio de trabajo de la promoción no tenga app/frontend. Antes de escribir código Remotion, registra las rutas de archivos fuente de frontend clave en las que confiarás en promo_storyboard.md (páginas/rutas/componentes para los tiempos de demostración). Más tarde, al implementar src/, 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-understanding y llama a ImageAnalyzer.analyze_images antes 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.goto para visitar la página, luego Browser.take_screenshot para capturar la imagen visual, luego llama a ImageAnalyzer.analyze_images en 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.
  5. 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.
  6. 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 como Idioma: Inglés (predeterminado) o Idioma: Chino (especificado por el usuario) antes de redactar tomas, texto, narración o mensajes de generación.
  7. Crea promo_storyboard.md antes 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.md es el único artefacto de planificación; no crees ni mantengas un todo.md separado.
  8. 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-generation y llama a AudioCreator.generate_audios con una solicitud por toma/tiempo.
  9. Después de la generación de TTS, prefiere la duration devuelta de cada segmento de audio. Si falta duration o es null, mide la duración real a partir de la URL devuelta (por ejemplo, con ffprobe), 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.
  10. Actualiza inmediatamente promo_storyboard.md con 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 a MusicCreator.generate_music, VideoCreator.generate_videos, generes más activos visuales ni escribas src/timeline.ts hasta que el tiempo actualizado esté persistido en promo_storyboard.md. Después de este bloqueo, promo_storyboard.md ya no debe mantener filas de tiempo TBD de marcador de posición ni una duración total desactualizada.
  11. 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-generation y llama a MusicCreator.generate_music con 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.
  12. Después de la generación de música, usa la URL devuelta directamente y prefiere la duration devuelta, igual que con la narración. Si falta duration o es null, mide la duración real del BGM con ffprobe. Actualiza inmediatamente promo_storyboard.md con la URL del BGM, los segundos medidos, la duración total objetivo, la estrategia de ajuste y los valores de mezcla planificados antes de escribir src/timeline.ts o src/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.
  13. 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.
  14. Lee remotion-best-practices y concéntrate en las secciones relevantes para el guión gráfico.
  15. Edita la implementación de Remotion en el lugar dentro de app/promo — mantén el diseño plano de src/ 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 como src/remotion/. Antes de la validación, haz una autoverificación rápida: elimina importaciones/variables no utilizadas, omite Sequence from={0} redundante, mantén la animación puramente impulsada por fotogramas (sin animation / transition de CSS, tim...

Skills relacionados