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>

.claude/agents/game-designer.md

@@ -35,7 +35,7 @@ memory: project
 
 ```
 概念草案（灵魂）→ 系统设计案（骨架）→ 执行案（血肉）
-  concept.md         <system>.md           <system>-execution.md
+  概念草案.md         <系统名>.md           <系统名>-执行案.md
   "这个游戏是什么"   "有哪些系统，如何关联"  "程序实现的交互规则"
 ```
 
@@ -43,29 +43,29 @@ memory: project
 
 ```
 docs/design/
-  concept.md                              # 概念草案（原型阶段开始后冻结）
+  概念草案.md                              # 概念草案（原型阶段开始后冻结）
   prototype/                              # 原型阶段产出
     README.md                             # 设计文档索引
-    <system>.md                           # 系统设计案
-    <system>-execution.md                 # 执行案
-    scene-v<XX>-<name>.md                 # 场景设计（索引中链接）
-    brainstorm-YYYY-MM-DD-<topic>.md      # 头脑风暴记录
+    <系统名>.md                           # 系统设计案
+    <系统名>-执行案.md                    # 执行案
+    场景-v<XX>-<名称>.md                  # 场景设计（索引中链接）
+    头脑风暴-YYYY-MM-DD-<主题>.md         # 头脑风暴记录
   production/                             # 批量生产阶段（从 prototype/ 复制）
 
 GameConfig/                               # 数值配置表
-  <name>.csv / <name>.json
+  <名称>.csv / <名称>.json
 ```
 
 ### 文件命名规范
 
 | 文档类型 | 格式 | 示例 |
 |---------|------|------|
-| 头脑风暴 | `brainstorm-YYYY-MM-DD-<topic>.md` | `brainstorm-2026-06-01-vision-pillars.md` |
-| 系统设计案 | `<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` |
+| 头脑风暴 | `头脑风暴-YYYY-MM-DD-<主题>.md` | `头脑风暴-2026-06-01-愿景支柱.md` |
+| 系统设计案 | `<系统名>.md` | `交互系统.md` |
+| 执行案 | `<系统名>-执行案.md` | `玩家控制器-执行案.md` |
+| 场景设计 | `场景-v<XX>-<名称>.md` | `场景-v01-城郊小街.md` |
+| 关卡执行案 | `关卡-v<XX>-<名称>-执行案.md` | `关卡-v01-城郊小街-执行案.md` |
+| 配置表 | `<名称>.csv` 或 `<名称>.json` | `弹珠参数.csv` |
 
 ---
 
@@ -83,10 +83,10 @@ GameConfig/                               # 数值配置表
 2. **一次一个问题** — 使用 AskUserQuestion 提供选项或开放提问。绝不一次性抛出所有问题。
 3. **要具体场景** — 如果回答模糊，问"你能描述一下那个时刻的画面吗？"
 4. **及时总结共识** — 每个子话题讨论后，总结并确认双方理解一致。
-5. **记录结果** — 写入 `brainstorm-YYYY-MM-DD-<topic>.md`。
+5. **记录结果** — 写入 `头脑风暴-YYYY-MM-DD-<主题>.md`。
 
 ### 头脑风暴记录
-- 位置：`docs/design/<stage>/brainstorm-YYYY-MM-DD-<topic>.md`
+- 位置：`docs/design/<stage>/头脑风暴-YYYY-MM-DD-<主题>.md`
 - 性质：非正式会议笔记，无固定格式，记录要点和共识。
 - 目的：下次会话阅读，避免重复讨论。
 
@@ -113,7 +113,7 @@ GameConfig/                               # 数值配置表
 ## 阶段特定行为
 
 ### 草案阶段
-- 产出 `docs/design/concept.md`，包含 7 个必填字段：
+- 产出 `docs/design/概念草案.md`，包含 7 个必填字段：
   1. 一句话描述
   2. 玩家核心游玩内容与感受
   3. 核心受众画像
@@ -122,8 +122,8 @@ GameConfig/                               # 数值配置表
   6. 市场定位与三大卖点
   7. 参考
 - 极轻量；可以反复推翻。
-- **用户确认并进入原型阶段后：concept.md 冻结。** 不再修改。
-- 偏离概念的内容应记录在系统设计案中并说明原因，不修改 concept.md。
+- **用户确认并进入原型阶段后：概念草案.md 冻结。** 不再修改。
+- 偏离概念的内容应记录在系统设计案中并说明原因，不修改概念草案.md。
 
 ### 原型阶段
 - 灵活性：核心行为必须完整，非核心可略过。
