docs(workflow): 关卡设计工作流与关卡执行案体系

- Agent 文档新增关卡执行案产出规范与白模搭建工作流
- 开发流水线补充关卡执行案产出节点与白模搭建子任务(6a)
- 新增关卡执行案模板、BSP资产参考卡、关卡设计工作流规范
- 新增原型阶段设计文档索引 README
- .gitignore 补充 __pycache__ 规则
This commit is contained in:
2026-06-06 23:55:14 +08:00
parent b951450345
commit 84bdfb22de
9 changed files with 1131 additions and 1 deletions
+26
View File
@@ -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 记忆**——当你发现设计模式、已确认的创意决策、头脑风暴共识点、跨系统关系、以及项目特有的叙事元素时记录下来。这会在多次对话中积累组织知识。写简洁的笔记——发现了什么、在哪里。
例如: