Communitygithub.com

poi-design

設計、建構、評析並完成開放世界遊戲中的據點(如:設施、城鎮、建築群、車站、殘骸、營地、廢墟、洞穴),涵蓋世界中的目的、無標記探索、遠距辨識、視覺簡報、適合玩家與大型敵人的動線流程、環境敘事、戰利品配置、物件與車輛使用規則、套件組裝、完成度標準、盲測評審(含視角與空拍)、所有者或主設計師簽核、缺陷轉規則修正,以及「合理嗎?」原則。用於規劃據點、撰寫簡報、佈局、裝飾、審查,或建立據點評審循環。

poi-design 是什麼?

此技能提供一套完整的方法論,用於設計並完成開放世界遊戲中的據點(POI)。開發者能據此定義據點在世界中的角色、可讀性與無標記探索方式;規劃基於規則的動線,以確保戰鬥空間的趣味性與大型敵人通過性;透過環境設計講述故事,並建立客觀的品質審查迴圈。它支援從小型哨站到複雜城鎮等各種規模,並能與其他模組化環境技能(如 `modular-environment-kit-production` 和 `building-layout-check`)無縫整合。其核心在於利用精心定義的規則(如動線規則 `FLOW_RULES` 與戰利品配置規則 `PLACEMENT_RULES`)取代主觀判斷,並透過盲測評審來驗證設計的合理性。此技能適用於 Claude Code、Cursor、Codex 等平台,協助使用者將據點設計從隨意的擺放提升為嚴謹、可重複驗證的工程流程。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TayHD/game-agent-skills/tree/HEAD/skills/poi-design

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

POI 設計

一個據點要能「完成」,必須具備以下條件:它看起來像一個真實存在、有人建造並使用過的地方,其狀態符合簡報所述(正常運作、有人佔據、廢棄、已成廢墟,或從未建造,如洞穴或小樹林);並且,它在遊戲中是一個精心設計的地圖:玩家與生物能進得去、穿得過、出得來,戰鬥具有形狀,且獎勵值得冒險。通過自動檢查是必要條件,但絕對不夠。此技能是處理整個據點的方法論;具體的數值則來自專案的世界設定、玩家人數與生物設定。

輔助技能:modular-environment-kit-production(構成據點的零件及其表面處理)、building-layout-check(據點內的每棟建築,以及此技能所延伸的世界簡報)和 project-knowledge-system(標準、決策與經驗教訓的存放處)。此技能不會重複它們的內容,而是會指向它們。

專案需提供的設定

設定含義預設值
WORLD_BRIEF場景、時代、建造者、美術風格、世界中的移動者(於 building-layout-check 中定義)。在設計第一個據點前必須提供。
WORLD_PLAN世界地圖,包含所有據點、其階級、據點間的路線、區域與地標。在進行據點佈局前必須提供。
POI_BRIEFS每個據點的視覺簡報(欄位如下)。Docs/Design/World/POIBriefs.json
POI_RUBRIC品質標準:自我檢查關卡的行數、評審的問題、P0 與 P1 項目、區域標準表。Docs/Design/World/POIStandard.md
FLOW_RULES有編號、可測量的動線規則,以及已命名的失敗模式(起始集如下)。此技能的動線章節
PLACEMENT_RULES根據區域、錨點和用途,各類物件應放置的位置。此技能的敘事章節
PROP_LIBRARY核准的物件與載具目錄,每種物件類型一個來源。必須提供;據點不得放置未經目錄收錄的物件。
PROP_POLICY是否可為特定據點建模鬆散物件。否:僅限結構體和固定於建築的零件;鬆散物件需來自 PROP_LIBRARY;缺口會列入清單供所有者處理。
VEHICLE_CLASSES可能出現的載具種類及其原因。僅限實用型(工作、服務、運輸、軍用、農業);種類稀少。
KIT_CONTRACT、FINISH_SPEC、CORE_LIBRARY如同在 modular-environment-kit-production 中定義。前述技能的預設值。
TIERS據點階級,附帶典型的規模區間與建築數量。據點(殘骸、營地、洞口、神龕)10-40 米,前哨站 40-80 米,車站 60-150 米,建築群 80-220 米,綜合設施 200-400 米(含 2-4 個子區域),城鎮 250-600 米(含 4-6 個圍繞廣場的子區域)
PLAYER_COUNT每台伺服器的玩家人數及典型小隊規模。必須提供;決定一個據點需容納多少隊伍。
LARGE_AGENT_DIAMETER必須通過的最大生物或載具(如同在 building-layout-check 中定義);若有多個尺寸等級,則為每個等級增加一個。0(無)
PROFILE、SITE如同在 building-layout-check 中定義;大多數 POI 為 contested。contested、building
CRITIC_TARGET、CAMERA_RANGE評審將與之比較的已發行遊戲名稱;工作狀態的攝影機距離。在世界簡報中命名;第一人稱為 2-5 米
CRITIC_MODEL每個 POI 評審所使用的模型及推理能力。最強的可用模型,搭配高推理能力
STUDIO、STAMPS所有者查看的審閱平台;印章與標記的記錄位置及誰有權蓋章。包含靜態圖、步行路線圖、平面圖與判決的私人審閱頁面;主設計師蓋章,所有者標記
RULES_LEDGER記錄每個因缺陷而產生的規則及其日期與原因的地方。專案的決策日誌加上 POI_RUBRIC 的變更日誌
DCC、ENGINE建模工具與遊戲引擎。專案自選

原則

  1. 目的優先。 每個據點在世界上和遊戲中都有一份工作;每棟建築、每個庭院、每條道路和每個物件都為其中之一服務。
  2. 佈局為王。 一旦據點完成,後續的美術迭代應保留其通道、出入口、制高點和標示點;更改任何一項都將使其重新開放。
  3. 重用勝於建模。 據點由驗證過的套件零件和目錄物件組裝而成;沒有任何東西是在引擎中手工打造的。
  4. 證據勝於空談。 關卡檢查測量數據;評審判斷關卡檢查無法涵蓋的部分;渲染圖和步行路線圖即為證據。
  5. 完工即是良品。 P0 問題必須解決;其他問題皆為待辦清單。
  6. 合理嗎? 絕不為了滿足某個關卡檢查項目、某個評審或某條規則而添加、移動或更改任何東西。如果某條規則讓這個據點變得更糟,請向主管申請豁免,並記錄原因。

1. 據點在世界中的位置

WORLD_BRIEF 需要為 POI 補充的內容。 除了 building-layout-check 要求的半頁內容外,簡報還需說明:玩家如何導航(地圖、指南針、地標;是否存在標記)、威脅名冊及其尺寸等級以及每種威脅能攀爬、進入或破壞什麼、PLAYER_COUNT 以及隊伍如何相遇、獎勵經濟體系(什麼是稀缺資源、死亡代價為何),以及世界自據點建成以來的年齡、氣候和歷史,這將決定磨損和植被生長的程度。

適用的規則。 根據 building-layout-check 為每個據點設定 PROFILE 和 SITE。第 4 節中的動線、掩護和制高點規則適用於 contested 據點,即玩家或生物會戰鬥、追逐或逃竄的地方。一個 explore 據點(例如寧靜的神龕、敘事廢墟)仍需滿足可達性、可發現性、故事和完成度,並將戰鬥規則作為備註記錄。一個 natural 據點(例如洞穴、峽谷、小樹林)不需要街道網絡、邊界、服務設施或地形整平,但仍需有進出口、可讀的路線、地標或入口辨識特徵、發生戰鬥的淺層死胡同,以及可供大型生物循環的路線。一個 ruin 據點需要保留其原始邏輯中倖存的部分,且其損壞情況必須有原因。據點等級的據點(單個殘骸、營地或洞口)需要兩個入口、一個停留的理由、獎勵附近的掩護以及遠距離的可辨識特徵;據點規模的計數(入口數量、最小分割、三個循環)從前哨站等級開始。

在任何人繪製平面圖之前,請為 WORLD_PLAN 中的每個據點撰寫以下幾行。

  • 角色: 它原本的用途(運送貨物、駐紮居住、研究、生活交易、開採、崇拜)以及它現在的狀態(被遺棄、被其他人佔據、已成廢墟、被大自然收回)。
  • 階級與規模: 來自 TIERS。一個據點只應根據其子區域和廣場的需求而成長,絕不應透過拉開建築物之間的距離來擴張。頂級據點數量稀少,中級據點數量眾多,且每個區域都應有一個值得玩家橫跨該區域前往的據點。
  • 威脅: 誰和什麼佔據此處(派系、生物、危險),這如何隨 PLAYER_COUNT 擴展,以及大型生物是否能到達其核心。在大型生物重要的地方,它們應保持優勢:據點應為玩家提供脫離接觸的方法,而不是讓一個小隊能刷他們的避風港。
  • 獎勵: 在此處可以找到、而在其他地方找不到的東西,以及其相對於鄰近據點的價值。獎勵跟隨風險。
  • 地形、故事與遊戲性理由: 各一行。一個沒有地形理由的據點看起來像是憑空出現;一個沒有遊戲性理由的據點會被玩家跳過。
  • 無標記探索: 玩家僅透過世界本身來發現和辨識據點。使用一個能遮擋隱藏據點之物(樹冠、屋頂、沙丘、山脊)的地標,從約 300 米外可讀(典型:桅杆、起重機、塔樓、儲槽、煙囪、尖頂);以及通往據點的道路、電線、管道和圍欄;小徑、煙霧、夜晚的燈光、聲音;使用世界自身語言的標示。永遠不要依賴地圖圖示、世界標記或 HUD 提示。
  • 間距與路徑: 典型的次要據點相距 500-800 米,主要據點相距 1 公里或更遠;在通往綜合設施的路徑上,約 200-600 米外有兩到三個衛星據點(前哨站、檢查點、營地);在據點之間約 150 米以上的開闊地帶設置一道掩護線(圍欄、溝渠、牆壁、殘骸線);在每個大型據點外側 50-150 米處設置一條有掩護的繞行路線,使鄰近據點間的最短路徑永遠不會穿過核心區域。
  • 遠距辨識: 據點在 300 米、100 米和大門處的樣子:先是輪廓,然後是其功能,最後是其入口。

2. 視覺簡報(每個據點一份,位於 POI_BRIEFS)

欄位:ID、名稱、階級、類型、規模、入口方向、地形、建築計畫(每個建築的套件、角色、佔地面積、樓層數、高度)、主要元素、佈局描述(一段話)、其狀態與狀況,以及一條氛圍描述。根據簡報製作的概念圖是氛圍參考,而非規格書:它們絕不能添加、合併或移動建築物,且平面圖始終是唯一真理。在一個固定的光線、季節、地形等級和鏡頭語言下生成每個概念圖(一張來自入口方向的俯瞰圖、一張頂視圖、一張來自路徑的平視角視圖、主要元素的特寫)。

3. 先有地面和街道

