unity-postprocess について
unity-postprocessは、UnityのSRP Volumeフレームワークで最新のURPおよびHDRPのポストプロセスを設定するスキルモジュールです。利用可能なエフェクトの確認や、VolumeProfile内のオーバーライドの追加、設定、削除に対応します。
主な機能
- 01アクティブなパイプラインの対応エフェクト一覧
- 02エフェクトオーバーライドの確認
- 03プロファイルへのオーバーライド追加・削除
- 04エフェクトパラメーターの設定
- 05一般的なポストプロセスの設定
活用シーン
- 01アクティブなパイプラインの利用可能なエフェクトを確認
- 02プロファイルにBloomや被写界深度を追加
- 03トーンマッピングやビネットのパラメーターを調整
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ besty0728/ unity-skills --skill unity-postprocessインストール後、Claude Code で/unity-postprocessを入力して読み込まれたか確認します。
詳細
このモジュールのスキルを呼び出す前に: 名前や説明から推測したパラメーターを使ってスキルを呼び出そうとしている場合は、いったん中止して、このファイルを読むか、
GET /skills/recommend?includeSchema=trueでスキーマを取得してください。recommend/schema からすでにパラメーター定義を取得している場合は、そのまま dryRun に進めます。
トリガー
- ポストプロセスの設定
- VolumeProfile へのエフェクトの追加
- URP/HDRP シーンの見た目の調整
- ポストプロセスの設定、VolumeProfile へのエフェクトの追加、URP/HDRP シーンの見た目の調整
ポストプロセススキル
SRP Volume フレームワークを基盤とする、最新の URP / HDRP ポストプロセススキルです。Volume コンテナー/プロファイルの CRUD(volume_profile_create、volume_create など)には、volume モジュールを使用してください。
動作モード
- クエリスキル(
postprocess_list_effects、postprocess_get_effect)はSkillMode.SemiAutoです。許可なく、3 つすべてのモードで実行されます。 - 変更スキル(
postprocess_add_effect、postprocess_set_parameter、postprocess_set_bloom、postprocess_set_depth_of_field、postprocess_set_tonemapping、postprocess_set_vignette、postprocess_set_color_adjustments)はSkillMode.FullAutoです。Approval ではユーザーの許可が必要です(許可するとサーバー側で 1 回実行され、結果が返されます)。Auto/Bypass では直接実行されます。 postprocess_remove_effectにはSkillOperation.Deleteが設定されており、Approval/Auto モードでは自動的に禁止されます(NeverInSemi)。実行できるのは Bypass またはユーザー管理の Allowlist のみです。
SRP パッケージスタブ
このモジュールは com.unity.render-pipelines.core(SRP_CORE)を使用してコンパイルされます。URP と HDRP のどちらもインストールされていない場合(SRP Core がない場合)、すべてのスキルはスタブ { error: "Scriptable Render Pipeline Core package … is not installed." }(RenderPipelineSkillsCommon.NoSRP())を返します。このスタブは診断用ペイロードであり、権限による拒否ではありません。許可は不要であり、NeverInSemi としても扱われません。
ガードレール
禁止事項:
- このモジュールを PPv2/
com.unity.postprocessingに使用しないでください。 - 一般的な Volume コンテナー/プロファイル管理にこのモジュールを使用しないでください。その場合は
volumeを使用してください。
ランタイム優先のルール:
- アクティブなパイプラインにエフェクトが存在すると決めつける前に、必ず
postprocess_list_effectsを呼び出してください。 - 汎用パラメーターを設定する前に、
postprocess_get_effectまたはvolume_get_componentを使って実際のパラメーター名を確認してください。 - 汎用パラメーター名を推測するより、専用の高頻度スキル(
postprocess_set_bloom、postprocess_set_depth_of_fieldなど)を優先してください。 - URP と HDRP のパラメーター仕様は似ていますが同一ではありません。パイプライン間で名前を安易に使い回さないでください。
スキル
postprocess_list_effects
アクティブなパイプラインでサポートされる、最新の SRP ポストプロセスエフェクトを一覧表示します。
postprocess_add_effect
VolumeProfile にポストプロセスエフェクトのオーバーライドを追加します。
postprocess_remove_effect
VolumeProfile からポストプロセスエフェクトのオーバーライドを削除します。
postprocess_get_effect
ポストプロセスエフェクトのオーバーライドを確認します。
postprocess_set_parameter
ポストプロセスエフェクトのオーバーライドのパラメーターを 1 つ設定します。
postprocess_set_bloom
Bloom を設定します。
postprocess_set_depth_of_field
Depth Of Field を設定します。
postprocess_set_tonemapping
Tonemapping を設定します。
postprocess_set_vignette
Vignette を設定します。
postprocess_set_color_adjustments
Color Adjustments を設定します。
正確なシグネチャ
正確な名前、パラメーター、デフォルト値、戻り値は、このファイルではなく GET /skills/schema または unity_skills.get_skill_schema() で定義されています。