Design implementieren
Überblick
Diese Fähigkeit bietet einen strukturierten Arbeitsablauf, um Figma-Designs mit pixelgenauer Präzision in produktionsreifen Code zu übersetzen. Sie gewährleistet eine konsistente Integration mit dem Figma MCP-Server, die ordnungsgemäße Verwendung von Design-Tokens und eine 1:1-Rückmeldungstreue zu den Designs.
Fähigkeitsgrenzen
- Verwenden Sie diese Fähigkeit, wenn das Ergebnis Code im Repository des Benutzers ist.
- Wenn der Benutzer darum bittet, Knoten innerhalb von Figma zu erstellen/bearbeiten/löschen, wechseln Sie zu figma-use.
- Wenn der Benutzer darum bittet, einen vollständigen Bildschirm in Figma aus Code oder einer Beschreibung zu erstellen oder zu aktualisieren, wechseln Sie zu figma-generate-design.
- Wenn der Benutzer nur nach Code Connect-Zuordnungen fragt, wechseln Sie zu figma-code-connect-components.
- Wenn der Benutzer darum bittet, wiederverwendbare Agentenregeln (
CLAUDE.md/AGENTS.md) zu verfassen, wechseln Sie zu figma-create-design-system-rules.
Voraussetzungen
- Der Figma MCP-Server muss verbunden und zugänglich sein.
- Der Benutzer muss eine Figma-URL im folgenden Format bereitstellen:
https://figma.com/design/:fileKey/:fileName?node-id=1-2:fileKeyist der Dateischlüssel1-2ist die Knoten-ID (die spezifische Komponente oder der Frame, die/der implementiert werden soll)
- ODER bei Verwendung von
figma-desktopMCP: Der Benutzer kann einen Knoten direkt in der Figma-Desktop-App auswählen (keine URL erforderlich). - Das Projekt sollte über ein etabliertes Designsystem oder eine Komponentenbibliothek verfügen (bevorzugt).
Erforderlicher Arbeitsablauf
Führen Sie die folgenden Schritte der Reihe nach aus. Überspringen Sie keine Schritte.
Schritt 1: Knoten-ID abrufen
Option A: Aus Figma-URL parsen
Wenn der Benutzer eine Figma-URL bereitstellt, extrahieren Sie den Dateischlüssel und die Knoten-ID, um sie als Argumente an die MCP-Tools zu übergeben.
URL-Format: https://figma.com/design/:fileKey/:fileName?node-id=1-2
Extrahieren:
- Dateischlüssel:
:fileKey(das Segment nach/design/) - Knoten-ID:
1-2(der Wert des Abfrageparametersnode-id)
Hinweis: Bei Verwendung des lokalen Desktop-MCP (figma-desktop) wird fileKey nicht als Parameter an Toolaufrufe übergeben. Der Server verwendet automatisch die aktuell geöffnete Datei, daher wird nur nodeId benötigt.
Beispiel:
- URL:
https://figma.com/design/kL9xQn2VwM8pYrTb4ZcHjF/DesignSystem?node-id=42-15 - Dateischlüssel:
kL9xQn2VwM8pYrTb4ZcHjF - Knoten-ID:
42-15
Option B: Aktuelle Auswahl aus der Figma-Desktop-App verwenden (nur figma-desktop MCP)
Bei Verwendung des figma-desktop MCP und wenn der Benutzer KEINE URL bereitgestellt hat, verwenden die Tools automatisch den aktuell ausgewählten Knoten aus der geöffneten Figma-Datei in der Desktop-App.
Hinweis: Die auswahlbasierte Abfrage funktioniert nur mit dem figma-desktop MCP-Server. Der entfernte Server benötigt einen Link zu einem Frame oder einer Ebene, um Kontext zu extrahieren. Der Benutzer muss die Figma-Desktop-App geöffnet haben und ein Knoten muss ausgewählt sein.
Schritt 2: Designkontext abrufen
Führen Sie get_design_context mit dem extrahierten Dateischlüssel und der Knoten-ID aus.
get_design_context(fileKey=":fileKey", nodeId="1-2")
Dies liefert die strukturierten Daten, einschließlich:
- Layout-Eigenschaften (Auto-Layout, Constraints, Größenanpassung)
- Typografie-Spezifikationen
- Farbwerte und Design-Tokens
- Komponentenstruktur und Varianten
- Abstände und Padding-Werte
Wenn die Antwort zu groß oder abgeschnitten ist:
- Führen Sie
get_metadata(fileKey=":fileKey", nodeId="1-2")aus, um die allgemeine Knotenübersicht zu erhalten. - Identifizieren Sie die spezifischen untergeordneten Knoten, die aus den Metadaten benötigt werden.
- Rufen Sie einzelne untergeordnete Knoten mit
get_design_context(fileKey=":fileKey", nodeId=":childNodeId")ab.
Schritt 3: Visuelle Referenz erfassen
Führen Sie get_screenshot mit demselben Dateischlüssel und derselben Knoten-ID für eine visuelle Referenz aus.
get_screenshot(fileKey=":fileKey", nodeId="1-2")
Dieser Screenshot dient als Quelle der Wahrheit für die visuelle Validierung. Halten Sie ihn während der gesamten Implementierung zugänglich.
Schritt 4: Erforderliche Assets herunterladen
Laden Sie alle Assets (Bilder, Symbole, SVGs) herunter, die vom Figma MCP-Server zurückgegeben werden.
WICHTIG: Befolgen Sie diese Asset-Regeln:
- Wenn der Figma MCP-Server eine
localhost-Quelle für ein Bild oder SVG zurückgibt, verwenden Sie diese Quelle direkt. - Importieren Sie KEINE neuen Symbolpakete und fügen Sie keine hinzu – alle Assets sollten aus der Figma-Nutzlast stammen.
- Verwenden oder erstellen Sie KEINE Platzhalter, wenn eine
localhost-Quelle bereitgestellt wird. - Assets werden über den integrierten Asset-Endpunkt des Figma MCP-Servers bereitgestellt.
Schritt 5: In Projektkonventionen übersetzen
Übersetzen Sie die Figma-Ausgabe in das Framework, die Stile und die Konventionen dieses Projekts.
Wichtige Prinzipien:
- Behandeln Sie die Figma MCP-Ausgabe (normalerweise React + Tailwind) als Darstellung von Design und Verhalten, nicht als endgültigen Codestil.
- Ersetzen Sie Tailwind-Utility-Klassen durch die bevorzugten Hilfsprogramme oder Designsystem-Tokens des Projekts.
- Verwenden Sie vorhandene Komponenten (Schaltflächen, Eingaben, Typografie, Symbol-Wrapper) wieder, anstatt Funktionalität zu duplizieren.
- Verwenden Sie das Farbsystem, die Typografie-Skala und die Abstands-Tokens des Projekts konsistent.
- Respektieren Sie vorhandene Routing-, Statusverwaltungs- und Datenabrufmuster.
Schritt 6: 1:1 Visuelle Rückmeldungstreue erreichen
Streben Sie pixelgenaue visuelle Rückmeldungstreue mit dem Figma-Design an.
Richtlinien:
- Priorisieren Sie die Figma-Rückmeldungstreue, um Designs exakt zu entsprechen.
- Vermeiden Sie fest codierte Werte – verwenden Sie Design-Tokens aus Figma, wo verfügbar.
- Wenn Konflikte zwischen Designsystem-Tokens und Figma-Spezifikationen auftreten, bevorzugen Sie Designsystem-Tokens, passen Sie aber Abstände oder Größen minimal an, um die Optik zu treffen.
- Befolgen Sie die WCAG-Anforderungen für Barrierefreiheit.
- Fügen Sie bei Bedarf Komponentendokumentation hinzu.
Schritt 7: Gegen Figma validieren
Bevor Sie die Aufgabe als abgeschlossen markieren, validieren Sie die endgültige Benutzeroberfläche anhand des Figma-Screenshots.
Validierungs-Checkliste:
- Layout stimmt überein (Abstände, Ausrichtung, Größen)
- Typografie stimmt überein (Schriftart, Größe, Gewicht, Zeilenhöhe)
- Farben stimmen exakt überein
- Interaktive Zustände funktionieren wie entworfen (Hover, Aktiv, Deaktiviert)
- Reaktionsverhalten folgt den Figma-Einschränkungen
- Assets werden korrekt gerendert
- Barrierefreiheitsstandards wurden eingehalten
Implementierungsregeln
Komponentenorganisation
- Platzieren Sie UI-Komponenten im dafür vorgesehenen Designsystem-Verzeichnis des Projekts.
- Befolgen Sie die Namenskonventionen für Komponenten des Projekts.
- Vermeiden Sie Inline-Stile, es sei denn, sie sind für dynamische Werte wirklich notwendig.
Designsystem-Integration
- Verwenden Sie IMMER Komponenten aus dem Designsystem des Projekts, wenn möglich.
- Ordnen Sie Figma-Design-Tokens den Projekt-Design-Tokens zu.
- Wenn eine passende Komponente vorhanden ist, erweitern Sie diese, anstatt eine neue zu erstellen.
- Dokumentieren Sie alle neuen Komponenten, die dem Designsystem hinzugefügt werden.
Codequalität
- Vermeiden Sie fest codierte Werte – extrahieren Sie diese in Konstanten oder Design-Tokens.
- Halten Sie Komponenten komponierbar und wiederverwendbar.
- Fügen Sie TypeScript-Typen für Komponenten-Props hinzu.
- Fügen Sie JSDoc-Kommentare für exportierte Komponenten hinzu.
Beispiele
Beispiel 1: Implementieren einer Button-Komponente
Benutzer sagt: „Implementiere diese Figma-Button-Komponente: https://figma.com/design/kL9xQn2VwM8pYrTb4ZcHjF/DesignSystem?node-id=42-15"
Aktionen:
- URL parsen, um fileKey=
kL9xQn2VwM8pYrTb4ZcHjFund nodeId=42-15zu extrahieren. - Führen Sie
get_design_context(fileKey="kL9xQn2VwM8pYrTb4ZcHjF", nodeId="42-15")aus. - Führen Sie
get_screenshot(fileKey="kL9xQn2VwM8pYrTb4ZcHjF", nodeId="42-15")für die visuelle Referenz aus. - Laden Sie alle Button-Symbole vom Asset-Endpunkt herunter.
- Überprüfen Sie, ob das Projekt eine vorhandene Button-Komponente hat.
- Wenn ja, erweitern Sie diese um eine neue Variante; wenn nein, erstellen Sie eine neue Komponente unter Verwendung der Projektkonventionen.
- Ordnen Sie Figma-Farben den Projekt-Design-Tokens zu (z. B.
primary-500,primary-hover). - Validieren Sie anhand des Screenshots auf Padding, Randradius und Typografie.
Ergebnis: Button-Komponente, die dem Figma-Design entspricht und in das Projekt-Designsystem integriert ist.
Beispiel 2: Erstellen eines Dashboard-Layouts
Benutzer sagt: „Erstelle dieses Dashboard: https://figma.com/design/pR8mNv5KqXzGwY2JtCfL4D/Dashboard?node-id=10-5"
Aktionen:
- URL parsen, um fileKey=
pR8mNv5KqXzGwY2JtCfL4Dund nodeId=10-5zu extrahieren. - Führen Sie
get_metadata(fileKey="pR8mNv5KqXzGwY2JtCfL4D", nodeId="10-5")aus, um die Seitenstruktur zu verstehen. - Identifizieren Sie die Hauptabschnitte aus den Metadaten (Kopfzeile, Seitenleiste, Inhaltsbereich, Karten) und deren untergeordnete Knoten-IDs.
- Führen Sie
get_design_context(fileKey="pR8mNv5KqXzGwY2JtCfL4D", nodeId=":childNodeId")für jeden Hauptabschnitt aus. - Führen Sie
get_screenshot(fileKey="pR8mNv5KqXzGwY2JtCfL4D", nodeId="10-5")für die gesamte Seite aus. - Laden Sie alle Assets (Logos, Symbole, Diagramme) herunter.
- Erstellen Sie das Layout unter Verwendung der Layout-Primitiven des Projekts.
- Implementieren Sie jeden Abschnitt nach Möglichkeit unter Verwendung vorhandener Komponenten.
- Validieren Sie das reaktionsfähige Verhalten anhand der Figma-Einschränkungen.
Ergebnis: Vollständiges Dashboard, das dem Figma-Design mit reaktionsfähigem Layout entspricht.
Best Practices
Immer mit Kontext beginnen
Implementieren Sie niemals auf der Grundlage von Annahmen. Rufen Sie immer zuerst get_design_context und get_screenshot ab.
Inkrementelle Validierung
Validieren Sie während der Implementierung häufig, nicht erst am Ende. So werden Probleme frühzeitig erkannt.
Abweichungen dokumentieren
Wenn Sie vom Figma-Design abweichen müssen (z. B. aus Gründen der Barrierefreiheit oder technischen Einschränkungen), dokumentieren Sie dies in Code-Kommentaren.
Wiederverwendung vor Neuerstellung
Überprüfen Sie immer, ob vorhandene Komponenten existieren, bevor Sie neue erstellen. Konsistenz in der gesamten Codebasis ist wichtiger als eine exakte Figma-Reproduktion.
Designsystem zuerst
Wenn Sie sich unsicher sind, bevorzugen Sie die Muster des Projekt-Designsystems gegenüber einer wörtlichen Figma-Übersetzung.
Häufige Probleme und Lösungen
Problem: Figma-Ausgabe ist abgeschnitten
Ursache: Das Design ist zu komplex oder hat zu viele verschachtelte Ebenen, um in einer einzigen Antwort zurückgegeben zu werden.
Lösung: Verwenden Sie get_metadata, um die Knotenstruktur zu erhalten, und rufen Sie dann einzelne Knoten mit get_design_context ab.
Problem: Design stimmt nach der Implementierung nicht überein
Ursache: Visuelle Abweichungen zwischen dem implementierten Code und dem ursprünglichen Figma-Design. Lösung: Vergleichen Sie nebeneinander mit dem Screenshot aus Schritt 3. Überprüfen Sie Abstands-, Farb- und Typografiewerte in den Designkontextdaten.
Problem: Assets werden nicht geladen
Ursache: Der Asset-Endpunkt des Figma MCP-Servers ist nicht zugänglich oder die URLs werden geändert.
Lösung: Stellen Sie sicher, dass der Asset-Endpunkt des Figma MCP-Servers zugänglich ist. Der Server stellt Assets unter localhost-URLs bereit. Verwenden Sie diese direkt ohne Änderung.
Problem: Design-Token-Werte unterscheiden sich von Figma
Ursache: Die Designsystem-Tokens des Projekts haben andere Werte als die im Figma-Design angegebenen. Lösung: Wenn sich Projekt-Tokens von Figma-Werten unterscheiden, bevorzugen Sie Projekt-Tokens für die Konsistenz, passen Sie aber Abstände/Größen an, um die visuelle Rückmeldungstreue zu wahren.
Design-Implementierung verstehen
Der Figma-Implementierungsarbeitsablauf etabliert einen zuverlässigen Prozess für die Übersetzung von Designs in Code:
Für Designer: Die Gewissheit, dass Implementierungen ihren Designs mit pixelgenauer Präzision entsprechen. Für Entwickler: Ein strukturierter Ansatz, der Rätselraten eliminiert und wiederholte Überarbeitungen reduziert. Für Teams: Konsistente, hochwertige Implementierungen, die die Integrität des Designsystems wahren.
Durch die Befolgung dieses Arbeitsablaufs stellen Sie sicher, dass jedes Figma-Design mit der gleichen Sorgfalt und Liebe zum Detail implementiert wird.