¿Qué hace edit-motion-graphics?
Responsable del resultado de una pieza de motion finalizada (MP4) construida como HTML de HyperFrames + una línea de tiempo de GSAP pausada. El PROMPT.md a nivel de fotograma es el producto; el código solo lo renderiza.
Reglas no negociables (léase primero)
- No hay código antes de un PROMPT.md a nivel de fotograma aprobado - también en ejecuciones autónomas: el agente redacta, un humano aprueba (decisión por defecto Q6). La aprobación es una línea registrada
APPROVAL: <quién> <fecha>en el archivo. El orden de cambios siempre es ledger -> PROMPT.md -> código. - Sin gastos aquí. AI-3D, imágenes fijas de IA o cualquier generación paga pasa por
paid-generation-gate; esta skill no realiza ninguna llamada paga. Un listado de catálogo no es acceso a cuenta. - Orden de revisión: Vista previa del estudio -> rangos
hf_segment-> UN render completo por ronda de notas -> QA de cada fotograma en el render final. Un trabajo pesado a la vez (render_lock). Agrupa las notas; diagnostica mientras el usuario aún escribe, pero no renderices. - Trampas duras: sin
dir="rtl"en la raíz de HyperFrames (RTL solo en elementos de texto,lang="he"en<html>); fuentes desde archivos (@font-faceenhf/fonts/);hyperframes snapshot --describe false, <= 5 marcas de tiempo por llamada; raíz de trabajo ASCII (new_project). - Fallo cerrado: una compuerta que no puede ejecutarse es
bloqueada(not_run), nuncapass. Un tiempo de espera, una muestra vacía o un render faltante nunca pasan. Una llamada a herramienta exitosa es evidencia de ejecución; un render visualizado es evidencia de apariencia; una imagen fija no puede probar movimiento. - Ley vs. gusto: las reglas 1-5 son ley. Los elementos marcados como estilo de estudio a continuación (sin subtítulos por defecto, lista prohibida, "sin rosa", gramática de Higgsfield, primero el 21) son el gusto del responsable, enseñados con su razón; un brief que diga lo contrario gana en gusto, nunca en compuertas.
- Los números llevan su fps (30 a menos que el brief diga lo contrario) y las temporizaciones medidas llevan la máquina (Windows 11 / Ryzen 7 7435HS / RX 7600S / 32 GB del responsable). Las temporizaciones de NVIDIA/Apple no están medidas. Los proyectos que restrinjan gastos, instalaciones o publicaciones anulan esta skill.
Entradas -> salidas
In: brief/ledger (de video-intake), kit de marca, capturas de pantalla o componentes de UI, música/VO. Out: hf/PROMPT.md (a nivel de fotograma), hf/DESIGN.md (una paleta bloqueada + tipo + tokens de movimiento), hf/cues.js (fuente de temporización única para imagen y sonido), hf/SOURCES.md, la composición, mix.wav, el MP4 final, informes de QA. Traspasos: notas -> revision-round; otras proporciones -> multi-video-variants (reorganización completa, nunca un recorte); compuerta de entrega -> render-qa-deliver; una referencia dada -> reference-style-transfer primero (sin referencia -> preguntar qué rango de tiempo es "el estilo").
Procedimiento
- Registrar + intake. Elegir un registro (
launch | kinetic | logo | explainer | calm) y fijar duración, proporciones, VO, música, nombre del entregable (references/launch-register-and-pace.md). Un lanzamiento denso de 30 s se sintió x1.7 demasiado rápido; la duración aprobada fue de 45 s: decide la duración primero. - Redactar PROMPT.md + DESIGN.md (6 bloques; las tablas de cámara, unión y eventos; tarjetas de beat para cualquier 3D). Ejecuta
python scripts/motion_spec_check.py hf/PROMPT.md --register <r>; corrige; solicita aprobación. - Fuentes de beats (
references/ui-sources-and-port.md): catalogar -> hf-blocks -> registros de shadcn (por defecto) -> 21st.dev solo con cuenta -> construir a mano; decidir 3D por beat (references/three-d-decision.md). - Construir un
index.html+cues.js; los componentes portados re-escritos como seek-safe. Luegohf_preflight --strict,python scripts/seek_safe_scan.py hf/,python scripts/palette_audit.py hf/DESIGN.md hf/ [--png <renders 3D>]. - Aprobar visualmente: cuatro fotogramas fijos + una instantánea de cada unión + hoja de contacto
sheet; vista previa del estudio; notas por lotes. - Sonido (
references/sound-and-captions.md):hf_mix --report; sonido de marca en cada evento de marca; multiplexar y medir el archivo final. - Un render completo bajo el bloqueo con un ETA primero;
frame_qa,motion_qa,hf_deliver; puntuar conagent-content/benchmarks/motion-graphics.rubric.mdusando un crítico separado; presentar el archivo, los cambios numerados, el ledger marcado y las brechas honestas.
Registro de un vistazo (detalles: references/launch-register-and-pace.md)
| Registro | Nueva pantalla | Cadencia de eventos | Cámara | Sonido |
|---|---|---|---|---|
launch | cada 2-6 s, >= 2 capas de profundidad | <= 0.5-1 s; 45-110/min por conteo manual | nunca se detiene (deriva 2-4 %/s, push-ins 8-15 %) | la música es el SFX; sonido de marca en cada evento de marca; ring-out |
kinetic | cada 1-3 s | hasta ~200/min (los intercambios de palabras cuentan) | el tipo es la cámara | la palabra clave aterriza 0..+7 f después de ser pronunciada |
logo | una idea, 3-8 s | resultado visible en 0.4-0.75 s | un movimiento + asentamiento | sonido de marca en la revelación; final de 3 pasos |
explainer | por idea, 3-6 s | 30-110/min | con propósito, hacia el objeto explicado | liderado por VO; SFX solo en cambios visibles |
calm | se permiten pausas | lo espaciado está bien | lenta o fija | un fondo uniforme + foley sutil; sin subidas/bajadas |
3D por beat en cinco líneas
Decide por beat, escribe la razón en PROMPT.md: Blender para geometría real / material héroe en pantalla > 2 s (EEVEE primero; medido 1.2-2.25 s/fotograma a 384-640 px, +1-1.5 min por lanzamiento); Three.js para beats con datos, instanciados, UI 3D con texto en vivo, editables en rondas o hex exactos, después de una compuerta AMD de hf_segment de 1 s; AI-3D solo detrás de paid-generation-gate y una verificación de licencia; 2.5D (depth_25d, Depth Anything V2 Small, 8.1-9.9 s por clip de 2 s) para un fotograma fijo que necesita un pequeño movimiento; ninguno para beats de UI/mensaje. Un objeto 3D nunca cubre información y reacciona a la palabra.
"Aburrido / parece IA / estático" en una marca de tiempo
Reemplaza el concepto del beat, no lo perfecciones. Elige del menú: un orbe de voz impulsado por el espectro real del VO; una construcción basada en datos (barras, contadores, globo de ruta); la UI reconstruida en código y capturada como un objeto (perspectiva, profundidad de campo, aumento del 150-300 %); un morph de elemento compartido que transporte contenido; un intercambio de número o palabra en su lugar; un héroe 3D aterrizando en la palabra clave. Nunca una "píldora de función" pequeña en una esquina, una captura de pantalla plana con un pequeño push-in, o un punto sobre negro. Añade la nota a la línea Prohibida y corrígelo en cada ocurrencia (regla global cuando se repite).
Presupuesto de tiempo (modelado o medido en la máquina del responsable; no mediciones de estudiantes)
Objetivo: primer borrador presentable de un lanzamiento de 30-45 s en aproximadamente 3-4 h con 1-2 rondas de corrección (el primer lanzamiento real tomó 10 borradores, 7 rondas de crítico, 4 rondas de notas del responsable); exactamente UN render completo por ronda. Render de referencia (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 del navegador -12 %; la captura es el cuello de botella (uso de CPU solo 2-3 de 16 núcleos lógicos). Renders premium anteriores: 8-14 min típico, 4-21 observado (0.8.79-0.8.93). Siempre compara una unidad y publica una línea de ETA antes de un trabajo de más de 3 minutos.
Compuertas
Estados: pass | fail | blocked | n/a, siempre con una razón.
| Compuerta | Predicado | Evidencia | Si es falso | Responsable | Revisar |
|---|---|---|---|---|---|
| G0 intake | registro, duración, proporciones, nombre del entregable, fuente de VO/música, respuesta de referencia registrada | hf/BRIEF.md | preguntar (3-4 preguntas por ronda); bloqueado | video-intake | cambios en el brief |
| G1 especificación a nivel de fotograma | 6 bloques; cada beat tiene fotogramas + px + easing + sonido + transición; línea Prohibida; paleta hex; línea APPROVAL: | motion_spec_check.py exit 0 (2 = falta aprobación = bloqueado) | corregir especificación; detenerse antes del código | esta skill + aprobador humano | cualquier retemporización o nuevo beat |
| G2 limpio y suave | UNA spline por escena, cada movimiento >= 1.2 s, reversiones >= 1 s y <= 1.3x, texto dentro del fotograma en cada clave; uniones salida = entrada, héroe persiste, sin técnica repetida, sin fundido | tablas en PROMPT + verificador; motion_qa 0 rangos de tartamudeo en el render | retemporizar / reencaminar; reemplazar el concepto del beat en lugar de perfeccionar | esta skill | cualquier cambio de cámara o unión |
| G3 densidad | por registro: lanzamiento = nueva pantalla cada 2-6 s, espacios entre eventos <= 0.7 s (respiros declarados exceptuados), 45-110 eventos/min (conteo manual) | Tabla de eventos + 3 muestras de fotograma por escena | añadir o reemplazar beats; estirar movimientos largos x1.6 en lugar de acumular | esta skill | después de cualquier retemporización |
| G4 3D por beat | cada beat 3D tiene una tarjeta: ruta (Blender / Three.js / AI-3D / 2.5D / ninguno), una frase de razón, ETA, evidencia de compuerta, licencia | tabla de tarjetas de beat; filas de Three.js: un fotograma de hf_segment de 1 s que no esté en blanco | redecidir; las filas de AI-3D necesitan paid-generation-gate | esta skill | nuevo beat o activo |
| G5 bloqueo de paleta | una tabla de paleta; cada hex en las fuentes y cada render 3D dentro de ella | palette_audit.py exit 0 (+ --png) | recolorear / rerenderizar; bloqueado si no hay tabla | esta skill | nuevo activo, nuevo render, nota de color |
| G6 sourcing de UI | cada beat de UI/efecto tiene una fila en SOURCES.md (origen, licencia, versión, fecha) y un puerto seek-safe; sin npx shadcn add en un proyecto; sin vista previa/medios de 21st copiados | SOURCES.md + escaneo | intercambiar fuente o construir a mano con una razón | esta skill | nuevo componente |
| G7 seek-safe | hf_preflight --strict 0 errores; seek_safe_scan.py 0 errores; las instantáneas en tiempos no secuenciales coinciden | informes + par de instantáneas | corregir; nunca "arreglar" suprimiendo sin una razón | esta skill | después de cada parche de código |
| G8 sonido | sonido de marca en cada evento de marca; SFX bajo VO dentro de -18..-26 dB y 1-3 f antes de la imagen; la música se desvanece; archivo final -14 LUFS +-0.5, TP <= -1 (preset de casa v1, Q5) | hf_mix --report, hf_deliver verificar en el archivo FINAL | remezclar y remultiplexar (sin rerenderizar) | render-qa-deliver mide | cualquier retemporización de audio o imagen |
| G9 subtítulos | sin elementos de subtítulo a menos que el brief lo solicite | grep de ids/clases + línea <direction> | eliminar / preguntar en una línea | esta skill | cambio en el brief |
| G10 render + QA | UN render completo esta ronda; frame_qa 0 banderas; promedio de rúbrica >= 4.0, ninguna dimensión < 3, M1/M3/M7 >= 3; cada línea del ledger marcada | Informes de QA + salida del crítico | volver a la compuerta fallida; máximo una ronda de corrección antes de escalar | render-qa-deliver | cada render completo |
Registro de resultados de compuertas (hf/QA.md, una línea por compuerta)
G1 pass motion_spec_check exit 0, 24 beats, approval "<who> 2026-10-02" (re-run after 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
Una compuerta sin línea es not_run. Nunca escribas pass de memoria de una ronda anterior: una retemporización, un nuevo activo o un parche lo invalida (consulta la columna Revisar).
Presentación de un borrador (render-qa-deliver es responsable de la compuerta de entrega)
Mensaje = el archivo de inmediato + cambios numerados (por los propios números de nota del usuario) + el ledger con cada línea marcada + la puntuación de la rúbrica del crítico separado + las brechas (lo que NO se verificó: revisión de hebreo, superposición de dispositivo, sonoridad en un teléfono) + el enlace del Estudio. Nunca presentes con un fotograma marcado, una compuerta fallida o una línea del ledger sin marcar.
Referencias (cargar cuando)
references/seam-camera-event-tables.md- SIEMPRE al escribir o revisar PROMPT.md; tambiénagent-content/techniques/frame-spec-prompt.mdyclean-smooth-motion.md.references/launch-register-and-pace.md- al elegir el registro, quejas de ritmo, lista prohibida, números de easing.references/three-d-decision.md- cualquier beat con profundidad o 3D;agent-content/techniques/2-5d.mdpara 2.5D.references/ui-sources-and-port.md- tarjetas de UI, efectos, animación de capturas de pantalla;agent-content/techniques/screenshot-rebuild.md.references/seek-safe-and-render-traps.md- al escribir código, parches, diferencias de render.references/palette-lock.md,references/typography-hebrew-kinetic.md,references/sound-and-captions.md- DESIGN.md, tipo hebreo, el plan de sonido.references/dated-versions.md- pines y licencias (fechados; expirados = desconocido).- Scripts (
python <script> --self-checkprimero):motion_spec_check.py,palette_audit.py,seek_safe_scan.py. Verifican texto y patrones, nunca apariencia.
Detenerse y escalar
Bloqueado, no adivinado: sin línea de aprobación; no es posible renderizar; falta una entrada de compuerta; un precio o licencia desconocido; un beat de Three.js cuyo segmento de 1 s está en blanco en AMD (recurrir a un sprite de Blender). Preguntar antes de cualquier gasto, instalación, publicación o mensaje a un tercero. Nunca enviar mensajes a otras sesiones de agente. Una nota del usuario "aburrido / parece IA / estático" en una marca de tiempo significa reemplazar el concepto del beat del menú del registro, en una línea de explicación.
Mantenimiento
Los hechos volátiles viven solo en references/dated-versions.md y los módulos fechados globales (hyperframes-traps.md, three-d-routes.md, audio-mix.md). Añade cada nueva nota del responsable a la línea Prohibida, no a este archivo. Solo comprobaciones especificadas y deterministas; no se ejecuta evaluación de modelo (decisión por defecto Q4).