# NovelToGame

> 把任何小说变成可玩的网页游戏。

NovelToGame 是一套把小说改编成网页游戏的开源技能，适配 Claude Code、Codex 和 Kimi Code。 它先从原著里找出真正能玩的部分，挑一个合适的改编方向，设计出可玩的世界和画面，再把一份 范围明确的构建说明交给编码智能体去实现，最后验证成品能不能跑起来。

[English](README_EN.md)

## 为什么需要它

直接把小说丢给模型做游戏，出来的多半是换皮的通用玩法。NovelToGame 解决真正难的那一步： 把这本书特有的世界观、地图、势力、任务、物品和情绪变成玩家动作和核心循环，判断它该做成什么游戏，再一路推进到 能玩的原型。

## 流程

一个总入口串起六个各司其职的环节，把原始文本一路打磨成可验证、可游玩的原型。

```mermaid flowchart LR classDef io fill:#fce4ec,color:#333,stroke:#e57373,stroke-width:1px classDef orch fill:#eef2ff,color:#1e1b4b,stroke:#6366f1,stroke-width:1px

novel["📖 小说"]:::io --> orch["novel-to-game"]:::orch orch --> 分析 --> 概念 --> 世界设计 --> 美术 --> 构建 --> 验证 --> game["🎮 可玩游戏"]:::io 验证 -.->|未通过| 构建 ```

## 技能

| 技能 | 职责 | |---|---| | `novel-to-game` | quick / director 两种模式的完整流程总入口 | | `novel-game-analyze` | 提取规则、动作、空间、角色、系统与名场面，梳理成一份游戏设定集 | | `game-concept` | 生成、淘汰并从三个真正不同的方案中做出选择 | | `game-world-design` | 设计玩家体验、会回应的世界、系统、关卡与完整可玩原型 | | `game-art-direction` | 定义核心视觉原则、镜头、世界的视觉语言、界面、反馈与招牌画面 | | `game-build` | 写出构建说明，并让编码智能体完成一次可验证的构建 | | `game-qa` | 验证启动、画面、交互、状态切换、通关与重开 |

## 通过 Agent Skills 安装

为你使用的 CLI 安装全部七个技能：

| Agent CLI | 安装命令 | 调用方式 | |---|---|---| | Claude Code | `npx skills add worldwonderer/novel-to-game -g -y -a claude-code -s '*'` | `/novel-to-game` | | Codex | `npx skills add worldwonderer/novel-to-game -g -y -a codex -s '*'` | `$novel-to-game` | | Kimi Code | `npx skills add worldwonderer/novel-to-game -g -y -a kimi-code-cli -s '*'` | `/skill:novel-to-game` |

同时安装三端，重复 `-a` 即可：

```bash npx skills add worldwonderer/novel-to-game -g -y -s '*' \ -a claude-code -a codex -a kimi-code-cli ```

克隆仓库后，三端也都能发现项目内的 7 个技能。

## 原生插件安装

Claude Code：

```text /plugin marketplace add worldwonderer/novel-to-game /plugin install novel-to-game@novel-to-game-skills /novel-to-game:novel-to-game quick ```

Codex：

```bash codex plugin marketplace add worldwonderer/novel-to-game codex plugin add novel-to-game@novel-to-game-skills ```

Kimi Code 0.27 或更高版本：

```text /plugin