Unity Prefab / Scene / Asset の壊れた参照・Variant override・配線ミスを構造化応答で診断し、 dry-run → confirm 経路で安全に修復するための MCP ツールリファレンス。 Editor Bridge のセットアップ手順もここに含む。 トリガー: .prefab, .unity, .asset, .mat, Prefab, Variant, 配線, 参照, 壊れた参照, broken reference, GUID, fileID, override, パッチ, patch plan, validate refs, validate structure, where-used, inspect variant, inspect wiring, inspect hierarchy, wiring, null参照, null reference, MonoBehaviour, 階層, hierarchy, Transform整合, 孤立, orphan, 重複fileID, duplicate fileID, Editor Bridge, Bridge セットアップ, bridge setup, deploy_bridge, UNITYTOOL_BRIDGE_WATCH_DIR, watch ディレクトリ のいずれかに該当する作業で使用する。
udon-log-triage
Udon / ClientSim のランタイム例外を分類してアセット / コンポーネントに紐づけ、 決定的な修正は `safe_fix`、判断が必要なものは `decision_required` で仕分ける。トリガー: ランタイム例外、Udon nullref、ClientSim 起動失敗、ログベースの regression。
含まれるファイル(2)
- SKILL.md2.4 KB
- agents/openai.yaml100 B
SKILL.md(原文)
インストールする前に、エージェントに与えられる指示の中身を確認できます。
Udon Log Triage
インターフェース
MCP ツールを直接呼び出す(CLI は廃止済み)。
Overview
Reduce runtime failures by classifying logs, mapping errors to assets, and controlling fixes.
Workflow
validate_runtimeMCP ツールでランタイムログを収集・分類する。- エラーの分類結果から
assert_no_critical_errorsのステップを確認する。 find_referencing_assetsでエラー箇所をアセット/コンポーネントにマッピングする。- 修正を提案: 決定的で一意な候補のみ
safe_fix、それ以外はdecision_required。 - ランタイム検証を再実行してレポートを保存する。
MCP ツール
validate_runtime— UdonSharp コンパイル + ClientSim 実行検証(asset_pathパラメータ)find_referencing_assets— エラー箇所のアセット参照検索inspect_wiring— MonoBehaviour フィールド配線検査
Editor Bridge モード
Unity Editor 起動中は以下の環境変数で Editor Bridge 経由の検証が可能:
export UNITYTOOL_BRIDGE_WATCH_DIR=/path/to/EditorBridge
Guardrails
- If the Editor Bridge is unavailable (no
UNITYTOOL_BRIDGE_WATCH_DIRor the watch directory is unreachable), mark the task as pending and stop after classification steps. - Do not apply changes without audit logs (confirm mode with change_reason).
- WSL environments: project_root and asset_path are auto-converted to Windows format for Unity; watch_dir is auto-converted to WSL format for Python I/O.
次にこれ
- 例外が broken reference に由来する(
NullReferenceExceptionの対象 PPtr が解決できない)と判明したら/prefab-sentinel:prefab-reference-repairに切り替える。 - 修正方針が確定したら
/prefab-sentinel:variant-safe-editで dry-run → confirm 経路に乗せる。 - ツールの選び方や Editor Bridge セットアップは
/prefab-sentinel:guideを参照する。
レビュー
まだレビューはありません。使ってみた感想をお寄せください。
同じリポジトリのスキル
概要と使いどころ
Create or repair a project-local Inspector profile after INSPECTOR_PROFILE_REQUIRED, INSPECTOR_PROFILE_INCOMPLETE, INSPECTOR_PROFILE_INVALID, or PROFILE_AUTHORING_REQUIRED, using Unity component source, custom Inspector evidence, serialized surfaces, and validation diagnostics.
日本語の概要は準備中です。原文の説明を表示しています。
VRChat エコシステムツール(ModularAvatar / liltoon / VRCFury / AvatarOptimizer 等)の ナレッジを 4 フェーズで段階的に調査・検証し `knowledge/*.md` に再現可能な形で蓄積する。 ソースコード読解 → inspect 実測まで進めると confidence を `high` に昇格できる。 トリガー: 新しい VRChat コミュニティツールに初めて遭遇した、 既存ナレッジの confidence が low で作業に支障がある、 ユーザーから「このツールについて調べて」と依頼された場合。
壊れた GUID / fileID 参照を検出し、一意な置換先のみ `safe_fix`、それ以外は `decision_required` で保留する。ignore-guid file (`<scope>/config/ignore_guids.txt`) と allowlist branch 経由で noise を整理する。 トリガー: `validate_refs` で missing GUID / fileID が出た、Broken PPtr の調査。
Prefab / Scene / Asset を壊さず編集する。preflight 診断 → dry-run 差分 → confirm + change_reason 監査 → runtime 検証の 4 段ゲートを 1 経路で踏む。 トリガー: パッチ適用、Prefab Variant 編集、`set_property` / `patch_apply` / `revert_overrides` を伴う変更全般。