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.md | MCP呼び出し予算とファイルメモリのしきい値と停止条件。開始前に読んでください |
| troubleshooting.md | 落とし穴の参照テーブル。結果がおかしいときに確認してください |
| examples/ | 4種類のプロジェクト(組み込みモック、Playwrightフィクスチャ、Nuxt開発、バックエンドAPIのインターセプト)に対応したキャプチャ設定テンプレート |
| evals/trials.json | 回帰テストケースとベースライン。ツール変更後はすべて再実行してください |
手順
- 入力を確認する:プロジェクトとその実行方法、対象画面、各画面のビューポートと高さタイプ、ターゲットFigmaファイル、バインドするデザインシステム。トピックと範囲はユーザーが決定します。自分で選ばないでください。Figmaリンクを入手したら、
create_sessionを実行し、1回の読み取り専用use_figmaを実行して、アカウントMCPがログインしているアカウントでファイルの読み取りと書き込みができることを確認します(ファイルを開けない場合は、whoamiを使用して、どのアカウントであり、誰とファイルを共有すべきかを説明します)。次に、scale-guard.md「MCP呼び出し予算」に従って、このジョブに必要な呼び出し回数を見積もります。予算が足りない場合は、最初にその旨を伝えます。 - プロジェクトを起動し、設定ファイルを書き、キャプチャする:web-capture.mdに従い、
al-capture.cjsを実行します。 - 最初にデバイスごとに1つの代表画面を構築し、ブラウザのスクリーンショットと比較します。一致した場合のみ、残りの画面を一括で処理します。
- 一括処理後、すべての画面を比較する:
al-diff.pyを実行します。また、スクリーンショットを撮り、Componentsセクションを確認します。 - 監査する:
audit-screens.jsを実行します。
完了条件:すべての画面に再構築があり、各画面のルートフレームの幅がビューポートと一致し、各デバイスの代表画面に参照スクリーンショットレイヤーがあること。issuesが空であるか、すべてのエントリがその原因とともに報告されていること。Componentsセクションがスクリーンショットで確認されていること。
Figmaへの書き込みに関する絶対ルール
Figmaファイルのメモリは、静的使用量が少ない場合でも一瞬で制限を超えて急増する可能性があり、制限を超えたファイルは常に回復できるとは限りません(scale-guard.md「インシデント」)。すべてのプロジェクトで以下に従ってください:
- 既存のファイルに書き込む前に、ユーザーにバージョンを保存するよう依頼してください。以前に構築した画面を削除または再構築する場合も含みます。ユーザーが保存したと返信するまで開始しないでください。ターゲットページに自分で構築したもの以外何もない場合(新規ファイル、空白ページ)は、この手順をスキップしてもかまいません。その旨をレポートで伝えてください。
- 一度に1画面ずつ送信する:この画面の画像とデータSVGをアップロードし、構築し、
ALDATA-およびALIMG-の一時フレームが削除されたことを確認してから、次の画面に進みます。最初にバッチ全体をアップロードしないでください。 - ユーザーが赤い警告またはリカバリモードを報告した場合は、すぐに停止してください。ユーザーがファイルに問題がないことを確認するまで、読み取り専用の
use_figmaも実行しないでください。 - 呼び出し制限に達したら停止する:いずれかの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行。