用途:unity-cli 通过一个 CLI(cs)驱动运行中的 Unity Editor 或 Player,适合需要检查或修改 Unity 场景、GameObject、组件、Transform、预制体等任务。
主要能力:默认创作面按六个面向智能体的域分组,使只有相关 schema 进入上下文;控制面与项目自定义命令使用显式视图。命令发现通过 cs list-commands 完成,返回记录带有 authoring、custom 或 control-plane 层级。路由顺序为:内置命令 → 项目自定义命令 → 代码片段 → 原始 exec。
使用方式:cs 指代 python "<SKILL_DIR>/scripts/cli/cs.py",每次调用需展开为绝对命令且不切换目录。正常使用不要传 --project,CLI 会从工作目录及其自身位置向上查找 Unity 项目。输入不要内联传 C# 或结构化参数,应写入文件后传绝对路径:原始 C# 用 --file,结构化参数用 --input。临时目录为 <project-root>/Temp/CSharpConsole/AgentScratch/,必须使用完整绝对路径,且只清理 AgentScratch/。示例:cs exec --file "<project-root>/Temp/CSharpConsole/AgentScratch/inspect-camera.cs";cs command --json --input "<project-root>/Temp/CSharpConsole/AgentScratch/req-create-cube.json";cs batch --json --input "<project-root>/Temp/CSharpConsole/AgentScratch/req-batch.json"。
REPL 会话:cs exec 默认新会话;当后续提交依赖先前变量、using、类型或辅助方法时,生成一个不透明任务专用 id 并复用,如 cs exec --session agent-a1b2c3 --file ...。不同任务或智能体不得共享会话;域重载会清除会话状态,cs refresh 后需重建上下文或使用新 id。
限制:不要枚举其他技能安装或运行 cs --help 重新发现已记录面。发现预算、账本、刷新屏障、精确查询等有严格规则;离线缓存或生成回退仅用于规划,执行需在本次调用中经实时验证的注册表。仅在用户明确要求更新命令列表时使用 cs list-commands --refresh。调用 command 或 batch 前需完整阅读 references/commands.md。若没有 Unity 项目,自定义与片段阶段标记为不可用。资料未提供收费、价格、平台或效果信息。