code-review-netsync

code-review-netsync 是一項專為 STYLY-NetSync 存儲庫開發人員設計的工程工具，該項目是一個用於基於位置的娛樂 (LBE) 的高性能 Unity 網絡框架。它通過對比 Git diff 與嚴格的項目特定規則來執行自動化代碼審查，確保 Unity (C#) 客戶端與基於 Python 的服務器之間的代碼質量和同步。此技能旨在協助軟件工程師和技術美術在提交合併請求或在 XR 環境中部署前進行代碼檢查。

• 對 Git diff 進行自動驗證，對照 Unity C# 與 Python 的編碼標準，包括空值安全、UnityEngine API 的線程安全以及 ZeroMQ 模式的正確使用。

• 監控並標記協議變更，通過檢測序列化邏輯、協議常量（如 MSG_CLIENT_POSE 或 PROTOCOL_VERSION）以及量化設置的修改來觸發檢查。

• 確保跨語言的一致性，標記在 Unity C# 類（例如 NetSyncManager, BinarySerializer）發生更改時，Python 文件（例如 client.py, binary_serializer.py）缺乏對應更新的情況。

• 強制執行項目架構規範，例如禁用 ZMQ_CONFLATE、正確處理多部分消息以及確保文檔使用英語編寫。

• 將審查結果按嚴重程度（CRITICAL、WARNING、INFO）分類，並提供可操作的修改建議。

• 在提交拉取請求或修改核心網絡組件時使用此技能，以便在進入生產環境前捕捉錯誤、協議不匹配或線程安全問題。

• 工具需要 Git diff 作為輸入（未暫存、已暫存或基於範圍）以識別目標文件。

• 若修改了 BinarySerializer.cs 或 types.py 等協議觸發文件，技能會自動應用全面的協議影響檢查清單。

• 在合併前務必審查「CRITICAL」輸出，因為這些標記直接針對可能導致 LBE 網絡堆棧崩潰或損壞的嚴重問題。