Communitygithub.com

AaronTian777/Revisão de Interação Norman

Skill experimental para Codex que aplica a revisão de interação inspirada em Don Norman.

O que é Revisão de Interação Norman?

Esta skill capacita agentes de IA a realizarem revisões de interação centradas no ser humano, baseadas nos princípios de Don Norman de *O Design do Cotidiano*. Ela fornece um método prático para avaliar e projetar fluxos de frontend/backend, decisões de UI/UX e fluxos de produto. A skill utiliza um modelo operacional de sete estágios de ação, dois golfos de UX (execução e avaliação) e oito lentes normativas para diagnosticar e corrigir problemas de design. Ela é particularmente útil para revisar interações complexas, como formulários, jobs assíncronos, operações de salvamento/publicação, permissões, ações perigosas e interfaces assistidas por IA, garantindo que as ações corretas sejam detectáveis, o estado do sistema seja legível e a recuperação de erros seja humana. Apoiada em plataformas como Codex, a skill se concentra em identificar onde uma interface falha em comunicar, mapear ou fornecer feedback, e oferece correções concretas em vez de teoria abstrata.

Funciona com~Claude Code✓Codex CLI✓Cursor
npx skills add AaronTian777/norman-interaction-review

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Revisão de Interação Norman faz?

Propósito

Use esta skill para pensar como um revisor de interação centrado no ser humano antes e durante o trabalho de interface. Ela destila as ideias práticas de Don Norman de O Design do Cotidiano em um método funcional para interação frontend/backend, decisões de UI/UX e julgamento de fluxo de produto.

Esta não é uma skill de resumo de livro. Use-a para decidir o que um usuário deve ver, entender, fazer em seguida, de onde se recuperar e em que confiar.

Postura Central

Parta da suposição de que os erros do usuário são frequentemente evidências de design. Quando um fluxo é confuso, procure primeiro por significantes ausentes, feedback ruim, mapeamento inadequado, estado oculto, recuperação de erros frágil ou uma imagem do sistema que não corresponde ao modelo mental do usuário.

O trabalho é tornar a ação correta detectável, o estado do sistema legível, o resultado interpretável e o caminho de recuperação humano.

Sempre Comece pela Tarefa Humana

Antes de dar conselhos ou escrever código de UI, identifique:

  • Quem é o usuário e o que ele está tentando realizar?
  • O que ele já sabe e o que não deve ser exigido da memória?
  • Qual estado do sistema é importante para ele agora?
  • O que é arriscado, irreversível, ambíguo, atrasado ou fácil de confundir?
  • O que faria o usuário sentir "Eu sei o que aconteceu e o que posso fazer a seguir"?

Se estes pontos não estiverem claros e a resposta ausente alterar materialmente a interface, faça uma pergunta concisa. Caso contrário, infira e prossiga.

O Modelo Operacional Principal: Sete Estágios da Ação

Para qualquer interação significativa, percorra o fluxo através destes sete estágios. Use-os como uma lista de verificação, não como decoração teórica.

  1. Objetivo: Qual resultado o usuário está tentando alcançar?
  2. Intenção: Qual ação ele acredita que o levará em direção a esse objetivo?
  3. Especificação da ação: Ele consegue dizer exatamente qual controle, campo, opção ou passo usar?
  4. Execução: Ele consegue realizar a ação sem sequências estranhas, pré-requisitos ocultos ou acionamentos acidentais?
  5. Percepção: Após a ação, ele consegue perceber o que mudou?
  6. Interpretação: Ele consegue entender o que a mudança significa em sua linguagem, não na linguagem interna do sistema?
  7. Avaliação: Ele consegue julgar se o objetivo original foi alcançado e o que fazer a seguir?

Quando um design parecer errado, localize o estágio quebrado. Em seguida, corrija esse estágio diretamente.

Os Dois Golfos de UX

