library-variables-figma

library-variables-figma — チームライブラリの変数を検索してインポートする

現在のファイルが登録しているライブラリで公開されている変数を参照し、必要なものをインポートします。インポートされた変数にはローカル ID が付与され、通常のローカル変数と同じように使用できます（バインド、読み取り、参照が可能です）。

スキルの適用範囲

• use_figma のルール — まず公式の figma-use スキルを読み込んでください。これは Figma Plugin API の完全なリファレンスです。これらのスクリプトが前提とする基本事項：トップレベルの await と return を使ったプレーンな JS（IIFE や figma.closePlugin() は使わない。console.log の出力は返されない）、各スクリプトの先頭で入力値を const としてインラインで指定、色の値は 0～1 の範囲、テキスト操作の前にフォントを読み込む、await figma.getNodeByIdAsync(...) を使う、そして アトミックエラー（スクリプトが失敗した場合は何も適用されないため、エラーを確認して修正し、再試行する）。
• ライブラリ変数以外のローカル変数 → export-tokens-figma、manage-variables-figma

ワークフロー

1. 検索する。 scripts/list-library-variables.js を use_figma（skillNames: "library-variables-figma"）経由で実行します。必要に応じて LIBRARY_NAME / COLLECTION_NAME / TYPE フィルターを設定できます。登録されている各コレクションと、その中のすべての変数の key が返されます。
2. インポートする。 変数の key を scripts/import-library-variable.js に入力して実行します。各変数の新しい localId が返されます。再インポートしても結果は変わりません（同じローカル ID が返されます）。
3. 使用する。 インポートした変数をノードのプロパティにバインドするか、ローカルのセマンティックトークンから参照します（バインドについては figma-use / manage-variables-figma を参照）。

注意事項

• 表示されるのは登録済みのライブラリのみです。コレクションが見つからない場合は、まずファイルのライブラリ設定でライブラリを有効にしてください（手動での Figma 操作が必要です）。
• getVariablesInLibraryCollectionAsync には ID ではなく、コレクションのキーを指定します。
• ライブラリ変数はソースへの読み取り専用の参照です。値を編集する場合は、ここではなくライブラリファイルで編集してください。