zenstory-ai/novel-to-game

Agent skills for source-grounded novel-to-game adaptation (小说改编游戏 / story to game): cited design docs, target-runtime builds, evidence-based QA. Three playable browser examples. For Claude Code, Codex, and Kimi Code.

NovelToGame란 무엇인가?

NovelToGame는 Claude Code, Codex, 또는 Kimi Code와 같은 AI 코딩 에이전트를 위한 7개의 오픈소스 스킬(플러그인) 세트입니다. 스킬을 사용하면 에이전트에 전체 텍스트 소설을 지정하고 단일 프롬프트로 대상 플랫폼(예: 웹 브라우저)용으로 구축된 플레이 가능한 게임을 얻을 수 있습니다. 워크플로우는 의도적으로 소스 기반입니다:

분석 – 에이전트가 전체 책을 읽고 모든 규칙, 캐릭터 목표, 플롯 포인트를 장 참조에 연결하는 SOURCE_BIBLE을 생성합니다.
컨셉 및 디자인 – 대체 게임 컨셉이 생성되고 각각 소스 바이블에 대해 검증됩니다. 소설과 충돌하는 방향은 하드 거부되고 기록됩니다.
아트 디렉션 및 장르 셸 – 선택한 장르의 "셸"(UI 레이아웃, 세계 진입, 목표 추적 등)이 구현, 저하, 생략에 대한 명시적 메모와 함께 문서화됩니다.
제품 브리프 – 한 페이지 요구 사항 시트가 대상 런타임(예: WebGL2)과 권리 또는 성인 콘텐츠 플래그와 같은 제약 조건을 고정합니다.
빌드 – 에이전트가 선택한 엔진/런타임에 대한 코드를 작성하고, 브리프가 승인한 경우에만 음성 자산을 선택적으로 생성합니다.
QA – 단일 자동 플레이스루가 기록됩니다. 실행은 6가지 검사(시작, 렌더링, 입력, 코어 루프, 결과, 재시작)를 통과해야 하며 결과는 verification.json 파일에 저장됩니다.

출력은 다음으로 구성됩니다:

플레이 가능한 빌드(예제에서 브라우저 접근 가능한 URL로 호스팅).
전체 디자인 문서(소스 바이블, 컨셉 결정, 게임 디자인 테이블, 아트 디렉션 가이드라인, QA 기록).
게임을 원본 소설에 연결하고 모든 디자인 선택에 대한 증거를 보여주는 적응 작업 공간.

왜 중요한가

증거 기반 적응: 모든 메커니즘은 소설에 대한 인용으로 정당화되어 "창의적 드리프트"를 방지합니다.
에이전트 비종속: 동일한 스킬 세트가 지원되는 세 코딩 에이전트 모두에서 작동합니다. 무거운 작업은 사용자 정의 엔진이 아닌 LLM이 수행합니다.
숨겨진 서비스 없음: 저장소에는 스킬 정의만 포함되며 번들 게임 엔진이나 클라우드 GPU 요구 사항이 없습니다.
오픈소스 및 재현 가능: 모든 마크다운 디자인 산출물은 버전 관리되므로 파이프라인을 직접 검사, 수정, 재실행할 수 있습니다.

빠른 설치(AI 코딩 에이전트가 이미 있는 사용자용)

# Claude Code 예시
npx skills add zenstory-ai/novel-to-game -g -y -a claude-code -s '*'
/novel-to-game   # 스킬 호출

다른 에이전트의 경우 claude-code를 codex 또는 kimi-code-cli로 바꿉니다. 스킬은 글로벌(-g) 또는 플래그를 빼면 로컬로 등록됩니다.

얻을 수 있는 것 – 예시 출력

예시	장르	플레이 가능한 링크	디자인 예상
서유기 – 삼차芭蕉扇	턴제 RPG(Fantasy Westward Journey 스타일)	https://xiyouji.vibecoco.ai	45–90분
금병매 – 욕망의 원장	갸루게 스타일 로맨스 ADV	https://jinpingmei.vibecoco.ai	루트당 20–30분
프로젝트 고원 – 잃어버린 세계	1인칭 3D 필드 사진(WebGL2)	https://plateau.vibecoco.ai	5–10분(단일 300초 실행)

각 링크는 브라우저 기반 프로토타입과 전체 증거 체인을 보여주는 마크다운 파일 폴더를 엽니다.

핵심 개념(README에서)

모든 디자인 결정은 소설을 인용 – 사실은 immutable, adaptable, open, 또는 conflicted로 라벨링됩니다.
장르 셸 문서화 – 시스템은 어떤 장르 관례가 유지, 저하, 제거되는지 기록합니다.
런타임 고정 브리프 – 빌드는 네이티브 엔진에서 웹 빌드로 조용히 전환되지 않습니다.
단일 실행 QA – 자동 실행은 게임이 시작되고, 렌더링되고, 입력을 받고, 코어 루프를 실행하고, 결과에 도달하고, 재시작할 수 있음을 증명합니다.
선택적 음성 – 브리프가 명시적으로 허용하는 경우에만 생성되며 기본적으로 외부 TTS를 사용하지 않습니다.

누가 사용할 수 있나요?

게임 디자이너: 문학 작품에서 빠르고 증거 기반의 프로토타입을 원하는 사람.
연구자: AI 기반 서사 적응 또는 자동 게임 디자인을 연구하는 사람.
교육자: LLM이 추적 가능한 출처를 가진 구조화된 소프트웨어 산출물을 생성할 수 있음을 시연하는 사람.

라이선스 및 커뮤니티

MIT 라이선스 – 스킬을 자유롭게 재사용, 수정, 재배포할 수 있습니다.
GitHub Discussions & Issues – 프로젝트는 생성된 게임과 스킬 파이프라인 자체에 대한 피드백을 장려합니다.

요약: NovelToGame은 기존 AI 코딩 에이전트를 활용하여 전체 소설을 문서화되고 실행 가능한 게임으로 변환하는 구체적인 오픈소스 파이프라인으로, 모든 디자인 선택을 소스 텍스트에 연결합니다.