docs(workflow): 关卡设计工作流与关卡执行案体系
- Agent 文档新增关卡执行案产出规范与白模搭建工作流 - 开发流水线补充关卡执行案产出节点与白模搭建子任务(6a) - 新增关卡执行案模板、BSP资产参考卡、关卡设计工作流规范 - 新增原型阶段设计文档索引 README - .gitignore 补充 __pycache__ 规则
This commit is contained in:
@@ -64,6 +64,7 @@ GameConfig/ # 数值配置表
|
||||
| 系统设计案 | `<system>.md` | `interaction-system.md` |
|
||||
| 执行案 | `<system>-execution.md` | `player-controller-execution.md` |
|
||||
| 场景设计 | `scene-v<XX>-<name>.md` | `scene-v01-suburban.md` |
|
||||
| 关卡执行案 | `level-v<XX>-<name>-execution.md` | `level-v01-suburban-execution.md` |
|
||||
| 配置表 | `<name>.csv` 或 `<name>.json` | `marble-params.csv` |
|
||||
|
||||
---
|
||||
@@ -341,6 +342,31 @@ GameConfig/ # 数值配置表
|
||||
|
||||
---
|
||||
|
||||
## 关卡执行案
|
||||
|
||||
关卡执行案是场景设计案的**空间精度版本**——将氛围描述转化为带有坐标、尺寸和资产建议的结构化搭建指南。
|
||||
|
||||
### 产出时机
|
||||
|
||||
关卡执行案在 **③执行案阶段** 产出,与系统执行案同步。产出前先阅读:
|
||||
- 对应的场景设计案 `scene-v<XX>-<name>.md`(氛围愿景)
|
||||
- `.claude/refs/level-execution-template.md`(文档模板)
|
||||
- `.claude/refs/blockout-asset-reference.md`(BSP 资产参考卡)
|
||||
|
||||
### 关键规则
|
||||
|
||||
1. **混合坐标体系**:区域用场景绝对坐标(原点在西南角),区域内物件用相对偏移坐标
|
||||
2. **BSP 资产建议是方向性指引**:引用资产类别名和组合方式(如 "Wall_400x300 × 2"),不写文件路径
|
||||
3. **交叉引用**:交互物引用 `interaction-system-execution.md` 编号,收集品引用 `collection-system-execution.md` 编号
|
||||
4. **不越界**:不写引擎组件名、文件路径、Blueprint 类名
|
||||
5. **标识色**:每个区域指定 `MI_Dev<颜色>` 标识色材质,供白模阶段区分
|
||||
|
||||
### 完整规范
|
||||
|
||||
参见 `docs/design/prototype/level-design-workflow.md`。
|
||||
|
||||
---
|
||||
|
||||
**持续更新你的 Agent 记忆**——当你发现设计模式、已确认的创意决策、头脑风暴共识点、跨系统关系、以及项目特有的叙事元素时记录下来。这会在多次对话中积累组织知识。写简洁的笔记——发现了什么、在哪里。
|
||||
|
||||
例如:
|
||||
|
||||
@@ -113,7 +113,40 @@ memory: project
|
||||
| UI | ... | ... | ... | ... |
|
||||
```
|
||||
|
||||
### 工作流 B:实现(步骤⑥)
|
||||
### 工作流 B:白模搭建(步骤⑥子任务 6a)
|
||||
|
||||
当版本开发涉及场景搭建时,白模搭建是 ⑥程序实现的首要子任务。
|
||||
|
||||
**输入**:
|
||||
- `level-v<XX>-<name>-execution.md` — 关卡执行案(空间指南)
|
||||
- `scene-v<XX>-<name>.md` — 场景设计案(氛围参考)
|
||||
- 系统执行案(交互物/收集品清单)
|
||||
- `Content/BlockingStarterPack/` — BSP 资产
|
||||
|
||||
**输出**:
|
||||
- `Content/Maps/LVL_<SceneName>V<XX>.umap` — 白模关卡文件
|
||||
- `docs/technical/level-v<XX>-build-report.md` — 搭建报告(偏差记录)
|
||||
- **在对应任务 Issue 下以评论发布搭建报告**(包含偏差清单、资产替代、缩放记录、比例验证结果,使 PM 和策划能直接在 Issue 中查看)
|
||||
|
||||
**搭建流程**:
|
||||
1. **准备**:阅读关卡执行案 → 创建 BSP 资产映射表 → 创建关卡文件
|
||||
2. **地面与边界**:铺设地面 Floor → 放置边界围墙/围挡
|
||||
3. **逐区域搭建**:按结构体 → 布景 → 交互物 → 收集品顺序
|
||||
4. **光照**:定向光/天空光 → 路灯/局部光源
|
||||
5. **验证**:角色比例检查(门洞/摄像机/家具) → 流线通行检查
|
||||
|
||||
**Actor 命名规范**:`LVL_<ZoneID>_<Category>_<Description>`
|
||||
- Category: STR(结构体) | PROP(布景) | INTR(交互物) | COLL(收集品) | BND(边界) | LGT(光源)
|
||||
|
||||
**Outliner 结构**:按区域分文件夹(Z1_家/Structure/、Z1_家/Props/、...),Global/ 放边界和光照。
|
||||
|
||||
**搭建报告**:逐区域对照文档要求记录偏差,包含资产替代清单、缩放记录、未实现项、比例验证结果。**报告必须同时**:
|
||||
1. 写入 `docs/technical/level-v<XX>-build-report.md`(本地文件)
|
||||
2. 以评论形式发布到对应任务 Issue(内容与本地文件一致,供 PM 和策划直接查看)
|
||||
|
||||
**完整规范**:参见 `docs/design/prototype/level-design-workflow.md` 第四章。
|
||||
|
||||
### 工作流 C:代码实现(步骤⑥子任务 6b-6f)
|
||||
|
||||
```
|
||||
阅读技术方案 → 阅读美术资产清单 → 编写代码 → 集成美术资产 → 验证功能 → 汇报结果
|
||||
|
||||
@@ -90,6 +90,11 @@ memory: project
|
||||
- **系统间关联**:与其他系统的依赖关系是否记录?
|
||||
- **技术越界检查**:策划是否误入技术实现细节?参数应标注"建议值,可调"
|
||||
|
||||
**关卡执行案附加检查**(仅当执行案包含关卡文档时):
|
||||
- **关卡资产存在验证**:关卡执行案中引用的 BSP 资产是否在 `Content/BlockingStarterPack/` 中实际存在?逐项验证可行性
|
||||
|
||||
> 关卡执行案的质量门**仅做资产存在验证**。空间精度、比例、跨文档一致性等维度的准确性由程序在白模搭建过程中验证——如果程序在 Issue 中汇报了搭建异常(尺寸偏差、资产无法匹配、比例问题等),PM 将异常汇总并汇报给用户确认,不自行判断通过或不通过。
|
||||
|
||||
### 质量门 2:程序设计质量门(④→⑤)
|
||||
|
||||
检查维度:
|
||||
@@ -242,6 +247,12 @@ memory: project
|
||||
- 单个代码任务应在一次工作会话中可完成(约 1-3 小时有效工作时间)
|
||||
- 如果一个系统的实现需要跨越多天,必须按程序设计文档的建议拆分
|
||||
|
||||
**③执行案任务拆分**:
|
||||
- PM 为**每一份系统执行案**创建独立的任务 Issue(如 `D-001 交互系统执行案`、`D-002 收集系统执行案`)
|
||||
- 当版本涉及场景搭建时,为**关卡执行案**单独创建一个任务 Issue(如 `D-005 v0.1 城郊小街关卡执行案`)
|
||||
- 不将多份系统执行案或关卡执行案合并为同一个任务
|
||||
- 关卡执行案任务与系统执行案任务**并行存在**,策划可按任意顺序完成,全部通过质量门后才进入 ④
|
||||
|
||||
---
|
||||
|
||||
## 9. 文档标准
|
||||
|
||||
Reference in New Issue
Block a user