先從街道開始佈局,然後放置建築物,接著是開放空間,最後是物件。

  • 地形整平: 地基和庭院是平坦的台地(典型橫向坡度 3% 或更小),由坡道(典型坡度 10% 或更小,帶有平台)和階梯連接;台地邊緣是擋土牆或坡度不陡於約 1:2 的植生護坡。台地之間至少有兩個連接點;絕不能只有一個有圍牆的坡道。沒有建築物建在未經整平的斜坡上;地形絕不能穿透硬質鋪面顯露出來。
  • 街道: 一個具有層級結構(從大門進來的主街道、次要街道、巷道、小巷)的連接網絡;每條行車道末端都連接到交叉口、大門或迴車道;世界道路終止於大門,絕不穿過據點內部;沒有道路穿過建築物或規劃的開放空間;建築物與車行道之間應保留人行道和退縮距離。切勿為了打破視線而彎曲道路。
  • 據點內部的濱水邊緣 應是人工構築的(碼頭牆、護岸、下水滑道);與海相連的水體應位於海平面高度。
  • 邊界圍牆需符合角色: 軍事基地使用城牆和塔樓,城鎮使用矮牆和樹籬,設施使用附有警衛室的安檢圍欄。所有據點使用相同的圍籬就是一個缺陷。大門看起來必須像大門,且位於比其框架更長的直線邊緣上。

4. 動線(起始 FLOW_RULES)

透過 building-layout-check 將據點平面圖作為空間圖進行分析(針對每棟建築),並在整個據點範圍內測量以下數值。數值為典型起點;請根據首批完成的據點進行校準。

入口與旋轉

  • 建築群的入口數為 3-5 個,綜合設施或城鎮為 4-8 個,最多約 8 個;分佈在至少 3 個面向上(前哨站或車站為 2 個);任何一個面向上的入口不得超過總數的一半。非正規入口(破口、涵管、攀爬點)帶有代價:噪音、需要蹲下、涉水。
  • 任何一個站立點最多只能看到一半的入口,或 60 米內不超過 2 個。
  • 最小分割(將核心區域與外界隔開所需的最少開口數):建築群或更大規模至少 3 個,小型據點至少 2 個;子區域之間至少 2 個。連接的區塊之間應有真實的接縫,而不是僅有兩個相接的角落。
  • 至少 3 條旋轉路線從大型據點出發,通往不同的鄰近據點和入口。

瓶頸、循環與死胡同

  • 玩家瓶頸寬 1.2-3 米,通道寬 4-8 米,大型生物路線寬度至少為 LARGE_AGENT_DIAMETER 的 1.5 倍(且其循環必須是完整的環路,不能是死路);每個瓶頸都應有一條繞行路線,其長度不超過直線路線的兩倍;進入核心區域的每條通道上最多一個瓶頸。
  • 整個據點內至少有 3 個獨立的循環路線,且任何面積超過約 400 平方米的建築物內部都應有一個循環路線。
  • 室外死胡同深度最多 15 米,且沒有超過 20 x 20 米的死角空間;室內死胡同深度最多一個房間。通道應連續:不能以空白牆壁或圍欄作為終點。

垂直空間與視線

  • 每個區域最多三個樓層平面。每個可到達的樓層、屋頂和制高點都應有兩條上去的路徑,相距約 15 米或在相對的面上;假設遊戲中存在能攀爬的敵人,他們可以到達屋頂。
  • 每個制高點都必須被標記和測量:至少從兩個不同通道提供反制角度,在 60-120 米外的另一個通道上有一個可與之匹敵的制高點,且沒有制高點能看到核心區域超過約 40% 的可步行地面。
  • 每 30-60 米應有一個視線阻斷;長直線視線(超過約 100 米)只能出現在一兩條有理由的軸線上(例如主要路徑、閱兵場、碼頭、跑道)。

掩護與戰鬥空間

  • 沿著每條路線,每 8-15 米應有掩護;在命名的開放區域中,任何一點距離高度 1.0 米或更高的掩護不得超過 15 米。低掩護高度 1.0-1.25 米,高掩護高度 1.75 米或更高;路線上的掩護約 60% 為低掩護;高掩護應放置在通道末端、門口和角落。掩護要符合其位置:廣場上使用街道家具,庭院中使用貨物。
  • 可進入的建築物應有兩個或更多在不同面上的門;核心建築則需要更多,其中一個為大型門。僅作為死胡同的房間應是刻意的戰利品房間。
  • 根據最大的敵人和隊伍規模來設計戰鬥空間:大型生物可以進入的庭院應有兩個大型出口;一個據點能容納從不同方向到來的兩支隊伍,而不會讓其中一支堵住另一支;當空無一人時,它仍能為單一玩家提供可讀性和獎勵。
  • 場景設置(例如倒塌的起重機、被破壞的金庫、擱淺的載具、被水淹沒的大廳)應位於通道上,有兩個出入口,並能從路徑上看見。
  • 命名的子區域應讓每個人一眼就能叫出名字(例如「儲油槽區」、「藍色倉庫」);在每個交叉口,應能不用回頭就看到前方的兩條路。

