Oil UI
Méthode de design · Revue à l'aveugle sur écran réel

Captures sur viewports réels et revue visuelle à l'aveugle par sous-agent pour UI IA

Un agent qui relit ses propres classes JSX et Tailwind affirme volontiers qu'un écran est « propre et équilibré » alors que le rendu réel dans le navigateur souffre de titres cassés sur trois lignes, de libellés gris illisibles sur fond sombre et d'une grille bancale. Oil UI impose le rendu navigateur réel et la critique par un sous-agent sans contexte comme étapes obligatoires avant de déclarer une interface terminée.

Points clés à retenir

Le code source n'est pas l'interface

jugez les mises en page exclusivement sur les vrais pixels rendus dans le navigateur aux viewports cibles (1440×900, 390×844, 1920×720).

À retenir 2

L'agent qui a écrit le code est biaisé en faveur de ses propres intentions ; lancer un nouveau sous-agent qui ne voit que les captures produit une critique honnête.

Inspectez trois vues

captures pleine page à 100 % pour le rythme, recadrages à 200 % pour l'alignement et la discipline des bordures, et images au texte flouté pour la masse des blocs.

À retenir 4

Les captures vérifient la tenue statique, tandis que cliquer et saisir dans la page active confirme que états, tiroirs et reprises d'erreur fonctionnent vraiment.

Entre Pages · Maison d’éditionNuméro 07 · Automne

Règlement des contributeurs

Échéance 20 nov.
Total restant dû¥8,640.00
2 prêts · 1 en attente de RIB
Contributeur et pièceMontant net (¥)Statut
Lin YaoMarche au bord de l’eau · Essai3,200.00Prêt
Chen ZhouL’envers des objets · Photo2,880.00Prêt
Xu NanÉtudes de cour · Illustration2,560.00RIB manquant
Les dossiers incomplets sont reportés automatiquement
Installer gratuitement le Skill open source Oil UI
npx skills add oil-oil/oil-ui

Nécessite un modèle capable d'analyser des images et un environnement navigateur local pour rendre et capturer les pages.

Pourquoi l'inspection du code source rate les défauts visuels

Dans le code source, une ligne flex avec justify-between a l'air soignée. Sur un vrai viewport de 390px avec un titre produit de 32 caractères et trois boutons d'action, cette même ligne écrase les boutons en pilules hautes et illisibles. De même, les classes de couleur dans le code ne montrent pas quand un texte secondaire disparaît sur fond sombre.

Beaucoup des détails les plus réussis de la galerie Oil UI reposent sur le comportement exact du viewport : dans Yantu (infodivertissement auto en 1920×720), l'approche d'un virage agrandit le guidage et atténue les contrôles média ; dans Splitwater (montre de natation en 198×242, DPR=4), un seul chiffre géant occupe l'écran mouillé ; dans Forkside (leçons d'échecs), jouer le bon coup de cavalier allume deux lignes d'attaque simultanées. Seul le rendu en direct confirme que ces états tiennent.

Les quatre niveaux de vérification visuelle dans Oil UI
Niveau d'inspectionComment cela fonctionneQuels défauts il détecte
Capture viewport à 100 %Captures pleine largeur et pleine hauteur à 1440×900 (bureau) ou 390×844 (mobile)Actions principales enfouies, hauteurs de sections monotones, rythme de défilement cassé et pieds de page rognés
Recadrages détail à 200 %Recadrages zoomés ×2 des en-têtes, lignes de tableaux, champs de formulaire et grilles tarifairesDoubles bordures, colonnes numériques mal alignées, marges incohérentes et légendes à faible contraste
Contrôle de structure en blocs floutésTexte flouté ou réduit pour ne laisser visibles que masses spatiales et touches de couleurMises en page déséquilibrées vers le haut ou bancales, accents concurrents et grilles uniformes de boîtes identiques
Parcours interactif en directCliquer, saisir, glisser les curseurs et provoquer les états d'erreur dans le navigateurBoutons inactifs, popovers masquant le contexte critique, reprise de validation cassée et états désynchronisés

Comment fonctionne la revue à l'aveugle par sous-agent sans contexte

Demandez à l'agent auteur de critiquer sa propre capture et il rationalisera presque toujours ses erreurs parce qu'il se souvient du prompt qu'il cherchait à satisfaire.

