Sensação da interface
O passe mestre para como uma interface se move e responde. Ele audita o que o aplicativo faz hoje contra quarenta itens (doze princípios de animação, oito leis de UX, vinte técnicas de UI) e um sistema de movimento, escreve um relatório e, em seguida, corrige cada descoberta seguindo o padrão daquele item. A maioria dos aplicativos já tem metade da lista; a auditoria afirma isso em vez de adicionar duas vezes. Velocidade, alvos e confiança sempre se aplicam; a decoração é contida em uma ferramenta de trabalho.
O próprio design system do projeto, tokens de movimento e regras prevalecem sobre qualquer coisa aqui. Orçamentos de performance (LCP, INP, tamanho do bundle), acessibilidade e texto são passes próprios além deste.
Arquivos neste skill
| Arquivo | Uso |
|---|---|
reference.md | cada um dos 40 itens: como verificar, o padrão de correção, quando pular, o que uma auditoria real encontrou |
motion.md | o sistema de movimento: tokens, doze regras, padrões CSS, como auditar movimento |
audit/census.sh | censo de código: conta os padrões por trás de cada item, com referências de arquivo:linha |
audit/probe.js | probe de página ao vivo: alvos reais, durações, easings, figuras, cabeçalhos, campos de código, placeholders |
report-template.md | o relatório de auditoria: uma linha de veredito por item, ordem de trabalho, o que não foi verificado |
Passo 1: auditoria (não mude nada)
- Leia primeiro o design system do projeto, os tokens de movimento e as regras de UI.
- Execute o censo a partir da raiz do projeto:
bash <caminho deste skill>/audit/census.sh . --show 5. Ele lê apenas a superfície entregue ao usuário (dependências, builds, cópias vendidas, testes, benchmarks, arquivos gerados e linhas de comentário são deixados de fora; adicione mais comCENSUS_EXCLUDE="dir1,dir2"). Instale ripgrep para uma execução rápida; sem ele, o script usa perl como fallback. Uma contagem é uma pista para abrir, não um veredito. - Execute o aplicativo. Em cada página chave, execute
audit/probe.js(cole no console, ou useawaitno executor JavaScript de uma ferramenta de navegador) a 1440 de largura e a 375, em cada tema do aplicativo. Ele rola a página inteira uma tela de cada vez e restaura a posição. Uma aba oculta não tem largura e não pinta quadros: mostre-a primeiro. Leia a saída com julgamento: um alvo marcado comospaced(sua distância para o próximo controle atinge o mínimo) é de menor gravidade; figuras só precisam detabular-numsonde mudam; marque janelas mock decorativas comoaria-hiddenou ignore suas linhas. - Dirija manualmente o que nenhum script pode ver, com eventos de ponteiro reais (um clique de uma ferramenta de navegador, não um
.click()sintético): pressione cada ação paga ou irreversível duas vezes rápido e conte os efeitos no servidor; limite a rede e uma gravação a 600 ms e pressione; abra e feche cada camada rapidamente e reabra-a no meio da saída, amostrando sua opacidade (motion.md, "Medindo uma reabertura"); pressione dentro de um menu que está fechando; digite uma consulta com acento e com maiúsculas/minúsculas diferentes; mova-se diagonalmente em direção a um submenu hover; botão Voltar do Android com uma camada aberta; deslize uma folha do telefone. - Escreva o relatório a partir de
report-template.md: todas as 40 linhas, cada uma presente, ausente, errada ou pular com uma razão, evidência como arquivo:linha ou um número, e construir ou escolher. Mostre-o antes de corrigir.
Passo 2: corrigir pela checklist
- Confiança primeiro: item 39 e qualquer coisa que possa dobrar uma cobrança ou perder dados, com um teste que falhe antes da correção.
- Itens Construir mudam o comportamento sem uma nova aparência (hit slop, triângulo seguro, gesto de voltar, dobra de acento, atalhos, entradas de menu de comandos, gravações otimistas, esqueletos, tokens de movimento, transições reversíveis). Corrija cada um pelo seu padrão em
reference.mdemotion.md, através dos próprios componentes e tokens do projeto, com um teste para qualquer lógica. - Itens Escolher mudam a aparência ou o produto (cantos, placeholders desfocados, desfazer em vez de confirmar, um batimento de erro, um novo batimento de movimento, uma transição de visualização). Avalie cada um como antes e depois na escala 1 em ambos os temas, numerados e separáveis; construa apenas o que o proprietário escolher.
- Nunca troque decoração removida por nova decoração.
Passo 3: verificar
Execute novamente o censo e o probe e compare os números com o relatório. Dirija cada interação corrigida da maneira que um usuário faria, em ambos os temas, e separadamente na largura de telefone. Relate construído, testado, aprovado visualmente e implantado como fatos separados, e nomeie o que não pôde ser medido (sem telefone físico, sem build de produção).
A checklist
Os números correspondem a reference.md e ao relatório.
| # | Item | Falha quando |
|---|---|---|
| A | Princípios de animação (motion.md) | |
| 1 | Squash e stretch | um badge, ponto ou botão de aterrissagem para morto |
| 2 | Antecipação | um pressionamento não tem estado dentro de um quadro (escala cerca de 0.97, cerca de 100 ms) |
| 3 | Encenação | uma camada aberta deixa a coisa primária pouco clara |
| 4 | Pose para pose | um botão ocupado, rótulo ou troca de ícone pula em largura ou conteúdo |
| 5 | Continuidade | o conteúdo de uma camada chega soldado ao seu contêiner |
| 6 | Entrada lenta, saída lenta | linear ou ease padrão em movimento de UI; mais de três easings |
| 7 | Arcos | algo viaja longe em linha reta |
| 8 | Ação secundária | uma ação concluída não tem um segundo batimento de confirmação |
| 9 | Tempo rápido | uma resposta de UI acima de 300 ms; uma superfície fora de seus pares; saídas não mais curtas |
| 10 | Feedback exagerado | um envio inválido mostra apenas um tremor, sem batimento de cor |
| 11 | Desenho sólido | sombras e camadas discordam sobre luz e profundidade |
| 12 | Apelo | um fluxo real, em etapas na escala 1, mostra uma emenda |
| B | Leis de UX | |
| 13 | Fitts | um alvo real abaixo de 32 px no desktop ou 44 px em um telefone |
| 14 | Áreas de clique maiores | alvos ampliados aumentando a imagem, ou irmãos sobrepostos |
| 15 | Hick | mais de cinco itens em um bloco de menu |
| 16 | Miller | mais de cerca de sete itens de nível superior não agrupados |
| 17 | Doherty | pressionar até a próxima pintura acima de 400 ms sem nada respondendo primeiro |
| 18 | Postel | uma variante de acento, maiúscula/minúscula ou espaçamento de uma consulta não encontra nada |
| 19 | Jakob | um padrão se comporta de maneira diferente de sua plataforma (submenu hover, voltar fecha uma camada) |
| 20 | Frequência de uso | uma ação diária está a mais de um passo ou um comando de distância |
| C | Velocidade e feedback | |
| 21 | Carregadores esqueleto | uma rota pinta em branco ou um spinner no quadro do clique |
| 22 | Atualizações otimistas | uma gravação reversível barata não mostra nada até o servidor responder |
| 23 | Menu de comandos | um destino é alcançável clicando, mas não digitando |
| 24 | Dicas de atalho | um controle com um atalho não o mostra em sua dica de ferramenta |
| 25 | Toasts de desfazer | uma exclusão restaurável não tem desfazer (o proprietário decide se substitui uma confirmação) |
| 26 | Stale-while-revalidate | uma página revisitada espera em vez de pintar seus últimos dados |
| 27 | Pré-renderização | uma página provável seguinte não é pré-buscada com intenção (julgue em produção) |
| 28 | Placeholders desfocados | uma imagem carregando é uma caixa cinza |
| 29 | Transições de visualização | uma abertura de grade para detalhes não tem morph de elemento compartilhado |
| 30 | Deslizar para dispensar | uma folha ou gaveta de telefone não pode ser fechada deslizando |
| 31 | Animações interrompíveis | reabrir durante uma saída reproduz a partir de zero |
| D | Plataforma e detalhe | |
| 32 | Volta preditiva | Voltar do Android com uma camada aberta sai da página |
| 33 | Hit slop | controles de ícone pequenos não têm crescimento de alvo invisível |
| 34 | Insetos de área segura | floats inferiores ignoram env(safe-area-inset-*) com viewport-fit=cover |
| 35 | Preenchimento automático de código único | um campo de código não tem autocomplete="one-time-code" e inputmode="numeric" |
| 36 | Números tabulares | figuras variáveis tremem (sem tabular-nums) |
| 37 | Títulos equilibrados | um título curto de várias linhas deixa um órfão (sem text-wrap: balance) |
| 38 | Cantos contínuos | cantos squircle não considerados (uma decisão de aparência: avalie) |
| E | Confiança | |
| 39 | Chaves de idempotência | dois pressionamentos rápidos de uma ação paga ou irreversível fazem dois efeitos no servidor |
| 40 | Triângulo seguro | um submenu hover fecha com um movimento diagonal em direção a ele |
Erros comuns
- Adicionar o que já existe: esqueletos, cache e tokens de movimento geralmente já estão; o veredito é presente.
- Deduplicação no cliente como guardião do dinheiro: dois cliques chegam antes de um re-renderizar desabilitar o botão. Proteja no servidor (atualização condicional, chave determinística, bloqueio) e segure o pressionamento em uma ref.
- Aumentar a imagem em vez do alvo; verificar alvos apenas na largura do desktop enquanto uma regra de desktop mata o mínimo do telefone.
- Keyframes para abrir e fechar: eles não podem reverter. Use transições em um atributo de estado, e torne uma camada de saída
inert. - Tratar desfazer, cantos ou tom de erro como escolhas de engenharia. Eles pertencem ao proprietário.
- Julgar pré-busca ou tempo em um servidor de desenvolvimento ou em uma aba de segundo plano.