@@ -343,8 +343,7 @@ GameConfig/                               # 数值配置表
 ## 阅读参考文档
 
 开始工作前，阅读相关参考文档：
-- `.claude/refs/development-workflow.md` — 流水线定义、阶段划分、质量标准
-- `docs/design/concept.md` — 已冻结的概念草案（只读参考）
+- `docs/design/概念草案.md` — 已冻结的概念草案（只读参考）
 - 已有的设计文档 `docs/design/<stage>/` — 产出新文档前了解当前状态
 - 项目管理工具 — 查看分配给你的任务和流水线状态
 
@@ -361,7 +360,7 @@ GameConfig/                               # 数值配置表
 ### 产出时机
 
 关卡执行案在 **③执行案阶段** 产出，与系统执行案同步。产出前先阅读：
-- 对应的场景设计案 `scene-v<XX>-<name>.md`（氛围愿景）
+- 对应的场景设计案 `场景-v<XX>-<名称>.md`（氛围愿景）
 - `.claude/refs/level-execution-template.md`（文档模板）
 - `.claude/refs/blockout-asset-reference.md`（BSP 资产参考卡）
 
@@ -369,13 +368,13 @@ GameConfig/                               # 数值配置表
 
 1. **混合坐标体系**：区域用场景绝对坐标（原点在西南角），区域内物件用相对偏移坐标
 2. **BSP 资产建议是方向性指引**：引用资产类别名和组合方式（如 "Wall_400x300 × 2"），不写文件路径
-3. **交叉引用**：交互物引用 `interaction-system-execution.md` 编号，收集品引用 `collection-system-execution.md` 编号
+3. **交叉引用**：交互物引用 `交互系统-执行案.md` 编号，收集品引用 `收集系统-执行案.md` 编号
 4. **不越界**：不写引擎组件名、文件路径、Blueprint 类名
 5. **标识色**：每个区域指定 `MI_Dev<颜色>` 标识色材质，供白模阶段区分
 
 ### 完整规范
 
-参见 `docs/design/prototype/level-design-workflow.md`。
+参见 `docs/design/prototype/关卡设计工作流.md`。
 
 ---
 

.claude/agents/game-dev.md

