figjam-create-content

figjam-create-content — FigJam ボードの作成と読み取り

FigJam ボードを要素ごとに作成し、内容を読み取ります。付箋（単体および一括）、 コネクタ、テキスト付き図形、セクション、テーブル、コードブロック、自動配置に加え、 get board contents と get connections に対応しています。ネイティブの一括処理 generate_diagram では大まかすぎる場合（たとえば、特定の色や位置、接続点を指定したい場合や、 既存のボードを拡張したい場合）に、細かく制御できます。

スキルの範囲

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

ワークフロー

1. FigJam ファイルであることを確認します。 FigJam 以外では、すべての操作がエラーになります。最初に確認してください： return { editorType: figma.editorType }; — 'figjam' である必要があります。
2. 操作を選択します：references/figjam-snippets.md から選びます。付箋／複数の付箋／コネクタ／テキスト付き図形／セクション／テーブル／コードブロックの作成、自動配置、またはボードの内容／接続の読み取りです。
3. スニペットを実行します：use_figma（skillNames: "figjam-create-content"）経由で実行し、インライン化された定数（テキスト、位置、色、ノード ID）を編集します。
4. コネクタには実際のノード ID が必要です。 先にノードを作成して返された ID を取得し、その ID を参照するコネクタを作成します（始点／終点と接続点）。
5. 作成した ID を返し、一括操作の後はボードを読み取って（get board contents）確認します。

注意事項

• テキストを設定する前にフォントを読み込んでください。 付箋、テキスト付き図形、テーブルのセル、コネクタのラベルでは、いずれもテキストを書き込みます。各スニペットは .characters を設定する前に await figma.loadFontAsync(...) を実行し、デフォルトフォントを利用できない場合に備えて Inter にフォールバックします。
• 付箋の色には名前付きパレット（YELLOW、BLUE、GREEN、PINK、ORANGE、PURPLE、RED、LIGHT_GRAY、GRAY）を使います。それ以外の色では、デフォルトの付箋の塗りつぶしが使われます。
• 図形の shapeType の値：SQUARE、ROUNDED_RECTANGLE、ELLIPSE、DIAMOND、TRIANGLE_UP、 TRIANGLE_DOWN、PARALLELOGRAM_RIGHT、PARALLELOGRAM_LEFT など。
• コネクタの接続点：AUTO、TOP、BOTTOM、LEFT、RIGHT。
• これらのツールを使うには Figma Desktop アプリが必要です（Plugin API はブラウザーでは利用できません）。