Gameforge 是一个游戏生成编排器(Orchestrator),负责驱动完整的游戏创建流水线。宿主智能体调用各个包含 LLM 的子技能,本技能则定义流水线形态、共享状态文件、验证关口与暂停条件。所有图像生成默认通过 GPT Image 2(gpt-image-2)以 quality: low 执行。
用途
适用于以下请求:
- “帮我做一个……的游戏”
- “生成一个叫……的 Phaser 游戏”
- “修复上次运行中的 QA 失败”
- 任何使用自然语言描述的 8-bit / 像素艺术 / 2D HTML5 游戏需求。
主要能力与流水线
流水线依次经过以下阶段:
- game-designer:将提示词转为 GDD JSON(含按类型自动选择的 style.palette)。
- world-architect:将 GDD 转为 levels.json(基于瓦片的关卡布局)。
- sprite-artist:将 GDD 实体转为精灵表与清单,默认使用 GPT Image 2 低质量。
- tile-artist:将 GDD 瓦片调色板转为 tiles.png 与瓦片元数据。
- bg-artist:生成视差背景图,对 top-down-adventure 和抽象解谜类型可跳过。
- audio-composer:根据类型预设生成 sfx.json、music.json 和 AudioManager.js,与美术阶段 3–5 并行运行。
- palette-enforcer:将所有生成的 PNG 量化为指定的 8-bit 调色板(如 pico8、sweetie-16、endesga-32)以保证视觉一致性。
- codesmith:将 GDD、关卡与清单转为 src/scenes/Game.js;当 state.audio 存在时导入 AudioManager 并在 create() 中调用 AudioManager.init(this)。
- manifest-auditor:在打开浏览器前,对照 manifest.json 交叉检查 Game.js 中每个动画/纹理键,将不匹配项交给 refiner。
- mobile-compat-checker --fix:自动修补 roundPixels: true 和 image-rendering: pixelated CSS,并标记触摸输入与音频解锁缺口。
- parallel-qa-orchestra:并发运行 4 个 worker(静态可达性、黄金路径、模糊测试、物理调试),合并为一份失败列表交给 refiner。
- VLM 意图门:宿主智能体将截图与原始描述对比审查,通过则交付,失败则进入 refiner(最多 3 次循环)。
阶段 3、4、5、6 可并行运行,阶段 7 为汇聚点(所有美术必须先完成),阶段 9 和 10 为快速 lint 检查(无需浏览器)。
使用方式
路径 A — 从描述创建新项目
- 询问项目名(或接受参数),运行
scripts/init_project.mjs <name>脚手架。 - 调用 game-designer,将 GDD 保存到 game-state.json 并验证。
- 调用 world-architect,保存关卡并验证。
- 并行调用 sprite-artist(默认 GPT Image 2 低质量;
--placeholder可免费迭代)、tile-artist(通过src/lib/sprites.js的 generateTilesetGPT(),每个瓦片类型一次 GPT Image 2 调用,512×512 → 32×32;无 FAL_KEY 时自动回退为纯色)、bg-artist(generate_bg.mjs --theme <theme>,对 top-down-adventure 或抽象解谜跳过)。 - 从状态写入 public/assets/manifest.json 和 public/data/levels.json。
- 调用 codesmith,写入 src/scenes/Game.js(及可选辅助文件)。
- 调用 playtester;若失败则调用 refiner,最多循环 3 次。
- 报告最终状态:passed / failed / partial。通过后提示用户执行
cd <project> && npm run dev。
路径 B — 精修既有项目
- 读取 game-state.json 和最新 QA 报告(qa/qa-report.json)。
- 若 passed === true 则停止。
- 调用 refiner,应用编辑。
- 调用 playtester,循环至通过或 3 次迭代。
可选:多人联机
游戏生成并运行后,可通过 multiplayer 技能添加联机:
node skills/multiplayer/scripts/init_server.mjs <project-dir> # Colyseus WebSocket 服务器
node skills/multiplayer/scripts/patch_game.mjs <project-dir> # 修补 Game.js 以支持网络同步
# 可选附加:
node skills/multiplayer/scripts/init_server.mjs <project-dir> --voice # PeerJS 语音/视频
node skills/multiplayer/scripts/init_server.mjs <project-dir> --lobby # React 大厅前端
支持最多 4 名玩家,20 Hz tick 速率,TypeScript 共享 schema。详见 skills/multiplayer/SKILL.md。
共享状态 game-state.json
项目根目录下的唯一事实来源,每个子技能读写。Schema 包含 version、name、prompt、genre、createdAt、gdd、levels、assets(sprites 与 tiles)、code(entryPoint 与 scenes)、qa(最近 5 份报告)。每次变更后使用 scripts/validate_state.mjs <project-dir> 验证,拒绝破坏 schema 的修改。
项目布局(每个生成的游戏)
<project>/
├── game-state.json # 共享状态
├── package.json # phaser + vite
├── vite.config.mjs
├── index.html
├── public/
│ ├── assets/
│ │ ├── entities.png # 来自 sprite-artist
│ │ ├── tiles.png # 来自 tile-artist
│ │ └── manifest.json # 每张表的行/列标签
│ └── data/
│ └── levels.json # 来自 world-architect
└── src/
├── main.js # Phaser 引导(模板,永不编辑)
├── config.js # 游戏配置:pixelArt、FIT、RND 种子
└── scenes/
├── Boot.js # 模板,永不编辑
├── Preload.js # 从清单构建动画,永不编辑
└── Game.js # codesmith 编写
Boot.js 和 Preload.js 在所有游戏中固定不变——它们读取 manifest.json,按 <ENTITY_ID>-<state>(状态小写)构建动画,并将关卡与清单存入 this.registry。codesmith 的 Game.js 仅按名称使用。
动画键约定
每个动画命名为 <ENTITY_ID>-<state-lowercase>,如 KNIGHT-walk、SLIME-hurt、BULLET-idle。帧索引 = row * cols + col,其中 row 是实体在表 rows[] 中的索引,col 是状态在表 cols[] 中的索引。codesmith 必须通过清单查找,不得硬编码。
暂停条件
- 任一阶段 schema 验证失败 → 暂停并向用户展示验证错误,不循环。
- 3 次 refiner 迭代未通过 → 暂停并展示失败,不静默标记完成。
- 资产技能需要 GPT Image 2 但 FAL_KEY 和 OPENAI_API_KEY 均缺失 → 回退为程序化精灵/瓦片并跳过 bg-artist。
- 用户取消(SIGINT)→ 以 130 退出。
参考与脚本
- references/pipeline.md — 详细阶段接口与数据流
- references/state-schema.md — 完整 JSON schema 与示例
- references/phaser-cookbook.md — codesmith 必须遵循的 Phaser 3 模式
scripts/init_project.mjs <name> [--dir path]— 从 templates/phaser-game/ 脚手架scripts/validate_state.mjs <project-dir>— schema 检查 + 不变量验证scripts/run_pipeline.mjs <project-dir>— 调用完整流水线(宿主智能体驱动所有 LLM 子技能;无需单独 API 密钥)
限制
暂未提供关于收费、价格、平台支持范围或效果保证的明确信息。使用 GPT Image 2 生成资产需要相应 API 密钥,否则回退为程序化资源。