Oil UI
Método de design · Revisão às cegas em tela real

Capturas em viewport real e revisão visual às cegas com subagente para UI de IA

Um agente lendo seu próprio JSX e classes Tailwind vai relatar com satisfação que uma tela parece "limpa e equilibrada" enquanto a renderização real no navegador sofre com quebras de título em três linhas, rótulos cinza-no-escuro ilegíveis e uma grade torta. O Oil UI trata a renderização ao vivo no navegador e a crítica de subagente sem contexto como etapas obrigatórias antes de considerar qualquer interface pronta.

Pontos principais

Código-fonte não é a interface

julgue layouts exclusivamente por pixels reais renderizados no navegador nos viewports-alvo (1440×900, 390×844, 1920×720).

Ponto-chave 2

O agente que escreveu o código tem viés a favor das próprias intenções; iniciar um subagente novo que vê apenas as capturas produz crítica honesta.

Inspecione três visões

capturas inteiras em 100% para ritmo, recortes em 200% para alinhamento e disciplina de bordas e imagens com texto borrado para peso dos blocos.

Ponto-chave 4

Capturas verificam o acabamento estático, enquanto clicar e digitar pela página ao vivo confirma que estados, gavetas e recuperação de erros realmente funcionam.

Entre Páginas · Editora IndependenteEdição 07 · Outono

Acerto de Colaboradores

Vence em 20 nov
Total em aberto¥8,640.00
2 prontos · 1 aguardando dados bancários
Colaborador e peçaValor líquido (¥)Status
Lin YaoCaminhada junto à água · Ensaio3,200.00Pronto
Chen ZhouO outro lado dos objetos · Foto2,880.00Pronto
Xu NanEstudos de pátio · Ilustração2,560.00Faltam dados bancários
Registros incompletos passam para o próximo ciclo
Instale a Oil UI Skill gratuita e de código aberto
npx skills add oil-oil/oil-ui

Exige um modelo capaz de ler imagens e um ambiente local de navegador que consiga renderizar e capturar páginas.

Por que a inspeção do código-fonte deixa escapar defeitos visuais

No código-fonte, uma linha flex com justify-between parece arrumada. Em um viewport real de 390px com um título de produto de 32 caracteres e três botões de ação, essa mesma linha esmaga os botões em pílulas altas e ilegíveis. Da mesma forma, classes de cor no código não revelam quando o texto secundário desaparece sobre um fundo escuro.

Muitos dos detalhes mais nítidos na galeria do Oil UI dependem do comportamento exato no viewport: no Yantu (infotainment automotivo em 1920×720), aproximar-se de uma curva amplia a orientação de navegação e atenua os controles de mídia; no Splitwater (relógio de natação em 198×242, DPR=4), um único numeral gigante domina a tela molhada; no Forkside (aulas de xadrez), fazer o lance certo de cavalo ilumina duas linhas simultâneas de ataque duplo. Só a renderização ao vivo confirma que esses estados se sustentam.

As quatro camadas de verificação visual no Oil UI
Camada de inspeçãoComo funcionaQuais defeitos detecta
Captura de viewport em 100%Capturas em tela cheia e rolagem completa em 1440×900 (desktop) ou 390×844 (mobile)Ações principais enterradas, alturas de seção monótonas, ritmo de rolagem quebrado e rodapés cortados
Recortes de detalhe em 200%Recortes com zoom de 2× em cabeçalhos, linhas de tabela, campos de formulário e planos de preçoBordas duplas, colunas numéricas desalinhadas, padding inconsistente e legendas com baixo contraste
Checagem de estrutura de blocos borradaTexto borrado ou reduzido para que apenas massas espaciais e cores de destaque fiquem visíveisLayouts pesados no topo ou desequilibrados, cores de destaque competindo e grades uniformes de caixas idênticas
Percurso interativo ao vivoClicar, digitar, arrastar controles deslizantes e provocar estados de erro no navegadorBotões mortos, popovers cobrindo contexto crítico, recuperação de validação quebrada e estado dessincronizado

Como funciona a revisão às cegas por subagente sem contexto

Peça ao agente autor para criticar a própria captura de tela e ele geralmente vai racionalizar seus erros porque se lembra do prompt que tentou atender.

