Communitygithub.com

poi-design

设计、构建、评审并发布开放世界游戏中任何设定、时期、风格或类型的兴趣点(化合物、城镇、设施、车站、残骸、营地、废墟、洞穴)。

poi-design 是什么?

该技能定义了一套完整的兴趣点设计方法,确保每个站点在游戏中既像真实存在的场所,又具有可玩性。它涵盖从站点在世界的定位、视觉概要、布局与流程、环境叙事、战利品放置,到最终评审和迭代的全过程。技能强调“目的优先”和“有意义”原则,避免为满足规则而做出不合理的设计。它适用于任何游戏引擎和DCC工具,并配套提供了详细的配置项、可量化的流程规则和失败模式命名框架,帮助团队高效协作并持续改进。技能特别注重玩家无需标记即可通过地形、地标和道路发现站点,以及为不同体型敌人和玩家数量优化战斗空间。

兼容平台~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倍(其环路必须是环路,绝不能是死胡同);每个咽喉点都有一个不超过其直线路径两倍的绕行路线;每通往核心的通道最多一个咽喉点。
  • 整个站点至少有三个独立的环路,并且任何面积超过约400平方米的建筑内部都有一个环路。
  • 室外死胡同深度最多15米,且没有超过20x20米的空间;室内则只有一个房间的深度。通道连续:不能以空白墙壁或围栏结束。

垂直空间和视线

  • 每个区域最多三个楼层面。每个可到达的楼层、屋顶和栖息点都有两种上法,相距约15米或在相反的面;假设如果游戏中有攀爬敌人,它们可以到达屋顶。
  • 每个有利位置都被声明和测量:至少两个来自不同通道的反向角度,一个在60-120米外另一通道上的可比有利位置,并且没有能看见核心区域超过约40%可步行地面的有利位置。
  • 每30-60米有一个视线断裂点;长直线开阔线(超过约100米)只允许在一两个声明的轴线上,且需有理由(主入口道路、阅兵场、码头、跑道)。

掩体和战斗空间

  • 沿着每条路线每8-15米有一个掩体;在命名的开放区域内没有任何点距离1.0米或更高的掩体超过15米。低掩体1.0-1.25米,高掩体1.75米或更高;约60%的路线掩体为低掩体;高掩体位于通道末端、门口和角落。掩体适合其位置:广场上的街道设施,院子里的货物。
  • 可进入的建筑在不同面有两个或多个门;锚点建筑更多,其中一个是大门。死路房间仅用于有意的战利品房间。
  • 根据最大敌人和队伍数量调整战斗空间大小:大型生物可以进入的院子有两个大型出口;一个站点能容纳从不同方向到达的两个队伍,而不会让一个队伍伏击另一个;当空无一人时,它仍然对单个玩家具有可读性和奖励。
  • 场景设置(倒塌的起重机、被破坏的金库、搁浅的车辆、被淹没的大厅)应位于通道上,有两个出入口,并且能从接近路线上看到。
  • 命名的子区域每个人都能一眼认出(“储油罐区”、“蓝色仓库”);每个交叉路口,无需转身就能看到前方两个方向的出路。

需要在评审中命名的失败模式: 亲吻角落、前门漏斗、护城河、死胡同院子、单门盒子、楼梯陷阱、上帝屋顶、管子、射击场、猜地图、残肢通道、唯一交叉口、鱼缸、过路磁铁、空白背面、边缘战利品、围栏迷宫、生物死胡同、被俯瞰的邻居、单平面锚点。每个评审者的发现应命名其模式和修复方法。

5. 环境叙事

  • 展示功能: 核心处的锚点;每栋建筑的角色与其位置相匹配(院子里的装卸门、大门处的岗亭、车辆旁的燃料);可见的服务设施(根据角色需要的水电、燃料、废物、通讯)。
  • 开放空间经过设计: 庭院、工作和存储场、装卸区、停车场、吸烟棚、垃圾围栏、雨棚、发电机基座,每个都放在真实场所应该放置的位置。一个显得拥挤的站点即使密度行通过了也算失败。
  • 这里发生了什么: 每个院子用其道具讲述一个小故事(中断的卸货、一个检查点、一次修复)。
  • 穿过和穿过: 玩家可以沿着一条反映空间使用的路径穿过主要院子;消防通道是真实的;屋顶和夹层有用途。
  • 叙事分层: 第一眼(功能),检查(谁在这里以及为什么),探索(发生了什么以及为什么它处于这种状态),秘密(一个只有最细心的人才能找到的故事片段)。
  • 道具放置(PLACEMENT_RULES): 通过目的定义的区域(工作、存储、循环、生活、安全)。道具锚定在其表面:地面上(基座、支架、轮挡),墙上(架子、挂钩、电缆桥架),天花板上(灯、起重机、管道)。同样的区域在多个站点中不使用相同的道具组合。
  • 车辆和驾驶员: 已编录的车辆类别;每辆车都有角色、路径和目的。车辆服务于站点,而不是填充它。驾驶员道具(钥匙、日志、货物清单)存在于控制点。

