用途:面向已有代码但缺少文档的游戏项目,逆转传统的先写文档后开发流程,从代码中还原文档。适用场景包括原型无文档、新成员快速理解代码库、原作者离开时的知识交接、项目复杂度上升后作者难以追踪系统、游戏 Jam 原型升级为正式项目、以及为发行商或投资方准备设计文档。
三个输出模式:design(反向工程游戏设计文档,含核心机制、系统、交互图、缺口与可调参数);architecture(架构决策记录,含技术栈、项目结构、检测到的架构模式、系统内部架构、横切关注点与技术债登记表);concept(从可玩原型提取游戏概念文档,含核心概念、玩家体验、机制摘要等)。三种模式共用同一代码分析管线,仅输出格式不同。
流程分四个阶段:项目扫描(检测引擎与框架、绘制目录结构、评估规模、检查已有文档);系统检测(按代码特征识别移动、战斗、背包、UI、音频、存档、AI、进度、物理碰撞、相机等系统,并列出孤立代码与缺失系统);机制提取(识别状态机、输入处理、碰撞响应、计时器、常量等,记录规则、参数、交互与设计意图);依赖映射(标注系统间使用、读取、修改关系,识别紧耦合、循环依赖与孤立系统)。
关键规则:先读代码再写文档,每条结论需可追溯到文件路径或代码模式;重意图而非实现;意图不明确处标记 [UNVERIFIED];按游戏系统而非文件结构组织;发现系统间不一致需明确标出。引擎检测覆盖 Godot、Unity、Unreal、Web/JS、Rust 等,均未命中则视为自定义或未知引擎。
限制:资料未提供具体安装命令、运行方式、收费模式或平台要求;效果与生成质量未提供验证信息。