用途:在 Fondale 游戏中确定世界有多大、长什么样,为后续所有素材生成提供统一尺寸基准,避免生成器随意决定尺寸。
读取:docs/game/story.md、docs/game/puzzles.md、docs/game/screenplay.md,以及已存在的 docs/game/world.md;同时读取已安装包 node_modules/@asterixcapri/fondale/docs/public/ 下的 authoring/project.md、authoring/hud.md、authoring/scene.md 契约。输入文档缺失时必须停下并提示作者运行 /define-story、/define-puzzles 或 /define-screenplay,不自行运行。
写入:docs/game/world.md、docs/game/assets.md、docs/game/progress.md,以及 AGENTS.md 中由标记界定的区块。路径相对于游戏仓库(工作目录)。
主要能力:清点剧情、谜题与剧本中的场景、角色、物件与动画;通过 $grilling 访谈作者,确定世界单位、比例锚点、逻辑分辨率(建议 1280 × 720)、舞台视角与地平线、透视缩放(建议远端 0.6)、各素材声明尺寸、视觉方向、HUD 字体与配色、光标与语音颜色;计算每世界单位像素数并推导目标高度;初始化资源登记表与进度文档。
使用方式:运行 /setup-game 后按流程逐步确认,完成后按 Next command 运行 /to-tickets。
限制:不运行缺失文档对应的子命令;不编造未提供的数值;背景按引擎校验的场景尺寸创作,不做归一化;透视缩放只表达纵深,不修正尺寸错误的素材。