6. 组装

遵循modular-environment-kit-production的套件合约和工作流程。

  • 套件部件优先: 站点从已通过的套件部件组装而成;一个新部件只有在至少一个站点需要它并且该部件通过modular-environment-kit-production时才会被制作。
  • 通过部件列表: 来自CORE_LIBRARY。站点使用核心库部件加上其等级组部件。
  • 部件放置: 部件被放置(在引擎中或DCC中),从未在引擎中被逐样建模。连接点是套件接口;部件之间的间隙是设计意图或套件缺失;前者已解决,后者已报告。
  • 建材源: 每个部件都记录其源文件(DCC文件、纹理、材质)、部件ID以及在该站点中的使用位置。
  • 完成度规格(FINISH_SPEC): 定义了三种完成度:ready(准备好发布,通过modular-environment-kit-production),rough(空间占位,用于流程测试),kitbash(连接到不同套件的部件,用于测试新的连接)。站点发布时,每个部件都必须为ready状态,除非POI_BRIEF使用rough或kitbash部件来满足流程要求。

工作流程:

  1. 根据概要选择套件和部件。
  2. 布局地形和街道(第3节)。
  3. 放置建筑结构。
  4. 添加开放空间和道具(第5节)。
  5. 根据流程规则(第4节)进行评审。
  6. 迭代直到所有P0项被清除。
  7. 进行rough完成度评估。
  8. 进行kitbash评估(如果相关)。
  9. 进行ready评估。
  10. 由主设计师盖章。
  11. 记录从故障中产生的任何新规则。

7. 完成度评估

完成度来自FINISH_SPEC并为每个站点调整。

  • rough评估: 空间布局、流程、入口、环路、咽喉点、掩体、视线、垂直空间。所有P0项必须清除才能发布。
  • kitbash评估: 如果站点使用kitbash部件,评估连接点的稳定性、网格穿透和材质匹配。所有P0项必须清除。
  • ready评估: 最终完成度:所有部件均为ready,所有道具均已放置,所有纹理均已烘焙,所有碰撞均已设置。站点必须通过所有rough和kitbash评估,并且所有P0项必须清除。

评审过程: 在CRITIC_TARGET游戏中查看实时场景,并在定义的CAMERA_RANGE内拍摄截图。评审者使用CRITIC_MODEL回答从POI_RUBRIC生成的问题。所有P0项必须清除。P1项由主设计师酌情决定。

8. 迭代和修复

故障到规则: 如果评审者发现一个故障(一个重复出现的问题),它会变成一个规则。该规则被添加至RULES_LEDGER并带有时间和原因。除非有例外,否则所有未来的站点都必须遵循该规则。

“有意义”检查: 对于每个元素(建筑、道具、路线),问:这有意义吗?如果感觉不对,即使它通过了所有检查,也要审查它。如果一条规则使这个站点更糟,请向主设计师申请例外。

9. 利益相关者评审

主设计师: 主设计师检查布局、流程和叙事。他们检查是否遵循了原则。他们可以请求更改。 所有者: 所有者(世界设计负责人)检查站点是否符合WORLD_BRIEF以及世界观。他们可以标记站点为已批准或请求更改。 评审小组: 由CRITIC_TARGET游戏的玩家组成。他们测试流程、掩体和奖励。他们提供反馈以实现迭代。

10. 发布

当以下条件满足时,站点可以发布:

  • 所有P0项被清除。
  • 主设计师盖章。
  • 所有者已批准。
  • 站点已通过评审小组测试。
  • 所有新规则已记录至RULES_LEDGER。

站点被记录在WORLD_PLAN中,并标记为已发布。

故障排除

  • 布局不稳定: 如果流程在视觉通道中不稳定,请审查入口、咽喉点和环路。确保所有建筑物都已放置并且所有路线都已连接。
  • 站点看起来不真实: 检查WORLD_BRIEF,确保叙事元素存在并且堆叠正确。确保道具服务于叙事而不仅仅是填满空间。
  • 站点被玩家跳过: 检查奖励是否值得风险,并且站点可以被发现。确保提供了清晰的导航线索。
  • 站点过于拥挤或空旷: 检查密度行,并根据需要调整开放空间。
  • 规则冲突: 如果一条规则与另一条冲突,请向主设计师申请例外。记录原因。

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.

相关技能