figma-design-system-sync

Figma デザインシステム同期

Figma での作業が、変数、スタイル、コンポーネント、バリアント、エフェクト、アセット、Code Connect、ローカルコードトークンなど、再利用可能なシステムの契約に関わる場合に、このスキルを使用します。

モード

• audit：Figma のシステム成果物とローカルコードの規約を比較します。
• sync-plan：変数／スタイル／コンポーネントの更新を計画します。
• token-map：Figma の変数をローカルトークンに対応付けます。
• component-map：コンポーネントとバリアントをコードコンポーネントに対応付けます。
• code-connect：インストール済みの Figma スキルを通じて Code Connect ファイルを作成またはレビューします。
• governance：命名、バージョニング、ロールアウトのルールを提案します。

ワークフロー

1. 現在のコンテキスト概要がない場合は、figma-context-reader を使って Figma のコンテキストを読み取ります。
2. 同期アクションを推奨する前に、ローカルのコードトークン／コンポーネントを調べます。
3. Code Connect が要求された場合は、利用可能であれば figma:figma-code-connect を呼び出します。
4. 差分を作成します。Figma のソース、コードの対象、ステータス、リスク、変更案を記載します。
5. 変更を行う場合は、対象範囲を明示して figma-canvas-editor または figma-apply-effects に委任します。
6. JSON／トークンの出力をローカルで検証してから、根拠として扱います。

ガードレール

• 移行マップなしに、変数／コンポーネント／スタイルの名前を変更したり、削除したりしないでください。
• 生成コードや生成変数は、レビューが完了するまで信頼できる唯一の情報源として扱わないでください。
• 各成果物について、どちらの方向を正とするか（Figma からコード、コードから Figma、または手動で調整）を記録してください。
• 変数のバインドに関する保証は、現在の Figma Plugin API のサポートと互換性を保ってください。

安全性とプライバシー

• 未公開のトークン、ライブラリ名、コンポーネント一覧、ソースコンポーネントのコードは機密情報として扱ってください。
• 明示的な移行マップとロールバック手順なしに、変数／コンポーネントの名前を変更して反映しないでください。
• 承認なしに、非公開のトークンエクスポートやコンポーネントのスナップショットを外部サービスにアップロードしないでください。

出力形式

assets/design-system-sync-report.md を使用します。

リソース

• 現在の機能を確認するには、$CODEX_SKILLS_DIR/senior-figma-orchestrator/references/figma-mcp-compatibility.md をお読みください。