setup-design-tokens-figma

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

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

スキルの範囲

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

ワークフロー

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

注意事項

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