메뉴
uloop などで Unity Editor を自律操作している最中に、Unity の確認ダイアログ・モーダル・中断メッセージで自動化が無言で固まる／中断するのを、ユーザーにクリックを頼まずコードで解消して進める方法。特に「未保存のシーン変更があるため中断」でテスト実行・Play 入場がブロックされたとき、Domain Reload 後にシーンが dirty になったとき、モーダルで uloop コマンドが返ってこないときに参照する。「Unity 側でボタンを押してください」と頼む前にこの手順で自力解消する。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
**Unity の UI View (MonoBehaviour) を実装・新規作成・修正するときは必ずこのスキルを呼ぶこと。** 画面・パネル・ダイアログ・オーバーレイ・リスト等、Image / TMP / Button / CanvasGroup を含む UI を伴う View を作るあらゆる場面で発動する。Prefab + SerializeField で構築する手順を定める。
自作ライブラリ submodule (my-unity-utils / my-unity-settings / unity-coding-standards / novel-kit 等) を修正するときの Git 運用方針。submodule 側には PR を作らず main へ直接マージし、PR は利用側プロジェクトの submodule ポインタ更新として出す。ブランチの切り方、コミット・マージ・ポインタ更新の順序、巻き込み禁止ルール、reusable workflow (@main 参照) の反映タイミングを定める。ライブラリと本体の 2 リポジトリにまたがる変更を扱うときに必ず参照する。
LiminalPalette（Unity 用汎用デバッグコンソール）の `liminal-*` skill 群をいつ・どう使うかの運用方針。Unity ゲームのランタイム動作確認・回帰テスト・状態観測をするとき、[LiminalCommand] / [LiminalScenario] / [LiminalObservableField] を HTTP API 経由で叩くとき、あるいは「変更後にゲームを起動して目視確認して」と頼みたくなったときに参照する。検証をその場で消費せず [LiminalScenario] として資産化する運用ルールを含む。実際の liminal-* skill 実体は liminal-palette パッケージ側に同梱される。
Unity Editor を外から操作する `uloop-*` skill 群をいつ・どう使うかの運用方針。コード編集後のコンパイル確認・EditMode/PlayMode テスト実行・シーン階層の把握・SerializeField 参照ワイヤリング・スクリーンショット・メニュー操作・Play モード制御など、開発ワークフロー内の Unity Editor 操作をするときに参照する。ランタイムのゲーム動作確認・回帰テストは対象外（それは liminal-palette-guide 側）で、使ってはいけない uloop skill も列挙する。
void2610 の Unity プロジェクト共通コーディング規約。Unity の C# コード（MonoBehaviour / ScriptableObject / ゲームロジック）を新規作成・編集・レビューするときに参照する。SerializeField の扱い、命名規則（private フィールドの `_` プレフィックス）、R3 の Subject<T> によるイベント、UniTask、式本体メソッド、メンバー宣言順序、enum の summary コメントなど、カスタム Roslyn アナライザー（VUA1001〜VUA4001）で強制しているルールを説明する。
SOC 직업 분류 기준
| name | unity-automation-unblock |
| description | uloop などで Unity Editor を自律操作している最中に、Unity の確認ダイアログ・モーダル・中断メッセージで自動化が無言で固まる／中断するのを、ユーザーにクリックを頼まずコードで解消して進める方法。特に「未保存のシーン変更があるため中断」でテスト実行・Play 入場がブロックされたとき、Domain Reload 後にシーンが dirty になったとき、モーダルで uloop コマンドが返ってこないときに参照する。「Unity 側でボタンを押してください」と頼む前にこの手順で自力解消する。 |
uloop で Unity Editor を外から叩いていると、Unity 側のダイアログ・モーダル・中断メッセージで自動化が止まることがある。原則:
uloop-execute-dynamic-code で Editor API を直接叩いて解消してから続行する。uloop-run-tests / Play 入場が次のように弾かれる:
Tests cannot run while the editor has unsaved scene or prefab changes.
Save or discard these changes before running tests. Unsaved changes: Scene: Assets/Scenes/XXX.unity
これは Editor のメモリ上でシーンが dirty なだけで、ディスク上のシーンファイルには差分が無いことが多い（Domain Reload・アセット再インポート・自動操作の副作用で dirty になる）。
ディスクに実差分が無いか確認（あるなら勝手に破棄しない）:
git status --short "Assets/Scenes/XXX.unity"
出力が空 = メモリ上 dirty のみ → 破棄して安全。差分がある = ユーザーの WIP の可能性 → 破棄前に確認する。
シーンを開き直して in-memory の変更を破棄（uloop-execute-dynamic-code）:
var scene = UnityEditor.SceneManagement.EditorSceneManager.GetActiveScene();
UnityEditor.SceneManagement.EditorSceneManager.OpenScene(
scene.path, UnityEditor.SceneManagement.OpenSceneMode.Single);
これで dirty フラグが落ち、テスト実行・Play 入場が通る。
意図した変更を残したい場合は破棄でなく保存する:
var scene = UnityEditor.SceneManagement.EditorSceneManager.GetActiveScene();
UnityEditor.SceneManagement.EditorSceneManager.SaveScene(scene);
Play 入場メニューが「未保存なら中断」する安全設計（例:
PlaySceneMenu系の MenuItem）を持つプロジェクトでも、上記の reopen で dirty を落とせば同じく通る。
確認/警告のモーダル（保存する? 破棄する? 上書きする?）が出て uloop が返らない
EditorUtility.DisplayDialog 等）を踏む経路自体を避ける。目的の状態変更は dynamic code で直接行う（例: ダイアログ経由の保存でなく SaveScene / AssetDatabase.SaveAssets を直接呼ぶ）。uloop-focus-window で Editor を前面化し、uloop-screenshot で状況を撮って何が待っているか確認してから、原因の操作を dynamic code 版に置き換えて再実行する。Domain Reload 待ちで次コマンドが早すぎて失敗する
uloop-compile は --wait-for-domain-reload true を付け、リロード完了を待ってから後続（配線・テスト）へ進む。Game View 非表示でランタイム描画・スクショが取れない / WaitForEndOfFrame 系がホスト非アクティブで進まない
uloop-focus-window（対象は Game）で前面化する。Application.runInBackground = true を先に入れて PlayerLoop の凍結を防ぐ（非フォーカス時にフレームが進まないとフェード等の tween が進行しない）。uloop-execute-dynamic-code か対応する uloop-* skill で自力解消する（→ uloop-guide skill）。