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 ディレクトリ のいずれかに該当する作業で使用する。
variant-safe-edit
Prefab / Scene / Asset を壊さず編集する。preflight 診断 → dry-run 差分 → confirm + change_reason 監査 → runtime 検証の 4 段ゲートを 1 経路で踏む。
トリガー: パッチ適用、Prefab Variant 編集、`set_property` / `patch_apply` / `revert_overrides` を伴う変更全般。
含まれるファイル(2)
- SKILL.md3.0 KB
- agents/openai.yaml104 B
SKILL.md(原文)
インストールする前に、エージェントに与えられる指示の中身を確認できます。
Variant Safe Edit
インターフェース
MCP ツールを直接呼び出す(CLI は廃止済み)。
Overview
Provide a deterministic, fail-fast workflow for variant edits with auditability and reference safety.
Workflow
- スコープとターゲットパスを宣言し、変更理由を記録する。
- Preflight:
inspect_variantとvalidate_refsで事前診断する。 - パッチ計画を準備し、
patch_applyの dry-run モードで差分を確認する。 error/criticalで停止。修正をsafe_fixまたはdecision_requiredに分類する。- confirm モードで適用(
change_reason必須)。 - Unity ランタイム検証が利用可能なら
validate_runtimeを実行する。
MCP ツール
inspect_variant— Prefab Variant のオーバーライドチェーン分析validate_refs— 壊れた参照のスキャンpatch_apply— パッチ計画の検証・適用(plan_jsonで JSON 文字列入力、dry_run/confirmモード)validate_runtime— UdonSharp コンパイル + ClientSim 検証revert_overrides— Variant の特定オーバーライドを削除set_property— シンボルパスでフィールド値を設定
Editor Bridge セットアップ
Unity Editor 起動中の Editor Bridge を介してパッチ適用・ランタイム検証を実行する(エディタを閉じる必要はない):
export UNITYTOOL_BRIDGE_WATCH_DIR=/path/to/EditorBridge
export UNITYTOOL_UNITY_TIMEOUT_SEC=30
適用後の目視確認:
editor_select→editor_frameで対象を表示editor_screenshotで視覚確認
Guardrails
- Do not edit YAML directly.
- Stop on
errororcritical; do not auto-applydecision_required. - Unity targets require the resident Editor Bridge configured via
UNITYTOOL_BRIDGE_WATCH_DIR; if unavailable, stop after dry-run. - WSL environments: target paths are auto-converted to Windows format for Unity; watch_dir is auto-converted to WSL format for Python I/O.
次にこれ
validate_refsで broken GUID / fileID が出たら/prefab-sentinel:prefab-reference-repairに切り替える(候補が複数あればdecision_requiredで保留)。validate_runtimeで Udon / ClientSim 例外が出たら/prefab-sentinel:udon-log-triageで分類とアセットマッピングに移る。- MCP ツールの仕様を確認したい / 別ツールを探したいときは
/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 で作業に支障がある、 ユーザーから「このツールについて調べて」と依頼された場合。
壊れた GUID / fileID 参照を検出し、一意な置換先のみ `safe_fix`、それ以外は `decision_required` で保留する。ignore-guid file (`<scope>/config/ignore_guids.txt`) と allowlist branch 経由で noise を整理する。 トリガー: `validate_refs` で missing GUID / fileID が出た、Broken PPtr の調査。
Udon / ClientSim のランタイム例外を分類してアセット / コンポーネントに紐づけ、 決定的な修正は `safe_fix`、判断が必要なものは `decision_required` で仕分ける。 トリガー: ランタイム例外、Udon nullref、ClientSim 起動失敗、ログベースの regression。