Communitygithub.com

Code to Figma

実行中のWebアプリから画面をネイティブなFigmaレイヤー(オートレイアウト、コンポーネント、インスタンス)として再構築し、ブラウザのスクリーンショットと差分比較します。スクリーンショットのインポートやコードレイヤーではありません。ユーザーが「このページをFigmaに変換」「コードをFigmaに」「画面をFigmaにプッシュ」「UIをFigmaで再構築」などと依頼した場合に使用します。

Code to Figma とは?

このスキルは、実行中のWebアプリケーションのDOMを解析し、それをFigma上で編集可能なオートレイアウトとコンポーネントとして再構築するための強力なツールです。Vue 3とReact(18、19、Next.js App Router Server Componentsを含む)向けのアダプターを備え、コンポーネント境界を自動検出します。他のフレームワークでは、繰り返しノード検出による基本構造の再現が可能です。処理はスクリーン単位で行われ、各画面の再構築後にブラウザのスクリーンショットとの差分を比較し、品質を保証します。また、Figmaファイルのメモリ制限に注意し、安全に書き込むためのルールが厳格に定められています。このスキルは、開発者がコードベースから直接Figmaデザインを生成し、デザインと実装の乖離を最小限に抑えたい場合に特に有用です。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/byby325/code-to-figma-ui-states/tree/HEAD/skills/code-to-figma

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Code to Figma は何をしますか?

プロジェクトを実行し、ブラウザ内のDOMをレイアウトツリーに抽出し、それをFigma上で編集可能なオートレイアウトとコンポーネントとして再構築します。

Webフロントエンド向け。コンポーネント境界にはVue 3およびReact(React 18および19でテスト済み、Next.js App Router Server Componentsを含む。React 16および17は同じファイバー構造を持ちますが未テスト)用のアダプターがあります。その他のフレームワークは繰り返しノード検出のみ対応します。ネイティブアプリやCanvas/WebGLで完全に描画された画面は対象外です。代わりにデザインファイルやワイヤーフレームを使用してください。

ファイル内容
web-capture.md全プロセス。開始前に読んでください
screen-structure.md出力が満たすべき構造ルール
scale-guard.mdMCP呼び出し予算とファイルメモリのしきい値と停止条件。開始前に読んでください
troubleshooting.md落とし穴の参照テーブル。結果がおかしいときに確認してください
examples/4種類のプロジェクト(組み込みモック、Playwrightフィクスチャ、Nuxt開発、バックエンドAPIのインターセプト)に対応したキャプチャ設定テンプレート
evals/trials.json回帰テストケースとベースライン。ツール変更後はすべて再実行してください

手順

  1. 入力を確認する:プロジェクトとその実行方法、対象画面、各画面のビューポートと高さタイプ、ターゲットFigmaファイル、バインドするデザインシステム。トピックと範囲はユーザーが決定します。自分で選ばないでください。Figmaリンクを入手したら、create_sessionを実行し、1回の読み取り専用use_figmaを実行して、アカウントMCPがログインしているアカウントでファイルの読み取りと書き込みができることを確認します(ファイルを開けない場合は、whoamiを使用して、どのアカウントであり、誰とファイルを共有すべきかを説明します)。次に、scale-guard.md「MCP呼び出し予算」に従って、このジョブに必要な呼び出し回数を見積もります。予算が足りない場合は、最初にその旨を伝えます。
  2. プロジェクトを起動し、設定ファイルを書き、キャプチャする:web-capture.mdに従い、al-capture.cjsを実行します。
  3. 最初にデバイスごとに1つの代表画面を構築し、ブラウザのスクリーンショットと比較します。一致した場合のみ、残りの画面を一括で処理します。
  4. 一括処理後、すべての画面を比較する:al-diff.pyを実行します。また、スクリーンショットを撮り、Componentsセクションを確認します。
  5. 監査する:audit-screens.jsを実行します。

完了条件:すべての画面に再構築があり、各画面のルートフレームの幅がビューポートと一致し、各デバイスの代表画面に参照スクリーンショットレイヤーがあること。issuesが空であるか、すべてのエントリがその原因とともに報告されていること。Componentsセクションがスクリーンショットで確認されていること。

Figmaへの書き込みに関する絶対ルール

Figmaファイルのメモリは、静的使用量が少ない場合でも一瞬で制限を超えて急増する可能性があり、制限を超えたファイルは常に回復できるとは限りません(scale-guard.md「インシデント」)。すべてのプロジェクトで以下に従ってください:

  1. 既存のファイルに書き込む前に、ユーザーにバージョンを保存するよう依頼してください。以前に構築した画面を削除または再構築する場合も含みます。ユーザーが保存したと返信するまで開始しないでください。ターゲットページに自分で構築したもの以外何もない場合(新規ファイル、空白ページ)は、この手順をスキップしてもかまいません。その旨をレポートで伝えてください。
  2. 一度に1画面ずつ送信する:この画面の画像とデータSVGをアップロードし、構築し、ALDATA-およびALIMG-の一時フレームが削除されたことを確認してから、次の画面に進みます。最初にバッチ全体をアップロードしないでください。
  3. ユーザーが赤い警告またはリカバリモードを報告した場合は、すぐに停止してください。ユーザーがファイルに問題がないことを確認するまで、読み取り専用のuse_figmaも実行しないでください。
  4. 呼び出し制限に達したら停止する:いずれかのFigmaツールが「Figma MCPツール呼び出し制限に達しました」を返した場合、再試行せず、回避するためにツールを切り替えないでください。完了した画面と、キャンバス上に残っている一時フレームのノードIDを一覧表示してください。

