niaka3dayo/agent-skills-vrc-udon

해결하는 문제

AI 코딩 에이전트는 VRChat의 UdonSharp(C#에서 Udon 어셈블리로)에서 표준 C#과 다른 엄격한 컴파일 제약 사항으로 인해 어려움을 겪는 경우가 많습니다. 이 프로젝트는 List<T>, async/await, 또는 잘못된 네트워킹 패턴과 같은 호환되지 않는 기능의 사용을 방지하는 스킬, 규칙 및 검증 훅의 지식 기반을 제공하여 생성된 코드가 VRChat 월드 내에서 실제로 컴파일되고 작동할 수 있도록 보장합니다.

작동 방식

이 프로젝트는 npm 또는 CLI 도구를 통해 AI 에이전트(예: Claude Code)에 통합될 수 있는 "스킬" 세트로서 기능합니다. 구성 요소는 다음과 같습니다:

• 규칙: AI가 코드를 작성하기 전에 가이드하는 마크다운 파일로, 차단된 C# 기능과 올바른 네트워킹 패턴(예: List<T> 대신 DataList 사용)을 자세히 설명합니다.
• 검증 훅: AI가 .cs 파일을 편집한 후 자동으로 실행되어 차단된 런타임 기능이나 동기화 부피 증가와 같은 오류를 감지하는 Bash 및 PowerShell 스크립트입니다.
• 템플릿: 일반적인 상호작용 및 동기화 패턴을 위한 17개의 코드 템플릿 라이브러리입니다.
• 참고 자료: SDK 버전의 기능을 AI 친화적인 설명으로 매핑하는 상세 문서입니다.

대상 사용자

AI 코딩 에이전트를 사용하여 UdonSharp 스크립트 작성을 돕고, AI가 생성한 컴파일 오류를 수동으로 수정하는 번거로운 과정을 피하고 싶은 VRChat 월드 제작자입니다.

주요 특징

• 자동 검증: 런타임 코드에서 async/await, try/catch, LINQ를 감지하는 훅을 포함합니다.
• 네트워킹 가이드: 데이터 예산을 최소화하고 올바른 소유권 모델을 적용하기 위한 동기화 의사결정 트리를 제공합니다.
• SDK 버전 관리: 3.10.5까지의 SDK 버전 간 기능을 매핑합니다.
• 에이전트 통합: AI 에이전트 환경에 쉽게 설치할 수 있도록 npm 패키지로 배포됩니다.