デザインの実装
概要
このスキルは、Figmaデザインをピクセルパーフェクトな本番コードに変換するための構造化ワークフローを提供します。Figma MCPサーバーとの一貫した統合、デザイントークンの適切な使用、およびデザインとの1:1の視覚的パリティを保証します。
スキルの範囲
- 成果物がユーザーのリポジトリ内のコードである場合にこのスキルを使用します。
- ユーザーがFigma内のノードの作成/編集/削除を依頼した場合は、figma-useに切り替えます。
- ユーザーがコードや説明からFigmaの全ページ画面を構築または更新するよう依頼した場合は、figma-generate-designに切り替えます。
- ユーザーがCode Connectマッピングのみを依頼した場合は、figma-code-connect-componentsに切り替えます。
- ユーザーが再利用可能なエージェントルール(
CLAUDE.md/AGENTS.md)を作成するよう依頼した場合は、figma-create-design-system-rulesに切り替えます。
前提条件
- Figma MCPサーバーが接続され、アクセス可能であること
- ユーザーが以下の形式でFigma URLを提供すること:
https://figma.com/design/:fileKey/:fileName?node-id=1-2:fileKeyはファイルキー1-2はノードID(実装する特定のコンポーネントまたはフレーム)
- または
figma-desktopMCPを使用する場合: ユーザーはFigmaデスクトップアプリでノードを直接選択できます(URLは不要) - プロジェクトに確立されたデザインシステムまたはコンポーネントライブラリがあること(推奨)
必須ワークフロー
以下の手順を順に実行してください。手順をスキップしないでください。
ステップ1: ノードIDの取得
オプションA: Figma URLから解析
ユーザーがFigma URLを提供した場合、ファイルキーとノードIDを抽出してMCPツールの引数として渡します。
URL形式: https://figma.com/design/:fileKey/:fileName?node-id=1-2
抽出:
- ファイルキー:
:fileKey(/design/の後のセグメント) - ノードID:
1-2(node-idクエリパラメータの値)
注: ローカルのデスクトップMCP(figma-desktop)を使用する場合、ツール呼び出しのパラメータとして fileKey は渡されません。サーバーは自動的に現在開いているファイルを使用するため、nodeId のみが必要です。
例:
- URL:
https://figma.com/design/kL9xQn2VwM8pYrTb4ZcHjF/DesignSystem?node-id=42-15 - ファイルキー:
kL9xQn2VwM8pYrTb4ZcHjF - ノードID:
42-15
オプションB: Figmaデスクトップアプリの現在の選択を使用(figma-desktop MCPのみ)
figma-desktop MCPを使用しており、ユーザーがURLを提供していない場合、ツールはデスクトップアプリで開かれているFigmaファイルの現在選択されているノードを自動的に使用します。
注: 選択ベースのプロンプトは figma-desktop MCPサーバーでのみ機能します。リモートサーバーは、コンテキストを抽出するためにフレームまたはレイヤーへのリンクが必要です。ユーザーはノードが選択された状態でFigmaデスクトップアプリを開いている必要があります。
ステップ2: デザインコンテキストの取得
抽出したファイルキーとノードIDを使用して get_design_context を実行します。
get_design_context(fileKey=":fileKey", nodeId="1-2")
これにより、以下の構造化データが提供されます:
- レイアウトプロパティ(Auto Layout、制約、サイズ設定)
- タイポグラフィ仕様
- カラー値とデザイントークン
- コンポーネント構造とバリアント
- スペーシングとパディングの値
応答が大きすぎる、または切り捨てられている場合:
get_metadata(fileKey=":fileKey", nodeId="1-2")を実行して高レベルのノードマップを取得します- メタデータから必要な特定の子ノードを特定します
get_design_context(fileKey=":fileKey", nodeId=":childNodeId")で個々の子ノードを取得します
ステップ3: ビジュアルリファレンスのキャプチャ
同じファイルキーとノードIDを使用して get_screenshot を実行し、ビジュアルリファレンスを取得します。
get_screenshot(fileKey=":fileKey", nodeId="1-2")
このスクリーンショットは視覚的な検証のための真実の情報源として機能します。実装中はアクセス可能な状態に保ってください。
ステップ4: 必要なアセットのダウンロード
Figma MCPサーバーから返されたアセット(画像、アイコン、SVG)をダウンロードします。
重要: 以下のアセットルールに従ってください:
- Figma MCPサーバーが画像またはSVGの
localhostソースを返した場合、そのソースを直接使用します - 新しいアイコンパッケージをインポートしたり追加したりしないでください。すべてのアセットはFigmaペイロードから取得する必要があります
localhostソースが提供されている場合、プレースホルダーを使用したり作成したりしないでください- アセットはFigma MCPサーバーの組み込みアセットエンドポイントを通じて提供されます
ステップ5: プロジェクト規約への変換
Figmaの出力をこのプロジェクトのフレームワーク、スタイル、および規約に変換します。
主要な原則:
- Figma MCPの出力(通常はReact + Tailwind)は、デザインと動作の表現として扱い、最終的なコードスタイルとしては扱いません
- Tailwindのユーティリティクラスをプロジェクトが好むユーティリティまたはデザインシステムトークンに置き換えます
- 機能を複製する代わりに、既存のコンポーネント(ボタン、入力、タイポグラフィ、アイコンラッパー)を再利用します
- プロジェクトのカラーシステム、タイポグラフィスケール、およびスペーシングトークンを一貫して使用します
- 既存のルーティング、状態管理、およびデータ取得パターンを尊重します
ステップ6: 1:1の視覚的パリティの達成
Figmaデザインとのピクセルパーフェクトな視覚的パリティを目指します。
ガイドライン:
- Figmaの忠実度を優先してデザインを正確に一致させます
- ハードコードされた値を避け、可能な場合はFigmaのデザイントークンを使用します
- デザインシステムトークンとFigma仕様の間に矛盾がある場合、デザインシステムトークンを優先しますが、視覚を一致させるためにスペーシングやサイズを最小限調整します
- アクセシビリティのためにWCAG要件に従います
- 必要に応じてコンポーネントのドキュメントを追加します
ステップ7: Figmaに対する検証
完了とマークする前に、最終的なUIをFigmaスクリーンショットと照らし合わせて検証します。
検証チェックリスト:
- レイアウトが一致する(スペーシング、配置、サイズ設定)
- タイポグラフィが一致する(フォント、サイズ、ウェイト、行の高さ)
- 色が正確に一致する
- インタラクティブな状態が設計通りに機能する(ホバー、アクティブ、無効)
- レスポンシブ動作がFigmaの制約に従う
- アセットが正しくレンダリングされる
- アクセシビリティ基準が満たされている
実装ルール
コンポーネントの整理
- UIコンポーネントはプロジェクトの指定されたデザインシステムディレクトリに配置します
- プロジェクトのコンポーネント命名規則に従います
- 動的な値に本当に必要な場合を除き、インラインスタイルを避けます
デザインシステムの統合
- 可能な場合は常にプロジェクトのデザインシステムのコンポーネントを使用します
- Figmaデザイントークンをプロジェクトのデザイントークンにマッピングします
- 一致するコンポーネントが存在する場合、新しいものを作成するのではなく拡張します
- デザインシステムに追加された新しいコンポーネントを文書化します
コード品質
- ハードコードされた値を避け、定数またはデザイントークンに抽出します
- コンポーネントは構成可能で再利用可能に保ちます
- コンポーネントのプロップにTypeScript型を追加します
- エクスポートされたコンポーネントにJSDocコメントを含めます
例
例1: ボタンコンポーネントの実装
ユーザーが言う: "このFigmaボタンコンポーネントを実装してください: https://figma.com/design/kL9xQn2VwM8pYrTb4ZcHjF/DesignSystem?node-id=42-15"
アクション:
- URLを解析して fileKey=
kL9xQn2VwM8pYrTb4ZcHjF、nodeId=42-15を抽出します get_design_context(fileKey="kL9xQn2VwM8pYrTb4ZcHjF", nodeId="42-15")を実行します- ビジュアルリファレンスとして
get_screenshot(fileKey="kL9xQn2VwM8pYrTb4ZcHjF", nodeId="42-15")を実行します - アセットエンドポイントからボタンアイコンをダウンロードします
- プロジェクトに既存のボタンコンポーネントがあるか確認します
- ある場合は新しいバリアントで拡張し、ない場合はプロジェクトの規約を使用して新しいコンポーネントを作成します
- Figmaの色をプロジェクトのデザイントークン(例:
primary-500、primary-hover)にマッピングします - スクリーンショットに対してパディング、ボーダー半径、タイポグラフィを検証します
結果: Figmaデザインに一致し、プロジェクトのデザインシステムと統合されたボタンコンポーネント。
例2: ダッシュボードレイアウトの構築
ユーザーが言う: "このダッシュボードを構築してください: https://figma.com/design/pR8mNv5KqXzGwY2JtCfL4D/Dashboard?node-id=10-5"
アクション:
- URLを解析して fileKey=
pR8mNv5KqXzGwY2JtCfL4D、nodeId=10-5を抽出します - ページ構造を把握するために
get_metadata(fileKey="pR8mNv5KqXzGwY2JtCfL4D", nodeId="10-5")を実行します - メタデータから主要セクション(ヘッダー、サイドバー、コンテンツエリア、カード)とその子ノードIDを特定します
- 各主要セクションに対して
get_design_context(fileKey="pR8mNv5KqXzGwY2JtCfL4D", nodeId=":childNodeId")を実行します - 全ページのスクリーンショットとして
get_screenshot(fileKey="pR8mNv5KqXzGwY2JtCfL4D", nodeId="10-5")を実行します - すべてのアセット(ロゴ、アイコン、チャート)をダウンロードします
- プロジェクトのレイアウトプリミティブを使用してレイアウトを構築します
- 可能な場合は既存のコンポーネントを使用して各セクションを実装します
- Figmaの制約に対してレスポンシブ動作を検証します
結果: レスポンシブレイアウトを備えた、Figmaデザインに一致する完全なダッシュボード。
ベストプラクティス
常にコンテキストから始める
前提に基づいて実装しないでください。常に最初に get_design_context と get_screenshot を取得してください。
段階的な検証
実装中に頻繁に検証し、最後だけではありません。これにより問題を早期に発見できます。
逸脱の文書化
Figmaデザインから逸脱する必要がある場合(例: アクセシビリティや技術的な制約のため)、コードコメントにその理由を文書化します。
新規作成よりも再利用
新しいコンポーネントを作成する前に、常に既存のコンポーネントを確認してください。コードベース全体の一貫性は、正確なFigmaの複製よりも重要です。
デザインシステムを優先
迷った場合は、文字通りのFigma変換よりもプロジェクトのデザインシステムパターンを優先します。
一般的な問題と解決策
問題: Figmaの出力が切り捨てられる
原因: デザインが複雑すぎるか、ネストされたレイヤーが多すぎて1回の応答で返せない。
解決策: get_metadata を使用してノード構造を取得し、その後 get_design_context で特定のノードを個別に取得します。
問題: 実装後にデザインが一致しない
原因: 実装されたコードと元のFigmaデザインの間に視覚的な不一致がある。 解決策: ステップ3のスクリーンショットと並べて比較します。デザインコンテキストデータのスペーシング、色、タイポグラフィの値を確認します。
問題: アセットが読み込まれない
原因: Figma MCPサーバーのアセットエンドポイントにアクセスできないか、URLが変更されている。
解決策: Figma MCPサーバーのアセットエンドポイントにアクセスできることを確認します。サーバーは localhost URLでアセットを提供します。これらを変更せずに直接使用します。
問題: デザイントークンの値がFigmaと異なる
原因: プロジェクトのデザインシステムトークンがFigmaデザインで指定された値と異なる。 解決策: プロジェクトトークンがFigmaの値と異なる場合、一貫性のためにプロジェクトトークンを優先しますが、視覚的な忠実度を維持するためにスペーシング/サイズを調整します。
デザイン実装について
Figma実装ワークフローは、デザインをコードに変換するための信頼性の高いプロセスを確立します:
デザイナーへ: 実装がデザインとピクセルパーフェクトに一致することへの自信。 開発者へ: 推測を排除し、やり取りの修正を減らす構造化されたアプローチ。 チームへ: デザインシステムの整合性を維持する、一貫性のある高品質な実装。
このワークフローに従うことで、すべてのFigmaデザインが同じレベルの注意と詳細さで実装されることが保証されます。