既知の制限

  • コンポーネント境界にはVue 3およびReact用のアダプターがあります。どちらも開発モードが必要です(プロダクションビルドにはコンポーネント名がなく、stats.jsonが警告します)。Svelte、Angular、その他のフレームワークは繰り返しノード検出のみ対応します。サポートを追加するには、al-extract.jsのADAPTERSにエントリを追加してください。
  • Reactコンポーネントの命名ルール:DOMノードが境界とみなされるのは、そのコンポーネントの唯一のルートノードである場合のみであり、名前は最も外側のコンポーネントから取得されます。子のみを渡すコンポーネント(Provider、Tooltip、ErrorBoundary)、styled-components/emotionスタイルコンポーネント、ルーターおよびフレームワーク内部コンポーネントはカウントされません。Next.js Server Component名にはReact 19開発ビルド(Next 15以降)が必要です。React 18ではクライアントコンポーネントのみがキャプチャされます。
  • React:Vite + Radix + Tailwind 4デモプロジェクトにはFigma再構築ベースラインがあります(4画面、ブラウザとの差分0.02~0.12%)。Next.js App Routerプロジェクトはキャプチャとパッキングを通じてのみ検証されています。
  • mask-imageとしてSVGを使用し、子を持たないアイコン(例:frappe-ui、UnoCSSのlucide-*クラス)はベクターに変換され、背景色で色付けされます。その他のmask-imageの使用法(グラデーションフェード、ビットマップマスク)およびclip-pathには同等のものはありません。フェードエッジや角度の付いたカットは完全な形状になります。
  • 色:rgb()がサポートされています。Chromeが返す可能性があるその他の形式(oklch()、color(srgb …)、lab()、hsl()など)はキャンバスを通じてsRGBに変換され、各チャンネルは1(8ビット丸め)ずれる可能性があります。
  • Plugin APIはインスタンス内のフレームの幅を変更できません。親フレームに引き伸ばされる単一の子はFillに変更され、親に引き伸ばされる子はパディングを通じて調整され、データでHugになっているオートレイアウトフレームはHugに変更されます。それ以外のすべての場合、サイズはマスターコンポーネントに従い、log.boxesにリストされます。
  • ネストされたz-indexを持つ小さな要素は、覆われてしまう可能性があります。レイヤーツリーは単一の子を親から外に移動できません。
  • システムフォント(ui-sans-serif)はInterに置き換えられます。文字幅がわずかに異なります。
  • font-variant-numeric: tabular-nums(タブラーフィギュア)はFigmaで有効にできません。Plugin APIのopenTypeFeaturesは読み取り専用です。日付、時刻、金額はブラウザよりも狭くなり、その後のテキストは5~8ピクセルずれます。log.driftにこれらがリストされます。
  • 回転とCSS三角形は、子を持たない要素(チェックマーク、タブの三角形、小さな正方形)に対してのみ処理され、ベクターに変換されます。子を持つ回転したコンテナはバウンディングボックスでレイアウトされ、そのコンテンツは回転しません。

レポート

  • 構造:オートレイアウトコンテナ比率、コンポーネント/バリアント数。どの領域が絶対配置か(オーバーレイ、スクロール中のコンテンツ)。
  • 比較結果:テキストのずれ、差分比率が最も高い画面、および再現できない既知のスポット。差分比率を文脈で読んでください。グラデーションやビットマップmask-imageは比率を押し上げるため、原因を説明してください。stats.jsonがアイコンが空であると警告した場合、まずアイコンソースを許可し、再キャプチャしてください。画面全体にほとんど色がない場合は、まず__alBuildが返したstatが色を拾ったかどうかを確認してください(troubleshooting.md)。
  • 参照スクリーンショットは代表画面にのみ配置されます。残りはローカルの出力フォルダに残ります。
  • ライブラリがバインドされている場合、この部分はfigma-library-bindingの「レポート」セクションに従って記述します。ライブラリがない場合、色とフォントサイズはハードコードされた値です。
  • 画面はモックデータから再現されます。どの領域がライブスクリーンショットで埋められたか、どのコピーがモックで変更されたか。
  • Figmaにプロダクトフォントがない場合、どのフォントが代替されたか。
  • スケール:scale-guard.md形式の1行。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

figma-library-binding

Bind Figma screens to a design system library — tokens only on exact value matches, swap icons and components for library versions, and list unmatched values for designers instead of snapping to the nearest token. Use when the user asks to "bind tokens", "use library components" or "find unbound colors". 把 Figma 畫面綁到專案的 design system library:顏色、圓角、邊框、間距、字級完全相同才綁 token,圖示和元件換成 library 版本,沒有對應的值列給設計決定,不取最近值。Use when 使用者要「綁 library」「綁 token」「換成 design system 元件」「檢查沒綁 variable 的顏色」,或 code-to-figma、figma-state-board 的畫面要綁 design system。

figma-state-board

Inventory every UI state of a feature from its code and lay them out on one Figma canvas (a state board) — real screens for states the prototype already handles, plus a gap check of missing error, empty and loading states, split into spec-required and suggested. Use when the user asks for a "state board", "all states of this feature in Figma", "which error screens are missing", or to update an existing board. 從任何產品專案的程式碼盤點一個功能的所有狀態,在 Figma 產出或更新「情境稿」:原型(通常是 mock data 做的)已經有的狀態畫真實畫面,原型缺的狀態全列進「缺漏檢查」,再分「規格有寫」(規格要求、原型漏做)和「建議補」(規格和原型都沒提的錯誤、空狀態、載入等)。Use when 使用者要「做情境稿」「把所有狀態/狀況畫到 Figma」「state board」「檢查缺了哪些 error 畫面」,或要依新規則增修既有情境稿。只要狀態清單用 state-discovery,只要把畫面轉進 Figma 用 code-to-figma。

関連スキル