AgentSkillsCN

uloop-execute-dynamic-code

通过 uloop CLI 在 Unity 编辑器中动态执行 C# 代码。用于编辑器自动化:(1) 预制件/材质连线及 AddComponent 操作;(2) 使用 SerializedObject 进行引用连线;(3) 场景/层级编辑及批量操作。但不适用于文件 I/O 或脚本编写。

SKILL.md
--- frontmatter
name: uloop-execute-dynamic-code
description: Execute C# code dynamically in Unity Editor via uloop CLI. Use for editor automation: (1) Prefab/material wiring and AddComponent operations, (2) Reference wiring with SerializedObject, (3) Scene/hierarchy edits and batch operations. NOT for file I/O or script authoring.

uloop execute-dynamic-code

Execute C# code dynamically in Unity Editor.

Usage

bash
uloop execute-dynamic-code --code '<c# code>'

Parameters

ParameterTypeDescription
--codestringC# code to execute (direct statements, no class wrapper)
--compile-onlybooleanCompile without execution
--auto-qualify-unity-types-oncebooleanAuto-qualify Unity types

Code Format

Write direct statements only (no classes/namespaces/methods). Return is optional.

csharp
// Using directives at top are hoisted
using UnityEngine;
var x = Mathf.PI;
return x;

String Literals (Shell-specific)

ShellMethod
bash/zsh/MINGW64/Git Bash'Debug.Log("Hello!");'
PowerShell'Debug.Log(""Hello!"");'

Allowed Operations

  • Prefab/material wiring (PrefabUtility)
  • AddComponent + reference wiring (SerializedObject)
  • Scene/hierarchy edits
  • Inspector modifications

Forbidden Operations

  • System.IO.* (File/Directory/Path)
  • AssetDatabase.CreateFolder / file writes
  • Create/edit .cs/.asmdef files

Examples

bash / zsh / MINGW64 / Git Bash

bash
uloop execute-dynamic-code --code 'return Selection.activeGameObject?.name;'
uloop execute-dynamic-code --code 'new GameObject("MyObject");'
uloop execute-dynamic-code --code 'UnityEngine.Debug.Log("Hello from CLI!");'

PowerShell

powershell
uloop execute-dynamic-code --code 'return Selection.activeGameObject?.name;'
uloop execute-dynamic-code --code 'new GameObject(""MyObject"");'
uloop execute-dynamic-code --code 'UnityEngine.Debug.Log(""Hello from CLI!"");'

Output

Returns JSON with execution result or compile errors.

Notes

For file/directory operations, use terminal commands instead.