게임 개발 스킬 키트

게임을 만드는 순서까지 함께 공개합니다

“재미있는 게임을 만들어 줘”라는 요청에는 아직 정해지지 않은 것이 많습니다. 무엇을 누르고, 언제 점수를 얻고, 어떤 상황에서 실패하며, 다시 시작할 이유가 무엇인지가 빠져 있습니다. 화면이 나온 뒤에 이 질문으로 돌아가면 이미지와 코드를 함께 다시 손대기 쉽습니다.

AI Tools Lab의 게임 개발 스킬 키트는 이 과정을 기획·구현, 조작감, 에셋, 후보정으로 나눕니다. 게임 아이디어를 입력하면 어떤 자료부터 정리하고 어느 단계에서 결과를 확인할지 AI와 공유하는 작업 지침입니다. 하나의 스킬이 모든 결정을 대신하는 구조가 아니라, 필요한 역할을 이어 쓰는 방식입니다.

이번 다운로드에는 지침 파일뿐 아니라 연결된 생성기·명세·품질 검사 도구를 함께 담았습니다. 원본 게임 프로젝트를 통째로 내려받지 않아도 시작할 수 있도록 분리했습니다. 단, 키트 자체가 완성 게임이나 설치형 게임 제작 앱은 아닙니다. 게임 규칙을 구현하고 결과를 판단하는 작업은 여전히 필요합니다.

스킬 4종을 언제 사용하나요?

스킬	맡기는 일	사용 경계
game-factory	아이디어 정리, 구현 구조, 게임별 기능, 첫 완료 검수	새 게임·기능 확장·아직 완료 검수를 통과하지 못한 작업
game-feel-motion-skill	입력 반응, 타격·보상 피드백, UI 모션, 스프라이트 명세	그림을 만들기 전에 셀 크기·여백·피벗 등 동작 조건 정리
game-asset-creation	이미지·스프라이트 제작, 승인한 프레임의 배치 교정	새 그림 생성과 기존 픽셀을 보존하는 교정을 구분
game-polish	문제 재현, 수정, 같은 조건에서 재캡처, 회귀 검사	유효한 첫 production PASS가 있는 게임의 결함 수정

예를 들어 캐릭터의 점프가 어색하다면 먼저 입력 반응 문제인지, 프레임 간격 문제인지 나눕니다. 타이밍과 피드백은 모션 스킬에서 정하고, 스프라이트 배치가 원인이라면 에셋 스킬로 교정합니다. 이미 검수를 마친 게임에서 발견한 결함은 polish가 수정 전후를 같은 조건으로 비교합니다.

반대로 새 스테이지나 플레이 모드를 추가하는 일은 기존 게임이라도 factory의 범위입니다. 결함 수정과 기능 확장을 구분하는 것이 다시 검수할 범위를 줄이는 출발점입니다.

ZIP에는 무엇이 들어 있나요?

skills/: 스킬 4종의 본문, 필요한 참조 자료·템플릿·명세 검사기
dev_game/: Phaser/Vite 기반 최소 구조 생성기, 예제 spec, 에셋·플레이 검수 기준
scripts/: 프로젝트 안의 스킬 등록, 환경 점검, 명령 연결 검사
시작 안내·이용 조건·배포 명세: 설치 순서, 원본 기준 버전, 변경 내역, 파일별 해시

완성 게임, 대용량 이미지·영상·음원, 계정 정보, 과거 게임의 PASS 기록, 설치된 라이브러리는 넣지 않았습니다. 다른 게임의 검수 결과를 새 게임의 완료 근거로 사용할 수 없도록 구분했습니다.

완성된 프로젝트의 구조가 궁금하다면 AI 게임 개발 프로젝트를, 파일을 열어 가볍게 수정해 보고 싶다면 고전풍 웹게임 소스를 함께 살펴보세요. 이 페이지는 그 결과물을 만드는 작업 방법과 지원 도구를 제공합니다.

새 폴더에서 시작하는 방법

ZIP을 새 폴더에 풀고 그 폴더를 AI 도구의 프로젝트로 엽니다. skills/만 따로 옮기지 말고 dev_game/과 scripts/를 포함한 구조를 유지하세요. factory와 polish가 이 도구를 참조합니다.

# ZIP을 푼 최상위 폴더에서 실행
node scripts/kit-doctor.mjs
node scripts/register-skills.mjs --host all --dry-run
node scripts/register-skills.mjs --host all --apply
npm --prefix dev_game run kit:check

첫 명령은 기본 도구 유무만 점검합니다. --dry-run은 등록할 경로를 보여주고, --apply는 이 프로젝트 안에만 스킬 링크를 만듭니다. 기존 파일이 있으면 덮어쓰지 않고 중단합니다. 전역 스킬과 사용자의 다른 프로젝트를 자동으로 변경하지 않습니다.

Node.js/npm이 기본이며, 모션 명세 검사에는 Python 3, 이미지 후처리에는 Pillow, 브라우저 검수에는 Playwright/Chromium이 필요합니다. 키트의 시작 안내에 설치와 점검 순서가 있습니다. AI 도구가 스킬을 자동으로 찾지 못하면 해당 SKILL.md를 직접 읽도록 지정할 수 있습니다.

이미지 생성 환경은 별도입니다. 이 키트의 이미지 자동화는 Codex 내장 imagegen 경로를 사용합니다. Claude Code에서 작업을 시작하더라도 해당 자동화에는 Codex CLI 브리지와 로그인이 필요합니다. 키트를 무료로 받는 것과 외부 AI 서비스의 구독·사용량 비용은 다른 문제입니다.

