Motion Agent — Melhores Práticas

O que Motion Agent — Melhores Práticas faz?

Use este documento como a camada de roteamento para trabalhos com o Motion Agent. O contrato de execução profunda do AE ainda está no arquivo skill/SKILL.md do repositório; leia-o antes de tocar no After Effects.

Princípio Central

Não trate o Motion Agent como "gerar um JSX e esperar que funcione". Trate-o como um fluxo de trabalho de produção:

1. Entenda o briefing, a referência, o produto e o contexto de entrega.
2. Escolha o skill de fluxo de trabalho correto.
3. Construa estruturas editáveis no AE, não camadas descartáveis.
4. Verifique com quadros capturados, valores amostrados e evidências concretas.
5. Promova padrões reutilizáveis para um caso ou skill.

Roteamento de Skills

O usuário pede por	Carregue
Um novo vídeo, cena, animação ou composição	motion-create
Vídeo de lançamento, filme de campanha, anúncio de produto, promoção social	motion-promo-video
Animação de UI, demonstração de produto, fluxo de dashboard, movimento de cartão/slider/tela	motion-ui-demo
Controles reutilizáveis do AE, expressões, rigs, presets, movimento componentizado	motion-ae-rig
Revisão, polimento, comparação, depuração, validação, fazer corresponder à referência	motion-qa
Renderizar, exportar, capturar pré-visualização, empacotar entrega	motion-render
Encontrar docs do repositório, exemplos, receitas de casos, fundamentos do AE	motion-docs

Se uma tarefa abranger várias áreas, carregue o menor conjunto útil. Por exemplo, uma demonstração de lançamento de produto geralmente precisa de motion-promo-video, motion-ui-demo, motion-ae-rig e motion-qa.

Antes de Editar o AE

Leia o arquivo skill/SKILL.md original do repositório e execute sua lista de verificação de pré-voo. Em particular:

• Use ae_scripts/tools/run_jsx.sh para JSX.
• Respeite os limites do ExtendScript ES3 do AE.
• Consulte os matchNames dos efeitos em vez de adivinhar os nomes de exibição.
• Mantenha uma alteração lógica por lote de script.
• Preserve as alterações do usuário e os valores de controle existentes.

Contrato de Produção

Cada resultado do Motion Agent deve deixar:

• uma estrutura de projeto editável do AE
• controles nomeados para ajustes repetidos
• evidências de pré-visualização
• uma breve nota explicando o que foi alterado e o que foi verificado
• scripts reutilizáveis ou notas de caso se o padrão provavelmente se repetir

Regras de Saída Editável

• Nomeie camadas, pré-composições, controles, marcadores e arquivos de saída para humanos.
• Coloque os controles voltados ao usuário em uma camada AI_Controls clara ou em uma camada de controle específica da tarefa.
• Mantenha as expressões legíveis e localizadas; prefira edições cirúrgicas a reescritas completas.
• Evite magia oculta: se o tempo ou layout for gerado, exponha os parâmetros importantes.
• Não transforme tudo em keyframes fixos, a menos que o usuário explicitamente queira saída final apenas.

Regras de Verificação

Antes de dizer "pronto", reúna evidências:

• capture quadros representativos
• inspecione camadas alteradas, expressões ou valores de controle
• amostre tempo/easing quando a qualidade do movimento for importante
• verifique limites de texto, legibilidade do logotipo e áreas seguras da composição
• registre qualquer suposição não verificada

Promoção de Padrões

Quando um fluxo de trabalho se repetir, não o deixe enterrado em um chat:

1. Adicione ou atualize um caso em cases/<categoria>/<caso>/.
2. Salve um RECIPE.md, JSX reutilizável e evidências antes/depois.
3. Se a regra for amplamente útil, promova a versão resumida para skill/SKILL.md ou um destes skills do agente.
4. Sincronize e faça commit de acordo com o fluxo de trabalho do repositório.