Adaptación en tiempo de ejecución de Codot
- Stitch MCP: Proporcionado de forma centralizada a través de Codot Settings → MCP (busca herramientas con el prefijo
stitch:omcp__stitch__). No reconfigures los archivos MCP por agente.- Verificación visual y del navegador: Prefiere las herramientas
browser_*integradas de Codot (browser_navigate,browser_snapshot,browser_screenshot,browser_console) en lugar de un MCP de Chrome DevTools externo al inspeccionar servidores de desarrollo locales o páginas renderizadas.- Entrega visual:
show_previewestá fuera de línea y no puede acceder a la red; el HTML exportado por Stitch depende de CDN de Tailwind/fuentes y se renderiza en blanco si se pasa directamente. Usa la habilidadstitch-preview(servidor estático local +browser_*para alta fidelidad/interacción, ostitch-offline.mjs+show_previewpara vista previa HTML en el chat, oshow_previewdirectamente en capturas de pantalla.png).- Descarga de activos: Utiliza siempre Stitch MCP
download_file(conhtmlCode.name/screenshot.name), nuncacurlcontradownloadUrl(que requiere credenciales y devuelve un envoltorio JSON). Si la salida dedownload_filese trunca a un archivo temporal, decodifícala constitch-preview/scripts/save-stitch-file.mjs.- Parámetros de objeto: Si una herramienta MCP falla con
expected object, got string(algunos runtimes de agentes serializan argumentos de objeto como cadenas), cambia al flujo de trabajo alternativo solo de cadenas enstitch-manage-design-systemen lugar de reintentar la misma llamada fallida.- Llamadas de larga duración: Si
generate_screen_from_textoedit_screensse agotan, consultalist_screenscada 60 segundos hasta ~5 minutos (5 consultas); si no aparece ninguna pantalla nueva, reemite la llamada una vez en lugar de esperar indefinidamente.- Mapeo de herramientas: Asigna nombres de herramientas genéricas (
Read,Write,Edit,Bash) a las herramientas del harness activo de Codot (read,write,edit,bash).
Videos Guía de Stitch a Remotion
Eres un especialista en producción de video centrado en crear videos guía atractivos a partir de diseños de aplicaciones. Combina las capacidades de recuperación de pantallas de Stitch con la generación programática de video de Remotion para producir presentaciones profesionales y fluidas.
Descripción general
Esta habilidad te permite crear videos guía que muestran las pantallas de la aplicación con transiciones profesionales, efectos de zoom y superposiciones de texto contextual. El flujo de trabajo recupera pantallas de proyectos de Stitch y las orquesta en una composición de video de Remotion.
Requisitos previos
Requeridos:
- Acceso al Servidor MCP de Stitch
- Acceso al Servidor MCP de Remotion (o CLI de Remotion)
- Node.js y npm instalados
- Un proyecto de Stitch con pantallas diseñadas
Recomendados:
- Familiaridad con las capacidades de video de Remotion
- Comprensión de componentes de React (Remotion usa React)
Recuperación y redes
Paso 1: Descubrir servidores MCP disponibles
Ejecuta list_tools para identificar los servidores MCP disponibles y sus prefijos:
- Stitch MCP: Busca el prefijo
stitch:omcp_stitch: - Remotion MCP: Busca el prefijo
remotion:omcp_remotion:
Paso 2: Recuperar información del proyecto de Stitch
-
Búsqueda de proyecto (si no se proporciona el ID del proyecto):
- Llama a
[stitch_prefix]:list_projectsconfilter: "view=owned" - Identifica el proyecto objetivo por título (ej., "Calculator App")
- Extrae el ID del proyecto del campo
name(ej.,projects/13534454087919359824)
- Llama a
-
Recuperación de pantallas:
- Llama a
[stitch_prefix]:list_screenscon el ID del proyecto (solo numérico) - Revisa los títulos de las pantallas para identificar todas las pantallas para el video guía
- Extrae los IDs de pantalla del campo
namede cada pantalla
- Llama a
-
Obtención de metadatos de pantalla: Para cada pantalla:
- Llama a
[stitch_prefix]:get_screencon elnamedel recurso de la pantalla (projects/{project}/screens/{screen}) - Recupera:
screenshot.name(projects/{project}/files/{file}) — Activo visual para el videohtmlCode.name(projects/{project}/files/{file}) — Opcional: para extraer texto/contenidowidth,height— Dimensiones de la pantalla para escalado adecuado- Título y descripción de la pantalla para superposiciones de texto
- Llama a
-
Descarga de activos:
- Llama a Stitch MCP
[stitch_prefix]:download_fileconscreenshot.name(no usescurloweb_fetchendownloadUrl, que requiere credenciales y devuelve un envoltorio JSON) - Si la salida de
download_filese trunca a un archivo temporal, decodifícala con:node skills/stitch/stitch-preview/scripts/save-stitch-file.mjs <tool-output> assets/screens/{screen-name}.png - Organiza los activos en el orden del flujo de video guía previsto
- Llama a Stitch MCP
Paso 3: Configurar el proyecto de Remotion
-
Verificar proyecto de Remotion existente:
- Busca
remotion.config.tsopackage.jsoncon dependencias de Remotion - Si existe, usa la estructura del proyecto existente
- Busca
-
Crear nuevo proyecto de Remotion (si es necesario):
npm create video@latest -- --blank- Elige la plantilla TypeScript
- Configura en un directorio dedicado
video/
-
Instalar dependencias:
cd video npm install @remotion/transitions @remotion/animated-emoji
Estrategia de composición de video
Arquitectura
Crea una composición modular de Remotion con estos componentes:
-
ScreenSlide.tsx— Componente de visualización de pantalla individual- Props:
imageSrc,title,description,width,height - Características: Animación de zoom, transiciones de fundido
- Duración: Configurable (por defecto 3-5 segundos por pantalla)
- Props:
-
WalkthroughComposition.tsx— Composición de video principal- Secuencia múltiples componentes
ScreenSlide - Maneja transiciones entre pantallas
- Añade superposiciones de texto y anotaciones
- Secuencia múltiples componentes
-
config.ts— Configuración de video- Fotogramas por segundo (por defecto: 30 fps)
- Dimensiones de video (coincidir con dimensiones de pantalla de Stitch o escalar adecuadamente)
- Cálculo de duración total
Efectos de transición
Usa @remotion/transitions de Remotion para efectos profesionales:
-
Fundido: Fundido cruzado suave entre pantallas
import {fade} from '@remotion/transitions/fade'; -
Deslizamiento: Transiciones de deslizamiento direccional
import {slide} from '@remotion/transitions/slide'; -
Zoom: Efectos de zoom para énfasis
- Usa la animación
spring()para un zoom suave - Aplica a elementos importantes de la interfaz de usuario
- Usa la animación
Superposiciones de texto
Añade información contextual utilizando el renderizado de texto de Remotion:
- Títulos de pantalla: Muestra en la parte superior o inferior de cada fotograma
- Anotaciones de características: Resalta elementos específicos de la interfaz de usuario con punteros animados
- Descripciones: Funde texto descriptivo para cada pantalla
- Indicador de progreso: Muestra la posición actual de la pantalla en el video guía
Pasos de ejecución
Paso 1: Recopilar activos de pantalla
- Identifica el proyecto de Stitch objetivo
- Lista todas las pantallas en el proyecto
- Descarga capturas de pantalla para cada pantalla
- Organiza en orden del flujo del video guía
- Crea un archivo de manifiesto (
screens.json):
{
"projectName": "Calculator App",
"screens": [
{
"id": "1",
"title": "Home Screen",
"description": "Interfaz principal de la calculadora con teclado numérico",
"imagePath": "assets/screens/home.png",
"width": 1200,
"height": 800,
"duration": 4
},
{
"id": "2",
"title": "Vista de historial",
"description": "Vista de cálculos anteriores",
"imagePath": "assets/screens/history.png",
"width": 1200,
"height": 800,
"duration": 3
}
]
}
Paso 2: Generar componentes de Remotion
Crea los componentes de video siguiendo las mejores prácticas de Remotion:
-
Crear
ScreenSlide.tsx:- Usa
useCurrentFrame()yspring()para animaciones - Implementa efectos de zoom y fundido
- Añade superposiciones de texto con temporización adecuada
- Usa
-
Crear
WalkthroughComposition.tsx:- Importa el manifiesto de pantallas
- Secuencia pantallas con componentes
<Sequence> - Aplica transiciones entre pantallas
- Calcula la temporización y los desplazamientos adecuados
-
Actualizar
remotion.config.ts:- Establece el ID de composición
- Configura las dimensiones del video
- Establece los fps y la duración
Recursos de referencia:
- Usa
resources/screen-slide-template.tsxcomo punto de partida - Sigue
resources/composition-checklist.mdpara completitud - Revisa ejemplos en el directorio
examples/
Paso 3: Vista previa y refinamiento
-
Iniciar Remotion Studio:
npm run dev- Abre una vista previa basada en navegador
- Permite edición y refinamiento en tiempo real
-
Ajustar temporización:
- Asegúrate de que cada pantalla tenga una duración de visualización adecuada
- Verifica que las transiciones sean suaves
- Revisa la temporización de las superposiciones de texto
-
Afinar animaciones:
- Ajusta las configuraciones de spring para efectos de zoom
- Modifica las funciones de easing para transiciones
- Asegúrate de que el texto sea legible en todo momento
Paso 4: Renderizar video
-
Renderizar usando la CLI de Remotion:
npx remotion render WalkthroughComposition output.mp4 -
Alternativa: Usar Remotion MCP (si está disponible):
- Llama a
[remotion_prefix]:rendercon los detalles de la composición - Especifica el formato de salida (MP4, WebM, etc.)
- Llama a
-
Opciones de optimización:
- Establece el nivel de calidad (
--quality) - Configura el códec (
--codec h264oh265) - Habilita el renderizado paralelo (
--concurrency)
- Establece el nivel de calidad (
Funciones avanzadas
Zonas interactivas
Resalta elementos en los que se puede hacer clic o características importantes:
import {interpolate, useCurrentFrame} from 'remotion';
const Hotspot = ({x, y, label}) => {
const frame = useCurrentFrame();
const scale = spring({
frame,
fps: 30,
config: {damping: 10, stiffness: 100}
});
return (
<div style={{
position: 'absolute',
left: x,
top: y,
transform: `scale(${scale})`
}}>
<div className="pulse-ring" />
<span>{label}</span>
</div>
);
};
Integración de narración
Añade narración al video guía:
- Genera un guión de narración a partir de las descripciones de las pantallas
- Usa texto a voz o graba audio
- Importa el audio en Remotion con el componente
<Audio> - Sincroniza la temporización de las pantallas con el ritmo de la narración
Extracción dinámica de texto
Extrae texto del código HTML de Stitch para anotaciones automáticas:
- Llama a
[stitch_prefix]:download_fileconhtmlCode.namepara cada pantalla (decodifica la salida truncada consave-stitch-file.mjs) - Analiza el HTML para extraer elementos de texto clave (encabezados, botones, etiquetas)
- Genera anotaciones automáticas para elementos importantes de la interfaz de usuario
- Añade a la composición como superposiciones de texto temporizadas
Estructura de archivos
project/
├── video/ # Directorio del proyecto Remotion
│ ├── src/
│ │ ├── WalkthroughComposition.tsx
│ │ ├── ScreenSlide.tsx
│ │ ├── components/
│ │ │ ├── Hotspot.tsx
│ │ │ └── TextOverlay.tsx
│ │ └── Root.tsx
│ ├── public/
│ │ └── assets/
│ │ └── screens/ # Capturas de pantalla descargadas de Stitch
│ │ ├── home.png
│ │ └── history.png
│ ├── remotion.config.ts
│ └── package.json
├── screens.json # Manifiesto de pantallas
└── output.mp4 # Video renderizado
Integración con habilidades de Remotion
Remotion mantiene sus propias habilidades de agente que definen las mejores prácticas. Revísalas para técnicas avanzadas:
- Repositorio: https://github.com/remotion-dev/remotion/tree/main/packages/skills
- Instalación:
npx skills add remotion-dev/skills
Habilidades clave de Remotion a aprovechar:
- Temporización de animaciones y easing
- Patrones de arquitectura de composición
- Optimización del rendimiento
- Sincronización de audio
Patrones comunes
Patrón 1: Presentación de diapositivas simple
Video guía básico con transiciones de fundido:
- 3-5 segundos por pantalla
- Transiciones de fundido cruzado
- Superposición de texto inferior con título de pantalla
- Barra de progreso en la parte superior
Patrón 2: Destacar características
Enfócate en elementos específicos de la interfaz de usuario:
- Zoom en regiones específicas
- Círculos/flechas animados que apuntan a funciones
- Énfasis en cámara lenta en interacciones clave
- Comparaciones lado a lado de antes/después
Patrón 3: Flujo de usuario
Muestra el recorrido del usuario paso a paso:
- Flujo de pantallas secuencial con deslizamientos direccionales
- Superposición de pasos numerados
- Resalta acciones del usuario (clics, toques)
- Conecta pantallas con rutas animadas
Solución de problemas
| Problema | Solución |
|---|---|
| Capturas borrosas | Asegúrate de que las imágenes descargadas estén a máxima resolución mediante download_file (screenshot.name) en lugar de miniaturas comprimidas |
| Texto desalineado | Verifica que las dimensiones de la pantalla coincidan con el tamaño de la composición; ajusta el posicionamiento del texto según el tamaño real de la pantalla |
| Animaciones entrecortadas | Aumenta los fps a 60; usa configuraciones de spring adecuadas con amortiguación (damping) apropiada |
| Error de compilación de Remotion | Revisa la compatibilidad de la versión de Node; asegúrate de que todas las dependencias estén instaladas; revisa la documentación de Remotion |
| La temporización no se siente bien | Ajusta la duración por pantalla en el manifiesto; previsualiza en Remotion Studio; prueba con usuarios reales |
Mejores prácticas
- Mantener la relación de aspecto: Usa las dimensiones reales de la pantalla de Stitch o escala proporcionalmente
- Temporización consistente: Mantén la duración de visualización de la pantalla consistente a menos que se enfatice una pantalla específica
- Texto legible: Asegura suficiente contraste; usa tamaños de fuente apropiados; evita superposiciones desordenadas
- Transiciones suaves: Usa animaciones spring para un movimiento natural; evita cortes bruscos
- Previsualizar a fondo: Siempre previsualiza en Remotion Studio antes del renderizado final
- Optimizar activos: Comprime imágenes adecuadamente; usa formatos eficientes (PNG para UI, JPG para fotos)
Ejemplo de uso
Solicitud del usuario:
Busca las pantallas en mi proyecto de Stitch "Calculator App" y crea un video de Remotion
que muestre un recorrido por las pantallas.
Flujo de trabajo del agente:
- Lista proyectos de Stitch → Encuentra "Calculator App" → Extrae el ID del proyecto
- Lista pantallas en el proyecto → Identifica todas las pantallas (Inicio, Historial, Configuración)
- Descarga capturas de pantalla para cada pantalla → Guarda en
assets/screens/ - Crea el manifiesto
screens.jsoncon metadatos de las pantallas - Genera componentes de Remotion (
ScreenSlide.tsx,WalkthroughComposition.tsx) - Previsualiza en Remotion Studio → Refina temporización y transiciones
- Renderiza el video final →
calculator-walkthrough.mp4 - Informa la finalización con un enlace de vista previa del video
Consejos para el éxito
- Empieza simple: Comienza con una presentación básica y añade complejidad gradualmente
- Prueba con frecuencia: Previsualiza después de cada cambio significativo
- Usa animaciones sutiles: Las animaciones excesivas pueden distraer; úsalas con moderación para enfatizar
- Prueba en diferentes dispositivos: Verifica la legibilidad en tamaños de pantalla pequeños
- Mantén una historia coherente: Cada pantalla debe contribuir a la narrativa general
- Solicita comentarios: Obtén opiniones antes de la producción final