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 ディレクトリ のいずれかに該当する作業で使用する。
prefab-reference-repair
壊れた GUID / fileID 参照を検出し、一意な置換先のみ `safe_fix`、それ以外は `decision_required` で保留する。ignore-guid file (`<scope>/config/ignore_guids.txt`) と allowlist branch 経由で noise を整理する。
トリガー: `validate_refs` で missing GUID / fileID が出た、Broken PPtr の調査。
含まれるファイル(2)
- SKILL.md2.1 KB
- agents/openai.yaml116 B
SKILL.md(原文)
インストールする前に、エージェントに与えられる指示の中身を確認できます。
Prefab Reference Repair
インターフェース
MCP ツールを直接呼び出す(CLI は廃止済み)。
Overview
Detect and repair broken references while avoiding unsafe auto-fixes.
Workflow
validate_refsMCP ツールで missing assets / fileIDs を特定する。find_referencing_assetsで壊れた参照の使用箇所を調査する。- 一意で決定的な置換先が存在すれば
safe_fixを提案する。 - 複数候補がある場合は
decision_requiredとして保留する。 - ノイズの多い missing GUID は
validate_refsのignore_asset_guidsパラメータで除外し、<scope>/config/ignore_guids.txtを更新する。 validate_refsを再実行してスコープがクリーンになったことを確認する。
MCP ツール
validate_refs— 壊れた GUID/fileID 参照のスキャン(scope,ignore_asset_guidsパラメータ)find_referencing_assets— GUID/パスの参照元アセット検索(asset_or_guid,scopeパラメータ)
Guardrails
- Do not edit YAML directly.
- Only apply
safe_fixwhen the candidate is unique and unambiguous. - Ignore-guid updates in CI are restricted to allowlisted branches.
次にこれ
- 置換先が決まったら
/prefab-sentinel:variant-safe-editでset_property/patch_applyを dry-run → confirm の経路に乗せる。 - 修復後にランタイム例外が再発したら
/prefab-sentinel:udon-log-triageで再分類する。 validate_refs/find_referencing_assetsの引数や挙動を確認したいときは/prefab-sentinel:guideと docs/tools.md を参照する。
レビュー
まだレビューはありません。使ってみた感想をお寄せください。
同じリポジトリのスキル
概要と使いどころ
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 で作業に支障がある、 ユーザーから「このツールについて調べて」と依頼された場合。
Udon / ClientSim のランタイム例外を分類してアセット / コンポーネントに紐づけ、 決定的な修正は `safe_fix`、判断が必要なものは `decision_required` で仕分ける。 トリガー: ランタイム例外、Udon nullref、ClientSim 起動失敗、ログベースの regression。
Prefab / Scene / Asset を壊さず編集する。preflight 診断 → dry-run 差分 → confirm + change_reason 監査 → runtime 検証の 4 段ゲートを 1 経路で踏む。 トリガー: パッチ適用、Prefab Variant 編集、`set_property` / `patch_apply` / `revert_overrides` を伴う変更全般。