需要在審查中指出的失敗模式: 相吻角落、前門漏斗、護城河、死胡同庭院、單門盒子、階梯陷阱、上帝屋頂、管道、射擊場、猜謎地圖、斷頭路、唯一交叉點、魚缸、穿堂道路磁鐵、空白背面、邊緣戰利品、圍欄迷宮、生物死路、被俯瞰的鄰居、單一平面核心。每個評審發現都應命名其模式及修復方法。

5. 環境敘事

  • 展示其功能: 核心建築位於中心;每棟建築的角色應符合其位置(裝卸門面向庭院、警衛亭位於大門、燃料靠近載具);可見的服務設施(根據角色需要的電力、水源、燃料、廢棄物處理、通訊)。
  • 開放空間經過設計: 庭院、工作和儲物場、裝卸區、停車場、吸煙區、垃圾間、雨棚、發電機平台等,每個都應放在真實世界中應有的位置。一個讀起來擁擠不堪的據點,即使密度檢查通過了,也算失敗。
  • 這裡發生過什麼事: 每個庭院都應透過其物件講述一個小故事(例如中斷的卸貨、檢查站、正在進行的維修……)
  • 戰利品透過位置說話: 戰利品不應隨意放置;重要的戰利品應在可見的、有守衛的空間中,並透過環境線索(例如一個上鎖的籠子、一個秘密隔間)來提示。
  • 物件與載具: 僅使用 PROP_LIBRARY 和 VEHICLE_CLASSES 中核准的物件。物件的放置應遵守 PLACEMENT_RULES。

6. 組裝與完成

  • 從 KIT_CONTRACT 中選擇套件: 使用已驗證過的套件零件進行組裝。
  • 遵循 FINISH_SPEC: 根據規格應用表面處理(磨損、風化、植被)。
  • 完成度標準: 在 POI_RUBRIC 中定義,並由審查過程驗證。

7. 審查迴圈

  • 自我檢查: 在提交審查前,根據 POI_RUBRIC 進行自我檢查。
  • 盲測評審: 使用 CRITIC_MODEL 從 CRITIC_TARGET 的角度進行評審。評審應包含視角評審和空拍評審。
  • 所有者簽核: 所有者審查並蓋章批准。
  • 缺陷轉規則: 重複出現的缺陷應轉化為 FLOW_RULES 或 POI_RUBRIC 中的新規則,並記錄在 RULES_LEDGER 中。
  • 「合理嗎?」規則: 始終對規則和審查意見保持批判性思考。

8. 附錄

(此處可加入擴展的 FLOW_RULES、PLACEMENT_RULES、PROP_LIBRARY 實例、CRITIC_MODEL 提示詞範例等,取決於專案需求。)

Individual skills in this repo

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

building-layout-check

Check that a generated or hand-built building, interior or enclosed environment (houses, offices, bunkers, ships, temples, ruins, caves, compounds, stations) is structurally sensible and properly walkable - load paths, walls that start and end at something, doors that lead somewhere, stairs with landings and headroom, no orphan rooms, no walls dropped into openings, enough exits, shallow dead ends, loops and two ways up where people fight or flee. Engine- and genre-neutral; ships a space-graph checker script. Use when reviewing a building or layout an agent or generator produced, before accepting a prefab, or when writing layout rules for a kit.

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.

相關技能