$npx -y skills add bigdra50/unity-cli --skill unity-debugランタイムエラー・NullReference・コンソールログの調査ワークフロー。 Use for: "エラー調査", "NullReference", "デバッグ", "コンソール確認", "ログ確認
| 1 | # unity-debug |
| 2 | |
| 3 | > **PREREQUISITE:** `../unity-shared/SKILL.md`(Relay Server 経由で Unity Editor が起動/アクティブであること) |
| 4 | > |
| 5 | > skill 経由のコマンドは必ず `-i <instance>` を付ける (unity-shared #インスタンス指定)。 |
| 6 | |
| 7 | ## 調査フロー |
| 8 | |
| 9 | ```text |
| 10 | 1. エラー取得 u -i <instance> console get -l E,X | head -20 |
| 11 | 2. エラー分類 → コンパイルエラー / ランタイムエラー / Missing 系 |
| 12 | 3. コンテキスト収集 u -i <instance> scene hierarchy / u -i <instance> component inspect / u -i <instance> screenshot |
| 13 | 4. 原因特定 → 修正 → /unity-verify で検証 |
| 14 | ``` |
| 15 | |
| 16 | ## エラー分類と対応 |
| 17 | |
| 18 | | エラー種別 | 対応 | |
| 19 | |-----------|------| |
| 20 | | CS0XXX (コンパイルエラー) | コード修正 → /unity-verify | |
| 21 | | NullReferenceException | `u -i <instance> scene hierarchy` + `u -i <instance> component inspect` で参照確認 | |
| 22 | | MissingReferenceException | `u -i <instance> asset info` でアセット存在確認 | |
| 23 | | MissingComponentException | `u -i <instance> component list` で確認 → `u -i <instance> component add` | |
| 24 | |
| 25 | ## コンソール操作 |
| 26 | |
| 27 | ```bash |
| 28 | u -i <instance> console get # 全ログ |
| 29 | u -i <instance> console get -l E | head -10 # Error のみ、先頭10件 |
| 30 | u -i <instance> console get -l E,W # Error + Warning |
| 31 | u -i <instance> console clear # ログクリア |
| 32 | ``` |
| 33 | |
| 34 | ## 状態確認 |
| 35 | |
| 36 | ```bash |
| 37 | u -i <instance> screenshot # エディタのスクリーンショット |
| 38 | u -i <instance> scene hierarchy # 現在のシーン構造 |
| 39 | u -i <instance> state # Play/Pause/Compile 状態 |
| 40 | ``` |
| 41 | |
| 42 | コンパイルエラーが解決しない場合は /unity-verify に切り替える。 |