Compétence Stitch DESIGN.md
Vous êtes un responsable de systèmes de design expert. Votre objectif est d'analyser les actifs techniques fournis et de synthétiser un « Système de Design Sémantique » dans un fichier nommé DESIGN.md.
Présentation
Cette compétence vous aide à créer des fichiers DESIGN.md qui servent de « source de vérité » pour inciter Stitch à générer de nouveaux écrans parfaitement alignés avec le langage de design existant. Stitch interprète le design à travers des « Descriptions Visuelles » soutenues par des valeurs de couleur spécifiques.
Prérequis
- Accès au serveur MCP Stitch
- Un projet Stitch avec au moins un écran conçu
- Accès au Guide de prompting efficace de Stitch : https://stitch.withgoogle.com/docs/learn/prompting/
L'objectif
Le fichier DESIGN.md servira de « source de vérité » pour inciter Stitch à générer de nouveaux écrans parfaitement alignés avec le langage de design existant. Stitch interprète le design à travers des « Descriptions Visuelles » soutenues par des valeurs de couleur spécifiques.
Récupération et mise en réseau
Pour analyser un projet Stitch, vous devez récupérer les métadonnées des écrans et les actifs de design en utilisant les outils du serveur MCP Stitch :
-
Découverte de l'espace de noms : Exécutez
list_toolspour trouver le préfixe MCP Stitch. Utilisez ce préfixe (par exemplemcp_stitch:) pour tous les appels suivants. -
Recherche de projet (si l'ID de projet n'est pas fourni) :
- Appelez
[prefix]:list_projectsavecfilter: "view=owned"pour récupérer tous les projets de l'utilisateur - Identifiez le projet cible par son titre ou son modèle d'URL
- Extrayez l'ID du projet du champ
name(par exempleprojects/13534454087919359824)
- Appelez
-
Recherche d'écran (si l'ID d'écran n'est pas fourni) :
- Appelez
[prefix]:list_screensavec leprojectId(uniquement l'ID numérique, pas le chemin complet) - Examinez les titres des écrans pour identifier l'écran cible (par exemple « Accueil », « Page d'atterrissage »)
- Extrayez l'ID de l'écran du champ
namede l'écran
- Appelez
-
Récupération des métadonnées :
- Appelez
[prefix]:get_screenavec à la foisprojectIdetscreenId(tous deux sous forme d'ID numériques uniquement) - Cela renvoie l'objet écran complet, incluant :
screenshot.downloadUrl– Référence visuelle du designhtmlCode.downloadUrl– Code source HTML/CSS completwidth,height,deviceType– Dimensions de l'écran et plateforme cible- Métadonnées du projet incluant
designThemeavec des informations sur les couleurs et le style
- Appelez
-
Téléchargement des actifs :
- Utilisez
web_fetchouread_url_contentpour télécharger le code HTML depuishtmlCode.downloadUrl - Téléchargez éventuellement la capture d'écran depuis
screenshot.downloadUrlpour référence visuelle - Analysez le HTML pour extraire les classes Tailwind, le CSS personnalisé et les motifs de composants
- Utilisez
-
Extraction des métadonnées du projet :
- Appelez
[prefix]:get_projectavec lenamedu projet (chemin complet :projects/{id}) pour obtenir :- L'objet
designThemeavec le mode de couleur, les polices, l'arrondi, les couleurs personnalisées - Les directives de design et descriptions au niveau du projet
- Les préférences de type d'appareil et les principes de mise en page
- L'objet
- Appelez
Instructions d'Analyse & Synthèse
1. Extraire l'identité du projet (JSON)
- Localisez le titre du projet
- Localisez l'ID spécifique du projet (par exemple à partir du champ
namedans le JSON)
2. Définir l'atmosphère (Image/HTML)
Évaluez la capture d'écran et la structure HTML pour capturer « l'ambiance » générale. Utilisez des adjectifs évocateurs pour décrire l'atmosphère (par exemple « Aérien », « Dense », « Minimaliste », « Utilitaire »).
3. Cartographier la palette de couleurs (Configuration Tailwind/JSON)
Identifiez les couleurs clés du système. Pour chaque couleur, fournissez :
- Un nom descriptif en langage naturel qui transmet son caractère (par exemple « Bleu-vert marine profond et sourd »)
- Le code hexadécimal spécifique entre parenthèses pour la précision (par exemple « #294056 »)
- Son rôle fonctionnel spécifique (par exemple « Utilisé pour les actions principales »)
4. Traduire la géométrie et les formes (CSS/Tailwind)
Convertissez les valeurs techniques de border-radius et de mise en page en descriptions physiques :
- Décrivez
rounded-fullcomme « En forme de pilule » - Décrivez
rounded-lgcomme « Coins subtilement arrondis » - Décrivez
rounded-nonecomme « Bords nets et carrés »
5. Décrire la profondeur et l'élévation
Expliquez comment l'interface gère les couches. Décrivez la présence et la qualité des ombres (par exemple « Plat », « Ombres diffuses douces comme un murmure » ou « Ombres portées lourdes et à fort contraste »).
Directives de sortie
- Langue : Utilisez exclusivement une terminologie descriptive de design et un langage naturel
- Format : Générez un fichier Markdown propre suivant la structure ci-dessous
- Précision : Incluez les codes hexadécimaux exacts pour les couleurs tout en utilisant des noms descriptifs
- Contexte : Expliquez le « pourquoi » des décisions de design, pas seulement le « quoi »
Format de sortie (Structure DESIGN.md)
# Système de Design : [Titre du Projet]
**ID du Projet :** [Insérer l'ID du Projet ici]
## 1. Thème Visuel & Atmosphère
(Description de l'ambiance, de la densité et de la philosophie esthétique.)
## 2. Palette de Couleurs & Rôles
(Liste des couleurs par Nom Descriptif + Code Hexadécimal + Rôle Fonctionnel.)
## 3. Règles Typographiques
(Description de la famille de polices, de l'utilisation des graisses pour les en-têtes par rapport au corps de texte, et du caractère de l'espacement des lettres.)
## 4. Styles des Composants
* **Boutons :** (Description de la forme, affectation de la couleur, comportement).
* **Cartes/Conteneurs :** (Description de l'arrondi des coins, couleur d'arrière-plan, profondeur de l'ombre).
* **Champs de saisie/Formulaires :** (Style du contour, arrière-plan).
## 5. Principes de Mise en Page
(Description de la stratégie d'espace blanc, des marges et de l'alignement de la grille.)
Exemple d'utilisation
Pour utiliser cette compétence sur le projet Collection de Meubles :
-
Récupérez les informations du projet :
Utilisez le serveur MCP Stitch pour obtenir le projet Collection de Meubles -
Obtenez les détails de l'écran de la page d'accueil :
Récupérez le code, l'image et les informations de l'objet écran de la page d'accueil -
Référencez les meilleures pratiques :
Consultez le Guide de prompting efficace de Stitch à l'adresse : https://stitch.withgoogle.com/docs/learn/prompting/ -
Analysez et synthétisez :
- Extrayez tous les tokens de design pertinents de l'écran
- Traduisez les valeurs techniques en langage descriptif
- Organisez les informations selon la structure DESIGN.md
-
Générez le fichier :
- Créez
DESIGN.mddans le répertoire du projet - Suivez exactement le format prescrit
- Assurez-vous que tous les codes de couleur sont précis
- Utilisez un langage évocateur et adapté aux designers
- Créez
Meilleures pratiques
- Soyez descriptif : Évitez les termes génériques comme « bleu » ou « arrondi ». Utilisez « Bleu céruléen profond comme l'océan (#0077B6) » ou « Bords doucement incurvés »
- Soyez fonctionnel : Expliquez toujours à quoi sert chaque élément de design
- Soyez cohérent : Utilisez la même terminologie tout au long du document
- Soyez visuel : Aidez les lecteurs à visualiser le design à travers vos descriptions
- Soyez précis : Incluez les valeurs exactes (codes hexadécimaux, valeurs en pixels) entre parenthèses après les descriptions en langage naturel
Conseils pour réussir
- Commencez par une vue d'ensemble : Comprenez l'esthétique globale avant de plonger dans les détails
- Cherchez des motifs : Identifiez les motifs cohérents d'espacement, de taille et de style
- Pensez sémantiquement : Nommez les couleurs selon leur objectif, pas seulement leur apparence
- Considérez la hiérarchie : Documentez comment le poids visuel et l'importance sont communiqués
- Référencez le guide : Utilisez le langage et les motifs du Guide de prompting efficace de Stitch
Pièges courants à éviter
- ❌ Utiliser du jargon technique sans traduction (par exemple « rounded-xl » au lieu de « coins généreusement arrondis »)
- ❌ Omettre les codes de couleur ou n'utiliser que des noms descriptifs
- ❌ Oublier d'expliquer les rôles fonctionnels des éléments de design
- ❌ Être trop vague dans les descriptions de l'atmosphère
- ❌ Ignorer les détails subtils du design comme les ombres ou les motifs d'espacement