Communitygithub.com

建筑布局检查

检查生成的或手动构建的建筑、室内或封闭环境(房屋、办公室、掩体、舰船、庙宇、废墟、洞穴、建筑群、空间站)在结构上是否合理且可步行通过——荷载路径、有起止点的墙壁、通往某处的门、带有平台和净空的楼梯、无孤立房间、无落入开口的墙壁、足够的出口、浅死胡同、人们战斗或逃跑时的循环和双向上通道。引擎和类型无关;附带一个空间图检查脚本。在审查代理或生成器生成的建筑或布局时、在接受预制件之前、或为套件编写布局规则时使用。

建筑布局检查 是什么?

建筑布局检查是一项AI代理技能,用于确保生成或手动构建的建筑在结构上合理且可步行通过,适用于任何引擎和游戏类型。它通过三个递进检查阶段来识别常见问题,如无端终止的墙壁、无法通过的门、不可达房间和不符合人体工程学的楼梯。该技能可配置世界设定文档,允许对不同的建筑时期、风格和功能(例如中世纪城堡、星际飞船或卡通村庄)进行定制。它包含一个用于空间图检查的Python脚本、几何探测指南以及一个第一人称审查流程。该技能支持探索和对抗两种配置模式,以相应调整出口和循环需求。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TayHD/game-agent-skills/tree/HEAD/skills/building-layout-check

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

建筑布局检查模块化套件可以轻松地将墙壁放置在网格允许的任何位置,而生成器和代理恰恰会这样做:墙壁在房间中央或窗户上结束,门通向空白墙壁或落差,无法到达的房间,楼梯面向墙壁,只有一扇门的盒子和从不分支的走廊。本技能就是要捕捉这些问题的检查工具。它评判的是布局和结构,而不是装饰或材质。

它适用于任何设定、时期和艺术风格,因为它根据世界自身的逻辑评判每个空间,该逻辑在世界设定文档中编写一次(如下):石制堡垒按石匠的建造方式和驻军的居住方式评判,星际飞船按船员的移动方式和船体的承载能力评判,洞穴按水流切割的方式和居民的使用方式评判,卡通村庄按该风格设定的规则评判。现代建筑规范仅在项目未作说明时作为后备。

按顺序进行三个检查阶段,因为每个阶段都比下一个更经济:空间图(脚本,数秒)、几何探测(在引擎或建模工具中,数分钟)和视线高度审查(个人或新的评论代理)。当所有阶段均无阻断问题时,建筑才算通过。

世界设定文档(在首次检查前编写)

项目环境文档中的一个简短章节,大约半页,供每次检查和每位审查者阅读。没有它,审查者将根据他们自己的时代和风格来评判,并标记错误的事物。

  1. 设定和时期: 地点和时间(例如“中世纪晚期河畔城镇”、“轨道采矿站,23世纪”、“洪水过后的1970年代郊区废墟”、“蘑菇民洞穴”)。
  2. 谁建造的,用什么建造的: 建造者的技术和材料,以及这些允许的范围:跨度(木材4-6米、石拱、钢桁架、生长珊瑚)、墙厚、地板如何承重、垂直移动方式(楼梯、梯子、坡道、电梯、攀爬、飞行、传送台)。
  3. 它的用途是什么,发生了什么变化: 其原始用途、当前用途(有人居住、废弃、被他人占用、废墟)以及改变它的事件(围攻、洪水、坍塌、植被覆盖)。损坏需要在世界中有原因。
  4. 艺术风格的规则: 写实、风格化、夸张、低多边形或玩具风格,以及它对比例(超大尺寸门、厚重的墙壁、歪斜的垂直线)和细节的影响。风格化的世界可以有目的地扭曲真实比例;设定文档说明程度。
  5. 谁在其中移动: 玩家的尺寸和移动方式(行走、蹲伏、爬行、攀爬、跳跃、游泳、飞行)、同伴、必须容纳的生物和载具,以及空间是用于探索、建造、战斗还是逃跑(这设定了 PROFILE)。
  6. 有意的例外: 这个世界所做的现代建筑不会做的事情,以便审查者接受它们(无护栏的城垛、梯子代替楼梯、单一入口的防御工事、无门的棚屋、陡峭台阶的螺旋楼梯、仅通过攀爬到达的房间)。

