figma-design-to-code-bridge について
figma-design-to-code-bridgeは、実装計画やレビューのためにFigmaのデザイン意図を既存のコードベースに対応付けます。コンポーネントやトークンのマッピング、Code Connectの準備、適切な実装スキルへの振り分けを扱います。
主な機能
- 01実装引き継ぎ計画の作成
- 02Figmaコンポーネントとコードの対応付け
- 03Code Connectの準備またはレビュー
- 04デザインとコードの差分特定
- 05実装スキルへのタスク振り分け
活用シーン
- 01Figmaフレームからの実装計画
- 02デザインバリアントとローカルコンポーネントの対応付け
- 03Code Connect作業のレビュー
- 04デザインとコードの差分確認
MCP 対応
Code Connect固有の作業では、インストール済みのfigma:figma-code-connectスキルを呼び出します。figma-context-readerから提供されたコンテキストも利用できます。
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ sergekostenchuk/ ui-ux-agent-skill-system --skill figma-design-to-code-bridgeインストール後、Claude Code で/figma-design-to-code-bridgeを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
agents/openai.yamlassets/design-to-code-handoff.mdevals/evals.json詳細
Figma デザインからコードへの橋渡し
実装が目的の場合は、figma-context-reader の後にこのスキルを使用します。出力は「スクリーンショットからのコード作成」ではなく、デザインの意図、トークン、コンポーネントを既存のコードベースに対応付けるものです。
モード
handoff-plan:Figma のフレームから構築/リファクタリング計画を作成します。component-map:Figma のコンポーネント/バリアントを既存のコードコンポーネントに対応付けます。code-connect:Figma Code Connect の作業を準備またはレビューします。gap-report:デザインとコードシステムの差異を特定します。implementation-route:webapp-ui-skillまたはmarketing-site-skillに引き継ぎます。
ワークフロー
figma-context-readerまたは提供されたコンテキスト概要から、Figma のコンテキストを取得します。- コンポーネントの選択を推奨する前に、ローカルのコードベースを調べます。
- Code Connect が依頼された場合は、Code Connect 固有の作業を行う前に、インストール済みの
figma:figma-code-connectスキルを呼び出します。 - トークン、コンポーネント、バリアント、状態、レスポンシブの制約を、ローカル実装のプリミティブに対応付けます。
- 密度の高いプロダクト/アプリの作業は
webapp-ui-skillに引き継ぎ、一般公開向けのランディングページ/プロダクトページはmarketing-site-skillに引き継ぎます。 - 実装後は、ローカルでのビジュアル検証を必須とします。Figma との一致だけでは検証になりません。
出力形式
assets/design-to-code-handoff.md を使用します。
判断ルール
- 単発の CSS を生成するより、既存のプロジェクトコンポーネントとデザイントークンを優先します。
- 正確な視覚的一致がアクセシビリティ、レスポンシブ対応、またはコードベースの規約と競合する場合は、UX の意図を維持します。
- Figma が生成したコードや MCP が生成したコードは、ローカルアーキテクチャに照らしてレビューするまでは草案として扱います。
- Figma ファイルに状態の情報がない場合は、実装計画にローディング、空、エラー、無効、フォーカス、ホバー、モバイルの各状態を含めます。
安全性とプライバシー
- 非公開の Figma ファイル、スクリーンショット、変数、コンポーネント名、ソースコードは機密情報として扱います。
- 明示的な承認とデータ転送に関する注記なしに、非公開コードや Figma のコンテキストを外部ツールに送信しないでください。
- Figma のフレームに合わせるためだけにローカルコンポーネントを上書きせず、まず対象範囲を限定した実装計画を提案します。
検証と評価
- 引き継ぎ内容に、Figma からコードへのコンポーネント対応付けとローカルでの検証手順の両方が含まれていることを確認します。
- 実装した作業では、ローカルアプリのブラウザーまたはスクリーンショットによる証拠を必須とします。
evals/evals.jsonを使用して、アプリフレームの振り分け、マーケティングページの振り分け、Code Connect の差異に関する動作をテストします。
リソース
- 最新の Figma ツールが重要な場合は、
$CODEX_SKILLS_DIR/senior-figma-orchestrator/references/figma-mcp-compatibility.mdを読みます。
コメント
Markdown 対応