Adaptação para o Runtime Codot
- MCP do Stitch: Fornecido centralmente via Configurações Codot → MCP (procure por ferramentas prefixadas com
stitch:oumcp__stitch__). Não reconfigurar arquivos MCP por agente.- Verificação Visual e Navegador: Prefira as ferramentas
browser_*nativas do Codot (browser_navigate,browser_snapshot,browser_screenshot,browser_console) em vez do MCP externo do Chrome DevTools ao inspecionar servidores de desenvolvimento local ou páginas renderizadas.- Entrega Visual:
show_previewestá offline e não pode acessar a rede; HTML exportado do Stitch depende de CDN Tailwind/fontes e renderiza em branco se passado diretamente. Use a habilidadestitch-preview(servidor estático local +browser_*para alta fidelidade/interação, oustitch-offline.mjs+show_previewpara pré-visualização HTML no chat, oushow_previewdiretamente em capturas de tela.png).- Download de Ativos: Sempre use o MCP do Stitch
download_file(comhtmlCode.name/screenshot.name), nunca usecurlcontradownloadUrl(que requer credenciais e retorna um wrapper JSON). Se a saída dedownload_filefor truncada para um arquivo temporário, decodifique-a comstitch-preview/scripts/save-stitch-file.mjs.- Parâmetros de Objeto: Se uma ferramenta MCP falhar com
expected object, got string(alguns runtimes de agente serializam argumentos de objeto como strings), mude para o fluxo de trabalho alternativo apenas com strings emstitch-manage-design-systemem vez de repetir a mesma chamada falha.- Chamadas de Longa Duração: Se
generate_screen_from_textouedit_screensexceder o tempo limite, consultelist_screensa cada 60 segundos por até ~5 minutos (5 consultas); se nenhuma nova tela aparecer, reenvie a chamada uma vez em vez de esperar indefinidamente.- Mapeamento de Ferramentas: Mapeie nomes genéricos de ferramentas (
Read,Write,Edit,Bash) para as ferramentas ativas do Codot (read,write,edit,bash).
Stitch para Vídeos de Demonstração no Remotion
Você é um especialista em produção de vídeos focado em criar vídeos de demonstração envolventes a partir de designs de aplicativos. Você combina as capacidades de captura de tela do Stitch com a geração programática de vídeos do Remotion para produzir apresentações suaves e profissionais.
Visão Geral
Esta habilidade permite criar vídeos de demonstração que mostram telas de aplicativos com transições profissionais, efeitos de zoom e sobreposições de texto contextuais. O fluxo de trabalho recupera telas de projetos Stitch e as orquestra em uma composição de vídeo Remotion.
Pré-requisitos
Obrigatório:
- Acesso ao Servidor MCP do Stitch
- Acesso ao Servidor MCP do Remotion (ou CLI do Remotion)
- Node.js e npm instalados
- Um projeto Stitch com telas projetadas
Recomendado:
- Familiaridade com as capacidades de vídeo do Remotion
- Compreensão de componentes React (Remotion usa React)
Recuperação e Rede
Passo 1: Descobrir Servidores MCP Disponíveis
Execute list_tools para identificar servidores MCP disponíveis e seus prefixos:
- MCP do Stitch: Procure pelo prefixo
stitch:oumcp_stitch: - MCP do Remotion: Procure pelo prefixo
remotion:oumcp_remotion:
Passo 2: Recuperar Informações do Projeto Stitch
-
Pesquisa de projeto (se o ID do Projeto não for fornecido):
- Chame
[stitch_prefix]:list_projectscomfilter: "view=owned" - Identifique o projeto alvo pelo título (ex.: "Calculator App")
- Extraia o ID do Projeto do campo
name(ex.:projects/13534454087919359824)
- Chame
-
Recuperação de telas:
- Chame
[stitch_prefix]:list_screenscom o ID do projeto (apenas numérico) - Revise os títulos das telas para identificar todas para a demonstração
- Extraia os IDs das telas do campo
namede cada tela
- Chame
-
Busca de metadados das telas: Para cada tela:
- Chame
[stitch_prefix]:get_screencom onamedo recurso da tela (projects/{project}/screens/{screen}) - Recupere:
screenshot.name(projects/{project}/files/{file}) — Ativo visual para o vídeohtmlCode.name(projects/{project}/files/{file}) — Opcional: para extrair texto/conteúdowidth,height— Dimensões da tela para dimensionamento adequado- Título e descrição da tela para sobreposições de texto
- Chame
-
Download de ativos:
- Chame o MCP do Stitch
[stitch_prefix]:download_filecomscreenshot.name(não usecurlouweb_fetchemdownloadUrl, que requer credenciais e retorna um wrapper JSON) - Se a saída de
download_filefor truncada para um arquivo temporário, decodifique-a com:node skills/stitch/stitch-preview/scripts/save-stitch-file.mjs <tool-output> assets/screens/{screen-name}.png - Organize os ativos na ordem do fluxo de demonstração pretendido
- Chame o MCP do Stitch
Passo 3: Configurar Projeto Remotion
-
Verificar projeto Remotion existente:
- Procure por
remotion.config.tsoupackage.jsoncom dependências do Remotion - Se existir, use a estrutura de projeto existente
- Procure por
-
Criar novo projeto Remotion (se necessário):
npm create video@latest -- --blank- Escolha o template TypeScript
- Configure em um diretório dedicado
video/
-
Instalar dependências:
cd video npm install @remotion/transitions @remotion/animated-emoji
Estratégia de Composição de Vídeo
Arquitetura
Crie uma composição Remotion modular com estes componentes:
-
ScreenSlide.tsx— Componente de exibição de tela individual- Props:
imageSrc,title,description,width,height - Recursos: Animação de zoom, transições de fade
- Duração: Configurável (padrão 3-5 segundos por tela)
- Props:
-
WalkthroughComposition.tsx— Composição de vídeo principal- Sequencia múltiplos componentes
ScreenSlide - Gerencia transições entre telas
- Adiciona sobreposições de texto e anotações
- Sequencia múltiplos componentes
-
config.ts— Configuração do vídeo- Taxa de quadros (padrão: 30 fps)
- Dimensões do vídeo (corresponder às dimensões da tela do Stitch ou dimensionar adequadamente)
- Cálculo da duração total
Efeitos de Transição
Use @remotion/transitions para efeitos profissionais:
-
Fade: Transição suave de cross-fade entre telas
import {fade} from '@remotion/transitions/fade'; -
Slide: Transições de deslizamento direcionais
import {slide} from '@remotion/transitions/slide'; -
Zoom: Efeitos de zoom para dar ênfase
- Use animação
spring()para zoom suave - Aplique a elementos importantes da interface do usuário
- Use animação
Sobreposições de Texto
Adicione informações contextuais usando a renderização de texto do Remotion:
- Títulos das telas: Exibir na parte superior ou inferior de cada quadro
- Destaques de recursos: Destacar elementos específicos da interface com ponteiros animados
- Descrições: Texto descritivo que aparece gradualmente para cada tela
- Indicador de progresso: Mostrar posição atual da tela na demonstração
Passos de Execução
Passo 1: Coletar Ativos das Telas
- Identificar projeto Stitch alvo
- Listar todas as telas no projeto
- Baixar capturas de tela para cada tela
- Organizar na ordem do fluxo de demonstração
- Criar arquivo de manifesto (
screens.json):
{
"projectName": "Calculator App",
"screens": [
{
"id": "1",
"title": "Tela Inicial",
"description": "Interface principal da calculadora com teclado numérico",
"imagePath": "assets/screens/home.png",
"width": 1200,
"height": 800,
"duration": 4
},
{
"id": "2",
"title": "Visualização de Histórico",
"description": "Visualização de cálculos anteriores",
"imagePath": "assets/screens/history.png",
"width": 1200,
"height": 800,
"duration": 3
}
]
}
Passo 2: Gerar Componentes Remotion
Crie os componentes de vídeo seguindo as melhores práticas do Remotion:
-
Criar
ScreenSlide.tsx:- Use
useCurrentFrame()espring()para animações - Implemente efeitos de zoom e fade
- Adicione sobreposições de texto com temporização adequada
- Use
-
Criar
WalkthroughComposition.tsx:- Importe o manifesto de telas
- Sequencie telas com componentes
<Sequence> - Aplique transições entre telas
- Calcule temporização e deslocamentos adequados
-
Atualizar
remotion.config.ts:- Defina o ID da composição
- Configure as dimensões do vídeo
- Defina taxa de quadros e duração
Recursos de Referência:
- Use
resources/screen-slide-template.tsxcomo ponto de partida - Siga
resources/composition-checklist.mdpara completude - Revise exemplos no diretório
examples/
Passo 3: Visualizar e Refinar
-
Iniciar o Remotion Studio:
npm run dev- Abre pré-visualização baseada em navegador
- Permite edição e refinamento em tempo real
-
Ajustar temporização:
- Garanta que cada tela tenha duração de exibição adequada
- Verifique se as transições são suaves
- Verifique a temporização das sobreposições de texto
-
Ajustar animações:
- Configure springs para efeitos de zoom
- Modifique funções de easing para transições
- Garanta que o texto seja legível o tempo todo
Passo 4: Renderizar Vídeo
-
Renderizar usando a CLI do Remotion:
npx remotion render WalkthroughComposition output.mp4 -
Alternativa: Usar o MCP do Remotion (se disponível):
- Chame
[remotion_prefix]:rendercom detalhes da composição - Especifique o formato de saída (MP4, WebM, etc.)
- Chame
-
Opções de otimização:
- Defina nível de qualidade (
--quality) - Configure codec (
--codec h264ouh265) - Ative renderização paralela (
--concurrency)
- Defina nível de qualidade (
Recursos Avançados
Pontos de Interatividade (Hotspots)
Destaque elementos clicáveis ou recursos 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>
);
};
Integração de Narração
Adicione narração à demonstração:
- Gere roteiro de narração a partir das descrições das telas
- Use texto-para-fala ou grave áudio
- Importe áudio no Remotion com o componente
<Audio> - Sincronize a temporização das telas com o ritmo da narração
Extração Dinâmica de Texto
Extraia texto do código HTML do Stitch para anotações automáticas:
- Chame
[stitch_prefix]:download_filecomhtmlCode.namepara cada tela (decodifique a saída truncada comsave-stitch-file.mjs) - Analise o HTML para extrair elementos de texto chave (cabeçalhos, botões, rótulos)
- Gere destaques automáticos para elementos importantes da interface
- Adicione à composição como sobreposições de texto temporizadas
Estrutura de Arquivos
project/
├── video/ # Diretório do projeto Remotion
│ ├── src/
│ │ ├── WalkthroughComposition.tsx
│ │ ├── ScreenSlide.tsx
│ │ ├── components/
│ │ │ ├── Hotspot.tsx
│ │ │ └── TextOverlay.tsx
│ │ └── Root.tsx
│ ├── public/
│ │ └── assets/
│ │ └── screens/ # Capturas de tela do Stitch baixadas
│ │ ├── home.png
│ │ └── history.png
│ ├── remotion.config.ts
│ └── package.json
├── screens.json # Manifesto das telas
└── output.mp4 # Vídeo renderizado
Integração com Habilidades do Remotion
O Remotion mantém suas próprias Skills de Agente que definem melhores práticas. Revise-as para técnicas avançadas:
- Repositório: https://github.com/remotion-dev/remotion/tree/main/packages/skills
- Instalação:
npx skills add remotion-dev/skills
Habilidades chave do Remotion a serem aproveitadas:
- Temporização e easing de animações
- Padrões de arquitetura de composição
- Otimização de desempenho
- Sincronização de áudio
Padrões Comuns
Padrão 1: Apresentação de Slides Simples
Demonstração básica com transições de fade:
- 3-5 segundos por tela
- Transições de cross-fade
- Sobreposição de texto inferior com título da tela
- Barra de progresso no topo
Padrão 2: Destaque de Recurso
Foco em elementos específicos da interface:
- Zoom em regiões específicas
- Círculos/setas animadas apontando para recursos
- Ênfase em câmera lenta em interações principais
- Comparações lado a lado antes/depois
Padrão 3: Fluxo do Usuário
Mostre a jornada do usuário passo a passo:
- Fluxo de tela sequencial com slides direcionais
- Sobreposição de etapas numeradas
- Destaque de ações do usuário (cliques, toques)
- Conecte telas com caminhos animados
Solução de Problemas
| Problema | Solução |
|---|---|
| Capturas de tela borradas | Garanta que as imagens baixadas estejam em resolução total via download_file (screenshot.name) em vez de miniaturas comprimidas |
| Texto desalinhado | Verifique se as dimensões da tela correspondem ao tamanho da composição; ajuste o posicionamento do texto com base no tamanho real da tela |
| Animações inconsistentes | Aumente a taxa de quadros para 60fps; use configurações de spring adequadas com damping apropriado |
| Falha na construção do Remotion | Verifique a compatibilidade da versão do Node; garanta que todas as dependências estejam instaladas; revise a documentação do Remotion |
| Temporização inadequada | Ajuste a duração por tela no manifesto; visualize no Remotion Studio; teste com usuários reais |
Melhores Práticas
- Mantenha a proporção: Use as dimensões reais da tela do Stitch ou dimensione proporcionalmente
- Temporização consistente: Mantenha a duração de exibição das telas consistente, a menos que enfatize telas específicas
- Texto legível: Garanta contraste suficiente; use tamanhos de fonte adequados; evite sobreposições poluídas
- Transições suaves: Use animações spring para movimento natural; evite cortes bruscos
- Visualize completamente: Sempre visualize no Remotion Studio antes da renderização final
- Otimize ativos: Comprima imagens adequadamente; use formatos eficientes (PNG para interface, JPG para fotos)
Exemplo de Uso
Prompt do usuário:
Consulte as telas no meu projeto Stitch "Calculator App" e construa um vídeo remotion
que mostre uma demonstração das telas.
Fluxo de trabalho do agente:
- Liste projetos Stitch → Encontre "Calculator App" → Extraia ID do projeto
- Liste telas no projeto → Identifique todas as telas (Início, Histórico, Configurações)
- Baixe capturas de tela para cada tela → Salve em
assets/screens/ - Crie manifesto
screens.jsoncom metadados das telas - Gere componentes Remotion (
ScreenSlide.tsx,WalkthroughComposition.tsx) - Visualize no Remotion Studio → Refine temporização e transições
- Renderize vídeo final →
calculator-walkthrough.mp4 - Reporte conclusão com link de pré-visualização do vídeo
Dicas para o Sucesso
- Comece simples: Comece com...