첫 게임 요청을 이렇게 나누어 보세요

처음에는 장르보다 짧은 플레이 흐름을 정하는 편이 좋습니다. 다음은 키트를 적용하는 방식을 설명하기 위한 예시입니다. 이 게임이 이미 완성되었다는 뜻은 아닙니다.

$game-factory
30초 동안 도형 택배를 세 종류의 칸에 분류하는 한 손 웹게임을 만들고 싶다.
먼저 핵심 입력, 정답·오답 처리, 난이도 변화와 다시 시작하는 흐름을 정리해 줘.
기본 구조를 만든 뒤 이 게임만의 분류 규칙을 별도로 구현해 줘.
이미지를 생성하기 전에 에셋 목록과 사용할 외부 도구를 확인해 줘.
빌드 결과와 실제 플레이 검수 결과를 구분해서 알려 줘.

기획 단계에서는 “빠르게 분류한다”를 입력·판정·점수·실패 조건으로 바꿉니다. 모션 단계에서는 정답을 넣었을 때와 오답을 넣었을 때의 반응을 구분합니다. 에셋 단계에서는 도형과 칸의 식별성부터 확보하고, 구현 단계에서는 실제 입력이 분류 결과에 반영되는지 확인합니다.

첫 검수가 끝난 다음 “두 손가락으로 누르면 점수가 두 번 오른다”는 문제가 발견되었다면 polish에 재현 조건을 전달합니다. 화면 크기, 입력 순서, 기대 점수와 실제 점수를 함께 알려 주면 수정한 뒤 같은 조건으로 다시 확인할 수 있습니다.

빌드 성공과 게임 완성은 다릅니다

생성기는 시작 화면·게임 화면·저장·오디오·레이아웃 검사 연결 등의 기본 구조를 만듭니다. custom-shell은 장르 고유 플레이를 대신 완성하지 않습니다. 화면을 열 수 있다는 이유로 규칙과 재미까지 검증된 것은 아닙니다.

키트의 회귀 검사인 factory:qa와 특정 게임의 완료 검사인 factory:production-gate도 역할이 다릅니다. 전자는 제작 도구가 깨지지 않았는지 확인하고, 후자는 그 게임의 에셋·상태·검수 조건을 확인합니다. 실제 조작으로 목적을 달성할 수 있는지와 게임 고유의 플레이는 수동 확인도 필요합니다.

이번 배포 준비에서는 macOS의 한글·공백 경로에서 기본 생성·빌드·브라우저 smoke, 명령 연결, 등록 충돌, 정상·오류 명세를 점검했습니다. 실제 AI가 새 게임 전체를 완성하는 과정과 Windows/Linux 환경 전체를 검증한 것은 아닙니다. 검증 범위와 도구 요구사항은 키트 시작 안내에 함께 적었습니다.

이용 조건과 다운로드 안내

이 키트에 포함된 AI Tools Lab 소유 자료는 사용·복제·수정·상업 이용·재배포를 모두 허용합니다. 학습을 위해 구조를 바꾸거나, 상업 프로젝트에 적용하거나, 수정본을 다시 제공할 수 있습니다.

적용 범위는 ZIP에 포함된 자사 자료입니다. 원본 GitHub 저장소 전체, 포함하지 않은 다른 게임과 에셋, 사이트의 다른 콘텐츠까지 동일한 조건으로 바뀌는 것은 아닙니다. Phaser·Vite·Playwright 등 제3자 구성요소와 AI 서비스는 각각의 조건을 따릅니다.

다운로드 패널에는 버전·용량·파일 해시를 표시했습니다. ZIP 안의 이용 조건과 파일 명세를 확인하고, 수정본을 제공할 때는 어떤 부분을 바꾸었는지 원본과 구분해 주세요. 로그인이나 이메일 입력 없이 받을 수 있습니다.

자주 묻는 질문

게임 소스 10종과 같은 자료인가요?

아닙니다. 웹게임 소스는 개별 게임의 코드와 실행 화면을 살펴보는 자료이고, 스킬 키트는 새 게임을 설계·구현·검수할 때 AI와 공유할 작업 지침과 도구입니다.

네 스킬을 항상 전부 사용해야 하나요?

아닙니다. 새 게임 제작은 factory에서 시작하고 모션·이미지 작업이 있을 때 해당 스킬을 연결합니다. polish는 첫 완료 상태가 유효한 게임의 결함 수정에 사용합니다. 모든 요청에 네 단계를 억지로 붙이지 않습니다.

스킬만 복사하면 바로 작동하나요?

factory와 polish는 지원 도구와 품질 문서를 함께 참조합니다. 첫 사용은 키트 전체 구조를 유지하는 방식을 권장합니다. 이미지나 모션 스킬만 따로 옮길 때도 각 폴더의 참조 자료와 도구 요구사항을 확인해야 합니다.

키트를 받으면 이미지 생성도 무료인가요?

키트 다운로드는 무료지만 AI 도구 이용료와 사용량 비용은 별도입니다. 자동 생성 명령을 실행하기 전에 연결할 도구와 계정 조건을 확인하세요. 키트에는 인증 정보가 포함되어 있지 않습니다.

원본과 배포본의 관계

이 키트는 AI Tools Lab에서 운영하는 GitHub 계정 coreline-ai의 게임 프로젝트에서 분리했습니다. 원본 기준 커밋을 고정하고, 프로젝트 경로·등록 방식 등 이식한 부분을 배포본에 기록했습니다. 페이지의 GitHub 링크는 원본이며, 다운로드 버튼은 이 페이지에서 설명한 별도 키트를 가리킵니다.

4가지 스킬, 하나의 개발 키트