unity

Unity Bridge 技能为 Claude Code 提供了一种可靠的、基于文件的通信协议，使其能直接与运行中的 Unity 编辑器进行交互。通过安装 com.mxr.claude-bridge Unity 软件包，开发人员可以自动化编辑器端的工作流程，免去设置网络、端口或管理 Socket 的复杂性。此技能实现了 AI 驱动开发工作流程与 Unity 编辑器之间的无缝集成，是游戏开发人员和 XR 工程师简化测试与构建周期的核心工具。

该技能通过一个确定性的命令行工具 (unity-bridge) 运行，负责处理 UUID 命令追踪、原子文件操作以及指数退避轮询。它能在 macOS、Windows 和 Linux 环境中有效运行。由于每个项目都维护自己的 .unity-bridge/ 目录，因此支持多个 Unity 项目同时开发而互不干扰。它非常适合在 Unity 中进行测试驱动开发 (TDD) 的团队，或是需要在调试阶段自动化重复性编辑器任务（如刷新资源或监控控制台）的工程师。

• 执行 EditMode 和 PlayMode 测试，并支持筛选功能以针对特定命名空间或测试类。

• 触发脚本编译，并直接从 Unity 编译器输出中获取详细的错误报告。

• 管理 Unity 播放模式状态，包括执行播放、暂停以及单帧步进操作。

• 访问并筛选 Unity 控制台日志，以便快速诊断运行时异常或警告。

• 以程序化方式刷新 Unity 资源数据库，确保外部脚本或生成器所做的更改已正确索引。

• 检查实时编辑器状态，例如引擎是否正在编译、是否处于播放模式，或是否正在进行后台更新。

• 需要通过 Package Manager 在 Unity 项目中安装 com.mxr.claude-bridge 软件包。

• Unity 编辑器必须保持开启且运行中，桥接器才能处理传入的命令。

• 使用基于 Python 的 CLI，要求本地 Shell 环境具备 Python 3.8+。

• 专为 Unity 2021.3+ 版本设计，并支持自动清理命令和响应文件，防止文件系统杂乱。

• 支持详细输出和自定义超时配置，适用于大型测试套件或较慢的构建环境。