niaka3dayo/agent-skills-vrc-udon

What it solves

AI 編碼代理程式在處理 VRChat 的 UdonSharp（将 C# 转换为 Udon Assembly）时经常遇到困难，因为它具有与标准 C# 不同的严格编译限制。本项目提供了一个包含技能、规则与验证钩子（hooks）的知识库，以防止 AI 编码代理程序使用不兼容的功能，例如 List<T>、async/await 或错误的网络通信模式，确保生成的代码在 VRChat 世界中确实可以编译并正常运行。

How it works

本项目作为一组可通过 npm 或 CLI 工具集成到 AI 编码代理程序（例如 Claude Code）的“技能”来运行。它包含：

• Rules: Markdown 文件，在 AI 编写代码之前提供指导，详细列出被禁止的 C# 功能和正确的网络通信模式（例如：使用 DataList 代替 List<T>）。
• Validation Hooks: Bash 和 PowerShell 脚本，在 AI 编辑 .cs 文件后自动运行，以检测错误，例如被禁止的运行时功能或同步数据量过大（sync bloat）。
• Templates: 一个包含 17 个常用交互和同步模式的代码模板库。
• References: 详细的文档，将 SDK 版本功能映射到 AI 友好的指令。

Who it’s for

VRChat 世界创作者，使用 AI 编码代理程序协助编写 UdonSharp 脚本，并希望避免手动修正 AI 生成的编译错误这一繁琐过程。

Highlights

• Automated Validation: 包含用于捕捉运行时代码中的 async/await、try/catch 和 LINQ 的钩子。
• Networking Guidance: 提供同步决策树，以最小化数据预算并使用正确的所有权模型。
• SDK Versioning: 将功能映射到高达 3.10.5 的 SDK 版本。
• Agent Integration: 作为 npm 包分发，以便轻松安装到 AI 代理程序环境中。