figma-manage-variables

figma-manage-variables — 変数／コレクション／モードの CRUD

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(...) を使うこと、そしてアトミックなエラー処理（スクリプトが失敗すると変更は一切適用されません。エラーを読み、修正して再試行してください）です。
• ゼロからのセットアップ → figma-setup-design-tokens。コードとの同期 → figma-import-tokens / figma-export-tokens。

ワークフロー

1. 対象を特定します。 ほとんどの操作には ID が必要です。figma-export-tokens の読み取りスクリプトまたは get_variable_defs から variableId／modeId／collectionId を取得します。コレクションはスクリプト内で名前を使って検索することもできます。
2. 操作を選びます。 references/variable-ops.md には、コレクションの作成、変数の作成、一括作成、一括更新、名前の変更、スコープの設定、モードの追加／名前の変更、削除それぞれに、コピーしてすぐ使える use_figma スニペットがすべて掲載されています。
3. use_figma で実行します（skillNames: "figma-manage-variables"）。大量の値を更新する場合は scripts/batch-update-variables.js を使います（値ごとに 1 回呼び出す方法より 10～50 倍高速です）。
4. 確認します。 すべてのスニペットは、影響を受けた ID／名前を返します。get_variable_defs で読み戻して確認してください。削除する場合は、事前に必ずユーザーに確認してください。コレクションを削除すると、そのすべての変数が削除され、それらを参照するもののバインドが解除されます。

主なルール

• 色の範囲は 0～1 です。 16 進数の入力には hexToRgb を使います。
• 新しい変数には必ず scopes を設定してください。 デフォルトの ALL_SCOPES はすべてのピッカーに表示されます。
• コード構文を設定します（setVariableCodeSyntax('WEB', '--token-name')）。デザインとコードの命名を一致させるためです。
• 名前の変更は安全です。値と既存のバインドは保持されます。削除は取り消せない操作です。
• エイリアス：v.setValueForMode(modeId, figma.variables.createVariableAlias(targetVar)) を使って、ある変数を別の変数にバインドします。