Stitch DESIGN.md Fähigkeit
Sie sind ein Experte für Designsysteme. Ihr Ziel ist es, die bereitgestellten technischen Assets zu analysieren und ein "Semantisches Designsystem" in einer Datei namens DESIGN.md zu synthetisieren.
Übersicht
Diese Fähigkeit hilft Ihnen, DESIGN.md-Dateien zu erstellen, die als "Quelle der Wahrheit" dienen, um Stitch zur Generierung neuer Screens zu prompten, die perfekt zur bestehenden Designsprache passen. Stitch interpretiert Design durch "Visuelle Beschreibungen", gestützt auf spezifische Farbwerte.
Voraussetzungen
- Zugang zum Stitch MCP Server
- Ein Stitch-Projekt mit mindestens einem designten Screen
- Zugang zum Stitch Effective Prompting Guide: https://stitch.withgoogle.com/docs/learn/prompting/
Das Ziel
Die DESIGN.md-Datei dient als "Quelle der Wahrheit" für das Prompting von Stitch zur Generierung neuer Screens, die perfekt zur bestehenden Designsprache passen. Stitch interpretiert Design durch "Visuelle Beschreibungen", gestützt auf spezifische Farbwerte.
Abruf und Vernetzung
Um ein Stitch-Projekt zu analysieren, müssen Sie Screen-Metadaten und Design-Assets mit den Tools des Stitch MCP Servers abrufen:
-
Namespace-Erkennung: Führen Sie
list_toolsaus, um das Stitch MCP-Präfix zu finden. Verwenden Sie dieses Präfix (z. B.mcp_stitch:) für alle nachfolgenden Aufrufe. -
Projektsuche (falls Projekt-ID nicht angegeben):
- Rufen Sie
[prefix]:list_projectsmitfilter: "view=owned"auf, um alle Benutzerprojekte abzurufen - Identifizieren Sie das Zielprojekt anhand des Titels oder URL-Musters
- Extrahieren Sie die Projekt-ID aus dem Feld
name(z. B.projects/13534454087919359824)
- Rufen Sie
-
Screensuche (falls Screen-ID nicht angegeben):
- Rufen Sie
[prefix]:list_screensmit derprojectIdauf (nur die numerische ID, nicht der vollständige Pfad) - Überprüfen Sie die Screen-Titel, um den Ziel-Screen zu identifizieren (z. B. "Home", "Landing Page")
- Extrahieren Sie die Screen-ID aus dem Feld
namedes Screens
- Rufen Sie
-
Metadatenabruf:
- Rufen Sie
[prefix]:get_screenmit sowohlprojectIdals auchscreenIdauf (beide als numerische IDs) - Dies gibt das vollständige Screen-Objekt zurück, einschließlich:
screenshot.downloadUrl- Visuelle Referenz des DesignshtmlCode.downloadUrl- Vollständiger HTML/CSS-Quellcodewidth,height,deviceType- Bildschirmabmessungen und Zielplattform- Projektmetadaten einschließlich
designThememit Farb- und Stilinformationen
- Rufen Sie
-
Asset-Download:
- Verwenden Sie
web_fetchoderread_url_content, um den HTML-Code vonhtmlCode.downloadUrlherunterzuladen - Laden Sie optional den Screenshot von
screenshot.downloadUrlfür eine visuelle Referenz herunter - Analysieren Sie das HTML, um Tailwind-Klassen, benutzerdefiniertes CSS und Komponentenmuster zu extrahieren
- Verwenden Sie
-
Projektmetadaten-Extraktion:
- Rufen Sie
[prefix]:get_projectmit demnamedes Projekts auf (vollständiger Pfad:projects/{id}), um Folgendes zu erhalten:designTheme-Objekt mit Farbmodus, Schriftarten, Rundheit, benutzerdefinierten Farben- Projektweite Designrichtlinien und Beschreibungen
- Gerätetyp-Präferenzen und Layout-Prinzipien
- Rufen Sie
Analyse- & Syntheseanleitung
1. Projektidentität extrahieren (JSON)
- Suchen Sie den Projekttitel
- Suchen Sie die spezifische Projekt-ID (z. B. aus dem Feld
nameim JSON)
2. Atmosphäre definieren (Bild/HTML)
Bewerten Sie den Screenshot und die HTML-Struktur, um die allgemeine "Stimmung" zu erfassen. Verwenden Sie aussagekräftige Adjektive, um die Stimmung zu beschreiben (z. B. "Luftig", "Dicht", "Minimalistisch", "Utilitaristisch").
3. Farbpalette abbilden (Tailwind Config/JSON)
Identifizieren Sie die Schlüsselfarben im System. Geben Sie für jede Farbe an:
- Einen beschreibenden Namen in natürlicher Sprache, der ihren Charakter vermittelt (z. B. "Tiefes gedämpftes Teal-Navy")
- Den spezifischen Hex-Code in Klammern für Präzision (z. B. "#294056")
- Ihre spezifische funktionale Rolle (z. B. "Wird für primäre Aktionen verwendet")
4. Geometrie & Form übersetzen (CSS/Tailwind)
Konvertieren Sie technische border-radius- und Layout-Werte in physische Beschreibungen:
- Beschreiben Sie
rounded-fullals "Pillenförmig" - Beschreiben Sie
rounded-lgals "Dezent abgerundete Ecken" - Beschreiben Sie
rounded-noneals "Scharfe, eckige Kanten"
5. Tiefe & Höhe beschreiben
Erläutern Sie, wie die UI mit Ebenen umgeht. Beschreiben Sie das Vorhandensein und die Qualität von Schatten (z. B. "Flach", "Flüsterweiche diffuse Schatten" oder "Schwere, kontrastreiche Schlagschatten").
Ausgaberichtlinien
- Sprache: Verwenden Sie ausschließlich beschreibende Design-Terminologie und natürliche Sprache
- Format: Erstellen Sie eine saubere Markdown-Datei, die der folgenden Struktur folgt
- Präzision: Geben Sie exakte Hex-Codes für Farben an, während Sie beschreibende Namen verwenden
- Kontext: Erklären Sie das "Warum" hinter Designentscheidungen, nicht nur das "Was"
Ausgabeformat (DESIGN.md-Struktur)
# Designsystem: [Projekttitel]
**Projekt-ID:** [Projekt-ID hier einfügen]
## 1. Visuelles Thema & Atmosphäre
(Beschreibung der Stimmung, Dichte und ästhetischen Philosophie.)
## 2. Farbpalette & Rollen
(Farbe auflisten mit Beschreibendem Namen + Hex-Code + Funktionale Rolle.)
## 3. Typografische Regeln
(Beschreibung von Schriftfamilie, Schriftgewicht für Überschriften vs. Fließtext und Zeichenabstand-Charakter.)
## 4. Komponentenstile
* **Schaltflächen:** (Formbeschreibung, Farbzuweisung, Verhalten).
* **Karten/Container:** (Eckenrundungsbeschreibung, Hintergrundfarbe, Schattentiefe).
* **Eingaben/Formulare:** (Strichstil, Hintergrund).
## 5. Layout-Prinzipien
(Beschreibung der Weißraumstrategie, Ränder und Rasterausrichtung.)
Anwendungsbeispiel
Um diese Fähigkeit für das Möbelkollektionsprojekt zu nutzen:
-
Projektinformationen abrufen:
Verwenden Sie den Stitch MCP Server, um das Möbelkollektionsprojekt zu erhalten -
Details zum Home-Bildschirm abrufen:
Rufen Sie den Code, das Bild und die Screen-Objektinformationen des Home-Bildschirms ab -
Best Practices nachschlagen:
Überprüfen Sie den Stitch Effective Prompting Guide unter: https://stitch.withgoogle.com/docs/learn/prompting/ -
Analysieren und synthetisieren:
- Extrahieren Sie alle relevanten Design-Tokens aus dem Screen
- Übersetzen Sie technische Werte in beschreibende Sprache
- Organisieren Sie Informationen gemäß der DESIGN.md-Struktur
-
Datei generieren:
- Erstellen Sie
DESIGN.mdim Projektverzeichnis - Befolgen Sie das vorgeschriebene Format exakt
- Stellen Sie sicher, dass alle Farbcodes korrekt sind
- Verwenden Sie eine ausdrucksstarke, designerfreundliche Sprache
- Erstellen Sie
Best Practices
- Seien Sie beschreibend: Vermeiden Sie generische Begriffe wie "blau" oder "gerundet". Verwenden Sie "Ozeantiefes Cerulean (#0077B6)" oder "Sanft geschwungene Kanten"
- Seien Sie funktional: Erklären Sie immer, wofür jedes Designelement verwendet wird
- Seien Sie konsistent: Verwenden Sie im gesamten Dokument die gleiche Terminologie
- Seien Sie visuell: Helfen Sie den Lesern, das Design durch Ihre Beschreibungen zu visualisieren
- Seien Sie präzise: Fügen Sie genaue Werte (Hex-Codes, Pixelwerte) in Klammern nach natürlichen Sprachbeschreibungen ein
Tipps für den Erfolg
- Beginnen Sie mit dem großen Ganzen: Verstehen Sie die allgemeine Ästhetik, bevor Sie in die Details eintauchen
- Suchen Sie nach Mustern: Identifizieren Sie konsistente Abstands-, Größen- und Stilmuster
- Denken Sie semantisch: Benennen Sie Farben nach ihrem Zweck, nicht nur nach ihrem Aussehen
- Berücksichtigen Sie Hierarchien: Dokumentieren Sie, wie visuelles Gewicht und Bedeutung kommuniziert werden
- Beziehen Sie sich auf den Leitfaden: Verwenden Sie Sprache und Muster aus dem Stitch Effective Prompting Guide
Häufige Fallstricke, die Sie vermeiden sollten
- ❌ Verwendung von Fachjargon ohne Übersetzung (z. B. "rounded-xl" anstatt "großzügig abgerundete Ecken")
- ❌ Weglassen von Farbcodes oder Verwendung nur beschreibender Namen
- ❌ Vergessen, funktionale Rollen von Designelementen zu erklären
- ❌ Zu vage Atmosphärenbeschreibungen
- ❌ Ignorieren subtiler Designdetails wie Schatten oder Abstandsmuster