UnitySkills

概览

GitHubGitHub

UnitySkills 是一个专为 Unity 设计的 AI 自动化技能库（ai-skill），基于 REST API 构建，允许 AI 编程助手直接控制 Unity Editor 中的场景、预制体和 `.meta` 文件。 该项目是对 unity-mcp 概念的深度重构与功能扩展，当前官方维护基线为 **Unity 2022.3+**（未来将聚焦于 2022.3+ / Unity 6）。代码库中包含 805 个 REST Skills，分布在 54 个类别的 56 个源文件中，并附带 28 个咨询设计模块。 ### 核心能力 - **多 IDE 原生支持**：提供一键安装，支持 Claude Code、Antigravity、Codex、Cursor、OpenCode、Kimi Code 等 6 种主流 AI 终端或 IDE。 - **三层权限模式**：提供 Approval（审批）、Auto（自动）、Bypass（绕过）三种运行模式，并为每个 Skill 配置风险元数据，高风险操作可被自动拦截。 - **执行前预览**：支持 `?mode=dryRun` 和 `?mode=plan` 参数，在不写入任何内容的情况下返回参数校验结果和影响评估。 - **事务性原子操作**：批量操作（`POST /skills/batch`）支持跨步骤引用、失败回滚以及差异对比，确保操作失败时场景保持干净。 - **防幻觉护栏**：每个 Skill 模块内置 DO NOT 列表和路由规则，降低 AI 误操作的概率。 - **多实例控制**：支持自动端口发现和全局注册表，可同时控制多个 Unity 项目。 - **审计日志**：所有调用、授权、撤销和拦截记录均写入结构化 JSONL 审计日志，可在面板中浏览。 ### 适用人群 适合使用 AI 辅助编程工具进行 Unity 游戏开发的工程师，尤其是需要让 AI 直接修改场景结构、管理资源或执行批量编辑器操作，同时对安全性和可回滚性有较高要求的团队。

Q&A

UnitySkills 支持哪些 Unity 版本？由 AI 生成

当前官方维护基线是 Unity 2022.3+。代码库中可能仍保留部分 Unity 2021 的兼容逻辑，但未来的功能开发、回归测试和适配工作将集中在 2022.3+ 和 Unity 6 上。

支持哪些 AI IDE 或终端？由 AI 生成

原生支持 6 种环境：Claude Code、Antigravity、Codex、Cursor、OpenCode 和 Kimi Code，提供一键安装。未列出的工具可通过自定义安装方式接入。

如何防止 AI 错误修改场景？由 AI 生成

项目提供了多层治理机制：执行前可使用 dryRun/plan 模式预览；执行时根据风险元数据自动拦截高危操作；执行后所有操作记录在 JSONL 审计日志中；若发生错误，可通过持久化快照或 workflow_undo_task 进行单任务回滚。

三种权限模式有什么区别？由 AI 生成

Approval 模式下服务器返回授权令牌，需用户批准后才执行；Auto 模式（新安装默认）下 FullAuto 技能直接运行，高危操作被自动拦截；Bypass 模式（升级用户默认）下所有技能不受限运行，仅保留可选的高危确认门控。

可以同时控制多个 Unity 项目吗？由 AI 生成

可以。UnitySkills 支持多实例控制，通过自动端口发现和全局注册表机制，能够同时管理多个 Unity 项目。