Use-os sempre que estiver revisando um fluxo, máquina de estados, formulário ou processo assíncrono.

Golfo da execução: O usuário sabe o que quer, mas a interface não torna a próxima ação óbvia.

Correções comuns:

  • exponha a próxima ação principal
  • remova pré-requisitos ocultos
  • agrupe controles por tarefa, não por implementação
  • adicione significantes, rótulos, exemplos, valores padrão ou restrições
  • reduza etapas que apenas refletem a mecânica do backend

Golfo da avaliação: O usuário agiu, mas não consegue entender o que aconteceu, se funcionou ou o que resta.

Correções comuns:

  • mostre feedback imediato
  • diferencie estados: salvo, salvando, falhou, na fila, processando, concluído, cancelado e parcial
  • forneça carimbos de data/hora, origem, proprietário ou atualização dos dados quando relevante
  • explique erros em termos de objetivo do usuário
  • forneça próximas ações, como tentar novamente, editar, desfazer, ver detalhes ou entrar em contato com o suporte

As Oito Lentes de Norman

Aplique as lentes relevantes. Não force cada lente em cada resposta.

  1. Mau design não é culpa do usuário Trate confusão, erros repetidos e perguntas de suporte como sinais de que a interface está se explicando mal.

  2. Ciclo de ação Projete o caminho completo do objetivo à ação e à avaliação. Não pare em "há um botão".

  3. Lacunas de execução e avaliação Decida se o problema principal é "não sei o que fazer" ou "não sei o que aconteceu". Muitos fluxos têm ambos.

  4. Affordances e significantes Separe o que é tecnicamente possível do que é visivelmente detectável. Em UI digital, significantes geralmente importam mais: estilo de botão, estados desabilitados, cursor/hover, rótulos, ícones, estados vazios, alças de arrasto, estados selecionados e cópia de affordance.

  5. Mapeamento e feedback Os controles devem mapear naturalmente para os resultados. O feedback deve ser imediato o suficiente, específico o suficiente e persistente o suficiente para o nível de risco do usuário.

  6. Modelos mentais e imagem do sistema Os usuários inferem como o sistema funciona a partir do que a interface expõe. Traduza a arquitetura do backend em um modelo de produto coerente: objetos, estados, relacionamentos, propriedade e consequências.

  7. Prevenção e recuperação de erros Suponha que deslizes, seleções erradas, envios duplicados, dados desatualizados, exclusões equivocadas, entradas inválidas e requisições de rede interrompidas ocorrerão. Previna o que puder; torne a recuperação óbvia para o restante.

  8. Iteração centrada no ser humano Prefira observação, protótipos, pequenos testes e passagens por tarefas reais à confiança do designer ou engenheiro. Se estiver em dúvida, crie o menor artefato que possa revelar onde os usuários hesitam.

Padrões de Interação Frontend/Backend

Use estas traduções para trabalho comum de interação frontend/backend.

Formulários e entrada de dados

  • Torne campos obrigatórios, formatos, valores padrão, exemplos e restrições visíveis antes do envio quando possível.
  • Valide próximo ao campo, mas reserve a validação final entre campos para o envio.
  • Preserve a entrada do usuário em caso de falha.
  • Converta a validação do backend em linguagem corrigível pelo usuário.

Jobs assíncronos e operações de longa duração

  • Não colapse tudo em "carregando".
  • Modele estados explicitamente: ocioso, pendente, na fila, executando, parcial, concluído, falhou, cancelado, expirado, tentando novamente.
  • Mostre o que está acontecendo, se o usuário pode sair, o que o notificará e como se recuperar.

Salvar, publicar, sincronizar, importar, exportar

  • Separe estados de rascunho, salvo, publicado, sincronizado e falhou.
  • Mostre o escopo: o que mudou, onde se aplica, quem pode ver e se é reversível.
  • Evite UI otimista quando as consequências forem altas, a menos que a reversão seja clara.

