mcpField
U
unity-project

unity-project

github.com/besty0728開発1.9k81 回インストール今日更新
リポジトリ

unity-project について

unity-projectは、設定やビルド情報を確認するUnity開発者向けのプロジェクト調査スキルです。プロジェクト、レンダーパイプライン、パッケージ、シェーダー、各種設定を読み取り専用で照会でき、Playerのビルドにも対応します。

主な機能

  1. 01Unityバージョンとプロジェクト情報を取得
  2. 02レンダーパイプラインとシェーダーを確認
  3. 03パッケージ、レイヤー、タグを一覧表示
  4. 04ビルドとPlayerの設定を取得
  5. 05Playerを非同期でビルド

活用シーン

  1. 01プロジェクト設定の確認
  2. 02利用可能なシェーダーやパッケージの調査
  3. 03ビルド対象とシーンの確認
  4. 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 を追加します。

パラメーター型必須デフォルト説明
tagNamestringはい-追加する Tag 名

戻り値: { success, tag }

project_get_player_settings

プレイヤー設定を取得します。

パラメーター: なし。

戻り値: { success, productName, companyName, bundleVersion, defaultScreenWidth, defaultScreenHeight, fullscreen, apiCompatibility, scriptingBackend }


正確なシグネチャ

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

コメント