以下规则中提到的“合理”、“建造者”、“设计师”或“理由”均指:对该设定文档中的建造者、用途和风格而言是合理的。

项目提供的设置

每个设置都有一个针对人类比例玩家的默认值,以米为单位,具有现代比例。具有其他比例或时期(小型生物、巨人、载具、陡峭的中世纪楼梯、不同的单位)的项目从其世界设定文档中设置数字,而不是使用方法。在脚本中,设置来自图的 "settings" 对象,然后是 --profile 和 --site,然后是 --set NAME=VALUE(后面覆盖);未知名称会报错,因此拼写错误永远不会悄无声息地通过。

场地类型和关闭的规则。 有些规则来自建筑如何为人类设计(按占地面积计算的出口、内部循环、无单一漏斗、死胡同房间的比例、分支走廊)。洞穴、废墟或自然空间因其探索性质而不需要这些规则,因此使用 SITE natural 或 ruin 和 PROFILE explore 时,它们作为注释报告;在 contested 中,它们适用于所有地方,因为无论在哪里,战斗和追逐都需要它们。任何规则也可以由世界设定文档用 RULES_OFF 关闭(例如,设计为只有一个门的要塞:RULES_OFF=exits,funnel),或在图的 accepted 列表中为一个空间接受。

设置默认值含义使用方
WORLD_BRIEF无(假设为现代、写实、人类比例,报告应说明)上面提到的半页文档。所有阶段
PROFILEexploreexplore(探索、故事、建筑、无室内战斗的生存)或 contested(玩家在此战斗、追逐或逃跑)。contested 打开标记为 (C) 的规则。脚本
SITEbuildingbuilding、vessel(舰船、站台、载具:按建筑处理)、natural(洞穴、峡谷、树林、冰层、礁石)或 ruin。脚本
RULES_OFF无逗号分隔的规则ID列表,仅作为注释报告。脚本
PLAYER_RADIUS0.40行走胶囊宽度的一半。脚本
CROUCH_HEIGHT1.10爬行空间、挤过、游泳、梯子、攀爬、舱口和窗户所需的净空高度。脚本
MIN_HEADROOM2.10非爬行空间的每个可步行表面上的净高。脚本
MIN_DOOR_WIDTH0.90门、开口、楼梯、坡道或电梯的净宽。脚本
MIN_CORRIDOR_WIDTH1.20走廊或通道的净宽。脚本
MIN_SPIRAL_WIDTH0.70标记为 "spiral": true 的楼梯的净宽。脚本
MIN_CLIMB_WIDTH0.60梯子、攀爬点、舱口或游泳通道的净宽。脚本
LARGE_AGENT_DIAMETER0(无)必须通过的最大生物或载具的直径;标记为 large_route 的路线的宽度至少为此值的1.5倍。脚本
STAIR_RISER_MIN、STAIR_RISER_MAX0.10、0.20台阶高度范围。中世纪或拥挤的世界增加最大值。脚本
STAIR_TREAD_MIN、STAIR_TREAD_MAX0.22、0.40踏步深度范围。脚本
STAIR_PACE_MIN、STAIR_PACE_MAX0.55、0.70步幅规则:两倍台阶高度加踏步深度。适用于各个时期,并能发现对踏步深度而言过陡的楼梯。不适用于螺旋楼梯。脚本
MAX_RISERS_PER_FLIGHT16至少在此级数设置一个平台(不适用于螺旋楼梯)。脚本
STEP_HEIGHT0.45角色无需楼梯即可攀爬的最高台阶;step 大于此值的门或开口是阻断物。脚本
GUARD_DROP1.00edge_drop 大于此值的可步行空间需要 "guarded": true(栏杆、矮墙、墙壁,或这个世界使用的任何东西),或者一个已接受的条件说明落差是有意为之且感觉像一个。脚本、探测
TUBE_LENGTH15没有分支的最长走廊或通道。脚本
DEAD_END_DEPTHexplore 20,contested 10从最后一个分支节点到死胡同的最深处,以米为单位。脚本
EXIT_SPACING、VERTICAL_SPACING10、15同一面上比此距离更近的出口只计算一次;两条垂直路线必须至少相隔此距离。脚本
MAX_ROOM_OPENINGS4(C) 进入一个房间或大厅的最大开口数。脚本
MIN_SPACE_AREA1.0最小可用空间。脚本
GUARD_HEIGHT1.00 至 1.10需要护栏时的高度。探测
LAYOUT_SOURCE项目的布局数据平面图的来源:配方或清单、关卡导出、或手绘平面图。阶段1输入

