mcpField
F
figma-context-reader

figma-context-reader

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

figma-context-reader について

figma-context-readerは、Figmaの入力を根拠付きのデザインブリーフにまとめる読み取り専用スキルです。Figmaメタデータと視覚的な推論を区別し、デザインレビューや実装引き継ぎに使えます。

主な機能

  1. 01フレームとページのブリーフ
  2. 02コンポーネントとトークンの要約
  3. 03監査用の根拠収集
  4. 04実装引き継ぎ用の情報整理
  5. 05根拠ラベルとプライバシー確認

活用シーン

  1. 01選択したFigmaフレームの要約
  2. 02コンポーネントのバリアントと制約の記録
  3. 03UX監査用の根拠準備
  4. 04実装担当者へのデザイン情報の引き継ぎ

MCP 対応

接続済みのMCP選択からFigmaのコンテキストを取得できます。MCPにアクセスできない場合は、エクスポート、スクリーンショット、ノードメタデータ、または手動での情報提供を求めます。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/sergekostenchuk/ui-ux-agent-skill-system --skill figma-context-reader

インストール後、Claude Code で/figma-context-readerを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
assets/
context-brief-template.md
evals/
evals.json

詳細

Figma コンテキストリーダー

このスキルを使って、Figma のコンテキストを根拠に基づくデザインブリーフにまとめます。読み取り専用のスキルです。変更操作は figma-canvas-editor または figma-design-system-sync に振り分けてください。

モード

  • frame-brief:選択したフレームまたはページを要約します。
  • component-brief:コンポーネント、バリアント、プロパティ、制約を要約します。
  • token-brief:変数、スタイル、色の役割、間隔、角丸、タイポグラフィ、エフェクトを要約します。
  • audit-input:ux-audit-skill または design-critic-skill に必要な Figma の根拠を収集します。
  • handoff:実装スペシャリスト向けのコンテキストを準備します。

ワークフロー

  1. 入力の種類を確認します:Figma URL、選択したノード、ファイルキー、スクリーンショット/エクスポート、または接続済み MCP の選択項目。
  2. ../../shared/privacy-policy.md を適用します。
  3. use_figma の呼び出しが必要な場合は、最初にインストール済みの figma:figma-use スキルを呼び出します。
  4. 必要なノード、変数、コンポーネント、スタイル、アセットのみを読み取ります。ユーザーがライブラリ/システム関連の作業を求めていない限り、ファイル全体の広範なスキャンは避けます。
  5. 根拠のラベルを付けて、構造化されたコンテキストブリーフを作成します。Figma の直接的なメタデータと視覚的な推論を区別します。
  6. MCP にアクセスできない場合は、代替手段としてエクスポート、スクリーンショット、ノードのメタデータ、または Figma の詳細情報を手動で提供するよう依頼します。

出力形式

assets/context-brief-template.md を使用します。

根拠に関するルール

  • Figma metadata:ノード名、種類、レイアウトフィールド、変数、スタイル、コンポーネント名、アセット参照。
  • Visual inference:階層、注目度、密度、意図の推定、視覚的な仕上がり。
  • Missing:現在の Figma コンテキストから確認できない情報。

Figma のコンテキストだけを根拠に、DOM、実行時の動作、アクセシビリティスキャン、または実装に関する証拠を主張しないでください。

検証と評価

  • 最終ブリーフに、根拠の出典とプライバシーモードが明記されていることを確認します。
  • すべての実装に関する主張が、Figma のメタデータ、視覚的な推論、またはコンテキストが不足している旨の明示的な注記に基づいていることを確認します。
  • 接続済み Figma コンテキストとスクリーンショットのみの入力を区別する前方テストには、evals/evals.json を使用します。

リソース

  • ツールの利用可否が不明な場合は、$CODEX_SKILLS_DIR/senior-figma-orchestrator/references/figma-mcp-compatibility.md を読みます。
  • レポートには assets/context-brief-template.md を使用します。

コメント