mcpField
F
figma-design-to-code-bridge

figma-design-to-code-bridge

github.com/sergekostenchukデザイン・UI3253 回インストール18 週間前に更新
リポジトリ

figma-design-to-code-bridge について

figma-design-to-code-bridgeは、実装計画やレビューのためにFigmaのデザイン意図を既存のコードベースに対応付けます。コンポーネントやトークンのマッピング、Code Connectの準備、適切な実装スキルへの振り分けを扱います。

主な機能

  1. 01実装引き継ぎ計画の作成
  2. 02Figmaコンポーネントとコードの対応付け
  3. 03Code Connectの準備またはレビュー
  4. 04デザインとコードの差分特定
  5. 05実装スキルへのタスク振り分け

活用シーン

  1. 01Figmaフレームからの実装計画
  2. 02デザインバリアントとローカルコンポーネントの対応付け
  3. 03Code Connect作業のレビュー
  4. 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.yaml
assets/
design-to-code-handoff.md
evals/
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 に引き継ぎます。

ワークフロー

  1. figma-context-reader または提供されたコンテキスト概要から、Figma のコンテキストを取得します。
  2. コンポーネントの選択を推奨する前に、ローカルのコードベースを調べます。
  3. Code Connect が依頼された場合は、Code Connect 固有の作業を行う前に、インストール済みの figma:figma-code-connect スキルを呼び出します。
  4. トークン、コンポーネント、バリアント、状態、レスポンシブの制約を、ローカル実装のプリミティブに対応付けます。
  5. 密度の高いプロダクト/アプリの作業は webapp-ui-skill に引き継ぎ、一般公開向けのランディングページ/プロダクトページは marketing-site-skill に引き継ぎます。
  6. 実装後は、ローカルでのビジュアル検証を必須とします。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 を読みます。

コメント