按占地面积计算的出口(所有可步行的室内楼层合计)。同一面上比 EXIT_SPACING 更近的出口只计算一次;玩家可以爬过的窗户算半个;单向的向外落点算作逃生途径,列出但不计数。

占地面积explorecontested
小于100平方米12,位于2个面
100至400平方米2,位于2个面3,至少位于2个面
大于400平方米3,至少位于2个面4,至少位于3个面

阶段1:空间图(脚本)

将地点描述为JSON格式的空间和链接(格式和每个字段见 templates/space_graph.example.json)并运行:

python3 -I scripts/layout_check.py <graph.json> [--profile explore|contested] [--site building|natural|ruin|vessel] [--set NAME=VALUE ...] [--json out.json]
  • 空间是玩家可以站立并感觉为一个地方的地方。类型有:exterior(外部世界,恰好一个)、room(房间)、chamber(自然或不规则房间)、corridor(走廊)、passage(自然走廊)、landing(平台)、stair(楼梯间空间)、roof(屋顶)、deck(甲板)、yard(庭院)、void(密封空间)。房间、大厅、走廊、通道、平台、屋顶和甲板计入死胡同;房间和大厅计入开口和死胡同比例。为每个空间指定ID、楼层、面积,并在可能时指定:位置(x、y)、长度和宽度(走廊和通道)、净空、edge_drop 和 guarded、crawl、anchor(主要空间)、sealed。
  • 链接是两个空间之间的任何通道。类型有:door(门)、opening(开口)、stair(楼梯)、ramp(坡道)、lift(电梯)、ladder(梯子)、hatch(舱口)、climb(攀爬)、swim(游泳)、squeeze(挤过)、window(玩家可以爬过的窗户)和 drop(单向,从a到b)。为链接指定已知的净宽和净空、朝向和到外部的x、y坐标、门处高度变化的 step,以及楼梯的台阶高度、踏步深度、级数和 spiral。将每段楼梯建模为连接其所连接空间之间的楼梯链接;任何连接两个楼层且非落点的链接都算作垂直通道。

规则ID,用于报告、accepted 和 RULES_OFF:reach(可达性)、return(可返回)、sealed(密封)、exits(出口)、dead_end(死胡同)、dead_share(死胡同比例)、loop(循环)、funnel(漏斗)、vertical(垂直)、door_width(门宽)、corridor_width(走廊宽度)、large_width(宽生物宽度)、headroom(净空)、step(台阶)、guard(护栏)、stair(楼梯)、tube(管道)、small(小)、openings(开口)。accepted 条目是 {"rule": "...", "space": "..."}(或 "link"),或仅指定一条规则并说明在所有地方接受它的理由。

脚本报告 BLOCKER(阻断物)、FINDING(发现)、ACCEPTED(已接受)、NOTE(注释,包括从给定数据无法检查的内容)和 OK(正常):

  • 可达性(reach、return):从外部使用图中的移动方式可到达每个非密封空间,并且从每个空间可返回(落点是单向的)。
  • 出口(exits):根据表格计数、面数和间距。
  • 死胡同(dead_end、dead_share):只有一个入口的空间,从最后一个分支节点的链深度,以及 (C) 死胡同房间的比例。
  • 循环(loop):如果建筑面积超过400平方米或深度超过两个空间,则至少有一个内部循环。
  • 漏斗(funnel):从外部到锚点(如果未标记则到最深房间)的独立路线(不共享任何空间);在建筑面积超过100平方米且 (C) 时,一条路线是阻断物,超过400平方米时是一条发现。
  • 垂直路线(vertical):从每个楼层朝向入口楼层的路线,向上或向下;在面积超过200平方米的楼层上,或在 (C) 中面积超过100平方米的楼层上,需要两条相距至少 VERTICAL_SPACING 的路线。
  • 尺寸和级别(door_width、corridor_width、large_width、headroom、small、step):按链接类型检查宽度和净空、比玩家窄的空间、没有楼梯的台阶。
  • 楼梯(stair):台阶高度、踏步深度、步幅和段长;同一建筑中混合的台阶高度。
  • 边缘(guard):超过 GUARD_DROP 的无护栏落差。
  • 管道和开口(tube、openings):超过 TUBE_LENGTH 且无分支的走廊;(C) 中开口过多的房间。

