unity-package

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

トリガー

• UPM パッケージの追加または削除
• インストール済みバージョンの確認
• レジストリの検索
• パッケージ操作のスクリプト化
• UPM パッケージの追加または削除、インストール済みバージョンの確認、レジストリの検索、パッケージ操作のスクリプト化

パッケージスキル

インストール済みの Unity パッケージと、Cinemachine や Splines のセットアップなど、パッケージ関連のヘルパーワークフローを管理します。

ガードレール

動作モード（v1.9 の 3 階層）：

• Approval（デフォルト）：クエリスキル（package_list、package_check、package_search、package_get_dependencies、package_get_versions、package_get_cinemachine_status）は直接実行されます。package_refresh だけが FullAuto の変更操作です。MODE_RESTRICTED の場合は、その実行に許可プロトコルを適用してください。それ以外の変更操作はすべて自動的に禁止されます（次の項目を参照）。許可を与えても解除されません。
• Auto ／ Bypass：SemiAuto と FullAuto は直接実行されます。
• このモジュールで自動的に禁止される操作：package_install、package_remove、package_install_cinemachine、package_install_splines（すべて MayTriggerReload = true、RiskLevel = "high"。さらに package_remove には SkillOperation.Delete も設定されています）。これらは Approval と Auto の両方で MODE_FORBIDDEN を返します。実行できるのは Bypass モードまたはユーザーが管理する Allowlist エントリー経由のみです。許可フローでも MODE_FORBIDDEN が返されるため、試行しないでください。
• インストール／削除／更新のジョブは、jobId を直ちに返します。実際のパッケージのインポートと Domain Reload は非同期で実行され、一時的に REST サーバーが利用できなくなることがあります。job_status ／ job_wait でポーリングしてください。

禁止事項（よくある誤り）：

• package_add ／ package_update は存在しません。package_install を使用してください。
• package_get_info は存在しません。package_list、package_check、package_get_dependencies、package_get_versions のいずれかを使用してください。
• package_search はインストール済みパッケージのキャッシュのみを検索します。Unity Registry には問い合わせません。
• パッケージのクエリスキルは Domain Reload 後にキャッシュを自動的に初期化します。起動直後の短い期間は、{ success: false, status: "refreshing", cacheReady: false, retryStrategy: "wait_and_retry", retryAfterSeconds: 2 } を返します。これを installed=false と解釈せず、再試行してください。
• パッケージのインストール／削除／更新ジョブは、パッケージのインポートと Domain Reload を引き起こすことがあります。一時的にサーバーが利用できなくなることを想定し、返されたジョブ ID を使用してください。

ルーティング：

• Cinemachine のクイックセットアップには、package_install_cinemachine を使用してください。
• Splines のクイックセットアップには、package_install_splines を使用してください。
• プロジェクトのマニフェストを調べるには、project_get_packages を使用してください。
• パッケージインストール後に define シンボルを変更するには、debug_set_defines を使用してください。

スキル

package_list

UnitySkills が現在キャッシュしている、インストール済みパッケージをすべて一覧表示します。 パラメーター： なし。

戻り値： { success, count, packages }

package_check

パッケージがインストールされているかどうかを確認します。

パラメーター	型	必須	デフォルト	説明
packageId	string	はい	-	com.unity.cinemachine などのパッケージ ID

戻り値： { packageId, installed, version }

package_install

パッケージをインストールします。リクエストが受け付けられると、非同期ジョブを返します。

パラメーター	型	必須	デフォルト	説明
packageId	string	はい	-	インストールするパッケージ ID
version	string	いいえ	null	任意の明示的なバージョン

戻り値： { success, status, jobId, message, serverAvailability }

package_remove

インストール済みパッケージを削除します。リクエストが受け付けられると、非同期ジョブが返されます。

パラメーター	型	必須	デフォルト	説明
packageId	string	はい	-	削除するインストール済みパッケージ ID

戻り値： { success, status, jobId, message, serverAvailability }

package_refresh

クエリスキルで使用するインストール済みパッケージのキャッシュを更新します。 パラメーター： なし。

戻り値： { success, status, jobId, message }

package_install_cinemachine

サポートされているパッケージ／バージョン戦略を使用して Cinemachine をインストールします。

パラメーター	型	必須	デフォルト	説明
version	int	いいえ	3	CM2 の場合は 2、CM3 の場合は 3。その他の値は拒否されます

注：

• CM3 は Splines の依存関係を自動的にインストールします。
• 要求された系列がすでにインストールされている場合、このスキルはジョブを作成せず、即座に成功を返すことがあります。

戻り値： { success, status?, jobId?, message, serverAvailability? }

package_install_splines

現在の Unity エディター系列に推奨されるバージョンの Unity Splines をインストールまたはアップグレードします。 パラメーター： なし。

戻り値： { success, status?, jobId?, message, serverAvailability? }

package_get_cinemachine_status

Cinemachine と Splines の現在のインストール状況を取得します。 パラメーター： なし。

戻り値： { cinemachine, splines }

package_search

パッケージ名または表示名で、インストール済みパッケージのキャッシュを検索します。

パラメーター	型	必須	デフォルト	説明
query	string	はい	-	検索キーワード

戻り値： { success, query, count, packages }

package_get_dependencies

インストール済みパッケージ 1 つの依存関係情報を取得します。

パラメーター	型	必須	デフォルト	説明
packageId	string	はい	-	インストール済みパッケージ ID

戻り値： { success, packageId, version, dependencyCount, dependencies }

package_get_versions

インストール済みパッケージ 1 つで利用可能なバージョンを取得します。

パラメーター	型	必須	デフォルト	説明
packageId	string	はい	-	インストール済みパッケージ ID

戻り値： { success, packageId, currentVersion, compatibleVersion, latestVersion, allVersions }

正確なシグネチャ

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