figma-setup-design-tokens

figma-setup-design-tokens — アトミックなトークンシステムの初期構築

1 回の use_figma 呼び出しで、変数コレクション、モード、すべての変数を作成します。新しいトークンシステム（または既存のコレクション内の新しいトークンシステム）を最速で立ち上げる方法です。1 つのアトミックなスクリプトとして実行されるため、すべてが作成されるか、何も作成されないかのどちらかです（スクリプトが失敗した場合、変更は適用されません）。

スキルの適用範囲

• use_figma のルール — まず公式の figma-use スキルを読み込んでください。これは Figma Plugin API の完全なリファレンスです。このスクリプトが前提とする基本事項は、トップレベルの await と return を使ったプレーンな JS（IIFE と figma.closePlugin() は使用しない。console.log の内容は返されません）、各スクリプトの先頭で const として入力値をインライン化すること、0～1 の範囲で色を指定すること、テキスト操作の前にフォントを読み込むこと、await figma.getNodeByIdAsync(...) を使うこと、そして アトミックなエラー処理（スクリプトが失敗すると何も適用されません。エラーを読み、修正して再試行してください）です。
• 既存システムへの段階的な CRUD／一括編集 → figma-manage-variables。
• コードのトークンファイルから同期 → figma-import-tokens。

ワークフロー

1. v1 の範囲を合意します。 コレクション名、モード（最初のモードがデフォルトです）、モードごとの値を含む完全なトークンセットを一覧にします。作成前に確定してください。後から編集するより、はるかに手間がかかりません。
2. scripts/setup-tokens.js の定数を設定します。COLLECTION_NAME、MODES、TOKENS（モード名をキーとする値）、および任意の変数ごとの SCOPES を指定します。
3. use_figma を使って実行します（skillNames: "figma-setup-design-tokens"）。{ collectionId, modes, created, errors } が返されます。
4. get_variable_defs または figma-export-tokens の読み取りスクリプトで検証し、スウォッチも作成した場合はスクリーンショットを撮影します。

注意事項

• 2 層構成のシステム：このスキルで プリミティブ（生の値）を作成し、次に figma-import-tokens（エイリアスの処理機能があります）または figma-manage-variables を使って、それらをエイリアスとして参照する セマンティック トークンを作成します。プリミティブは単一モードにし、テーマ設定はセマンティック層にまとめてください。
• スコープを設定します：デフォルトの ALL_SCOPES を使うと、すべてのプロパティピッカーが煩雑になります。各トークンが属する対象に合わせて SCOPES を渡してください（背景には FRAME_FILL／SHAPE_FILL、テキストには TEXT_FILL、間隔には GAP、角丸には CORNER_RADIUS、サイズ設定には WIDTH_HEIGHT）。
• コレクションごとに初期構築は 1 回にしてください。コレクションが複数ある場合は、実行も複数回必要です。