edit-motion-graphics
Dono do resultado de uma peça de motion finalizada (MP4) construída como HTML HyperFrames + uma timeline GSAP pausada. O PROMPT.md em nível de quadro é o produto; o código apenas o renderiza.
Regras inegociáveis (leia primeiro)
- Nenhum código antes de um PROMPT.md em nível de quadro aprovado — também em execuções autônomas: o agente rascunha, um humano aprova (padrão de decisão Q6). A aprovação é uma linha registrada
APPROVAL: <quem> <data>no arquivo. A ordem de mudança é sempre ledger -> PROMPT.md -> código. - Sem gastos aqui. IA-3D, imagens de IA ou qualquer geração paga passam por
paid-generation-gate; esta skill não faz nenhuma chamada paga. Uma listagem de catálogo não é acesso a conta. - Ordem de revisão: Pré-visualização do Studio -> intervalos
hf_segment-> UMA renderização completa por rodada de anotações -> QA de cada quadro na renderização final. Um trabalho pesado por vez (render_lock). Agrupe as anotações; diagnostique enquanto o usuário ainda está escrevendo, mas não renderize. - Armadilhas difíceis: sem
dir="rtl"na raiz do HyperFrames (RTL apenas em elementos de texto,lang="he"no<html>); fontes de arquivos (@font-faceemhf/fonts/);hyperframes snapshot --describe false, <= 5 timestamps por chamada; raiz de trabalho ASCII (new_project). - Falhe fechado: um gate que não pode ser executado é
blocked(not_run), nuncapass. Um tempo limite, uma amostra vazia ou uma renderização ausente nunca passam. Uma chamada de ferramenta bem-sucedida é evidência de execução; uma renderização visualizada é evidência de aparência; uma imagem estática não pode provar movimento. - Lei vs. gosto: as regras 1 a 5 são lei. Itens marcados como estilo do estúdio abaixo (sem legendas por padrão, lista proibida, "sem rosa", gramática Higgsfield, 21 de primeiro) são o gosto do dono, ensinados com sua justificativa; um briefing que diga o contrário vence no gosto, nunca nos gates.
- Números carregam seu fps (30 a menos que o briefing diga o contrário) e temporizações medidas carregam a máquina (Windows 11 / Ryzen 7 7435HS / RX 7600S / 32 GB do dono). Temporizações NVIDIA/Apple não são medidas. Projetos que restrinjam gastos, instalações ou publicações substituem esta skill.
Entradas -> saídas
Entrada: briefing/ledger (de video-intake), kit de marca, capturas de tela ou componentes de UI, música/VO. Saída: hf/PROMPT.md (nível de quadro), hf/DESIGN.md (uma paleta + tipo + tokens de movimento bloqueados), hf/cues.js (fonte de temporização única para imagem e som), hf/SOURCES.md, a composição, mix.wav, o MP4 final, relatórios de QA. Transferências: anotações -> revision-round; outras proporções -> multi-video-variants (re-layout completo, nunca um corte); gate de entrega -> render-qa-deliver; uma referência fornecida -> reference-style-transfer primeiro (sem referência -> pergunte qual intervalo de tempo é "o estilo").
Procedimento
- Registre + receba. Escolha um registro (
launch | kinetic | logo | explainer | calm) e trave duração, proporções, VO, música, nome do entregável (references/launch-register-and-pace.md). Um lançamento denso de 30 s parecia 1,7x mais rápido; a duração aprovada foi de 45 s: decida a duração primeiro. - Rascunhe PROMPT.md + DESIGN.md (6 blocos; as tabelas de câmera, costura e eventos; cartões de batida para qualquer 3D). Execute
python scripts/motion_spec_check.py hf/PROMPT.md --register <r>; corrija; peça aprovação. - Fontes das batidas (
references/ui-sources-and-port.md): catálogo -> hf-blocks -> registros shadcn (padrão) -> 21st.dev apenas com uma conta -> construção manual; decida 3D por batida (references/three-d-decision.md). - Construa um
index.html+cues.js; componentes portados reescritos como seguros para busca. Depoishf_preflight --strict,python scripts/seek_safe_scan.py hf/,python scripts/palette_audit.py hf/DESIGN.md hf/ [--png <renderizações 3D>]. - Aprove visualmente: quatro imagens estáticas + uma captura de cada costura + folha de contato
sheet; pré-visualização do Studio; lote de anotações. - Som (
references/sound-and-captions.md):hf_mix --report; som da marca em cada evento de marca; multiplexe e meça o arquivo final. - Uma renderização completa sob o bloqueio com uma ETA primeiro;
frame_qa,motion_qa,hf_deliver; pontue comagent-content/benchmarks/motion-graphics.rubric.mdusando um crítico separado; apresente o arquivo, as alterações numeradas, o ledger marcado e as lacunas honestas.
Registro de relance (detalhes: references/launch-register-and-pace.md)
| Registro | Nova tela | Cadência de eventos | Câmera | Som |
|---|---|---|---|---|
launch | a cada 2-6 s, >= 2 camadas de profundidade | <= 0,5-1 s; 45-110/min contagem manual | nunca para (deriva 2-4 %/s, push-ins 8-15 %) | música é o SFX; som da marca em cada evento de marca; ring-out |
kinetic | a cada 1-3 s | até ~200/min (trocas de palavras contam) | o tipo é a câmera | palavra-chave chega 0..+7 f após ser falada |
logo | uma ideia, 3-8 s | resultado visível em 0,4-0,75 s | um movimento + pouso | som da marca na revelação; final em 3 etapas |
explainer | por ideia, 3-6 s | 30-110/min | proposital, para o objeto explicado | liderado por VO; SFX apenas em mudança visível |
calm | pausas permitidas | esparso é aceitável | lento ou travado | um leito uniforme + foley sutil; sem risers/drops |
3D por batida em cinco linhas
Decida por batida, escreva a razão no PROMPT.md: Blender para geometria real / material herói na tela > 2 s (EEVEE primeiro; medido 1,2-2,25 s/quadro a 384-640 px, +1-1,5 min por lançamento); Three.js para batidas orientadas a dados, instanciadas, 3D-UI-com-texto-vivo, editáveis em rodadas ou de hexágono exato, após um gate AMD hf_segment de 1 s; IA-3D apenas atrás de paid-generation-gate e uma verificação de licença; 2.5D (depth_25d, Depth Anything V2 Small, 8,1-9,9 s por clipe de 2 s) para uma imagem estática que precisa de um pequeno movimento; nenhum para batidas de UI/mensagem. Um objeto 3D nunca cobre informação e reage à palavra.
"Entediante / parece IA / estático" em um timestamp
Substitua o conceito da batida, não o aprimore. Escolha do menu: um orbe de voz guiado pelo espectro real do VO; uma construção orientada a dados (barras, contadores, globo de rota); a UI reconstruída em código e capturada como objeto (perspectiva, profundidade de campo, ampliação de 150-300 %); um morph de elemento compartilhado que carrega conteúdo; uma troca de número ou palavra no lugar; um herói 3D pousando na palavra-chave. Nunca um "pill de funcionalidade" em canto pequeno, uma captura de tela plana com um pequeno push-in, ou um ponto no preto. Adicione a anotação à linha Proibida e corrija em toda ocorrência (regra global quando se repete).
Orçamento de tempo (modelado ou medido na máquina do dono; não medições de estudante)
Alvo: primeiro rascunho apresentável de um lançamento de 30-45 s em cerca de 3-4 h com 1-2 rodadas de correção (o primeiro lançamento real levou 10 rascunhos, 7 rodadas de crítico, 4 rodadas de anotações do dono); exatamente UMA renderização completa por rodada. Referência de renderização (HyperFrames 0.8.98, E11, pesado 40 s / 1200 f): 1 worker 132,6 s, 4 workers 92,8 s, 8 workers 88,1 s; GPU do navegador -12 %; captura é o gargalo (uso de CPU apenas 2-3 de 16 núcleos lógicos). Renderizações premium anteriores: 8-14 min típico, 4-21 observado (0.8.79-0.8.93). Sempre execute benchmark de uma unidade e poste uma linha de ETA antes de um trabalho acima de 3 minutos.
Gates
Estados: pass | fail | blocked | n/a, sempre com uma razão.
| Gate | Predicado | Evidência | Se falso | Dono | Revisão |
|---|---|---|---|---|---|
| G0 intake | registro, duração, proporções, nome do entregável, fonte de VO/música, resposta de referência registrada | hf/BRIEF.md | pergunte (3-4 perguntas por rodada); bloqueado | video-intake | mudanças no briefing |
| G1 especificação de nível de quadro | 6 blocos; cada batida tem quadros + px + easing + som + transição; linha Proibida; paleta hex; linha APPROVAL: | motion_spec_check.py exit 0 (2 = aprovação ausente = bloqueado) | corrija a especificação; pare antes do código | esta skill + aprovador humano | qualquer retempo ou nova batida |
| G2 limpo e suave | UMA spline por cena, cada movimento >= 1,2 s, reversões >= 1 s e <= 1,3x, texto dentro do quadro em cada keyframe; as costuras saem = entram, herói persiste, nenhuma técnica repetida, sem fade | tabelas no PROMPT + verificador; motion_qa 0 faixas de gagueira na renderização | retempo / recaminho; substitua o conceito da batida em vez de polir | esta skill | qualquer mudança de câmera ou costura |
| G3 densidade | por registro: lançamento = nova tela a cada 2-6 s, gaps de eventos <= 0,7 s (respirações declaradas excetuadas), 45-110 eventos/min (contagem manual) | Tabela de Eventos + 3 amostras de quadro por cena | adicione ou substitua batidas; estique movimentos longos x1,6 em vez de comprimir | esta skill | após qualquer retempo |
| G4 3D por batida | toda batida 3D tem um cartão: rota (Blender / Three.js / IA-3D / 2.5D / nenhum), uma frase de razão, ETA, evidência de gate, licença | tabela de cartões de batida; linhas Three.js: um quadro hf_segment de 1 s que não está em branco | redecida; linhas IA-3D precisam de paid-generation-gate | esta skill | nova batida ou ativo |
| G5 paleta travada | uma tabela de paleta; todo hex nas fontes e toda renderização 3D dentro dela | palette_audit.py exit 0 (+ --png) | recolorir / rerenderizar; bloqueado se não houver tabela | esta skill | novo ativo, nova renderização, anotação de cor |
| G6 fonte de UI | cada batida de UI/efeito tem uma linha em SOURCES.md (origem, licença, versão, data) e um port seguro para busca; sem npx shadcn add em um projeto; sem pré-visualização/mídia 21st copiada | SOURCES.md + varredura | troque a fonte ou construa manualmente com uma razão | esta skill | novo componente |
| G7 seguro para busca | hf_preflight --strict 0 erros; seek_safe_scan.py 0 erros; capturas de tela em tempos não sequenciais concordam | relatórios + par de capturas | corrija; nunca "corrija" suprimindo sem uma razão | esta skill | após cada patch de código |
| G8 som | som da marca em cada evento de marca; SFX sob VO dentro de -18..-26 dB e 1-3 f antes da imagem; música termina; arquivo final -14 LUFS +-0,5, TP <= -1 (predefinição da casa v1, Q5) | hf_mix --report, hf_deliver verifica no arquivo FINAL | remisture e remultiplexe (sem rerenderizar) | render-qa-deliver mede | qualquer retempo de áudio ou imagem |
| G9 legendas | nenhum elemento de legenda a menos que o briefing peça | grep de ids/classes + linha <direction> | remova / pergunte em uma linha | esta skill | mudança no briefing |
| G10 renderização + QA | UMA renderização completa nesta rodada; frame_qa 0 flags; média do rubric >= 4,0, nenhuma dimensão < 3, M1/M3/M7 >= 3; toda linha do ledger marcada | Relatórios de QA + saída do crítico | volte para o gate que falhou; no máximo uma rodada de correção antes de escalar | render-qa-deliver | cada renderização completa |
Registrando resultados de gate (hf/QA.md, uma linha por gate)
G1 pass motion_spec_check exit 0, 24 beats, approval "<quem> 2026-10-02" (re-run após r2 retime: pass)
G5 blocked 3D render coin_r2.png not readable by palette_audit (not_run) - install Pillow or downscale
G7 fail seek_safe_scan SS02 index.html:211 Math.random -> seeded hash; rescan pending
Um gate sem linha é not_run. Nunca escreva pass pela memória de uma rodada anterior: um retempo, um novo ativo ou um patch o invalida (veja a coluna Revisão).
Apresentando um rascunho (render-qa-deliver é dono do gate de entrega)
Mensagem = o arquivo imediatamente + alterações numeradas (pelos números de anotação do próprio usuário) + o ledger com cada linha marcada + a pontuação do rubric do crítico separado + as lacunas (o que NÃO foi verificado: revisão de hebraico, sobreposição de dispositivo, intensidade sonora em um telefone) + o link do Studio. Nunca apresente com um quadro sinalizado, um gate falho ou uma linha de ledger não marcada.
Referências (carregue quando)
references/seam-camera-event-tables.md- SEMPRE ao escrever ou revisar PROMPT.md; tambémagent-content/techniques/frame-spec-prompt.mdeclean-smooth-motion.md.references/launch-register-and-pace.md- escolhendo o registro, reclamações de ritmo, lista proibida, números de easing.references/three-d-decision.md- qualquer batida com profundidade ou 3D;agent-content/techniques/2-5d.mdpara 2.5D.references/ui-sources-and-port.md- cartões de UI, efeitos, animação de captura de tela;agent-content/techniques/screenshot-rebuild.md.references/seek-safe-and-render-traps.md- escrevendo código, patches, diferenças de renderização.references/palette-lock.md,references/typography-hebrew-kinetic.md,references/sound-and-captions.md- DESIGN.md, tipo hebraico, o plano de som.references/dated-versions.md- pins e licenças (datadas; expiradas = desconhecido).- Scripts (
python <script> --self-checkprimeiro):motion_spec_check.py,palette_audit.py,seek_safe_scan.py. Eles verificam texto e padrões, nunca aparência.
Pare e escale
Bloqueado, não adivinhado: nenhuma linha de aprovação; nenhuma renderização possível; uma entrada de gate ausente; um preço ou licença desconhecido; uma batida Three.js cujo segmento de 1 s está em branco em AMD (volte a um sprite do Blender). Pergunte antes de qualquer gasto, instalação, publicação ou mensagem a terceiros. Nunca envie mensagens para outras sessões de agente. Uma anotação do usuário "entediante / parece IA / estático" em um timestamp significa substituir o conceito da batida do menu do registro, em uma linha de explicação.
Manutenção
Fatos voláteis vivem apenas em references/dated-versions.md e nos módulos datados globais (hyperframes-traps.md, three-d-routes.md, audio-mix.md). Adicione cada nova anotação do dono à linha Proibida, não a este arquivo. Verificações especificadas e determinísticas apenas; modelo eval não executado (padrão de decisão Q4).