Three.js 게임 개발용 AI 에이전트 스킬 9종 공개

개발자 Majid Manzarpour가 Codex와 Claude Code 러너에서 사용할 수 있는 Three.js Game Skills 9종 묶음을 공개했다. 이 스킬들은 특정 모델이나 API 키 없이도 기존 러너의 스킬 디렉토리에 파일을 복사하는 방식으로 설치 및 사용이 가능하다.

주요 기능 및 구성

이 스킬 세트는 Vite, TypeScript, Three.js 기반의 스캐폴딩을 제공하며, 결정론적 테스트 훅과 시드 고정 난수를 포함한다. threejs-game-director가 진입점 역할을 하며 요청 범위에 따라 작업을 분담한다. 기본 구조는 리드 1명과 워커 2명으로 구성되며, 파일 소유권과 입출력 계약이 명확히 정의된다.

제공되는 9개 스킬은 다음과 같다:

• director: 라우팅 및 검증 담당
• gameplay-systems, aaa-graphics-builder, ui-designer: 게임 로직, 그래픽, UI 개발
• debug-profiler, qa-release: 디버깅 및 릴리스 관리
• 3d-generator, image-generator, audio-generator: Tripo, Gemini, ElevenLabs API를 활용한 자산 생성 (핵심 스킬은 무료이며, 외부 자산 생성 시 해당 API 키 필요)

시각 품질 점수표 및 검증 메커니즘

이 프로젝트의 핵심 차별점은 **10개 항목으로 구성된 시각 품질 점수표(0~3점)**를 통한 객관적 검증이다. 에이전트가 생성한 결과물이 기준을 충족하는지 스크린샷, 픽셀 지표, 봇 플레이 기록 등 측정된 증거를 요구한다.

• 프리미엄 기준: 전 항목 2점 이상, 평균 2.3점 이상
• 쇼케이스 기준: 전 항목 2점 이상, 3점 항목 6개 이상, 평균 2.7점 이상
• 자동 실패 조건: 플레이 불가, 미다듬은 기본 도형 사용, 사각형 통계 카드 HUD 남용, 렌더러 진단 부재 등

또한 캔버스 지표를 통해 반증 기준을 설정한다. 색 엔트로피가 3.0비트 미만이거나 지배 색상 비율이 0.6을 초과하면 평평한 화면으로 간주되어 점수가 제한된다. 에지 밀도나 휘도 대비가 기준 미달일 경우에도 조명이나 지오메트리 항목의 점수가 제한된다.

설치 및 한계

설치는 npx skills add majidmanzarpour/threejs-game-skills 명령어를 통해 가능하며, MIT 라이선스를 따른다. 다만 Three.js/브라우저 캔버스 외의 엔진은 지원되지 않으며, 백그라운드 실행이나 비동기 처리는 러너 자체의 기능에 의존한다. 헬퍼 테스트의 모의 응답은 시각 품질 개선의 근거로 인정되지 않는다.