unity-bookmark

このモジュールのスキルを呼び出す前に： 名前や説明から推測したパラメーターでスキルを呼び出そうとしている場合は、いったん停止し、まずこのファイルを読むか、GET /skills/recommend?includeSchema=true でスキーマを取得してください。recommend/schema からすでにパラメーター定義を取得している場合は、そのまま dryRun に進めます。

トリガー

• Scene View の視点を保存または復元する
• カメラアングルをブックマークする
• 保存したシーン位置間を移動する
• シーンの視点を保存または復元する、カメラ位置をブックマークする、保存済みの位置間を切り替える

ブックマークスキル

Scene View のカメラ位置を保存して呼び出します。

ガードレール

動作モード（v1.9 の三層構成）：

• Approval（デフォルト）：bookmark_list のみ SkillMode.SemiAuto（読み取り専用）としてマークされているため、Approval モードでは grant プロトコルを経ずに直接実行できます。bookmark_set（Operation.Create。ブックマークテーブルに書き込み）と bookmark_goto（Operation.Execute。エディターの選択オブジェクトと Scene View の視点を変更）はどちらも副作用があるため、デフォルトの SkillMode.FullAuto が適用され、Approval モードでは grant が必要です。workflow モジュールのドキュメントと整合しています（C# の WorkflowSkills.cs にある属性の指定が基準です）。
• Auto／Bypass：SemiAuto と FullAuto は直接実行されます。
• このモジュールで Auto モードでは禁止されるスキル：bookmark_delete（SkillOperation.Delete）。Bypass モード、またはユーザーが管理する Allowlist エントリーを介した場合にのみ実行できます。grant フローは MODE_FORBIDDEN を返します。ブックマークはメモリ上にのみ存在するため、bookmark_delete はエントリーを削除するだけで、アセットの入出力は行いません。

禁止事項（よくある誤った推測）：

• bookmark_save は存在しません。bookmark_set を使用してください。
• bookmark_load／bookmark_restore は存在しません。bookmark_goto を使用してください。
• bookmark_remove は存在しません。bookmark_delete を使用してください。
• ブックマークに保存されるのは Scene View の位置と現在の選択項目であり、シーンの状態ではありません。

ルーティング：

• ワークフローのスナップショット（オブジェクト状態の取り消し）には、workflow モジュールを使用します。
• シーンの保存／読み込みには、scene モジュールを使用します。

スキル

bookmark_set

現在の選択項目とシーンビューの位置をブックマークとして保存します。

パラメーター	型	必須	デフォルト	説明
bookmarkName	string	はい	-	ブックマーク名
note	string	いいえ	null	ブックマークに付ける任意のメモ

戻り値： { success, bookmark, selectedCount, hasSceneView, note }

bookmark_goto

ブックマークから選択項目とシーンビューを復元します。

パラメーター	型	必須	デフォルト	説明
bookmarkName	string	はい	-	ブックマーク名

戻り値： { success, bookmark, restoredSelection, note }

bookmark_list

保存済みのブックマークをすべて一覧表示します。

パラメーターはありません。

戻り値： { success, count, bookmarks: [{ name, selectedCount, hasSceneView, note, createdAt }] }

bookmark_delete

ブックマークを削除します。

パラメーター	型	必須	デフォルト	説明
bookmarkName	string	はい	-	ブックマーク名

戻り値： { success, deleted }

正確なシグネチャ

正確な名前、パラメーター、デフォルト値、戻り値は、このファイルではなく GET /skills/schema または unity_skills.get_skill_schema() で定義されています。