unity-urp について
unity-urp は、Unity の URP アセットとレンダラー機能を管理するスキルモジュールです。描画設定を行う開発者向けで、機能追加前に実行環境での利用可否を確認します。
主な機能
- 01URP アセットとレンダラーレイアウトの確認
- 02HDR、MSAA、スケール、シャドウ設定の編集
- 03レンダラーと機能の一覧表示
- 04レンダラー機能の追加・削除・切り替え
活用シーン
- 01アクティブな URP アセットの確認
- 02シャドウやカメラテクスチャ設定の調整
- 03レンダラー機能の管理
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ besty0728/ unity-skills --skill unity-urpインストール後、Claude Code で/unity-urpを入力して読み込まれたか確認します。
詳細
このモジュールのスキルを呼び出す前に: 名前や説明から推測したパラメーターを使ってスキルを呼び出そうとしている場合は、いったん止めて、このファイルを読むか、
GET /skills/recommend?includeSchema=trueでスキーマを取得してください。recommend/schema からすでにパラメーター定義を取得している場合は、そのまま dryRun に進めます。
トリガー
- URP アセットの設定
- レンダラー機能の追加または編集
- URP のレンダリング設定の調整
- URP アセットの設定、レンダラー機能の追加または編集、URP のレンダリング設定の調整
URP スキル
Unity 2022.3 以降(URP 14 および Unity 6 / URP 17)向けの、URP 固有のアセットおよびレンダラー機能の管理です。
動作モード
- クエリスキル(
urp_get_info、urp_list_renderers、urp_list_renderer_features)はSkillMode.SemiAutoです。許可なしで 3 つすべてのモードで実行されます。 - 変更スキル(
urp_set_asset_settings、urp_add_renderer_feature、urp_set_renderer_feature_active)はSkillMode.FullAutoです。Approval ではユーザーの許可が必要です(許可するとサーバー側で 1 回実行され、結果が返されます)。Auto / Bypass では直接実行されます。 urp_remove_renderer_featureにはSkillOperation.Deleteが設定されており、Approval / Auto モードでは自動的に禁止されます(NeverInSemi)。実行できるのは Bypass またはユーザーが管理する Allowlist のみです。
URP パッケージのスタブ
このモジュールは com.unity.render-pipelines.universal(URP)を対象にコンパイルされています。URP がインストールされていない場合、すべてのスキルはスタブ { error: "Universal Render Pipeline package … is not installed." }(RenderPipelineSkillsCommon.NoURP())を返します。このスタブは診断用のペイロードであり、許可の拒否ではありません。許可は不要で、NeverInSemi としても扱われません。このエラーが表示された場合は、まず project_get_render_pipeline を呼び出してください。
ガードレール
禁止事項:
- このモジュールを ShaderGraph に使用しないでください
- 任意のカスタムレンダラー機能を安全にインスタンス化できると想定しないでください
- Unity 2022 と Unity 6 で、同じ組み込みレンダラー機能が公開されていると想定しないでください
ランタイム優先のルール:
urp_add_renderer_featureの前に、必ずurp_get_infoを呼び出してくださいurp_get_info.creatableRendererFeaturesが返した名前のみを使用してくださいRenderObjects、FullScreenPassRendererFeature、ScreenSpaceReflectionRendererFeatureなどを、あらゆる環境で利用可能なものとしてハードコードしないでくださいurp_set_renderer_feature_activeまたはurp_remove_renderer_featureを呼び出す前に、urp_list_renderer_featuresを使用して既存の機能名/インデックスを確認してください
検証済みの動作:
- Unity 2022.3 と URP 14 の実環境では、作成可能な機能のセットが小さく、たとえば
DecalRendererFeatureとScreenSpaceAmbientOcclusionのみの場合があります - Unity 6 と URP 17 の実環境では、より多くの機能が公開される場合があります
スキル
urp_get_info
アクティブな URP アセットとレンダラーの構成を調べます。
urp_set_asset_settings
HDR、MSAA、レンダースケール、シャドウ、カメラテクスチャなど、URP アセットの主要な設定を変更します。
urp_list_renderers
アクティブな URP アセット上のレンダラーデータアセットを一覧表示します。
urp_list_renderer_features
指定したレンダラーのレンダラー機能を一覧表示します。
urp_add_renderer_feature
安全な組み込みレンダラー機能をレンダラーに追加します。
urp_remove_renderer_feature
レンダラーからレンダラー機能を削除します。
urp_set_renderer_feature_active
レンダラー機能を有効または無効にします。
正確なシグネチャ
正確な名前、パラメーター、デフォルト値、戻り値は、このファイルではなく GET /skills/schema または unity_skills.get_skill_schema() で定義されています。