UI Toolkit UIの操作・検証（uloop回避策スキル）

背景（なぜこのスキルが必要か）

uloop-cli 2.2.0 + Unity 6000.4.5f1 で実測した制約:

1. simulate-mouse-input（Mouse.current注入）は Success=true でも UI Toolkit の Button.clicked が発火しない
2. simulate-mouse-ui は EventSystem + InputSystemUIInputModule + PanelRaycaster が揃っていても「no UI element hit」になる（uGUI前提）
3. screenshot --annotate-elements true は UI Toolkit 要素を検出しない（AnnotatedElements が空になる）
4. screenshot --capture-mode rendering は UI Toolkit 要素が全てシアンの矩形に化ける

やり方

操作: execute-dynamic-code でUIイベントを直接送出する

.csx ファイルに C# を書いて実行する:

npx --yes uloop-cli@2.2.0 execute-dynamic-code --code-file <path>.csx --project-path <unity-project>

ボタンクリック（Button.clicked を発火させる標準形）:

using UnityEngine;
using UnityEngine.UIElements;

var doc = Object.FindFirstObjectByType<UIDocument>();
var root = doc.rootVisualElement;
var button = root.Q<Button>("onigiri-button");   // name指定。classなら Query<Button>(className: "shop-buy").ToList()

using (var e = new NavigationSubmitEvent())
{
    e.target = button;
    button.SendEvent(e);
}
return "clicked: " + button.name;

• 連打は for ループで囲む
• Toggle/Slider等の値変更は element.value = x; で直接設定してよい（変更通知は using var ev = ChangeEvent<T>.GetPooled(old, new); ev.target = element; element.SendEvent(ev);）
• 注意: System.IO や AssetDatabase.CreateFolder は execute-dynamic-code では禁止

状態検証: ラベル文字列をreturnで読み取る

スクショの目視より確実。操作と同じ .csx 内で実行結果を返す:

string count = root.Q<Label>("onigiri-count").text;
return $"count=[{count}]";

見た目検証: スクショは必ず window モードで撮る

npx --yes uloop-cli@2.2.0 screenshot --window-name Game --output-directory <dir> --project-path <unity-project>

• --capture-mode rendering は使わない（UI Toolkitがシアン化して正しく評価できない）
• windowモードはエディタのツールバーが写り込み、Game Viewの表示スケール（例: 0.85x）の影響を受ける点は承知の上で使う

ワークフロー例（クリック→状態→見た目の3点検証）

1. control-play-mode --action Play でPlayMode開始（enum は Play/Stop/Pause。小文字は不可）
2. .csx で SendEvent 操作 + ラベル値を return で確認
3. screenshot --window-name Game で見た目を確認
4. control-play-mode --action Stop