Atelier UI — Orchestrateur de conception
Gardez le contexte léger. Ne chargez jamais tous les modules à la fois — aiguillez vers un module de construction après la prise en charge, et déléguez les vérifications mécaniques aux scripts.
Dans les commandes et chemins ci-dessous, <skill> est le répertoire contenant ce fichier SKILL.md (par exemple ~/.gemini/config/skills/atelier-ui, %USERPROFILE%\.gemini\config\skills\atelier-ui sur Windows, ou .agents/skills/atelier-ui local à l'espace de travail). Mettez toujours entre guillemets "<skill>/..." dans les commandes shell pour que les chemins avec espaces fonctionnent.
Flux de travail
1. Sonder l'environnement (une seule fois)
Exécutez le scanner de capacités à la racine du projet :
node "<skill>/scripts/detect-env.mjs"
Ne présumez pas de l'existence d'outils externes (impeccable, agent-browser). Utilisez la sortie JSON (project.framework, project.devCommand, tools.impeccableCmd, tools.agentBrowser, tools.browserBinary, tools.cdpSupported) pour choisir la pile et le niveau de QA.
2. Prise en charge (1 tour, avec valeurs par défaut)
Lisez <skill>/modules/01-intake.md uniquement si une question essentielle reste ouverte.
- Posez toutes les questions manquantes en un seul message numéroté avec des valeurs par défaut (ou commencez immédiatement si l'utilisateur a fourni tous les détails ou a dit
"defaults"/"go ahead"). - Écrivez le plan arrêté dans
.atelier/BRIEF.mdpour que la compaction de contexte ne perde jamais les exigences.
3. Aiguiller vers UN module de construction
Choisissez le mode de surface à partir du brief et lisez uniquement ce fichier :
- Marque / Page d'atterrissage / Portfolio / Entreprise locale (
PersuaderouExpérience) : lisez<skill>/modules/02-brand-site.md. - SaaS / Tableau de bord / Docs / Application existante (
OpérerouLire) : lisez<skill>/modules/03-app-ui.md. - Monde 3D / WebGL / Shaders (
3D) : lisez<skill>/modules/04-3d-visual.md.
4. Socle de conception universel (toujours actif)
- Jetons plutôt que couleurs brutes : Utilisez des propriétés personnalisées CSS (
:root) ou les jetons Tailwind/thème existants du projet. - Pas de pièges de mise en page :
overflow-x: clipsurhtml, body(jamais100vw) ;minmax(0, 1fr)sur les pistes de grille d'images ;min-width: 0; overflow-wrap: break-wordsur les titres d'affichage. - Mouvement et accessibilité : Jamais
transition: all; animez uniquementtransform/opacity/clip-path/filter; ajoutez:focus-visibleet@media (prefers-reduced-motion: reduce). - Liste noire anti-bâclage : Pas de dégradés violet-à-bleu non mérités, pas de texte en dégradé sur le corps/les titres, pas de cartes imbriquées dans des cartes, pas d'accroches
01/02/03au-dessus des gros titres, pas d'émojis comme icônes UI, pas de témoignages, logos ou métriques inventés. - Contraste et états : Texte du corps >= 4,5:1, grand texte >= 3:1 ; chaque contrôle interactif couvre les états par défaut, survol, focus-visible, désactivé, chargement, vide et erreur.
- Copie propre : Les boutons sont
<Verbe> <Objet>(jamais le générique"En savoir plus"). Ne laissez jamais de texte de remplacement (Lorem ipsum,Acme,TODO).
(Les vérifications mécaniques se trouvent dans lint-ui.mjs et check-ui.mjs ; les règles de mise en page structurelles telles que les cartes imbriquées et minmax(0, 1fr) sont vérifiées par vous et le critique de niveau 3.)
5. Vérification et porte de contrôle critique
Après la construction, lisez <skill>/modules/05-qa-gate.md et exécutez l'échelle de QA :
- Lintage anti-bâclage statique (
tools.impeccableCmds'il est détecté, plusnode "<skill>/scripts/lint-ui.mjs" <target-dir>). - Vérification navigateur (
agent-browser, l'outil navigateur de votre environnement, ounode "<skill>/scripts/check-ui.mjs" <target> --out .atelier/shots --full --sheet) en desktop (1440x900) et mobile (390x844). - Vérification visuelle optionnelle par un critique sans contexte utilisant les captures d'écran (quand
Profondeur de QAestcriticoudeep).
Fichiers de cette compétence
Chemin (sous <skill>/) | Charger quand |
|---|---|
modules/01-intake.md | Étape 2 : clarifier les briefs ambigus et écrire .atelier/BRIEF.md |
modules/02-brand-site.md | Étape 3 : nouvelles pages marketing, d'entreprise, d'entreprise locale ou de portfolio |
modules/03-app-ui.md | Étape 3 : tableaux de bord, outils, docs ou raffinement d'applications existantes |
modules/04-3d-visual.md | Étape 3 : constructions Three.js, WebGL ou shader |
modules/05-qa-gate.md | Étape 5 : exécution des lintages, vérifications navigateur et revues critiques sans contexte |
library/themes.json | Étape 3 (02-brand-site) : traiter les associations de couleurs et de polices non génériques |
scripts/detect-env.mjs | Étape 1 : détection de la pile du projet et des outils CLI/navigateur installés |
scripts/lint-ui.mjs | Étape 5 : linteur anti-bâclage et du socle de conception intégré sans dépendance |
scripts/check-ui.mjs | Étape 5 : vérificateur du protocole Chrome DevTools (CDP) intégré sans dépendance |