← ClaudeAtlas

unity-clilisted

用官方 Unity CLI(unity 命令 + com.unity.pipeline 包)自动化 Unity 编辑器: 场景/GameObject/组件/材质/prefab 增删改、console 读取、跑测试、打包、eval 执行任意 C#。 当用户要操作 Unity、改场景、跑测试、打包、或说"在 Unity 里…"时使用。 Automate the Unity Editor via the official Unity CLI: scene/GameObject/component/material/prefab edits, console reading, running tests, builds, and eval'ing arbitrary C#.
ZHAO0424/unity-cli-skill · ★ 2 · AI & Automation · score 65
Install: claude install-skill ZHAO0424/unity-cli-skill
# unity-cli:官方 Unity CLI 编辑器自动化 **版本锚定(实测 2026-08-05)**:Unity CLI `1.0.0-beta.3` + `com.unity.pipeline 0.4.0-exp.1`(要求 Unity 6.0+)。 CLI 处于 beta,升级后先跑文末"验证清单"再继续用。 **前置条件**:装 CLI(`irm https://public-cdn.cloud.unity3d.com/hub/prod/cli/install.ps1 | iex`, macOS/Linux 见官方文档)→ `unity auth login` → 给目标工程装包:`unity pipeline install --project-path <P>`。 本机工程状态记录见 `references/local-setup.md`(如存在)。 ## 本 skill 的边界与分工 - **读代码/理解架构/改 .cs** → 宿主 agent 的 Read/Grep/Edit 文件工具,改完调 `recompile` 回编辑器。 **不要用 eval 改代码**——那是文件工具的事。 - **场景/资产/编辑器状态** → 本 skill 的 CLI 通道。 - **协同纪律:改一个由脚本驱动的场景对象前,先读那个脚本**——序列化字段的含义和运行时行为在代码里,不在场景里。 - **项目专属知识**(架构、核心系统、禁改对象、命名约定)→ 写在你工程自己的 CLAUDE.md, 模板见 `references/project-context-template.md`。本 skill 管通道,你的 CLAUDE.md 管工程知识。 - **XR 任务**(XR Origin / XRI 交互 / 手追踪 / 世界空间 UI / XR 验收)→ **先读 `references/xr-recipes.md`** 再动手,里面有搭 rig、抓取接线、射线排查、XR 专项��检的成套配方。 ## 安全模型(诚实版) 本 skill 是文档,**不是沙箱**。eval 与内置命令以编辑器进程的权限执行——给 AI 编辑器控制权, 信任级别等同于给 AI 终端 Bash。四道真护栏: 1. **git 干净状态前置(铁律)**:任何批量改动会话开始前,工作区必须 clean。 版本控制是唯一可靠的 undo;编辑器内的 Undo 栈不覆盖资产删除与外部文件写入。 2. **宿主层执法**:Claude Code 用户可以用 permission rules 真正 gate 掉 eval,例如在 `.claude/settings.json` 里把 `Bash(unity command eval*)` 设为 ask/deny——这才是机制,prompt 约束不是。 3. **写域收窄**:批量生成类任务先 `set_authoring_root`(如 `Assets/AgentWork`), 文件写入被限制在该子目录内;做完再设回 `Assets`。 4. **破坏性命令护栏**:内置命令 `confirm=true` 才执行 + `dry_run` 预演;红线:禁止用 eval 绕过。 残余风险要认:eval 里的查询与场景编辑无法白名单化,这是灵活性的代价。 不接受此权衡 → 只用内置命令,并在宿主层 deny eval。 ## 两种模式与决策树 1. **连接模式**(编辑器