Criar Gráficos em Movimento
Host do plugin e projeto
Use o servidor MCP chatcut e o ID do projeto a partir da URL do editor do usuário ou do resultado do projeto do plugin. Este plugin funciona com o editor Web, incluindo URLs de desenvolvimento local. Não abra o ChatCut Desktop nem use chatcut_desktop para um projeto Web. Se as ferramentas chatcut não estiverem disponíveis, reporte a falha de conexão; não envie a tarefa para o Agente nativo do editor como substituto.
Encontre referências de MG antes de projetar
Navegue e confirme uma direção visual
Para produção, reutilize um estilo de projeto aceito ou marca/referência fornecida pelo usuário. Use manage_design_style get quando sua especificação completa não for conhecida. Edições rotineiras de texto/posicionamento não precisam de nova seleção de estilo ou reescaneamento do catálogo.
Quando uma nova direção for necessária ou o usuário pedir para navegar por alternativas, comece com browse_library references: {view: "style-overview"}. Leia TODAS as folhas de contato numeradas, seguindo nextOffset até complete. Elas contêm representantes de estilo habilitados para agente e publicados, incluindo Design Styles vinculados existentes. list_presets é apenas o subconjunto do catálogo legado; não pode substituir esta visão geral visual. Tente novamente uma página com falha; reporte uma visão geral incompleta em vez de pulá-la silenciosamente.
Para vídeo guiado por fala, entenda o conteúdo falado e inspecione quadros de vídeo representativos antes de selecionar estilos. Reutilize evidências de transcrição e quadro já no contexto. Considere o tópico, tom de entrega, idioma na tela e a cor, enquadramento do assunto e fundo da filmagem junto com as prévias de estilo.
Quando a direção visual ainda não estiver acordada, selecione até 6 opções distintas adequadas para o conteúdo e filmagem atuais, e leia suas partes hero. Carregue a skill widget-forms do host e mostre imagens reais heroPreview.url com nomes curtos. Imagens retornadas pela ferramenta são evidências para o agente, não um seletor voltado para o usuário; escolhas apenas textuais não mostram as diferenças visuais. Mantenha cada escolha mapeada para seu ID de referência; use o ramo "Outro" do formulário para preferências ou outro lote sem repetir escolhas ou adicionar uma opção separada "Mostrar mais". Aguarde a seleção antes de aplicar um novo estilo e produzir o MG, a menos que o usuário já tenha escolhido uma direção ou delegado explicitamente a escolha do estilo. Uma resposta "Outro" não é aceitação.
Aplique o estilo selecionado
Leia o summary, hero e members do representante selecionado. Siga seu designStyleAction com manage_design_style:
apply_preset: use opresetIdretornado diretamente; não clone ou atualize o preset meramente para salvar metadados de referência.apply: reutilize odesignStyleIdretornado para um estilo de usuário salvo existente.create: apenas uma referência independente precisa de um novo estilo de propriedade do usuário. Defina e salve sua paleta, fontes e regras visuais reutilizáveis a partir da referência selecionada. Reutilize a paleta documentada da referência; se ausente, derive uma paleta coerente de sua imagem representativa. SalvedesignSpec.referenceSources: [{id: "<ID da referência>"}]e oheroPreview.urlindividual em AMBOSthumbnailUrledesignSpec.images: [{role: "style reference", url: "<heroPreview.url>"}]. UseapplyToProject: true; preserve imagens existentes ao corrigir um array.
Após aplicar, chame get para a especificação completa atualizada e IDs de origem; não carregue regras em cache do estilo anterior. Para um novo estilo, verifique se sua paleta, fontes, origem, capa e imagem de referência foram salvos. Apenas um ID de origem não salva uma imagem. Imagens de referência são evidências visuais, não filmagens/fundos para incorporar ou texto de exemplo para reproduzir.
Use fontRecommendations["zh-Hans"] / .en de acordo com o texto real na tela, incluindo texto bilíngue e números latinos. Reutilize um plano de fontes aceito; um grupo de idioma vazio não está resolvido. Combine o caráter tipográfico e a hierarquia de título/corpo da referência, e verifique a cobertura de glifos e disponibilidade em tempo de execução. Salve famílias/papéis selecionados em designSpec.fonts, e idioma, peso, itálico e eixos necessários em styleGuide. Um exemplo de formulário entre estilos não pode substituir este plano. Apenas ao selecionar fontes ausentes ou adaptar tipografia explicitamente, leia Font matching; a correspondência chinesa começa a partir de uma imagem de efeito chinesa gerada, não de letras inglesas.
Corresponda instâncias às formas de MG necessárias
Use o conteúdo falado e os quadros alvo para decidir quais formas de MG são úteis; deixe as prévias de referência refinar essas escolhas. Mantenha a linguagem visual confirmada em todo o vídeo e encontre instâncias adequadas para cada forma necessária. Escolha as instâncias você mesmo, a menos que o usuário peça para compará-las. Formas diferentes podem usar instâncias diferentes; componentes recorrentes podem reutilizar uma já inspecionada. Siga nextReferenceSearch quando retornado:
- Com membros relacionados, navegue por
kind: "instance", styleId: "<UUID do representante>"ou leia IDs de membros relevantes. - Se uma forma necessária não tiver um membro adequado, pesquise TODA a biblioteca de instâncias por consulta de conteúdo/forma
queryoufacets.form, omitindostyleId,facets.stylee termos de nome de estilo, mesmo que outras formas já tenham correspondências do mesmo estilo. - Compare a colagem de capa, então leia IDs selecionados com
parts: ["summary", "hero"]. Adicionemotionpara animação ecodepara implementação. Se uma referência com código retornartemplateInspection, use sua chamada somente leitura para esquema/padrões de propriedade salvos; JSX pode ler props sem declarar seus valores.legacyTemplateRefssão IDs de modelo:manage_template getlê metadados, elist_assetslê propriedades de MG. Nenhum deles aplica ou copia um modelo.inspect_asseté para mídia/MGs do projeto atual, não IDs de origem do catálogo.
Adapte a composição, hierarquia, espaçamento e estrutura de revelação da instância às fontes fixas do projeto, paleta, materiais e tomada real. Se a busca mais ampla de formas também não tiver adequação, estenda o quadro de estilo e declare essa limitação. Realize leituras de detalhes relevantes em lote; encontrar uma instância não cobre formas não relacionadas. Siga pendingIds para respostas divididas; known pode incluir apenas versões retornadas e partes ainda em contexto. Cada folha de movimento é UM design em timestamps reais; uma montagem não é um layout, e uma imagem estática não estabelece animação.
Para uma nova sobreposição de cabeça falante/substancialmente redesenhada, leia Overlay composition. Importe apenas arquivos de produção de materials que aparecerão no resultado; use seus IDs de ativo do projeto. Revise o MG composto com a filmagem alvo.
Use as referências ao criar
Leia o code da instância selecionada ao emprestar sua implementação, ou leia propriedades de modelo vinculadas com manage_template list_assets. Use-a como referência no fluxo de trabalho de código abaixo, preservando o estilo do projeto.
Inspecione também imagens selecionadas: uma URL, ID ou resultado de busca por si só não é uma referência visualizada. Mantenha evidências de ESTILO para aparência e evidências de FORMA entre estilos para estrutura. Se uma referência selecionada falhar, tente novamente ou reporte a evidência faltante em vez de alegar que foi inspecionada.
Use esta skill quando uma tarefa do plugin ChatCut exigir um ativo de Motion Graphic criado ou corrigido como JSX inline. O Agente ChatCut embutido tem seu próprio fluxo de trabalho motion-graphic-gen; não mude para ele a partir desta tarefa de plugin.
Motion Graphics do plugin Codex são criados diretamente. Use create_motion_graphic_from_code para novos ativos JSX e edit_asset para JSX MG existentes. Esta superfície não fornece submit_motion_graphic; não traduza a solicitação em um prompt Gemini ou resumo de geração. Se as ferramentas de criação direta estiverem faltando, pare e reporte as ferramentas indisponíveis do plugin ChatCut.
Passe o código fonte do Motion Graphic inline através das ferramentas MCP chatcut. Não armazene código no repositório ChatCut, ai-working/, /tmp, um servidor HTTP local, arquivos de código gerados ou caminhos de aplicativo adivinhados quando a ferramenta aceita JSX inline diretamente.
Princípios Fundamentais
- Inspecione o estado do projeto quando o tamanho da tela, fps, linguagem visual existente, posicionamento ou conflitos de linha do tempo não forem conhecidos.
- Identifique as entradas necessárias em Antes de Codificar antes de criar o JSX.
- Crie ou atualize ativos de Motion Graphics através do fluxo de trabalho de ativos de código inline disponível; use esquemas atuais de ferramentas para formas exatas de payload.
- Posicione ou mova ativos através do fluxo de trabalho de edição de linha do tempo quando a edição exigir posicionamento na linha do tempo.
- Releia o estado do projeto e verifique o quadro visível após mudanças estruturais ou visuais.
Antes de Codificar
Antes de escrever JSX, identifique apenas as informações necessárias para esta edição:
- Posicionamento: hora de início, duração, camada alvo se conhecida, e o quadro alvo com o qual o gráfico deve compor.
- Papel na edição: qual trabalho este Motion Graphic performa no vídeo.
- Conteúdo: texto, números, mídia ou fatos visuais exatos que devem aparecer.
- Tempo: se o movimento interno deve sincronizar com fala, música ou um evento visual.
- Fonte visual: estilo fornecido pelo usuário, Design Style do projeto, cores/fontes da marca ou um Motion Graphic aceito existente.
- Campos editáveis: quais valores de texto, cores, números, booleanos, imagem ou vídeo devem se tornar propriedades.
Pergunte apenas por entradas faltantes e de alto impacto que alterariam materialmente o resultado.
Sistema visual e posicionamento
Use o Design Style completo confirmado e as referências inspecionadas acima. Para uma nova direção personalizada, estabeleça um resultado composto antes de fazer em lote; direções aceitas e correções rotineiras não precisam de renovação de estilo.
Escolha cada composição, posição, tamanho e tempo de leitura a partir da tomada real e do trecho de fala. Mantenha tipografia, paleta, materiais e movimento compartilhados, adaptando a forma da referência ao conteúdo. Uma âncora fixa esquerda/direita ou contêiner de cartão é apropriado apenas quando a composição o exige.
Reutilize um ativo com propriedades por item para um componente recorrente intencional com a mesma estrutura de informação. Novas estruturas precisam de sua própria referência de instância e composição. Os limites da sobreposição devem conter o gráfico de forma justa; use dimensões da linha do tempo apenas para um design que visivelmente abrange o quadro.
Corresponda a duração do ativo e batidas internas ao trecho de linha do tempo colocado. Se o tempo mudar materialmente, atualize o MG em vez de truncar animação inacabada. Revise quadros compostos estabelecidos lado a lado para um lote, corrigindo colisões, legibilidade e repetição não intencional antes de relatar conclusão.
Propriedades Editáveis
Exponha valores visíveis ao usuário e propensos a mudança como propriedades editáveis.
- Texto visível, cores primárias, cores de destaque e valores numéricos chave devem ser propriedades.
- Escolhas de fontes devem ser propriedades
fontquando os usuários podem razoavelmente alterá-las. - Fontes de imagem e vídeo devem ser propriedades
image/video. - As chaves de código devem corresponder exatamente às chaves do esquema de propriedade.
- Leia valores de
item.props; não codifique conteúdo visível que o usuário possa razoavelmente querer alterar depois. - Use sobrescritas de propriedade em nível de item apenas para componentes recorrentes intencionais com a mesma tarefa do visualizador, estrutura de informação e forma visual. Se qualquer um desses diferir, crie outro ativo MG e compartilhe lógica de paleta, tipo e movimento.
As entradas de propriedade devem declarar uma chave estável, rótulo visível ao usuário, tipo e valor padrão. Tipos de propriedade suportados incluem texto, número, cor, booleano, seleção, fonte, imagem e vídeo.
Fontes
Motion Graphics devem usar fontes disponíveis no renderizador do ChatCut para que a prévia e a exportação local permaneçam consistentes. Não confie em fontes de sistema específicas da máquina como STKaiti, PingFang SC, Microsoft YaHei, Arial, Helvetica, Comic Sans MS, system-ui, -apple-system ou famílias CSS genéricas como a fonte primária renderizada; a disponibilidade difere entre máquinas e pode causar fallback.
Ao escolher ou substituir uma fonte, chame search_fonts e use o nome de família canônico retornado textualmente como o valor fontFamily e o defaultValue da propriedade font correspondente. Use Google Fonts ou fontes personalizadas do projeto retornadas pelo catálogo. Se uma fonte específica da máquina solicitada não estiver no catálogo, explique que a renderização local consistente não pode ser garantida, pesquise por uma alternativa suportada com sensação semelhante e use-a a menos que o usuário aceite explicitamente o fallback de fonte.
Ativos e composição
Uma instância de referência pode descrever uma composição completa feita de vários itens de linha do tempo. Não implica um ativo MG autocontido. Mantenha capturas de tela de referência, materiais de produção e filmagem do projeto atual distintos.
Padrão para itens separados quando o design combina mídia comum com gráficos:
- Papel/textura/fundo reutilizável: um item de imagem ou vídeo atrás da composição.
- Foto atual do projeto, imagem de produto ou filmagem: seu próprio item de mídia. O agente seleciona/substitui, corta, posiciona e aplica efeitos suportados a ele; não se espera que o usuário monte as camadas manualmente.
- Tipografia, formas e decoração animada: item(ns) MG transparente(s). Separe a decoração de fundo do texto em primeiro plano quando a mídia deve ficar entre eles.
Planeje a ordem das camadas, retângulo de mídia alvo, início/duração e tempo de entrada antes de criar. Declare no escopo do código/brief do MG quais camadas já existem fora do MG, para que a foto ou papel da referência não seja gerado novamente. Aplique preto-e-branco/cor/granulado ao item de mídia pretendido em vez de afetar acidentalmente o texto em primeiro plano. Verifique o suporte a efeitos na superfície real de reprodução/exportação; dividir camadas não prova por si só paridade Web/Desktop.
- Reutilize ativos de
browse_assetsno projeto atual. Importe apenas arquivos de produção necessários na saída para Meus Ativos. Carregueasset-importe use seu helper de sessão/uploadimport_media. Registrar mídia do projeto não a publica na biblioteca de recursos pública. - Posicione mídia normal de produção através de
edit_item, usando os IDs de ativos do projeto atual retornados. O agente lida com a substituição de pessoas de exemplo, cópia, e dados com o conteúdo da tarefa atual. Não use a conclusão da referência.