Files
ChildHood/.claude/skills/world-sketcher/SKILL.md
T
starmen1265 22711cf946 feat(tools): 添加世界布局草图工具 World Layout Sketcher
三级层次化布局绘图 → AI 解读 → 关卡执行案前置输入

工具特性:
- L1 场景总览(道路/水域/区域/不可通行)→ L2 区域详图(建筑/绿地)
- 双层画布架构:L2 底图显示 L1 内容,绘图层独立操作
- L1↔L2 双向像素缩放同步
- 像素扫描提取连通区域(BFS),输出 bounds + 世界坐标
- JSZip 打包下载(JSON + 独立 PNG 像素文件 + 预览图)
- 加载时从 ZIP 恢复完整画布像素数据

集成更新:
- 新增 .claude/skills/world-sketcher/ 技能定义
- game-designer agent 添加 world-sketcher skill + 布局草图前置步骤
- 关卡设计工作流插入 ③a-③c 子流程
2026-06-09 16:49:54 +08:00

4.5 KiB
Raw Blame History

name, description
name description
world-sketcher 世界布局草图工具。当需要"画布局"、"世界草图"、"分析布局草图"、"layout sketch"、 "interpret sketch"、"world layout"、"世界布局"、"布局草图"时使用。 引导用户使用绘图工具画出世界布局,分析草图 PNG 产出结构化布局数据 Markdown, 作为关卡执行案的前置输入。

世界布局草图工具 (World Layout Sketcher)

三级层次化布局绘图 → AI 解读 → 结构化布局文档 → 关卡执行案前置输入

触发条件

  • 用户主动触发:用户说"画布局"、"世界草图"、"layout sketch"、"world layout"等
  • 策划关卡执行案前置:策划需要产出关卡执行案,但不存在对应的布局解读文档
  • 用户提供草图分析:用户提供了草图 PNG 要求分析

工具位置

tools/world-sketcher/
  sketch.html              # 绘图工具(浏览器打开)
  README.md                # 使用说明、画笔图例
  output/                  # 草图输出目录

三级层次

层级 范围 绘制内容
L1 场景总览 ≤1km 大区域、主干道、河流
L2 区域详图 ≤300m 建筑、内部道路、绿化、水体
L3 建筑内部 预留 拖放细节资产(未实现)

画笔颜色 → 材质映射

画笔 颜色 地形 UE 材质
道路 Road #909090 灰 道路 MI_DevGray
建筑 Building #E07020 橙 建筑物 MI_DevOrange
水域 Water #40A0D0 天蓝 河流/水塘 MI_DevSkyBlue
植被 Greenery #40B040 绿 树木/草地 MI_DevGreen
不可通行 Blocked #A07040 棕 山体/围墙 MI_DevBrown
区域 Zone #D04040 红 区域划分 MI_DevRed

工作流

步骤 1:检查现有草图

检查 tools/world-sketcher/output/ 目录下是否有当前场景的草图文件。

  • 如果存在:跳到步骤 3
  • 如果不存在:进入步骤 2

步骤 2:引导用户绘图

  1. 告诉用户打开 tools/world-sketcher/sketch.html
  2. 说明画笔含义:不同颜色代表不同地形类型
  3. 建议先画 L1 场景总览(大区域、主干道、河流),用区域画笔画出各区域轮廓
  4. 双击已画区域命名(如"城郊小街"),勾选"可进入"创建 L2 详图
  5. 进入 L2 后用建筑、道路等画笔细化区域内部
  6. 完成后点"保存全部",将文件保存到 output/ 目录

步骤 3:AI 分析草图

  1. 读取 PNG 草图(使用 vision 分析)
  2. 读取 JSON 伴随数据(scale、elements、层级关系)
  3. 交叉参考场景设计案 场景-v<XX>-<名称>.md 的氛围描述
  4. 产出布局解读文档

步骤 4:产出布局解读文档

产出文件:docs/design/<场景名>-layout-v<XX>.md

文档结构:

# <场景名> 世界布局解读 v<XX>

> 基于 `tools/world-sketcher/output/` 中的草图分析产出。

## 草图参数
| 参数 | 值 |
|------|-----|
| 世界尺寸 | ... |
| 坐标系 | 原点西南角,X+东,Y+北 |
| 比例 | 1px = ... |

## L1 场景总览

### 识别区域
| 区域编号 | 名称 | 推测坐标范围 (cm) | 推测尺寸 | 地形类型 | 标识色建议 |
|---------|------|-------------------|---------|---------|-----------|

### 识别道路/河流
| 编号 | 名称 | 类型 | 走向 | 长度 |

### 区域连通关系
| 连接 | 方式 | 说明 |

## L2 区域详图(如有)

### <区域名>
| 编号 | 名称 | 类型 | 推测坐标 | 尺寸 |

## 待确认问题
1. ...

## 待细化项
- ...

步骤 5:用户确认

将解读文档呈现给用户,等待用户确认或修正。确认后,该文档作为关卡执行案的前置输入。


与关卡执行案的衔接

布局解读文档产出并经用户确认后,策划产出关卡执行案时:

  1. 区域坐标:直接采用解读文档中的推测坐标范围作为起点
  2. 区域连通:采用解读文档中的连通关系
  3. 标识色:采用解读文档中的标识色建议(与画笔颜色一致)
  4. 需细化:解读文档中"待细化项"的内容在执行案中必须给出精确数据

注意事项

  • 画笔颜色是强制预定义的,不允许自由拾色,保证颜色→材质的映射一致
  • 坐标系与 zone_config.py 一致:原点西南角,X+ 东,Y+ 北,单位 cm
  • AI 解读时如有不确定之处,必须列入"待确认问题",不要自行假设
  • L3 建筑内部本期不实现,仅预留 has_interior 标记