前言¶
Unity 项目里改场景、动资源、补脚本，常见做法是你在 IDE 和 Editor 之间来回切，再把步骤口述给 AI，让它生成一段「请你手动执行」的清单。模型并不直接碰当前工程，容易漏上下文，也难自动跑测试验证。
下面介绍 SkillHub 上的 Control Unity Editor scenes and assets through MCP for Unity。它把 Agent 的做事方式对齐到 MCP for Unity：在 Unity 侧装好 MCP 桥接、在客户端里启用本 Skill 后，兼容 MCP 的代理可以按文档约定去检查场景、管理资源、编辑脚本、运行测试，并承担一部分可自动化的开发任务。
这是什么¶
Control Unity Editor scenes and assets through MCP for Unity 是社区来源（community）的 Agent Skill，坐标为 @user_3c6cb52e/control-unity-editor-scenes-and-assets-through-mcp-for-unity，当前版本 1.0.0，分类为 dev-programming。SkillHub 页面简介与包内 SKILL.md 一致：将 MCP 兼容代理连接到 Unity 编辑器，以便检查场景、管理资源、编辑脚本、运行测试并自动化游戏开发任务。
需要区分两层：
- Skill（本条目）：写给 AI 的
SKILL.md工作说明，告诉代理何时、如何配合 MCP for Unity 操作编辑器。 - MCP for Unity（上游工具链）：CoplayDev 维护的 Unity 包与 MCP 服务，官方文档见 coplaydev.github.io/unity-mcp。Skill 内注明内容摘自上游 README，并指向该文档站。
SkillHub 元数据：requires_api_key=false，安装本 Skill 本身不要求 API Key；实际连编辑器仍依赖本机 Unity 与 MCP 客户端配置。
核心功能¶
依据 Skill 简介与上游 MCP for Unity 公开说明，可核对的能力包括：
- 场景与对象：通过自然语言驱动编辑器创建场景、GameObject，并进行场景相关操作（上游称提供约 50 个聚焦的 MCP 工具入口，详见 工具目录）。
- 脚本：在工程内创建、修改 C# 脚本（上游 Quickstart 示例包含为对象添加组件等编辑动作）。
- 资源与工程：管理 Unity 资源、执行测试、以及上游文档提到的 profile、build 等编辑器侧工作流。
- 测试：对接 Unity Test Framework 类能力（Skill 简介中的「运行测试」；具体工具名以官方工具参考为准）。
本 Skill 不替代 Unity 或 MCP 协议本身，而是让 Agent 在已连通 MCP for Unity 的前提下，按 SKILL.md 与官方文档选用工具，而不是只输出人工步骤。
安装与启用¶
完整链路分两步：先在 Unity 里启用 MCP for Unity，再把 Skill 装进当前 Agent 的 skills 目录。
1. Unity 与 MCP for Unity（上游）¶
Skill SKILL.md 列出的先决条件：
- Unity 编辑器
- Python 3.10+（上游 Quickstart 还建议通过
uv管理 Python 环境） - 任意 MCP 兼容客户端（Skill 举例：Claude、Codex、VS Code、Cursor）
上游 README Quickstart 步骤如下。
在 Unity 中通过 Package Manager 从 Git 安装包：
https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main
路径：Window → Package Manager → + → Add package from git URL，粘贴上述 URL。上游说明 Unity 版本支持 2021.3 LTS 至 6.x；也可用 openupm add com.coplaydev.unity-mcp（见上游文档）。
配置本机已检测到的 MCP 客户端：
Window → MCP for Unity → Configure All Detected Clients
导入后若出现设置向导，按向导确认 Python/uv 与客户端配置；也可随时从 Window → MCP for Unity 启停服务、切换传输方式或重新配置。细节以 安装文档 为准。
2. 在 SkillHub 安装本 Skill（Agent）¶
SkillHub 页面给出的安装提示为：参照 SkillHub 安装说明，安装坐标 @user_3c6cb52e/control-unity-editor-scenes-and-assets-through-mcp-for-unity。
若尚未安装 skillhub CLI，可先检查版本：
command -v skillhub && skillhub --version
未安装时，官方提供一键安装脚本（完整安装含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
将 Skill 安装到当前 Agent 识别的 skills 目录（必须用 --dir，否则默认 ./skills/ 可能不会被加载）。例如 Cursor：
skillhub install @user_3c6cb52e/control-unity-editor-scenes-and-assets-through-mcp-for-unity --dir ~/.cursor/skills/
其他客户端常见路径（摘自 SkillHub 安装文档）：Claude Code 为 ~/.claude/skills/；Codex 为 ~/.codex/skills/ 或项目下 .agents/skills/。安装后按各客户端要求刷新或重启，使 Skill 生效。
典型用法¶
经过上面的步骤，Unity Editor 已运行、MCP 客户端显示已连接，且 Agent 已加载本 Skill 后，可以用自然语言描述编辑器内目标。上游 Quickstart 中的示例提示为：
Create a cube at the origin and add a Rigidbody.
预期行为是代理通过 MCP 在场景中创建物体并添加组件，而不是仅返回操作说明。更复杂的场景编辑、资源变更、脚本修改与测试，应结合 MCP for Unity 工具参考 与 Skill 内指向的文档逐项核对。
Skill 包内 SKILL.md 较短，实操时以 coplaydev.github.io/unity-mcp 为权威补充；多实例、工具组、远程服务等进阶主题见上游 Advanced 章节链接。
适用场景与注意¶
适合谁
- 已在用 Cursor、Claude Code、Codex、VS Code 等 MCP 客户端，并希望 AI 直接操作当前 Unity 工程 的开发者。
- 愿意在本地维护 Unity + Python/
uv+ MCP 服务，并接受对生成脚本与场景变更做人工审查的团队。
限制与注意
- 本 Skill 1.0.0 为说明型 Skill，不包含 Unity 包本体；必须先完成 MCP for Unity 的包安装与客户端配置，否则 Agent 无可用 MCP 工具。
- SkillHub 统计（以抓取资料为准）：评分 100000，下载 1216；标签 requires_api_key=false。这与「无需 SkillHub API Key」一致，不等于无需配置 Unity 侧环境。
- 上游为 MIT 许可的独立工具，与 Unity Technologies 无隶属关系；版本、工具列表会随 CoplayDev 仓库更新，生产使用前请对照当前 Release Notes。
- 让 Agent 改脚本、改场景前，建议配合版本管理与
read_console、测试类工具做验证（具体工具名见官方参考），避免未编译错误或场景损坏直接进入主分支。
结尾¶
Control Unity Editor scenes and assets through MCP for Unity 的价值在于：把「会写 Unity 教程的模型」变成「在已连接的 Editor 里能执行 MCP 调用的协作者」——前提是 Unity 包与客户端已按上游文档配好，Agent 再通过 SkillHub 装上本 Skill。
- SkillHub 页面：https://www.skillhub.cn/skills/user_3c6cb52e/control-unity-editor-scenes-and-assets-through-mcp-for-unity
- API 条目：https://api.skillhub.cn/user_3c6cb52e/control-unity-editor-scenes-and-assets-through-mcp-for-unity
- MCP for Unity 文档：https://coplaydev.github.io/unity-mcp/
