基于 REST API 的 AI 驱动型 Unity 编辑器自动化引擎
让 AI 通过Skills直接掌控 Unity 场景
本项目基于 unity-mcp 的优秀理念深度重构与功能扩展。
- ⚡ 极致效能：支持 Result Truncation 与 SKILL.md 瘦身，最大化节省 Token。
- 🛠️ 全能工具库：内置 100+ Skills，支持 Batch (批处理) 操作，性能提升 100 倍。
- 🛡️ 安全第一：支持 Transactional (事务原子性)，操作失败自动回滚，场景零残留。
- 🌍 多实例支持：自动端口发现、全局注册表，支持同时控制多个 Unity 项目。
- 🤖 深度集成：独家支持 Antigravity Slash Commands，解锁
/unity-skills交互新体验。 - 🔌 全环境兼容：完美支持 Claude Code, Antigravity, Gemini CLI 等主流 AI 终端。
本项目针对以下环境进行了深度优化，确保持续、稳定的开发体验：
| AI 终端 | 支持状态 | 特色功能 |
|---|---|---|
| Antigravity | ✅ 完美支持 | 支持 /unity-skills 斜杠命令，原生集成工作流。 |
| Claude Code | ✅ 完美支持 | 智能识别 Skill 意图，支持复杂多步自动化。 |
| Gemini CLI | ✅ 完美支持 | 实验性支持，适配最新 experimental.skills 规范。 |
| Codex | ✅ 完美支持 | 支持 $skill 显式调用和隐式意图识别。 |
通过 Unity Package Manager 直接添加 Git URL：
https://github.com/Besty0728/Unity-Skills.git?path=/SkillsForUnity
⚠️ 重要提示：请不要随意更新 Unity Package，此项目会经常开发测试，请认准 Releases 版本。main分支为稳定版，beta分支为开发测试版。
稳定版安装 (main):
https://github.com/Besty0728/Unity-Skills.git?path=/SkillsForUnity
开发测试版安装 (beta):
https://github.com/Besty0728/Unity-Skills.git?path=/SkillsForUnity#beta
在 Unity 中点击菜单：Window > UnitySkills > Start Server
- 打开
Window > UnitySkills > Skill Installer。 - 选择对应的终端图标（Claude / Antigravity / Gemini / Codex）。
- 点击 "Install" 即可完成环境配置，无需手动拷贝代码。
安装器落盘文件说明（生成于目标目录）：
SKILL.mdscripts/unity_skills.py- Antigravity 额外生成
workflows/unity-skills.md
Codex 特别说明：推荐使用全局安装。项目级安装需要在
AGENTS.md中声明才能识别，全局安装后重启 Codex 即可。
📘 需要更完整的安装与使用说明，请查看：docs/SETUP_GUIDE.md
如果不使用一键安装，可按以下标准流程手动部署（适用于所有支持 Skills 的工具）：
- 定位 Skills 源码目录：本仓库的
unity-skills/即为可分发的 Skills 模板（根目录包含SKILL.md）。 - 找到工具的 Skills 根目录：不同工具路径不同，优先以该工具文档为准。
- 完整复制：将整个
unity-skills/目录复制到工具的 Skills 根目录下。 - 目录结构要求：复制后需保持结构如下（示例）：
unity-skills/SKILL.mdunity-skills/skills/unity-skills/scripts/
- 重启工具：让工具重新加载 Skills 列表。
- 验证加载：在工具内触发 Skills 列表/命令（或执行一次简单技能调用），确认可用。
以下为已验证的默认目录（若工具配置过自定义路径，请以自定义为准）：
- Claude Code：
~/.claude/skills/ - Antigravity：
~/.agent/skills/ - Gemini CLI：
~/.gemini/skills/ - OpenAI Codex：
~/.codex/skills/
若你使用的是其他支持 Skills 的工具，请按照该工具文档指定的 Skills 根目录进行安装。只要满足标准安装规范（根目录包含 SKILL.md 并保持 skills/ 与 scripts/ 结构），即可被正确识别。
| 分类 | 数量 | 核心功能 |
|---|---|---|
| GameObject | 7 | 增删改查、层级管理、变换同步。 |
| Component | 5 | 智能组件挂载、属性劫持与配置。 |
| Scene | 6 | 场景无缝切换、状态保存、高清截图。 |
| Material | 17 | HDR 发光控制、材质球属性批量修改。 |
| UI System | 10 | 响应式 Canvas 构建、Button/Text 组件生成。 |
| Others | 55+ | 涵盖 Animator, Light, Prefab, Validation 等。 |
.
├── SkillsForUnity/ # Unity 编辑器插件 (Package 核心)
│ └── Editor/Skills/ # 核心 Skill 逻辑与 C# 安装器
├── unity-skills/ # 跨平台 AI Skill 模板 (核心源码)
│ ├── SKILL.md # Skill 定义与 Prompt 设计
│ └── scripts/ # Python Helper 封装
├── CHANGELOG.md # 详尽的更新记录与路线图
└── LICENSE # MIT 开源协议本项目采用 MIT License 许可。