Cooperzheng/ai-game-dev-framework：让 AI 持续迭代游戏开发的轻量文档协作框架

简体中文 | English

让 AI 持续迭代你想做的游戏。

原型跑起来以后，设计开始变得难以接续：换个会话又要解释一遍，AI 临时补的规则逐渐变成定案，功能做完了，手感和画面却还没达到要求。

这套轻量文档与协作规则，将游戏目标、已确认设计和 AI 当前方案保存在项目中，帮助后续开发减少跑偏和重复沟通。适合用 AI 持续制作游戏的独立开发者和小团队，可接入新旧项目，不绑定引擎或模型。

什么时候用

场景	常见问题	框架提供什么
原型进入持续迭代	AI 为了跑通流程补的奖励、数值和规则，后来被当成已确认设计	区分确认要求与暂定方案，保留继续调整设计的空间
换会话或更换 Agent	设计散在聊天里，新一轮开发漏掉限制、重复讨论	提供当前设计入口，让后续开发有据可查
打磨玩法、手感和画面	功能和测试通过了，实际体验仍有差距	保留体验目标与参考范围，要求交付说明实际效果和剩余差距

接入项目

在目标游戏项目中，把下面这段话发给 AI：

请将 https://github.com/Cooperzheng/ai-game-dev-framework 接入当前项目。先读 BOOTSTRAP.md。保留有效设计、工程知识和历史记录，将游戏目标与用户要求归入 PROJECT，模块设计与实现归入同名模块目录，区分已确认设计与 AI 当前方案。检查并报告接入结果及规则加载情况。本次只接入，不提交或推送。

已有项目按接入指南合并，保留原有约束。首次接入需要整理已有设计；后续由 AI 按规则维护变化，设计者主要确认目标和重要取舍。

如何运作

位置	职责
AGENTS.md	规定何时读取设计、如何维护要求、如何判断完成
docs/PROJECT.md	保存游戏核心体验、整体方向与用户要求
docs/modules/模块名/DESIGN.md	模块的体验、规则、操作和确认范围
同模块 IMPLEMENTATION.md（按需）	实现、参数、制作、专用操作与当前复验
docs/engineering/、standards/、references/、release/、local/	共用工程、规范、参考、发行输入、本地材料

PROJECT 和 System 区分两类内容：

**已确认设计：**你明确要求或认可的内容，注明来源与范围；改变含义前需要对齐。
**AI 当前方案：**AI 可以在授权范围内继续调整的设计细节；实现完成、测试通过或你未提出反对，都不等于确认。

例如，你要求“主动躲避，不引入体力管理”。AI 可以提出闪避和翻滚、调校尚未确认的冷却，但不能自行加入体力消耗。下一轮开发先读取这些依据，设计变化再更新回正文。

模块文档按需建立，设计与实现同目录；中文项目可使用“模块/模块名/设计.md、实现.md”。Plan 可选，不预建空实现或重复目录。具体分工见文档组织。

以实际体验检查交付

你要求参考图中的厚重云层，接入体积云只是实现进展。AI 还应对照画面，检查形态、层次和质感，说明未达目标的部分；只认可云的质感，也不意味着授权重做地形或整体色调。

完整虚构示例用于说明规则，不是真实效果证据。交付规则涵盖可玩入口检查、受测版本和历史结果的区分。

验收与清理统一按轻量留存规范：日常简短交付，重要版本或模块通常留 3–5 张截图；同主题媒体默认只留最新有效一套，必要基线、对照与回退保留。检查按改动选择，不默认制作快照、副本或报告。

可选：初始化空项目

需要 Git 和 Node.js 18+，无第三方依赖：

git clone https://github.com/Cooperzheng/ai-game-dev-framework.git
node ai-game-dev-framework/tools/adopt.mjs --target ../my-game
node ai-game-dev-framework/tools/adopt.mjs --target ../my-game --apply

第一条 node 命令只预览；--apply 只接受不存在或为空的目标。路径相对终端当前目录，含空格时加引号，框架副本与游戏目录分开。非空项目由 AI 按接入指南合并；无 Node 可手动接入。

工具生成文档骨架，不生成游戏代码或安装引擎。填写真实设计依据后才算完成接入；本仓库的 PROJECT 描述框架自身，不能直接作为游戏的设计文档。

文档入口

本表为框架仓库的导航；游戏项目的 README 由接入工具单独生成，按实际模块维护。

内容	入口
工作规则与来源	AGENTS · 框架方向
接入与升级	BOOTSTRAP · 接入指南
文档分工与模板	文档组织 · 模块设计/实现模板
专项规范	UI · 验收与轻量留存
参考与案例	参考说明 · 虚构示例
可选过程记录	工作记录说明，不承担当前设计
版本与许可	版本 · 变更记录 · LICENSE

边界与维护

框架提供可查的设计依据，不能保证所有 Agent 自动遵循。宿主未自动加载 AGENTS 时，需显式要求读取或从宿主规则入口引用；文档接入与规则加载分别检查。

维护检查：node tools/check.mjs、node --test tools/adopt.test.mjs。这些检查验证文档链接与初始化行为，不证明真实游戏体验或长期设计一致性。

版本 · 变更与验证记录 · MIT License。升级按差异合并；第三方资料和游戏资产沿用各自许可。

如果这套框架对你有帮助，欢迎点个 Star，方便以后找到它。