niaka3dayo/agent-skills-vrc-udon

Skills, rules, and validation hooks that teach AI coding agents to generate correct UdonSharp code

它解決的問題

AI程式碼代理經常在處理 VRChat 的 UdonSharp(C# 到 Udon 汇编)時遇到困難,因為它有嚴格的編譯限制,與標準 C# 不同。此專案提供了一套技能、規則和驗證鉤子知識庫,防止 AI 代理使用不相容的功能,例如 List<T>async/await 或錯誤的網路通訊模式,確保生成的程式碼實際上可在 VRChat 世界中編譯並執行。

如何運作

此專案作為一組「技能」,可透過 npm 或 CLI 工具整合至 AI 代理(如 Claude Code)中。其組成包括:

  • 規則:Markdown 檔案,在 AI 寫程式碼前提供指引,詳細說明被禁止的 C# 功能和正確的網路通訊模式(例如,使用 DataList 而非 List<T>)。
  • 驗證鉤子:Bash 與 PowerShell 腳本,在 AI 編輯 .cs 檔案後自動執行,以偵測錯誤,例如被禁止的執行時功能或同步資料過大。
  • 範本:一套 17 個常用互動與同步模式的程式碼範本。
  • 參考資料:詳細文件,將 SDK 版本功能對應至對 AI 友好的指示。

適用對象

使用 AI 程式碼代理協助撰寫 UdonSharp 程式碼的 VRChat 世界創作者,希望避免手動修正 AI 生成的編譯錯誤這項繁瑣的過程。

特色亮點

  • 自動驗證:包含鉤子以捕捉執行時程式碼中的 async/awaittry/catch 和 LINQ。
  • 網路通訊指引:提供同步決策樹,以最小化資料預算並確保正確的擁有權模型。
  • SDK 版本管理:將功能對應至 SDK 版本,最高支援至 3.10.5。
  • 代理整合:以 npm 套件形式發佈,可輕鬆安裝至 AI 代理環境中。

相關

  • 專案
  • 專案
  • 專案
  • 專案