majidmanzarpour/threejs-game-skills

해결하는 문제

AI 에이전트(Codex 및 Claude Code 등)를 위한 전문적인 '스킬' 세트를 제공함으로써, 프로페셔널하고 완성도 높은 Three.js 브라우저 게임을 구축하는 과정을 단순화합니다. 사용자가 모든 기술적 세부 사항을 수동으로 안내할 필요 없이, 에이전트가 게임 메커니즘, 고급 그래픽, UI 디자인, 자산 생성, 품질 보증을 자동으로 조율할 수 있습니다.

작동 방식

이 프로젝트는 AI 에이전트의 스킬 디렉터리에 설치되는 SKILL.md 파일, 프롬프트 템플릿, 헬퍼 스크립트의 컬렉션을 제공합니다. 중심적인 '디렉터' 스킬(threejs-game-director)이 오케스트레이터 역할을 하며, 특정 요구사항에 따라 전문 스킬로 작업을 라우팅합니다:

• 게임플레이 및 UI: 메커니즘, 물리, 반응형 HUD를 처리합니다.
• 그래픽 및 자산: AAA급 조명, 쉐이더, 재질을 관리합니다. 외부 API(Tripo를 통한 3D 생성, Gemini를 통한 이미지 생성, ElevenLabs를 통한 오디오 생성)와 통합하여 게임용 자산을 생성할 수 있습니다.
• QA 및 디버깅: 포함된 Vite + TypeScript 스키마와 Playwright 템플릿을 사용해 스모크 테스트, 시각적 회귀 검사, 성능 프로파일링을 실행합니다.

대상 사용자

3D 웹 게임 개발에 AI 에이전트(Claude Code 또는 Codex 등)를 사용하며, 기본 프로토타입을 넘어 프로덕션 수준의 완성도 높은 경험을 원하는 개발자들입니다.

주요 특징

• 에이전트 오케스트레이션: 전체 게임 개발 라이프사이클을 자동으로 여러 전문 스킬이 협력하도록 조율하는 디렉터 스킬.
• 자동 QA: 캔버스 픽셀 검사, 봇 플레이테스트, 시각적 스코어카드를 통해 게임 품질을 검증하는 도구 포함.
• AI 자산 파이프라인: API 키를 통해 3D 모델, 텍스처, 사운드 효과를 네이티브로 생성하는 통합 기능.
• 결정론적 테스팅: 시드된 RNG와 테스트 훅을 제공하여 AI 에이전트가 자신의 작업을 신뢰할 수 있게 검증할 수 있도록 지원.