Was macht Code to Figma?
Führe das Projekt aus, extrahiere das DOM als Layout-Baum im Browser und baue es dann in Figma als bearbeitbare Auto-Layout-Frames und Komponenten nach.
Für Web-Frontends. Komponentengrenzen haben Adapter für Vue 3 und React (React 18 und 19 getestet, einschließlich Next.js App Router Server Components; 16 und 17 haben die gleiche Fiber-Struktur, sind aber ungetestet). Andere Frameworks erhalten nur die Erkennung wiederholter Knoten. Native Apps und vollständig in Canvas/WebGL gezeichnete Bildschirme sind nicht abgedeckt; verwende stattdessen die Design-Datei oder Wireframes.
| Datei | Inhalt |
|---|---|
| web-capture.md | Der vollständige Prozess; vor dem Start lesen |
| screen-structure.md | Strukturregeln, die die Ausgabe erfüllen muss |
| scale-guard.md | Schwellenwerte und Abbruchbedingungen für das MCP-Call-Budget und den Dateispeicher; vor dem Start lesen |
| troubleshooting.md | Fehlertabelle; konsultieren, wenn die Ergebnisse falsch sind |
| examples/ | Capture-Konfigurationsvorlagen für vier Projektarten: integrierter Mock, Playwright-Fixture, Nuxt-Dev, Backend-API abfangen |
| evals/trials.json | Regressionsfälle und Basislinien; nach Änderungen an den Tools alle erneut ausführen |
Schritte
- Eingaben bestätigen: das Projekt und wie es ausgeführt wird, welche Bildschirme, der Viewport und Höhentyp jedes Bildschirms, die Ziel-Figma-Datei und das zu bindende Designsystem. Der Benutzer entscheidet über Thema und Umfang; wähle sie nicht selbst. Sobald du den Figma-Link hast, führe
create_sessionplus ein schreibgeschütztesuse_figmaaus, um zu bestätigen, dass das angemeldete MCP-Konto die Datei lesen und schreiben kann (wenn die Datei nicht geöffnet werden kann, verwendewhoami, um zu erklären, welches Konto es ist und mit wem die Datei geteilt werden soll). Dann schätze, wie viele Aufrufe dieser Auftrag gemäß scale-guard.md „MCP-Call-Budget“ benötigt; wenn das Budget nicht ausreicht, teile es zuerst mit. - Projekt starten, Konfiguration schreiben, aufnehmen: führe
al-capture.cjsaus, gemäß web-capture.md - Zuerst einen repräsentativen Bildschirm pro Gerät erstellen, mit dem Browser-Screenshot vergleichen und nur dann bündeln, wenn er übereinstimmt
- Nach dem Batch jeden Bildschirm vergleichen: führe
al-diff.pyaus; erstelle auch Screenshots und überprüfe den Komponentenbereich - Audit: führe
audit-screens.jsaus
Erledigt, wenn: jeder Bildschirm einen Wiederaufbau hat, die Breite des Root-Frames jedes Bildschirms dem Viewport entspricht und der repräsentative Bildschirm jedes Geräts eine Referenz-Screenshot-Ebene hat; issues ist leer oder jeder Eintrag wird mit seiner Ursache gemeldet; der Komponentenbereich wurde in einem Screenshot überprüft.
Harte Regeln für das Schreiben nach Figma
Der Speicher einer Figma-Datei kann im Handumdrehen über das Limit schießen, selbst wenn die statische Nutzung gering ist, und eine Datei, die explodiert, kann nicht immer wiederhergestellt werden (scale-guard.md „Vorfall“). Befolge diese bei jedem Projekt:
- Bevor du in eine bestehende Datei schreibst, bitte den Benutzer, eine Version zu speichern, auch bevor du zuvor erstellte Bildschirme löschst oder neu aufbaust. Beginne nicht, bis der Benutzer antwortet, dass sie gespeichert ist. Wenn die Zielseite nichts außer dem enthält, was du selbst erstellt hast (neue Datei, leere Seite), kannst du dies überspringen; gib dies im Bericht an.
- Sende immer nur einen Bildschirm gleichzeitig: lade die Bilder und das Daten-SVG dieses Bildschirms hoch, baue ihn auf, bestätige, dass die temporären Frames
ALDATA-undALIMG-gelöscht wurden, und fahre dann mit dem nächsten fort. Lade nicht den gesamten Batch zuerst hoch. - Wenn der Benutzer eine rote Warnung oder den Wiederherstellungsmodus meldet, sofort anhalten. Führe nicht einmal ein schreibgeschütztes
use_figmaaus, bis der Benutzer bestätigt, dass die Datei in Ordnung ist. - Anhalten, wenn das Call-Limit erreicht ist: Wenn ein Figma-Tool „Limits der Figma-MCP-Tool-Aufrufe erreicht“ zurückgibt, nicht wiederholen und keine Tools wechseln, um es zu umgehen. Liste die abgeschlossenen Bildschirme und die Knoten-IDs der noch auf der Leinwand befindlichen temporären Frames auf.
Bekannte Grenzen
- Komponentengrenzen haben Adapter für Vue 3 und React; beide benötigen den Entwicklungsmodus (Produktions-Builds haben keine Komponentennamen, und
stats.jsonwird warnen). Svelte, Angular und andere Frameworks erhalten nur die Erkennung wiederholter Knoten; um eines zu unterstützen, füge einen Eintrag zuADAPTERSinal-extract.jshinzu. - React-Komponenten-Benennungsregeln: Ein DOM-Knoten zählt nur dann als Grenze, wenn er der einzige Root-Knoten der Komponente ist, und der Name wird von der äußersten Komponente übernommen. Komponenten, die nur Children weitergeben (Provider, Tooltip, ErrorBoundary), styled-components/emotion-Style-Komponenten sowie Router- und Framework-interne Komponenten zählen nicht. Next.js-Server-Komponentennamen erfordern einen React-19-Dev-Build (Next 15 und höher); mit React 18 werden nur Client-Komponenten erfasst.
- React: Das Vite + Radix + Tailwind 4 Demo-Projekt hat eine Figma-Wiederaufbau-Basislinie (vier Bildschirme, 0,02–0,12% Abweichung vom Browser). Das Next.js App Router Projekt wurde nur durch Capture und Packen verifiziert.
- Icons, die ein SVG als
mask-imageverwenden und keine Children haben (z. B. frappe-ui, UnoCSSlucide-*-Klassen), werden in Vektoren umgewandelt und mit der Hintergrundfarbe eingefärbt. Anderemask-image-Verwendungen (Farbverläufe, Bitmap-Masken) undclip-pathhaben kein Äquivalent; verblasste Kanten und abgewinkelte Schnitte werden zu vollen Formen. - Farben:
rgb()wird unterstützt, plus die Formate, die Chrome zurückgeben kann, wieoklch(),color(srgb …),lab()undhsl(); letztere werden über eine Leinwand in sRGB konvertiert, und jeder Kanal kann um 1 abweichen (8-Bit-Rundung). - Die Plugin-API kann die Breite eines Frames innerhalb einer Instanz nicht ändern. Ein einziges Kind, das sich streckt, um seinen Eltern-Frame zu füllen, wird auf Füllen geändert; Kinder, die sich strecken, um den Eltern zu füllen, werden durch Padding angepasst; Auto-Layout-Frames, die in den Daten auf Hug gesetzt sind, werden auf Hug geändert; in allen anderen Fällen folgt die Größe der Hauptkomponente, und
log.boxeslistet sie auf. - Kleine Elemente mit verschachteltem z-index können verdeckt werden; die Ebenenstruktur kann ein einzelnes Kind nicht aus seinem Elternelement verschieben.
- Systemschriftarten (
ui-sans-serif) werden durch Inter ersetzt; die Zeichenbreiten weichen geringfügig ab. font-variant-numeric: tabular-nums(Tabellenziffern) kann in Figma nicht aktiviert werden: Die Plugin-APIopenTypeFeaturesist schreibgeschützt. Daten, Uhrzeiten und Beträge werden schmaler als im Browser dargestellt, und der Text danach verschiebt sich um 5–8px;log.driftlistet diese auf.- Rotation und CSS-Dreiecke werden nur für Elemente ohne Kinder behandelt (Häkchen, Tab-Dreiecke, kleine Quadrate), die in Vektoren umgewandelt werden; rotierte Container mit Kindern werden durch ihre Begrenzungsbox angeordnet, und ihr Inhalt wird nicht rotiert.
Bericht
- Struktur: Verhältnis der Auto-Layout-Container, Anzahl der Komponenten/Varianten; welche Bereiche absolut sind (Overlays, Content mittendrin)
- Vergleichsergebnisse: Textversatz, die Bildschirme mit der höchsten Abweichungsrate und bekannte Stellen, die nicht reproduziert werden können. Lies die Abweichungsrate im Kontext: Farbverläufe oder Bitmap-
mask-imagetreiben die Rate nach oben, erkläre also die Ursache; wennstats.jsonwarnt, dass Icons leer sind, erlaube zuerst die Icon-Quelle und nimm erneut auf. Wenn ein ganzer Bildschirm fast keine Farbe hat, prüfe zuerst, ob das von__alBuildzurückgegebenestatFarben erfasst hat (troubleshooting.md) - Referenz-Screenshots werden nur auf repräsentativen Bildschirmen platziert; der Rest bleibt im lokalen Ausgabeordner
- Mit einer gebundenen Bibliothek schreibe diesen Teil gemäß dem „Bericht“-Abschnitt der Figma-Bibliotheksbindung; ohne Bibliothek sind Farben und Schriftgrößen hartcodierte Werte
- Bildschirme werden aus Mock-Daten reproduziert; welche Bereiche mit Live-Screenshots gefüllt wurden und welcher Text in den Mocks geändert wurde
- Welche Schriftart ersetzt wurde, wenn Figma die Produktschriftart nicht hat
- Skalierung: eine Zeile im scale-guard.md-Format