@@ -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` — 视觉方向参考（集成美术时阅读）
 
 ---
 

.claude/agents/game-pm.md

@@ -30,9 +30,6 @@ memory: project
 
 ## 2. 参考文档与项目管理工具
 
-开始工作前，必须先阅读：
-- `.claude/refs/development-workflow.md` — 流水线定义、阶段划分、质量门标准（**首先阅读**）
-
 ### 项目管理工具
 
 进度管理（任务列表、流水线状态、角色汇报）全部通过项目管理工具追踪。当前使用 **Gitea**（Issues + Milestones），具体 CLI 命令、认证方式和标签体系详见：
@@ -40,9 +37,9 @@ memory: project
 > **`.claude/skills/gitea-collab.md`** — Gitea 协作工具完整参考
 
 **保留在本地的文档**（不在项目管理工具中管理）:
-- `docs/plans/prototype-roadmap.md` — 阶段路线图（信息量太大）
-- `docs/plans/reviews/<task-ID>-review.md` — 审查记录（详细结构化文档）
-- `docs/plans/work-log.md` — 工作日志
+- `docs/plans/原型阶段-路线图.md` — 阶段路线图（信息量太大）
+- `docs/plans/reviews/<task-ID>-审查记录.md` — 审查记录（详细结构化文档）
+- `docs/plans/工作日志.md` — 工作日志
 - 所有设计文档 (`docs/design/`)、技术文档 (`docs/technical/`)、美术文档 (`docs/art/`)
 
 **重要规则**：你的记忆只是参考信息，不能替代实际状态验证。"记忆说文件 X 存在" ≠ "X 现在存在"——使用前必须验证。
@@ -87,7 +84,7 @@ memory: project
 
 ### 审查后强制操作（无论谁执行审查）
 
-- [ ] 在 `docs/plans/reviews/<task-ID>-review.md` 写了审查记录
+- [ ] 在 `docs/plans/reviews/<task-ID>-审查记录.md` 写了审查记录
 - [ ] 在对应 Issue 上发布了审查结论评论（通过/不通过 + 摘要）
 - [ ] 更新了 Issue 的 gate:* 标签（通过→pass，不通过→fail）
 - [ ] **通过时**：关闭 Issue 并附完成说明
@@ -108,9 +105,8 @@ memory: project
 2. **获取活跃任务列表** → 所有进行中的任务
 3. **读取流水线追踪器状态** → 理解流水线位置
 4. **读取近期角色汇报** → 了解最新进展
-5. **检查本地审查记录**（如有）：检查 `docs/plans/reviews/` 中的近期质量门审查
-6. **交叉核对**流水线检查清单，确认当前流水线位置和阻塞点
-7. **向用户报告**：当前进度、阻塞点、建议的下一步行动
+5. **交叉核对**流水线检查清单，确认当前流水线位置和阻塞点
+6. **向用户报告**：当前进度、阻塞点、建议的下一步行动
 
 > 具体 CLI 命令参见 `.claude/skills/gitea-collab.md`
 
@@ -190,7 +186,7 @@ memory: project
 ### 必须获得用户确认：
 - 关闭 Issue（完成任务）和创建新 Issue
 - 创建新里程碑或关闭现有里程碑
-- 修改 `roadmap.md` 或 `prototype-roadmap.md`
+- 修改 `路线图.md` 或 `原型阶段-路线图.md`
 - 质量门不通过后退回工作
 - 重大偏差处理（回退或开新版本）
 - 阶段转换
@@ -234,8 +230,8 @@ memory: project
 |------|------|---------|
 | 任务追踪 | **项目管理工具 Issues**（唯一真实来源） | 任务状态变化 |
 | 流水线进度 | **Pipeline Tracker** | 流水线步骤变化 |
-| 阶段路线图 | `docs/plans/<stage>-roadmap.md` | 阶段开始、迭代调整 |
-| 审查记录 | `docs/plans/reviews/<task-ID>-review.md` | 每次质量门审查 |
+| 阶段路线图 | `docs/plans/<阶段>-路线图.md` | 阶段开始、迭代调整 |
+| 审查记录 | `docs/plans/reviews/<task-ID>-审查记录.md` | 每次质量门审查 |
 
 > 审查记录格式参见 `.claude/skills/quality-gate-review.md`
 
@@ -338,5 +334,5 @@ memory: project
 # PM Agent 记忆索引
 
 - [流水线阶段判断 2026-06-03](pipeline-status-20260603.md) — v0.1 处于阶段④执行案完善中，质量门未通过
-- [Roadmap 对齐问题](roadmap-alignment.md) — roadmap.md 缺少 v0.5-v0.7，需与 game-vision.md 对齐
+- [Roadmap 对齐问题](roadmap-alignment.md) — 路线图.md 缺少 v0.5-v0.7，需与游戏愿景.md 对齐
 - [设计文档质量审查](design-doc-review.md) — 交互系统技术越界、收集系统缺v0.1执行细节、边界情况不足

.claude/agents/game-reviewer.md

@@ -31,7 +31,6 @@ memory: project
 开始工作前，必须先阅读：
 - `.claude/skills/quality-gate-review.md` — **4 道质量门标准、阶段对应标准、审查流程**（核心技能）
 - `.claude/skills/gitea-collab.md` — Gitea CLI 命令和操作规范
-- `.claude/refs/development-workflow.md` — 流水线定义和阶段划分
 
 ---
 
@@ -56,7 +55,7 @@ memory: project
 ### 步骤 4：执行强制操作
 **必须**完成以下所有操作（缺一不可）：
 
-1. ✅ 在 `docs/plans/reviews/<task-ID>-review.md` 写审查记录
+1. ✅ 在 `docs/plans/reviews/<task-ID>-审查记录.md` 写审查记录
 2. ✅ 在对应 Issue 上发布审查结论评论（通过/不通过 + 摘要）
 3. ✅ 更新 Issue 的 gate:* 标签
 4. ✅ **通过时**：关闭 Issue（附完成说明）
@@ -72,7 +71,7 @@ node scripts/gitea.js --role pm issue comment <number> --body "## 质量门审
 
 **质量门**：[执行案/程序设计/美术资产/程序实现]
 **审查日期**：YYYY-MM-DD
-**审查记录**：docs/plans/reviews/<task-ID>-review.md
+**审查记录**：docs/plans/reviews/<task-ID>-审查记录.md
 
 ### 结论
 [一句话总结]
@@ -89,7 +88,7 @@ node scripts/gitea.js --role pm issue comment <number> --body "## 质量门审
 
 **质量门**：[执行案/程序设计/美术资产/程序实现]
 **审查日期**：YYYY-MM-DD
-**审查记录**：docs/plans/reviews/<task-ID>-review.md
+**审查记录**：docs/plans/reviews/<task-ID>-审查记录.md
 
 ### 结论
 [一句话总结]