Especificación de morph de UI (paso 06 del curso, nivel L3)
Escribe la lista de estados, no la vibra. El prompt más marcado como favorito de la semana de lanzamiento de Opus 5.5 no fue una frase corta: el bucle de morph de UI de @twoclipping y la película MakerMap de @verbove usaron una especificación XML con entradas a solicitar, una dirección, una lista de estado por tiempo fuerte, reglas de construcción y advertencias. La idea detrás de ellos: una forma que nunca corta. Un solo elemento cambia de tamaño, radio y color de estado a estado (botón, cargador, reproductor, gráfico, paleta de comandos), un cursor provoca cada cambio con un clic real, y el último fotograma es igual al primero para que la película se repita.
Argumentos de la solicitud (pueden estar vacíos), mostrados una vez:
Crédito: la disposición de seis secciones sigue la plantilla pública de @twoclipping (https://x.com/twoclipping/status/2103273003555402193; el XML está en la publicación principal, no en una respuesta al hilo como dice el curso) y la especificación MakerMap de @verbove (https://x.com/verbove/status/2103483957266268381). La plantilla en esta habilidad está escrita en las propias palabras de motion-studio: assets/spec-template.xml.
1. Solicitar las entradas
Pregunta en una sola ronda de AskUserQuestion (los subagentes no pueden preguntar; tú sí):
| Entrada | Valor predeterminado | Regla |
|---|---|---|
| Producto + URL | requerido | capturar la UI real y copiarla con /motion-studio:product-reel etapa 3 cuando haya una URL |
| 8 a 12 estados en orden narrativo | logo, CTA, campo de email, cargador, verificación, tarjeta, gráfico, paleta de comandos | uno por tiempo fuerte |
| Datos reales por estado | preguntar | etiquetas, números, nombres del producto; sin marcadores de posición |
| Colores de marca, fuentes, un acento | de la captura o studio.json | un acento |
| Pista de audio | sintetizar minimal a 120 BPM | una pista suministrada debe permitir este uso y comenzar en un tiempo fuerte |
| Formatos | 9x16, 1x1, 16x9 | misma línea de tiempo, reencuadrada |
| Bucle | sí | el último estado se transforma de nuevo en el primero |
2. Completar la especificación
Copia la plantilla en el proyecto como docs/spec.xml y completa cada [...] con las respuestas.
Mantén las seis secciones: <inputs>, <direction>, <structure>, <build>, <gotchas>,
<start>. El subagente motion-director (motion-studio:motion-director) puede redactarla a partir de tu
resumen; solo escribe bajo docs/.
3. Colocar los estados en la rejilla de tiempos
-
Proyecto: inicializar con
--loopsi es necesario (node "${CLAUDE_PLUGIN_ROOT}/skills/studio-init/scripts/init.mjs" <dir> --title "<Producto> morph" --loop --duration <S> --install; en una instalación solo de habilidades usanode "${CLAUDE_SKILL_DIR}/../studio-init/scripts/init.mjs" ...con las mismas banderas, o invoca la habilidadstudio-init). -
Rejilla:
node tools/score.mjs --style minimal --bpm 120 --dur <S>, o mide la pista suministrada connode tools/beats.mjs audio/<track>. -
Lista de estados con tiempos exactos de tiempo fuerte, verificaciones de bucle y advertencias:
node "${CLAUDE_SKILL_DIR}/scripts/statelist.mjs" --states "logo,CTA button,email field,loader,check,card,chart,palette" --out docs/statelist.mdBanderas Uso --states "a,b:2,c"o--file list.txtestados en orden; :2mantiene un estado durante dos compases--beats audio/beats.jsonrejilla medida (predeterminado cuando el archivo existe); --beats nonela ignora--bpm N,--beats-per-bar Nanular la rejilla --no-loopuna película que termina en lugar de repetirse --jsonuna línea JSON con el inicio, fin y duración de contenido de cada estado Advierte cuando la longitud del bucle difiere de
studio.jsonduration, cuando el primer estado no está en 0 s (una entrada en la pista), o cuando un estado dura menos de 1 s. Corrige la duración o recorta la pista antes de continuar. -
Completa las columnas de acción del cursor, datos y sonido de
docs/statelist.md, y copia la tabla endocs/shotlist.md.
4. La puerta
Muestra la lista de estados en la rejilla de tiempos y espera la confirmación del usuario antes de escribir
cualquier código de película (la sección <start> lo dice, y también el curso). Una lista rechazada se
reescribe, no se programa alrededor. Registra la decisión en la línea Status: de docs/shotlist.md.
5. Construir a partir del ejemplo verificado
Copia assets/morph-loop.film.js a film/film.js y adáptalo: es un
bucle funcional de 16 s, 8 estados a 120 BPM que se renderiza en todos los formatos. Reemplaza STATES (tamaños en
unidades de 1080 px, token de relleno), COPY y los pintores de content con la lista aprobada y los datos
reales; mantén los mecanismos:
| Mecanismo | API | Regla |
|---|---|---|
| tiempos de estado | grid.bar(i) | nunca segundos escritos |
| tamaño del contenedor, radio, canales de color, zoom de cámara | loopTrack(t, keys, dur, spring) | claves en [0, duration]; el cambio de unión una vez, como clave en el primer tiempo fuerte (este ejemplo) o en t = duración |
| contenido dentro y fuera | swapAlpha(t, start, nextStart) | dentro después de que comience el morph, fuera antes del siguiente |
| cursor | loopTrack en x e y, cursor(g, x, y, { pressed }) | hace clic en el elemento actual en el tiempo fuerte |
| pestañas y resaltados de lista | indicator(t, stops, { width }) | bordes con diferentes muelles |
| sonidos | cues de grid.bar y grid.beat | clic en presiones, swoosh bajo morphs |
| granulado y otro ruido indexado por fotograma | grain(g, W, H, c.frame % LOOP_FRAMES, ...) con LOOP_FRAMES = Math.round(dur * fps) | la crítica compara hash(0) con hash(duration, { wrap: false }); el ruido sembrado por el índice de fotograma bruto hace que el final difiera del fotograma 0 y falla la verificación del bucle |
Cada patrón con su razonamiento: references/morph-recipes.md.
Establece studio.json "loop": true y duration a la longitud del bucle, luego npm run lint.
6. Crítica y entrega
Ejecuta el bucle de crítica desde /motion-studio:motion-reel (al menos 3 rondas, todos los ejes >= 8, sin P0 abiertos; cada ronda
construye la mezcla renderizada y ambas pasadas de evidencia primero, consulta su manual de ejecución).
Para bucles de morph también verifica out/review/<fmt>/loop.png (solo pasada en vivo; la pasada video/ no tiene panel de bucle) y la métrica de "costura de bucle"
(hash(0) igual a hash(duration, { wrap: false }), relación de continuidad <= 1.5; el panel |end - first| debe ser negro,
que el granulado indexado por fotograma rompe a menos que su índice se envuelva), etiquetas durante cada intercambio en strip.png, y la
posición del cursor en cada tiempo fuerte en contact.png. Un salto en la costura es un P0. Luego npm run build.
Reglas para películas de morph
- Un contenedor, nunca se corta. Los estados difieren solo en tamaño, radio, relleno y contenido.
- Un cursor provoca cada cambio; ningún estado cambia por sí mismo.
- Algo se mueve en cada tiempo fuerte: una presión, escritura, un contador, un dibujo de línea, un paso de resaltado.
- Solo datos reales del producto. Muelles con como máximo un indicio de sobrepaso; ninguno en escritura.
- Prohibido: easing rebotante, brillos, degradados en cromo de UI, ráfagas de partículas, tiempos fuertes muertos.
- Nunca
will-change(ni ningún truco de rasterización) en nada que la cámara escale.
Siguiente: /motion-studio:springs para ajustar la sensación; /motion-studio:ship-formats para el reencuadre y entrega por formato.