Communitygithub.com

建築佈局檢查

檢查生成或手動建造的建築、內部空間或封閉環境(房屋、辦公室、掩體、船艦、寺廟、廢墟、洞穴、建築群、太空站)的結構合理性與可步行性,包括荷載路徑、起止有據的牆壁、通往他處的門、具平台與淨空高度的樓梯、無孤立房間、無放置於開口內的牆壁、足夠的出口、淺層死巷、迴圈與雙向逃脫路線,適用於戰鬥或逃離場景。引擎與類型中立,附帶空間圖譜檢查腳本。

建築佈局檢查 是什麼?

此技能定義了一套三階段檢查流程,用於驗證由代理程式或生成器產生的建築佈局的結構完整性與遊戲可玩性。第一階段「空間圖譜」是一個快速腳本,將空間與連結以 JSON 格式建模,並針對可達性、出口、死巷、迴圈與樓梯等規則進行檢查。第二階段「幾何探針」則在引擎或建模工具中執行,以實際物理碰撞檢測牆端、淨空、支撐與邊緣防護。第三階段「視線高度審查」由人類或批評代理以第一人稱視角檢查佈局。此技能與引擎、時代及美術風格無關,並透過一個「世界簡報」文件來設定每個世界的特定參數,確保審查標準符合該世界的邏輯。

相容平台~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. 背景與時代: 時間與地點(例如「中世紀晚期河畔城鎮」、「2300 年代軌道採礦站」、「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.00可步行空間的 edge_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專案的佈局數據平面圖的來源:配方或清單、關卡匯出,或手繪平面圖。第一階段輸入

依樓地板面積計算的出口數量(所有可步行的室內樓層總和)。同一面上距離小於 EXIT_SPACING 的出口僅計數一次;玩家可攀爬通過的窗戶計為半個;單向通往外部的掉落視為逃生路線,會列出但不計入。

樓地板面積explorecontested
小於 100 m²12,位於 2 個面
100 至 400 m²2,位於 2 個面3,至少位於 2 個面
大於 400 m²3,至少位於 2 個面4,至少位於 3 個面

第一階段:空間圖譜(腳本)

將場所描述為 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)。提供其淨寬與淨空高度(若已知)、通往外部連結的 face 與 x, y、門處高度變化的 step,以及樓梯的 riser、tread、risers 與 spiral。將每個樓梯段建模為其所連接空間之間的 stair 連結;任何兩個樓層之間的非 drop 連結均計為垂直路線。

規則 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 m² 或深度超過兩個空間時,至少有一個內部迴圈。
  • 漏斗 (funnel):從外部到錨點(若未標記則為最深房間)的獨立路線(不共用空間);在 (C) 模式下,面積超過 100 m² 時一條路線為阻礙,面積超過 400 m² 時為發現。
  • 垂直路線 (vertical):每個樓層通往入口樓層的路線(向上或向下);面積超過 200 m² 的樓層需有兩條,且間距至少為 VERTICAL_SPACING;在 (C) 模式下,面積超過 100 m² 時亦然。
  • 尺寸與高度 (door_width、corridor_width、large_width、headroom、small、step):依連結種類檢查寬度與淨空高度、比玩家窄的空間、無樓梯的階梯。
  • 樓梯 (stair):階高、階深、步距與梯段長度;同一建築內混合階高。
  • 邊緣 (guard):落差超過 GUARD_DROP 且無防護的邊緣。
  • 管道與開口 (tube、openings):長度超過 TUBE_LENGTH 且無分支的走廊;(C) 開口過多的房間。

第二階段:幾何探針(在引擎或建模工具中)

圖譜無法看見幾何形狀。使用專案自己的工具在組裝好的建築上執行這些探針;每個探針必須產生一個數字或清單,而非螢幕截圖。

探針測量內容失敗條件
行走洪水填充一個玩家尺寸的膠囊在重力作用下從每個外部門開始行走,將牆壁視為固體(可使用導航網格建置)。圖譜稱為可達的空間無法到達,或者行走到達了圖譜中沒有的位置(縫隙、牆頂、無路徑的屋頂)。
支撐對於每個樓板、屋頂、樓梯、樑與上層牆壁:其投影下方的元素。任何物體懸空(超過 1 公分間隙)、柱或牆壁落在無樑或牆壁支撐的樓板跨距上、或懸臂超過其後方跨距約三分之一且無可見的托架或支撐。
牆端每堵牆與隔間的各個端點。端點未接觸任何物體(且非已完成的自由端)、落在門或窗戶開口內、或離另一堵牆的距離小於玩家寬度。
開口每個門兩側的樓板高度、每扇窗戶的射線。門通往牆壁、掉落處、密閉空間或高度大於 STEP_HEIGHT 的階梯;窗戶在 1 公尺內被牆壁、樓板、樓梯或高大物體阻擋;樓板或內牆跨越立面窗戶。
淨空沿每個路線掃掠膠囊、門的擺動區域、樓梯平台。淨空高度或寬度低於設定值;柱子、物體或隔間位於門路徑、平台或走廊淨寬內。
邊緣每個可步行邊緣及其落差。落差超過 GUARD_DROP 且無防護,亦未標記為刻意設計。
重疊牆中牆、牆中樓板、物體中牆的交集。任何超過數公釐且玩家可見的交集。

第三階段:視線高度審查

一位全新的審查者(未見過此建築的人類或批評代理)以視線高度在其中行走,並查看每個樓層的平面圖與剖面圖。他們會獲得世界簡報、建築物用途(「兩戶農舍」、「被淹沒的研究掩體」、「坍塌的神廟」、「貨運駁船的船員甲板」)以及已接受的條件(刻意死巷、鎖上的門、坍塌區域、爬行空間),並回答:

  1. 每堵牆都有理由嗎? 它圍出一個房間、承載某物、保護邊緣、遮擋視線,或者(在廢墟中)它是上述功能的殘留部分。不符合任何一點的牆壁應予移除。
  2. 每個房間都有其用途與合適的入口嗎? 盥洗室應從通道進入,而非穿過臥室從廚房進入;儲藏室應靠近其所儲存的物品;崗哨應能觀察其守衛的區域;氣閘應位於壓力與非壓力區域之間……

[此處原始內容截斷,無法完整翻譯]

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.

相關技能