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+ 版本設計，並支援自動清理命令和回應檔案，防止檔案系統雜亂。

• 支援詳細輸出和自訂超時配置，適用於大型測試套件或較慢的建構環境。