O Oil UI quebra esse viés de confirmação iniciando um subagente separado que recebe zero código-fonte e zero histórico de implementação — apenas os arquivos PNG renderizados e uma frase resumindo o que é o produto. Agindo como um usuário exigente de primeira viagem, o revisor às cegas aponta espaçamento apertado, clichês residuais de IA e contraste fraco.

  1. Capture telas determinísticas de cada estado obrigatório

    O agente principal abre a página em execução em um navegador headless e captura a visão padrão, os estados ativos de interação e os breakpoints mobile.

  2. Entregue as imagens a um subagente novo sem contexto de código

    O revisor inspeciona as capturas frente aos critérios de legibilidade, hierarquia e anti-slop do Oil UI e devolve uma lista concreta de defeitos visuais.

  3. Corrija defeitos, subtraia excesso e capture novamente

    O agente principal resolve cada problema apontado no código e tira uma nova captura para verificar a correção antes de concluir a tarefa.

Modelo de prompt para acionar uma revisão às cegas por captura

Sempre que um rascunho de tela funcionar na lógica, mas ainda parecer um pouco estranho, rode esta etapa de revisão:

Prompt de captura em viewport real e revisão às cegas por subagente
Execute uma verificação visual do Oil UI e uma revisão às cegas por subagente na tela atual:
1. Abra a página ao vivo em um navegador local e capture telas em 1440×900 (desktop) e 390×844 (mobile), cobrindo o estado padrão e [Estado 1 / Estado 2].
2. Inicie um subagente novo sem contexto de código. Passe apenas as capturas e o resumo do produto, e peça que critique: clichês residuais de template de IA, texto com baixo contraste, padding apertado, colunas desalinhadas e foco pouco claro na primeira tela.
3. Corrija todos os problemas apontados pelo revisor às cegas e capture novamente as telas para confirmar.

Funciona automaticamente em agentes que suportam subagentes e inspeção de imagens, como Claude Code e Codex.

Exemplos funcionais e prompts da galeria

Explorar coleção →
Oil UI Pro

Oil UI Pro: até 3 rodadas de revisão às cegas 9/10 antes de publicar

A Skill gratuita executa uma única passagem de revisão para bugs óbvios de layout. Para lançamentos voltados ao cliente, o Oil UI Pro adiciona checagens de acabamento anti-slop, percursos interativos ao vivo e polimento profundo opcional de até 3 rodadas visando 9/10 ($19.99 pagamento único, atualizações vitalícias).

Explorar o Oil UI Pro →
Copiar prompt de instalação do Pro
npx github:oil-oil/oil-cli install oil-ui-pro

Perguntas frequentes

O que acontece se o ambiente do meu agente não conseguir abrir um navegador ou inspecionar imagens?

O enquadramento de brief, orientação por categoria e regras anti-slop do Oil UI ainda ajudam durante a geração de código, mas sem navegador real e inspeção de imagens o agente não enxerga pixels renderizados nem roda revisões visuais às cegas. Para melhores resultados, combine o Oil UI com Playwright ou ferramenta local de navegador.

Por que inspecionar recortes com zoom de 200% além de capturas de página inteira?

Capturas de página inteira comprimem tabelas densas e controles de formulário o bastante para esconder desalinhamentos de 1px, bordas colidindo e texto secundário turvo. Recortar controles-chave em 200% torna erros de microtipografia e espaçamento impossíveis de ignorar.

O que borrar ou mascarar o texto revela durante uma revisão?

Quando você não consegue mais ler as palavras, para de perdoar um layout fraco porque o texto parece inteligente. Visões de blocos borrados expõem imediatamente se a ação principal se destaca e se o peso visual está equilibrado pelo canvas.

De quantas rodadas de revisão às cegas uma tela típica precisa?

Uma a duas rodadas pegam a grande maioria dos problemas de espaçamento, contraste e clichês em telas comuns. Para landing pages principais ou workspaces complexos, o ciclo de três rodadas do Oil UI Pro leva o acabamento visivelmente mais longe.

Guias relacionados

Guia de design de UI no Claude Code ↗Guia de design de UI no Codex ↗Corrigindo UI genérica de IA ↗