unity-project について
unity-projectは、設定やビルド情報を確認するUnity開発者向けのプロジェクト調査スキルです。プロジェクト、レンダーパイプライン、パッケージ、シェーダー、各種設定を読み取り専用で照会でき、Playerのビルドにも対応します。
主な機能
- 01Unityバージョンとプロジェクト情報を取得
- 02レンダーパイプラインとシェーダーを確認
- 03パッケージ、レイヤー、タグを一覧表示
- 04ビルドとPlayerの設定を取得
- 05Playerを非同期でビルド
活用シーン
- 01プロジェクト設定の確認
- 02利用可能なシェーダーやパッケージの調査
- 03ビルド対象とシーンの確認
- 04Playerビルドの作成
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ besty0728/ unity-skills --skill unity-projectインストール後、Claude Code で/unity-projectを入力して読み込まれたか確認します。
詳細
このモジュール内のスキルを呼び出す前に: 名前や説明から推測したパラメーターを使ってスキルを呼び出そうとしている場合は、いったん停止し、まずこのファイルを読むか、
GET /skills/recommend?includeSchema=trueを使ってスキーマを取得してください。recommend/schema からパラメーターの定義をすでに取得している場合は、そのまま dryRun に進めます。
トリガー
- Unity のバージョンを確認する
- レンダーパイプラインを検出する
- インストール済みのシェーダー/パッケージを一覧表示する
- Unity のバージョンの確認、レンダーパイプラインの判定、インストール済みのシェーダー/パッケージの一覧表示
プロジェクトスキル
プロジェクト情報と設定。
動作モード
build_player は RiskLevel=high の実際のビルド操作であり、Bypass または Allowlist によって許可された後にのみ実行できます。project_add_tag のデフォルトは FullAuto です。残りの 8 個の照会スキルは、すべて SemiAuto の読み取り専用操作です。
Player Settings、Build Settings、Layer は、このモジュールから読み取り専用で取得できます。編集する場合は、
editor_execute_menuを使ってEdit/Project Settings...またはFile/Build Settings...を開いてください。注意:editor_execute_menu自体が auto-forbidden です(editor モジュールで、MayTriggerReload = trueに指定):Approval モードと Auto モードでは、どちらもMODE_FORBIDDENが返され、grant でも解除されません。Bypass または Allowlist に該当する場合のみ呼び出せます。それ以外のモードでは、これらのウィンドウを手動で開くようユーザーに案内してください。
禁止事項(よくある誤り):
project_saveは存在しません →scene_save(scene モジュール)またはeditor_execute_menuの menuPath="File/Save" を使用してください。どちらも auto-forbidden(RiskLevel="high"/MayTriggerReload)であり、Bypass または Allowlist の場合のみ呼び出せます。project_settingsは存在しません →project_get_render_pipeline、project_get_build_settingsなど、用途に応じたスキルを使用してください。project_set_resolution/project_set_player_settingsは存在しません → Player Settings はproject_get_player_settingsで読み取り専用として取得できます。編集するには、editor_execute_menuでEdit/Project Settings...を開いてください(このスキルは auto-forbidden であり、Bypass または Allowlist の場合のみ呼び出せます。それ以外の場合は、手動で開くようユーザーに案内してください)。project_createは存在しません → プロジェクトは REST API ではなく、Unity Hub から作成します。
ルーティング:
- グラフィックス/品質/SRP の設定には
graphicsモジュールを使用してください。 - Layer/Tag の管理には
project_add_tag(このモジュール)を使用してください。Layers はproject_get_layersで読み取り専用として取得できます(編集するにはeditor_execute_menu→Edit/Project Settings...が必要ですが、このスキルは auto-forbidden のため、Bypass または Allowlist の場合のみ呼び出せます)。 - ビルド設定の確認には
project_get_build_settings、プレイヤーのビルドにはbuild_playerを使用してください。
スキル
project_get_info
レンダーパイプライン、Unity のバージョン、設定など、プロジェクト情報を取得します。 パラメーター: なし。
project_get_render_pipeline
現在のレンダーパイプラインの種類と推奨シェーダーを取得します。 パラメーター: なし。
project_list_shaders
プロジェクトで利用可能なシェーダーをすべて一覧表示します。 パラメーター:
filter(string、省略可):名前で絞り込みます。limit(int、省略可):結果の最大数(デフォルトは 50)。
project_get_build_settings
ビルド設定(プラットフォーム、シーン)を取得します。
パラメーター: なし。
戻り値: { success, activeBuildTarget, buildTargetGroup, sceneCount, scenes }
build_player
BuildPipeline.BuildPlayer を使ってプレイヤーをビルドし、非同期 Job とともに直ちに返します。
パラメーター: outputPath?、target?、scenes?、development=false、overwrite=false。出力先はプロジェクト内かつ Unity 管理フォルダーの外にする必要があります。
戻り値: {success, status:"accepted", jobId, kind, platform, outputPath, scenes}。/jobs/{id} をポーリングしてください。最終結果には BuildReport の概要が含まれます。
project_get_packages
インストール済みの UPM パッケージを一覧表示します。
パラメーター: なし。
戻り値: { success, manifest }
project_get_layers
すべての Layer 定義を取得します。
パラメーター: なし。
戻り値: { success, count, layers }
project_get_tags
すべての Tag 定義を取得します。
パラメーター: なし。
戻り値: { success, count, tags }
project_add_tag
カスタム Tag を追加します。
| パラメーター | 型 | 必須 | デフォルト | 説明 |
|---|---|---|---|---|
| tagName | string | はい | - | 追加する Tag 名 |
戻り値: { success, tag }
project_get_player_settings
プレイヤー設定を取得します。
パラメーター: なし。
戻り値: { success, productName, companyName, bundleVersion, defaultScreenWidth, defaultScreenHeight, fullscreen, apiCompatibility, scriptingBackend }
正確なシグネチャ
正確な名前、パラメーター、デフォルト値、戻り値は、このファイルではなく、GET /skills/schema または unity_skills.get_skill_schema() で定義されています。