面向 Unreal Engine 的 Claude Code 技能

Claude Code 技能是一个包含 SKILL.md 文件的文件夹：先是 YAML 头信息（建议写 description，另有 allowed-tools 等可选字段），后面是 Markdown 指令。当你的请求与技能描述匹配，或你输入 /skill-name 时，Claude Code 会加载该技能。

• 项目技能放在 .claude/skills/<name>/SKILL.md。提交到仓库后，团队也能用。
• 个人技能放在 ~/.claude/skills/<name>/SKILL.md。
• 插件技能随通过 /plugin 安装的插件一起提供，调用方式为 /plugin-name:skill-name。

Anthropic 的文档建议 SKILL.md 保持在 500 行以内。技能描述在技能列表中超过 1,536 个字符会被截断；对话压缩后，每个技能只保留前 5,000 个 token。Claude Code 运行期间会读取对技能的修改。

Epic 在 GitHub 上以 MIT 许可发布了 unreal-engine-skills-for-claude-code-plugin。其 README 将它描述为通过 MCP 从 Claude Code 控制 Unreal Editor 的方式，背后有 30 多个工具集，包括 Actor、蓝图、材质、Niagara、Sequencer 和自动化测试等。

• unreal-mcp 技能：如何在 Claude Code 中使用 Unreal MCP，附带设置和日常操作的参考页面。
• 一个 SessionStart 钩子（unreal-context.sh），告诉 Claude Code 这个仓库是 Unreal 项目。
• 两个配套技能：create-toolset，以及用于创建和审查技能的 unreal-skill。

README 给出了这些命令。在 Claude Code 中运行：

/plugin install unreal-engine-skills-for-claude-code@claude-plugins-official

# 如果缺少该插件市场：
/plugin marketplace add anthropics/claude-plugins-official

要为整个团队启用，README 的做法是在项目的 .claude/settings.json 中，于 enabledPlugins 下添加 "unreal-engine-skills-for-claude-code@claude-plugins-official": true。

要让它真正派上用场，你需要：

• 启用了 Unreal MCP（ModelContextProtocol）和 All Toolsets 插件的 Unreal Editor。
• 编辑器正在运行且 MCP 服务器已启动（默认自动启动，否则运行 ModelContextProtocol.StartServer）。
• SessionStart 钩子需要 PATH 中有 bash。在 Windows 上请用 Git Bash 或 WSL。

如何把 Claude Code 连接到编辑器，详见如何用 Claude Code 或 Cursor 设置 Unreal Engine 5.8 MCP。

当你要求在打开的项目中执行操作（生成 Actor、编辑蓝图、用 Live Coding 编译）时，unreal-mcp 技能会触发；遇到概念性问题时则不介入。开启工具搜索后，Claude Code 用 list_toolsets 和 describe_toolset 发现工具，再用 call_tool 执行。

• 批量修改前后都要保存：MCP 做的修改并非总能撤销。
• 等待编译完成，并通过 Live Coding 编译 C++。
• 有依赖关系的调用逐个执行，不要并行。
• 任何不是明确成功的结果都要停下来。
• 结果看起来不对时，检查 Play in Editor 是否正在运行。

引擎端的技能是另一回事

Unreal 有自己的“技能”概念。在 5.8.0 源码发布版中，技能是带有描述和指令的引擎对象，通过两个 Unreal MCP 工具 ListSkills 和 GetSkills 提供。Epic 的 unreal-mcp 技能要求 Claude Code 在开始不熟悉的工作时调用 ListSkills，并优先遵循项目自己的技能，而不是通用默认做法。

源码发布版附带的引擎技能涵盖蓝图基础、材质基础、默认室外光照、Niagara（基础、渲染器、优化等）以及 PCG 图生成。Unreal MCP 还有一个 Instructions 设置（Editor Preferences > Agentic Workflows > Model Context Protocol；项目级版本通过 DefaultGame.ini 共享），会向每个客户端发送提示。

• README 提醒："Localhost is not a trust boundary." Unreal MCP 本身没有身份验证。
• execute_tool_script 能以完整编辑器权限运行任意 Python。README 建议不要使用 --dangerously-skip-permissions。
• 长时间会话前先 commit 或 shelve 你的工作；有些修改无法在编辑器中撤销。
• Unreal MCP 是实验性功能，README 也没有写明支持的引擎版本。
• 技能告诉 Claude Code 如何谨慎操作，但结果在游戏中是否正常，仍需你自己检查。

不装插件的 Claude Code

没有 Unreal MCP 时，Claude Code 仍能在终端处理 C++、配置文件和构建，但看不到蓝图资产内部，也看不到正在运行的编辑器。关于这种分工，详见Claude Code 用于 Unreal Engine 与 UE 原生 AI 的对比。

Dola 不属于这套组合。它是一个桌面应用加上自己的 Unreal Editor 插件，面向 Windows 和 Linux 上的 Unreal Engine 5.7。它的智能体通过 Dola 的后端运行 Claude，所以你不需要安装 Claude Code、插件市场条目或 MCP 配置。

• 先审查再保留：每次修改都在 Changes 面板中等待。在 Unreal 中打开差异，然后接受，或拒绝以恢复旧资产。
• 通过试玩做 QA：QA 智能体会读取图表，并在 Play in Editor 中试玩改动，之后才算完成。
• 按你的环境选择：如果是已在使用 Claude Code 的 5.8 项目，Epic 的插件是直接的路径。在 5.7 上，Dola 开箱即用，并会检查自己的工作。

2026 年 11 月 9 日 Dola 的一次真实运行：一条提示 "make BP_Lamp blink"，在 PIE 中检查后等待审查。

完整运行过程，一步一步：看 Dola 如何工作。