阶段2:几何探测(在引擎或建模工具中)

图无法看到几何体。在组装好的建筑上使用项目自己的工具运行这些探测;每个探测必须产生一个数字或列表,而不是截图。

探测测量内容失败条件
行走洪泛一个玩家尺寸的胶囊体从每个外部门口开始,在重力下行走,将墙壁视为实体(导航网格构建可接受)。图声称可达的空间无法到达,或者行走到达了图中没有的位置(间隙、墙顶、无路线的屋顶)。
支撑对于每个地板、屋顶、楼梯、梁和上层墙壁:其足迹下方的元素。任何物体悬空(超过1厘米的空气间隙),柱子或墙壁落在没有梁或墙壁支撑的地板跨度上,或者悬臂梁超出其后跨度约三分之一且没有可见的支架或支撑。
墙端每堵墙和隔断的每个端点。端点未触及任何事物(也不是完成的自由端)、落在门或窗开口内、或者距离另一堵墙小于玩家宽度。
开口每扇门两侧的地板高度,每扇窗户的射线穿过。门朝向墙壁、落差、密封空间或高度大于 STEP_HEIGHT 的台阶;窗户后方1米内被墙壁、楼板、楼梯或高大家具遮挡;外墙上的窗户被地板或内墙穿过。
间隙沿每条路线扫描的胶囊体、门摆动区域、楼梯平台。净空或宽度低于设置;道具、柱子或隔断位于门路径、平台上或走廊的净宽内。
边缘每个可步行的边缘及其落差。落差超过 GUARD_DROP 且无护栏,且未标记为有意。
重叠墙中墙、墙中地板和道具中墙壁的交集。任何大于几毫米且玩家可见的交集。

阶段3:视线高度审查

一名新的审查者(未见过该建筑的个人或评论代理)以视线高度在其中行走,并查看每个楼层的平面图和剖面图。他们获得世界设定文档、建筑用途(“两户农舍”、“被水淹的研究掩体”、“坍塌的寺庙”、“货船的船员甲板”)以及已接受的条件(有意的死胡同、锁着的门、坍塌的部分、爬行空间),并回答:

  1. 每堵墙都有理由吗? 它围起一个房间、承重、保护边缘、遮挡视线,或者(在废墟中)是这些之一的残留物。做不到这些的墙应被移除。
  2. 每个房间都有用途和合适的进入方式吗? 盥洗室应靠近通道,而不是穿过厨房经过卧室到达;储藏室应靠近所存物品;岗哨应能看到其守卫的对象;气闸应位于压力区和低压之间;牢房不应有从内部打开的门——每个房间应感觉是其用途的适当位置。
  3. 大小的变化有意义吗? 窄走廊通往更开阔的空间(房间、大厅、外部),宽走廊暗示重要性或交通流量。没有理由的宽度变化会让人迷失方向。
  4. 垂直路线是否清晰? 从楼梯顶部或底部,在楼梯本身可见的范围内,下一个通道应该朝向你来的大致方向(而不是立即转向相反方向)、通向一个你来的方向的空间、或者通往一个可以从楼梯上看到的开口。感觉不到走错的楼梯应被重新定位。
  5. 是否存在人们会被迫穿过一个空间去往另一个空间的情况? 在 contested 布局中,被迫穿过卧室到达梯子的区域、单一入口庭院、或者某人必须穿过整层楼离开的楼层,都应被标记为漏斗(即使计算上不止一条路线)。
  6. 空间序列是否讲述了一个有意的故事? 从入口到内部,较大的空间是否在需要时打开,收窄是否意味着接近目标或危险,或者序列是否感觉随机?
  7. 在视野深度内是否有怪异的透视现象? 狭窄的走廊在20米后突然变宽为大型空间而不改变方向,这会压缩透视;宽阔的走廊在几米后进入极小的门,这会显得笨拙。应通过单独改变方向(转弯、偏置)或一起改变宽度和方向来打破。
  8. 美学能帮助行走吗? 沿着墙壁的踢脚线或边缘、楼梯踏步深度的变化、走廊天花板高度的变化是否告诉我们我们身在何处以及要去哪里?在看不到墙壁的地方(外部,或者如果玩家总是看地板),这是可选的;在走廊和房间中,期望寻找出口的玩家应该能够获得视觉线索。
  9. 已接受的理由在行走时感觉合理吗? 被标记为有意的死胡同是否感觉像一个尽头的房间(而不是未完成的位置),从外部到达的锐利边缘是否感觉像是为世界设定的合理事物(而不是未完成),某物是否因缺少另一层纹理而让人感觉错误?
  10. 带宽是否适合移动? 走廊和门的宽度应匹配群组大小(单人很紧,双人舒适,三人紧凑)。供通过的车队应足够宽以供载具通过。

