feat(tools): 白模关卡自动生成Python脚本——Level Builder
两阶段流水线:搭建指南Markdown → JSON → UE5 Actor - 解析器:4种表格变体+范围展开+坐标表达式计算 - 配置:37种BSP资产映射+13种材质+7区域定义 - 验证:265个Actor全部通过,0错误 - Builder:UE5 Python API自动放置Actor+材质+Outliner - 报告:自动生成搭建报告Markdown Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
+17
-18
@@ -20,7 +20,7 @@ memory: project
|
||||
|
||||
| 文档 | 路径 | 用途 |
|
||||
|------|------|------|
|
||||
| 技术设计方案 | `docs/technical/<system-name>-tech.md` | 回应执行文档每条规则的实现方案 |
|
||||
| 技术设计方案 | `docs/technical/<系统名>-技术方案.md` | 回应执行文档每条规则的实现方案 |
|
||||
| C++ 源码 | `Source/` | 引擎级系统、性能关键路径 |
|
||||
| 蓝图资产 | `Content/Blueprints/` | 游戏逻辑、UI、交互 |
|
||||
| DataAsset | `Content/Data/` | 数据驱动的配置资产 |
|
||||
@@ -88,10 +88,10 @@ memory: project
|
||||
```
|
||||
|
||||
**必须按序阅读的输入**:
|
||||
1. 执行文档 (`docs/design/<stage>/<system-name>-execution.md`) — 行为规则细节
|
||||
2. 系统设计文档 (`docs/design/<stage>/<system-name>.md`) — 全局上下文
|
||||
1. 执行文档 (`docs/design/<stage>/<系统名>-执行案.md`) — 行为规则细节
|
||||
2. 系统设计文档 (`docs/design/<stage>/<系统名>.md`) — 全局上下文
|
||||
3. 配置表 (`GameConfig/`) — 可调参数
|
||||
4. 概念文档 (`docs/design/concept.md`) — 方向参考(需要理解设计意图时查阅)
|
||||
4. 概念文档 (`docs/design/概念草案.md`) — 方向参考(需要理解设计意图时查阅)
|
||||
|
||||
**技术设计文档**:按 `.claude/skills/requirements-analysis/` 中定义的需求分析 skill 产出。
|
||||
|
||||
@@ -124,14 +124,14 @@ memory: project
|
||||
当版本开发涉及场景搭建时,白模搭建是 ⑥程序实现的首要子任务。
|
||||
|
||||
**输入**:
|
||||
- `level-v<XX>-<name>-execution.md` — 关卡执行案(空间指南)
|
||||
- `scene-v<XX>-<name>.md` — 场景设计案(氛围参考)
|
||||
- `关卡-v<XX>-<名称>-执行案.md` — 关卡执行案(空间指南)
|
||||
- `场景-v<XX>-<名称>.md` — 场景设计案(氛围参考)
|
||||
- 系统执行案(交互物/收集品清单)
|
||||
- `Content/BlockingStarterPack/` — BSP 资产
|
||||
|
||||
**输出**:
|
||||
- `Content/Maps/LVL_<SceneName>V<XX>.umap` — 白模关卡文件
|
||||
- `docs/technical/level-v<XX>-build-report.md` — 搭建报告(偏差记录)
|
||||
- `docs/technical/关卡-v<XX>-搭建报告.md` — 搭建报告(偏差记录)
|
||||
- **在对应任务 Issue 下以评论发布搭建报告**(包含偏差清单、资产替代、缩放记录、比例验证结果,使 PM 和策划能直接在 Issue 中查看)
|
||||
|
||||
**搭建流程**:
|
||||
@@ -147,10 +147,10 @@ memory: project
|
||||
**Outliner 结构**:按区域分文件夹(Z1_家/Structure/、Z1_家/Props/、...),Global/ 放边界和光照。
|
||||
|
||||
**搭建报告**:逐区域对照文档要求记录偏差,包含资产替代清单、缩放记录、未实现项、比例验证结果。**报告必须同时**:
|
||||
1. 写入 `docs/technical/level-v<XX>-build-report.md`(本地文件)
|
||||
1. 写入 `docs/technical/关卡-v<XX>-搭建报告.md`(本地文件)
|
||||
2. 以评论形式发布到对应任务 Issue(内容与本地文件一致,供 PM 和策划直接查看)
|
||||
|
||||
**完整规范**:参见 `docs/design/prototype/level-design-workflow.md` 第四章。
|
||||
**完整规范**:参见 `docs/design/prototype/关卡设计工作流.md` 第四章。
|
||||
|
||||
### 工作流 C:代码实现(步骤⑥子任务 6b-6f)
|
||||
|
||||
@@ -292,22 +292,21 @@ memory: project
|
||||
## 关键文件路径
|
||||
|
||||
### 你产出和维护:
|
||||
- `docs/technical/<system-name>-tech.md` — 技术设计文档
|
||||
- `docs/technical/notes/*.md` — 架构决策、技术选型笔记、经验教训
|
||||
- `docs/technical/<系统名>-技术方案.md` — 技术设计文档
|
||||
- `docs/technical/笔记/*.md` — 架构决策、技术选型笔记、经验教训
|
||||
- `Source/` — C++ 代码
|
||||
- `Content/Blueprints/` — 蓝图
|
||||
- `Content/Data/` — DataAsset 配置
|
||||
|
||||
### 你阅读:
|
||||
- `.claude/refs/development-workflow.md` — 流水线定义、质量标准
|
||||
- 项目管理工具 Issues — 查看分配给你的任务和流水线状态(参见 `.claude/skills/gitea-collab.md`)
|
||||
- `docs/plans/<stage>-roadmap.md` — 版本划分、范围
|
||||
- `docs/design/concept.md` — 游戏方向参考
|
||||
- `docs/design/<stage>/<system-name>.md` — 系统设计概览
|
||||
- `docs/design/<stage>/<system-name>-execution.md` — 行为规则(你的主要输入)
|
||||
- `docs/plans/<阶段>-路线图.md` — 版本划分、范围
|
||||
- `docs/design/概念草案.md` — 游戏方向参考
|
||||
- `docs/design/<stage>/<系统名>.md` — 系统设计概览
|
||||
- `docs/design/<stage>/<系统名>-执行案.md` — 行为规则(你的主要输入)
|
||||
- `GameConfig/*.csv` / `*.json` — 可调参数
|
||||
- `docs/plans/reviews/<task-id>-review.md` — PM 质量门审查结果
|
||||
- `docs/art/style-guide.md` — 视觉方向参考(集成美术时阅读)
|
||||
- `docs/plans/reviews/<任务ID>-审查记录.md` — PM 质量门审查结果
|
||||
- `docs/art/美术风格指南.md` — 视觉方向参考(集成美术时阅读)
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user