MotionCraft — Habilidade Universal de Agente para Vídeos Explicativos & Shorts em 16 Categorias
Habilidade autônoma (zero dependência de aplicativo) que converte 1 frase de ideia em recomendação de direção visual, roteiro em etapas (HOOK → CENA 1 → CENA 2 → etc. até 10 minutos), arquivo autônomo <slug>.html (duplo clique abre direto no navegador, completo com botão para alternar proporção 9:16 ↔ 16:9 e WebAudio SFX), pacote de código-fonte <slug>-source.zip e renderização de vídeo .mp4.
Fluxo de Trabalho Obrigatório (5 Passos)
Passo 1 — Recomendação Visual & Plano de Roteiro (HOOK → CENA 1..N)
Quando o usuário fornecer uma ideia (se a proporção ou duração não forem mencionadas, use padrão 9:16 Shorts 30–45s para fatos rápidos, ou 16:9 Vídeo 60–600s para tópicos aprofundados):
- Selecione 1 Categoria mais adequada das 16 Categorias Oficiais:
3D·Isométrico·Explosão de Casa·Stickman 3D·Astronomia·Mundo Animal·Oceano·Ciência & Natureza·História·Mapas·Islâmico·Geografia·Anatomia·Folclore·Desenho Animado·Animação 2D. - Formule uma Recomendação Visual Específica:
- Objetos & Adereços (
objetos): assunto principal texturizado/articulado + pelo menos 3 adereços para comparação de escala/evidência. - Câmera & Transições (
camera): padrão multi-ângulo (aberto→close-updetalhe →órbita/giroPara/afastamento). - Ambiente & Iluminação (
ambiente): atmosfera de céu/espaço, névoa/luz volumétrica, paleta de cores e tom da narração.
- Objetos & Adereços (
- Elabore o Roteiro em Etapas (
0atéDURsegundos sem lacunas vazias):- A primeira parte OBRIGATÓRIA é
HOOK(3–10 segundos de abertura para despertar curiosidade). - Em seguida,
CENA 1,CENA 2, etc., e conclua com uma conclusão factual forte (~2,2 palavras/segundo). - Para durações longas (> 60s até
600s / 10 minutos), leia Guia de Duração Longa de 10 Minutos.
- A primeira parte OBRIGATÓRIA é
Passo 2 — Leia a Receita da Categoria & Padrão Ouro de Código de Exemplo (OBRIGATÓRIO!)
NÃO escreva sceneCode a partir de chutes vazios! Antes de escrever o código de animação:
- Leia a tabela de categorias e o ID
styleem Catálogo de 16 Categorias e a lista de funções de tempo de execução em Referência da API do Engine v4 (MF). - Leia os exemplos de código-fonte oficiais mais próximos em Padrão Ouro de Código de Referência.
- Lei de Equivalência de Qualidade: A densidade de objetos, detalhes de textura (
CanvasTexture/ SVG em camadas / linha costeiraworld-atlas/ shader GLSL), iluminação e suavidade da câmera DEVEM SER EQUIVALENTES aos exemplos emgolden-showcases.md. É proibido desenhar caixas/círculos simples sem textura ou adereços!
Passo 3 — Regras de Ouro para Escrever sceneCode
sceneCode é executado como o corpo da função (MF, stage, tl, W, H, DUR):
- Responsivo Duplo (
9:16Shorts &16:9Vídeo): Sempre use proporções deWeH(W * 0.5,H * 0.45,size: W < H ? 50 : 56,labelX: W < H ? W * 0.08 : W * 0.54) para que a animação seja exibida por completo sem cortes em1080×1920ou1920×1080. - Não Sobrescreva a Variável
H: Nunca escrevaconst { H } = MF;pois isso sobrescreverá a altura do palcoH! Sempre chame usando o prefixoMF.(MF.H,MF.S,MF.T). - 100% Determinístico: É proibido usar
Math.random(),Date.now(),setTimeoutousetInterval. UseMF.rng('seed-fixo'), tweens emtleMF.onTick((t) => ...)como função pura do tempot. - Frame 0 Já Deve Estar Vivo: Elementos do palco e título de abertura
HOOKdevem usarat: 0para que o primeiro frame não fique vazio/escuro. - Anti-PPT: No máximo 1 manchete (
MF.highlightHeadline) + 1 chamada/número (MF.leaderCallout/MF.bigStat) por vez. A história deve ser conduzida por mudanças na ação do mundo/objetos e movimento da câmera, e não por uma sequência de cartões de texto!
Passo 4 — Monte o Arquivo Autônomo (.html, -source.zip, -naskah.md)
Crie um arquivo de especificação JSON (ex.: spec.json):
{
"title": "Título do Vídeo",
"idea": "Ideia original do usuário",
"style": "stickman-3d",
"aspectRatio": "9:16",
"duration": 30,
"visualRecommendation": {
"objetos": "...",
"camera": "...",
"ambiente": "..."
},
"scenes": [
{ "label": "HOOK", "title": "...", "start": 0, "end": 7, "narration": "...", "visualBeat": "..." },
{ "label": "CENA 1", "title": "...", "start": 7, "end": 18, "narration": "...", "visualBeat": "..." }
],
"sceneCode": "const view = MF.H('div', { className: 'mf-view' }, stage); ..."
}
Em seguida, execute o script de construção autônomo (Node.js nativo puro, 0 dependências npm!):
node "<caminho-para-habilidade>/scripts/build.mjs" --spec caminho/para/spec.json --out-dir caminho/destino
Este script valida a sintaxe e o determinismo do sceneCode, incorpora ./assets/motion-engine.js, ./assets/sfx-synth.mjs e ./assets/land-110m.json (se usar mapas), e gera:
<slug>.html— 1 arquivo autônomo pronto para assistir em qualquer navegador (auto-loop + barra de scrub + botão para alternar9:16↔16:9+ WebAudio SFX).<slug>-source.zip— arquivo completo do código-fonte (index.html,src/scene.js,src/project.json,NASKAH-DAN-STORYBOARD.md,engine/).<slug>-naskah.md— documento de roteiro e recomendações visuais organizado.
Fallback Sem Shell / Web Chat: Se o ambiente do agente não tiver acesso ao terminal Node.js, copie o conteúdo de
./assets/starter-template.html, substitua os placeholders/*__MOTION_ENGINE__*/,/*__SFX_SYNTH__*/e/*__PROJECT_JSON__*/ nulldiretamente para gerar o arquivoindex.htmlcompleto.
Passo 5 — Verificação de Quadros & Exportação de Vídeo MP4 (Opcional / Se o Navegador Headless Estiver Disponível)
Se o ambiente tiver Chrome/Edge + puppeteer-core (ou puppeteer), execute a verificação automática para garantir 0 erros de tempo de execução e verificar capturas de tela:
# Verificação rápida (verificar 0 erros + salvar screenshot do HOOK e do meio):
node "<caminho-para-habilidade>/scripts/export-mp4.mjs" --html caminho/destino/<slug>.html --verify-only
# Renderização completa para vídeo MP4 (H.264 + AAC SFX automático, opcional + --vo narracao.mp3):
node "<caminho-para-habilidade>/scripts/export-mp4.mjs" --html caminho/destino/<slug>.html --fps 30 --scale 1
Se forem encontrados erros ou textos sobrepostos nas capturas de tela de verificação, corrija o sceneCode, reconstrua com scripts/build.mjs e entregue o resultado ao usuário.