如何将此技能用于您的AI代理

将此技能添加到您的代理配置中(例如Claude Code的.claude、Cursor的.cursorrules、Codex CLI的配置)。然后,在审查建筑布局或地板平面图时,告知代理您正在审查的项目的世界设定文档(如上方文档第2节所述——世界设定文档应在项目文档中)。您还可以告知代理任何已接受的或特殊的条件。然后要求代理对给定的布局执行检查,首先作为人类分析提供发现,然后协助将布局转换为空间图JSON格式并运行提供的Python脚本。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

creature-animation-pipeline

Author and ship a full bespoke animation set for a creature (dinosaur, beast, large biped or quadruped) with AI agents - biomechanics and mass first, rig profile and joint caps, key frames first, clip order and mirrors, a per-species animation studio for review, blind calibrated critics, the owner's stamp lock with a no-regression champion take, every clip wired, a species speed curve and the feel-bug rules. Use when starting a new species, authoring or fixing creature clips, setting up the review studio, critics or stamps, or deciding whether a creature clip is done.

first-person-weapon-animation

Build bespoke first-person and third-person weapon animation for an Unreal shooter - gun-space rig, measured hold poses, gun-first action authoring with key frames first, reload anatomy, modular weapon families with per-weapon profiles, procedural layers with stated interpolation, export and install with round-trip checks, a per-weapon review surface, calibrated blind critics, owner stamps and a no-regression champion take. Use when authoring hold poses, reloads or other weapon actions, installing weapon animation, tuning or debugging first-person feel, or reviewing weapon animation.

human-character-animation

Build bespoke third-person human character animation for a multiplayer Unreal shooter (NPC bodies and the player's third-person body) - rig and retargeting hygiene, vetting clip drops, locomotion with motion matching, turn-in-place, layered upper body and aim offsets, third-person weapon read, cover, hit reactions and deaths, a review studio, calibrated blind critics with measured checks, owner stamps with a champion take, key frames first and the blending law. Use when authoring, importing, wiring or reviewing human character clips, setting up a human animation review loop, or fixing a human body feel bug.

poi-design

Design, build, critique and ship points of interest (compounds, towns, facilities, stations, wrecks, camps, ruins, caves) in an open-world game of any setting, period, style or genre - the site's purpose in the world, how it is found without markers and read from a distance, a visual brief per site, flow sized for the game's players and largest enemies, story told through the environment, loot placement, prop and vehicle sourcing rules, assembly from passed kit pieces, a finish bar, blind calibrated critics with eye-height and aerial reviews, owner or lead stamps, fault-to-rule fixes and the "does it make sense?" rule. Use when planning a POI, writing its brief, laying it out or dressing it, reviewing one, or setting up a POI critic loop.

相关技能