unity-debug

unity-debug

PREREQUISITE: ../unity-shared/SKILL.md（Relay Server 経由で Unity Editor が起動/アクティブであること）

skill 経由のコマンドは必ず -i <instance> を付ける (unity-shared #インスタンス指定)。

調査フロー

1. エラー取得      u -i <instance> console get -l E,X | head -20
2. エラー分類      → コンパイルエラー / ランタイムエラー / Missing 系
3. コンテキスト収集  u -i <instance> scene hierarchy / u -i <instance> component inspect / u -i <instance> screenshot
4. 原因特定 → 修正 → /unity-verify で検証

エラー分類と対応

エラー種別	対応
CS0XXX (コンパイルエラー)	コード修正 → /unity-verify
NullReferenceException	u -i <instance> scene hierarchy + u -i <instance> component inspect で参照確認
MissingReferenceException	u -i <instance> asset info でアセット存在確認
MissingComponentException	u -i <instance> component list で確認 → u -i <instance> component add

コンソール操作

u -i <instance> console get                   # 全ログ
u -i <instance> console get -l E | head -10   # Error のみ、先頭10件
u -i <instance> console get -l E,W            # Error + Warning
u -i <instance> console clear                 # ログクリア

状態確認

u -i <instance> screenshot          # エディタのスクリーンショット
u -i <instance> scene hierarchy     # 現在のシーン構造
u -i <instance> state               # Play/Pause/Compile 状態

コンパイルエラーが解決しない場合は /unity-verify に切り替える。