Oil UI brise ce biais de confirmation en lançant un sous-agent distinct qui ne reçoit aucun code source ni aucun historique d'implémentation — uniquement les captures PNG rendues et une phrase présentant le produit. Agissant comme un premier utilisateur exigeant, le relecteur à l'aveugle signale espacements étriqués, clichés IA résiduels et contrastes faibles.

  1. Capturer de manière déterministe chaque état requis

    L'agent principal ouvre la page active dans un navigateur headless et capture la vue par défaut, les états d'interaction actifs et les points de rupture mobiles.

  2. Confier les images à un nouveau sous-agent sans contexte de code

    Le relecteur examine les captures selon les critères de lisibilité, hiérarchie et sobriété d'Oil UI et renvoie une liste concrète de défauts visuels.

  3. Corriger les défauts, soustraire le superflu et recapturer

    L'agent principal résout chaque point signalé dans le code et prend une nouvelle capture pour confirmer la correction avant de terminer la tâche.

Modèle de prompt pour déclencher une revue à l'aveugle sur captures

Chaque fois qu'un brouillon fonctionne techniquement mais paraît encore un peu bancal, lancez cette passe de revue :

Prompt de capture sur viewports réels et revue par sous-agent à l'aveugle
Lance une vérification visuelle Oil UI et une revue par sous-agent à l'aveugle sur l'écran actuel :
1. Ouvre la page active dans un navigateur local et prends des captures en 1440×900 (bureau) et 390×844 (mobile), couvrant l'état par défaut et [État 1 / État 2].
2. Lance un nouveau sous-agent sans contexte de code. Ne lui transmets que les captures et le résumé du produit, et demande-lui de relever : restes de clichés de template IA, textes à faible contraste, marges étriquées, colonnes mal alignées et point focal peu clair au premier écran.
3. Corrige chaque point soulevé par le relecteur à l'aveugle et reprends des captures pour confirmer.

Fonctionne automatiquement dans les agents prenant en charge les sous-agents et l'inspection d'images, comme Claude Code et Codex.

Exemples fonctionnels et prompts de la galerie

Parcourir la collection →
Oil UI Pro

Oil UI Pro : jusqu'à 3 cycles de revue à l'aveugle visant 9/10 avant mise en ligne

Le skill gratuit exécute une seule passe de revue pour les bugs de mise en page évidents. Pour les lancements clients, Oil UI Pro ajoute contrôles anti-clichés, parcours interactifs en direct et finition optionnelle jusqu'à 3 cycles visant 9/10 ($19.99 en achat unique, mises à jour à vie).

Découvrir Oil UI Pro →
Copier le prompt d'installation Pro
npx github:oil-oil/oil-cli install oil-ui-pro

Questions fréquentes

Que se passe-t-il si mon environnement d'agent ne peut pas ouvrir de navigateur ni inspecter d'images ?

Le cadrage du brief, les repères par catégorie et les règles anti-clichés d'Oil UI restent utiles pendant la génération de code, mais sans vrai navigateur ni inspection d'images, l'agent ne peut pas voir les pixels rendus ni mener de revue visuelle à l'aveugle. Pour de meilleurs résultats, associez Oil UI à Playwright ou à un outil navigateur local.

Pourquoi inspecter des recadrages zoomés à 200 % en plus des captures pleine page ?

Les captures pleine page réduisent suffisamment les tableaux denses et contrôles de formulaire pour masquer des décalages de 1px, des bordures qui se touchent et des textes secondaires ternes. Recadrer les contrôles clés à 200 % rend évidentes les erreurs de micro-typographie et d'espacement.

Que révèle le floutage ou le masquage du texte pendant une revue ?

Dès qu'on ne peut plus lire les mots, on cesse de pardonner une mise en page faible sous prétexte que le texte sonne bien. Les vues en blocs floutés montrent aussitôt si l'action principale ressort et si le poids visuel est équilibré sur le canevas.

Combien de cycles de revue à l'aveugle faut-il pour un écran courant ?

Un à deux cycles suffisent pour corriger la grande majorité des problèmes d'espacement, de contraste et de clichés sur des écrans classiques. Pour des pages d'atterrissage phares ou des espaces de travail complexes, la boucle en trois cycles d'Oil UI Pro pousse nettement plus loin la finition.

Guides associés

Guide de design UI avec Claude Code ↗Guide de design UI avec Codex ↗Éliminer les clichés visuels de l'IA ↗