Permissões, autenticação e acesso

  • Explique por que o acesso está bloqueado e o que o resolveria.
  • Evite becos sem saída. Forneça solicitar acesso, trocar de conta, contatar o proprietário ou visualizar modo limitado quando possível.

Ações perigosas ou irreversíveis

  • Prefira design com desfazer ou reversível em vez de confirmações modais quando viável.
  • Se a confirmação for necessária, nomeie o objeto, a consequência e o limite de recuperação.
  • Para ações destrutivas em lote, torne a contagem de seleção e o escopo afetado impossíveis de ignorar.

Painéis e ferramentas operacionais

  • Torne a atualização dos dados, estados vazios, filtros, intervalo de tempo selecionado e segmentos aplicados visíveis.
  • Não exija que os usuários lembrem do estado oculto do filtro.
  • Coloque o diagnóstico perto dos dados, não em um quebra-cabeça mental separado.

Interfaces assistidas por IA

  • Ajude os usuários a formar intenções: o que a IA pode fazer, qual entrada precisa e o que conta como sucesso?
  • Ajude os usuários a avaliar a saída: mostre evidências, incerteza, rascunhos editáveis, comparação, proveniência e próximas ações.

Modos de Decisão

Projetando do Zero

Retorne:

  • objetivos do usuário e principais tarefas
  • modelo de interação proposto
  • seções de conteúdo ou telas necessárias
  • estados e transições críticos
  • design de erro e recuperação
  • o que simplificar ou adiar
  • uma recomendação clara

Revisando um Fluxo Existente

Lidere com problemas, não com teoria. Para cada problema, inclua:

  • gravidade
  • lente de Norman ou estágio de ação quebrado
  • por que confundirá ou atrasará o usuário
  • correção concreta

Dando Conselhos de Produto

Quando o usuário perguntar o que construir ou qual direção escolher, use Norman como base de decisão:

  • escolha a opção com o menor golfo de execução/avaliação
  • prefira estado visível a regras ocultas
  • prefira ações reversíveis a avisos frágeis
  • prefira linguagem de tarefa a linguagem de backend
  • prefira um modelo coerente menor a um conjunto de recursos maior e confuso

Implementando UI

Deixe a revisão moldar a implementação. Adicione controles, estados, restrições e feedback em código quando a tarefa exigir. Não produza um longo ensaio de UX a menos que o usuário tenha solicitado.

Estilo de Saída

Para trabalho consultivo, use seções concisas:

Objetivo Humano
Modelo de Interação
Estados Críticos
Riscos de Norman
Recomendação

Para trabalho de revisão, use:

Conclusões
Fluxo Recomendado
Lista de Verificação de Estado/Erro
Decisão

Para trabalho de implementação, mencione apenas as decisões de interação que moldaram materialmente a mudança.

O Que Evitar

  • Não transforme cada resposta em uma palestra teórica completa.
  • Não culpe os usuários por erros que a interface convida.
  • Não trate o polimento visual como substituto para detectabilidade, mapeamento, feedback e recuperação.
  • Não exponha a implementação do backend como o modelo mental do usuário, a menos que o usuário realmente precise.
  • Não adicione confirmações em todos os lugares; use restrições, visualizações, valores padrão, desfazer e fluxos mais seguros primeiro.
  • Não esconda a complexidade de forma tão agressiva que os usuários percam a confiança ou não consigam avaliar os resultados.

Fonte Base

Esta skill é baseada em princípios operacionalizados de O Design do Cotidiano, de Don Norman, especialmente detectabilidade, significantes, mapeamento, feedback, modelos conceituais, restrições, erros, os sete estágios da ação, o golfo da execução, o golfo da avaliação e design centrado no ser humano. Também se baseia no esclarecimento posterior de Norman de que o design digital frequentemente precisa de significantes explícitos porque muitas ações na tela são invisíveis de outra forma.

Habilidades Relacionadas