build-slides-figma

build-slides-figma — Figma Slides デッキを作成する

Figma Slides のプレゼンテーションを作成・編集します。スライドグリッドの管理（一覧表示／作成／複製／並べ替え ／削除／フォーカス／スキップ）、コンテンツの追加（テキスト、図形、背景色）、トランジションの制御ができます。各 スライドは SLIDE ノードで、デッキは 2D グリッドです（figma.getSlideGrid() → スライドの行）。

スキルの適用範囲

• use_figma のルール — まず公式の figma-use スキルを読み込んでください。これは Figma Plugin API の完全なリファレンスです。これらのスクリプトで必要となる基本事項は、トップレベルの await と return を使った通常の JS（IIFE や figma.closePlugin() は使わないこと。console.log は戻り値として返されません）、各スクリプトの先頭で入力値を const としてインライン化すること、色の値は 0～1 の範囲にすること、テキスト操作の前にフォントを読み込むこと、await figma.getNodeByIdAsync(...) を使うこと、そしてアトミックなエラー処理（スクリプトが失敗すると変更は一切適用されません。エラーを読み、修正して再試行してください）です。
• 操作ごとに完全なスニペットを 1 つ使用します → references/slides-snippets.md。

ワークフロー

1. Slides ファイルであることを確認します。 Slides 以外では、すべての操作がエラーになります。まず次を確認してください。 return { editorType: figma.editorType }; — 値が 'slides' である必要があります。
2. スライドを一覧表示して、ID とグリッド上の位置を取得します（scripts／スニペットの List slides）。他のすべての操作では、スライド ID を参照します。
3. references/slides-snippets.md から操作を選びます。スライドの作成／複製／削除／並べ替え、テキスト／図形の追加、背景の設定、トランジションの設定／取得、フォーカス、スキップ、スライドの内容の読み取りができます。
4. スニペットを実行します。use_figma を使い（skillNames: "build-slides-figma"）、インライン化された定数を編集してください。
5. 作成／変更したスライド ID を返し、再度一覧表示するか、内容を読み取って確認します。

注意事項

• テキストの追加前にフォントを読み込みます。 add text to slide は .characters を設定する前に await figma.loadFontAsync({ family, style }) を呼び出します。必ずこの処理を行ってください。デフォルトは Inter / Regular です。
• figma.createSlide({ row, col }) でグリッド上の位置を指定して作成するか、figma.createSlide() で末尾に追加できます。
• トランジションの style 値：NONE、DISSOLVE、SLIDE_FROM_LEFT、SLIDE_FROM_RIGHT、 SLIDE_FROM_BOTTOM、SLIDE_FROM_TOP、PUSH_FROM_LEFT、PUSH_FROM_RIGHT、PUSH_FROM_BOTTOM、 PUSH_FROM_TOP、SMART_ANIMATE。タイミングのデフォルト値は { type: 'ON_CLICK' } です。
• 背景は、全面を覆う（1920×1080）Background の長方形としてインデックス 0 に挿入されます。 再実行すると重ねて追加せず、既存の背景を更新します。
• reorder にはスライド ID の 2D 配列（行 × 列）を指定し、figma.setSlideGrid でグリッドを再構築します。現在のグリッドに存在しない ID を指定すると、エラーになります。
• スキップは slide.isSkippedSlide を切り替えます（注意：プロパティ名は skipped ではなく isSkippedSlide です）。
• これらのツールを使うには Figma Desktop アプリが必要です（ブラウザーでは Plugin API を利用できません）。