Sensación de interfaz
El pase maestro de cómo una interfaz se mueve y responde. Audita lo que la aplicación hace hoy contra cuarenta elementos (doce principios de animación, ocho leyes de UX, veinte técnicas de UI) y un sistema de movimiento, escribe un informe y luego corrige cada hallazgo según el patrón de ese elemento. La mayoría de las aplicaciones ya tienen la mitad de la lista; la auditoría lo indica en lugar de agregarlo dos veces. Velocidad, objetivos y confianza siempre se aplican; la decoración es moderada en una herramienta de trabajo.
El propio sistema de diseño del proyecto, tokens de movimiento y reglas tienen prioridad sobre cualquier cosa aquí. Los presupuestos de rendimiento (LCP, INP, tamaño del paquete), accesibilidad y copia son pases independientes al lado de este.
Archivos en esta skill
| Archivo | Uso |
|---|---|
reference.md | cada uno de los 40 elementos: cómo verificarlo, el patrón de corrección, cuándo omitirlo, qué encontró una auditoría real |
motion.md | el sistema de movimiento: tokens, doce reglas, patrones de CSS, cómo auditar el movimiento |
audit/census.sh | censo de código: cuenta los patrones detrás de cada elemento, con referencias archivo:línea |
audit/probe.js | sonda de página en vivo: objetivos reales, duraciones, easing, figuras, encabezados, campos de código, marcadores de posición |
report-template.md | la plantilla del informe de auditoría: una fila de veredicto por elemento, orden de trabajo, lo que no se verificó |
Pase 1: auditoría (sin cambios)
- Lee primero el sistema de diseño del proyecto, los tokens de movimiento y las reglas de UI.
- Ejecuta el censo desde la raíz del proyecto:
bash <ruta de esta skill>/audit/census.sh . --show 5. Lee solo la superficie enviada (se excluyen dependencias, builds, copias vendidas, pruebas, benchmarks, archivos generados y líneas de comentario; agrega más conCENSUS_EXCLUDE="dir1,dir2"). Instala ripgrep para una ejecución rápida; sin él, el script recurre a perl. Un conteo es una pista para abrir, no un veredicto. - Ejecuta la aplicación. En cada página clave ejecuta
audit/probe.js(pégalo en la consola o usaawaiten el ejecutor de JavaScript de una herramienta del navegador) a 1440 píxeles de ancho y a 375, en cada tema que tenga la aplicación. Desplaza toda la página una pantalla a la vez y restaura la posición. Una pestaña oculta no tiene ancho ni pinta fotogramas: muéstrala primero. Lee su resultado con criterio: un objetivo marcado comospaced(su espacio hasta el siguiente control llega al piso) tiene menor gravedad; las figuras solo necesitantabular-numscuando cambian; marca las ventanas decorativas falsas conaria-hiddeno ignora sus filas. - Prueba manualmente lo que ningún script puede ver, con eventos de puntero reales (un clic de herramienta de navegador, no un
.click()sintético): presiona cada acción paga o irreversible dos veces rápido y cuenta los efectos en el servidor; estrangula la red y una escritura a 600 ms y presiona; abre y cierra cada capa rápidamente y vuélvela a abrir a mitad de la salida, muestreando su opacidad (motion.md, "Midiendo una reapertura"); presiona dentro de un menú que se cierra; escribe una consulta con acentos y mayúsculas diferentes; muévete en diagonal hacia un submenú hover; botón de retroceso de Android con una capa abierta; desliza una hoja de teléfono. - Escribe el informe a partir de
report-template.md: las 40 filas, cada una presente, ausente, incorrecta o omitir con una razón, evidencia como archivo:línea o un número, y construir o elegir. Muéstralo antes de corregir.
Pase 2: corregir según la lista de verificación
- Confianza primero: elemento 39 y cualquier cosa que pueda duplicar un cargo o perder datos, con una prueba que falle antes de la corrección.
- Los elementos construir cambian el comportamiento sin una nueva apariencia (área de impacto, triángulo seguro, gesto de retroceso, plegado de acentos, atajos, entradas de menú de comandos, escrituras optimistas, esqueletos, tokens de movimiento, transiciones reversibles). Corrige cada uno según su patrón en
reference.mdymotion.md, a través de los componentes y tokens propios del proyecto, con una prueba para cualquier lógica. - Los elementos elegir cambian la apariencia o el producto (esquinas, marcadores de posición borrosos, deshacer en lugar de confirmación, un latido de error, un nuevo latido de movimiento, una transición de vista). Evalúa cada uno como antes y después a escala 1 en ambos temas, numerados y separables; construye solo lo que el propietario elija.
- Nunca intercambies decoración eliminada por nueva decoración.
Pase 3: verificar
Vuelve a ejecutar el censo y la sonda y compara los números con el informe. Prueba cada interacción corregida como lo haría un usuario, en ambos temas, y por separado en ancho de teléfono. Informa construido, probado, aprobado visualmente y desplegado como hechos separados, y nombra lo que no se pudo medir (sin teléfono físico, sin build de producción).
La lista de verificación
Los números coinciden con reference.md y el informe.
| # | Elemento | Fallo cuando |
|---|---|---|
| A | Principios de animación (motion.md) | |
| 1 | Estirar y encoger | una insignia, punto o perilla de aterrizaje se detiene en seco |
| 2 | Anticipación | una pulsación no tiene estado dentro de un fotograma (escala alrededor de 0.97, alrededor de 100 ms) |
| 3 | Puesta en escena | una capa abierta deja poco claro el elemento principal |
| 4 | Pose a pose | un botón ocupado, etiqueta o intercambio de icono salta en ancho o contenido |
| 5 | Seguimiento | el contenido de una capa llega soldado a su contenedor |
| 6 | Entrada lenta, salida lenta | linear o ease predeterminado en movimiento de UI; más de tres easings |
| 7 | Arcos | algo viaja lejos en línea recta |
| 8 | Acción secundaria | una acción completada no tiene un segundo latido de confirmación |
| 9 | Tiempo rápido | una respuesta de UI superior a 300 ms; una superficie fuera de sus pares; las salidas no más cortas |
| 10 | Retroalimentación exagerada | un envío inválido muestra solo una sacudida, sin latido de color |
| 11 | Dibujo sólido | las sombras y las capas no coinciden en luz y profundidad |
| 12 | Atractivo | un flujo real, recorrido a escala 1, muestra una costura |
| B | Leyes de UX | |
| 13 | Fitts | un objetivo real de menos de 32 píxeles en escritorio o 44 píxeles en teléfono |
| 14 | Áreas de impacto más grandes | objetivos agrandados al ampliar la imagen, o hermanos superpuestos |
| 15 | Hick | más de cinco elementos en un bloque de menú |
| 16 | Miller | más de aproximadamente siete elementos de nivel superior no agrupados |
| 17 | Doherty | desde la pulsación hasta el siguiente pintado superior a 400 ms sin nada que responda primero |
| 18 | Postel | una variante de acento, mayúsculas o espaciado de una consulta no encuentra nada |
| 19 | Jakob | un patrón se comporta de manera diferente a su plataforma (submenú hover, retroceso cierra una capa) |
| 20 | Frecuencia de uso | una acción diaria está a más de un paso o un comando de distancia |
| C | Velocidad y retroalimentación | |
| 21 | Cargadores esqueleto | una ruta pinta en blanco o un spinner en el fotograma del clic |
| 22 | Actualizaciones optimistas | una escritura reversible barata no muestra nada hasta que el servidor responde |
| 23 | Menú de comandos | un destino es alcanzable haciendo clic pero no escribiendo |
| 24 | Sugerencias de atajos | un control con un atajo no lo muestra en su tooltip |
| 25 | Toasts de deshacer | un borrado restaurable no tiene deshacer (el propietario decide si reemplaza una confirmación) |
| 26 | Stale-while-revalidate | una página revisitada espera en lugar de pintar sus últimos datos |
| 27 | Pre-renderizado | una página probable siguiente no se precarga en la intención (juzgar en producción) |
| 28 | Marcadores de posición borrosos | una imagen cargando es una caja gris |
| 29 | Transiciones de vista | una apertura de cuadrícula a detalle no tiene morph de elemento compartido |
| 30 | Deslizar para descartar | una hoja o cajón de teléfono no se puede cerrar deslizando |
| 31 | Animaciones interrumpibles | volver a abrir durante una salida reproduce desde cero |
| D | Plataforma y detalle | |
| 32 | Retroceso predictivo | Retroceso de Android con una capa abierta abandona la página |
| 33 | Área de impacto | controles de icono pequeños no llevan crecimiento de objetivo invisible |
| 34 | Inserción de área segura | flotantes inferiores ignoran env(safe-area-inset-*) bajo viewport-fit=cover |
| 35 | Autocompletado de código único | un campo de código carece de autocomplete="one-time-code" y inputmode="numeric" |
| 36 | Números tabulares | figuras cambiantes saltan (sin tabular-nums) |
| 37 | Encabezados equilibrados | un encabezado corto de varias líneas deja un huérfano (sin text-wrap: balance) |
| 38 | Esquinas continuas | esquinas de squircle no consideradas (una decisión estética: evaluarlo) |
| E | Confianza | |
| 39 | Claves de idempotencia | dos pulsaciones rápidas de una acción paga o irreversible causan dos efectos en el servidor |
| 40 | Triángulo seguro | un submenú hover se cierra en un movimiento diagonal hacia él |
Errores comunes
- Agregar lo que ya existe: los esqueletos, el almacenamiento en caché y los tokens de movimiento a menudo ya están; el veredicto es presente.
- Desduplicación del cliente como guardia de dinero: dos clics llegan antes de que un re-render deshabilite el botón. Protege en el servidor (actualización condicional, clave determinista, bloqueo) y mantén la pulsación en una ref.
- Agrandar la imagen en lugar del objetivo; verificar objetivos solo en ancho de escritorio mientras una regla de escritorio elimina el piso del teléfono.
- Keyframes para abrir y cerrar: no se pueden revertir. Usa transiciones en un atributo de estado, y haz que una capa saliente sea
inert. - Tratar deshacer, esquinas o tono de error como decisiones de ingeniería. Pertenecen al propietario.
- Juzgar precarga o sincronización en un servidor de desarrollo o una pestaña de fondo.