前言¶
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/
