Communitygithub.com

건축물 배치 검토

생성되거나 수동 제작된 건물, 인테리어 또는 밀폐 공간(주택, 사무실, 벙커, 선박, 사원, 폐허, 동굴, 복합 시설, 기지)이 구조적으로 타당하고 적절히 걸어 다닐 수 있는지 확인합니다. 하중 경로, 시작과 끝이 명확한 벽, 어딘가로 이어지는 문, 착륙 공간과 머리 공간이 있는 계단, 고립된 방, 개구부에 놓인 벽, 충분한 출구, 얕은 막다른 길, 루프, 전투나 도주 상황에서 두 개의 상행 경로 등을 검사합니다. 엔진 및 장르에 중립적이며, 공간 그래프 검사 스크립트를 제공합니다. 에이전트나 생성기가 제작한 건물이나 배치를 검토할 때, 프리팹을 승인하기 전에, 또는 키트용 배치 규칙을 작성할 때 사용하세요.

건축물 배치 검토란 무엇인가요?

이 스킬은 절차적 생성이나 AI 에이전트가 만든 건축물의 구조적, 기능적 타당성을 검증하는 자동화된 검토 시스템입니다. 공간 그래프 스크립트를 통한 1차 패스, 엔진 내 기하학적 프로브를 통한 2차 패스, 그리고 사람이나 비평 에이전트의 시점 검토를 통한 3차 패스로 구성되어 있어 설계 결함을 조기에 발견합니다. 현대 건축 규정뿐만 아니라 판타지, SF, 유적 등 다양한 세계관에 맞춰 조건을 설정할 수 있는 '월드 브리프(world brief)' 개념을 지원하므로, 어떤 장르와 스타일의 건축물에도 적용 가능합니다. Claude Code, Cursor, Codex 등 AI 코딩 에이전트와 함께 사용하도록 설계되었으며, JSON 형식의 공간 그래프를 입력받아 분석합니다. 주 개발 도구로 Python 3 스크립트(`scripts/layout_check.py`)를 제공하며, 각 프로젝트의 설정 파일과 함께 실행하여 출구 수, 막다른 길 깊이, 복도 폭, 계단 규격 등 20여 가지 규칙을 검증합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TayHD/game-agent-skills/tree/HEAD/skills/building-layout-check

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

건축물 배치 검토은(는) 무엇을 하나요?

모듈식 키트를 사용하면 격자가 허용하는 어디든 쉽게 벽을 배치할 수 있으며, 생성기와 에이전트는 정확히 그렇게 할 것입니다. 방 한가운데서 끝나거나 창문을 가로지르는 벽, 빈 벽이나 낙하 지점을 향해 열리는 문, 아무도 도달할 수 없는 방, 벽을 향해 도착하는 계단, 단일 문 상자와 분기되지 않는 복도 등이 발생할 수 있습니다. 이 스킬은 이러한 문제를 잡아내는 검사입니다. 마감이나 재료가 아닌 배치와 구조를 판단합니다.

이 검사는 모든 설정, 시대 및 아트 스타일에서 작동합니다. 왜냐하면 세계 고유의 논리(아래에 한 번 작성된 월드 브리프)에 따라 모든 공간을 평가하기 때문입니다. 석조 성채는 석공이 짓고 수비대가 생활하는 방식으로, 우주선은 승무원이 이동하고 선체가 운반하는 방식으로, 동굴은 물이 깎고 주민이 사용하는 방식으로, 만화 마을은 그 스타일이 정한 규칙으로 평가합니다. 현대 건축 규정은 프로젝트가 아무것도 명시하지 않을 때만 대체로 사용됩니다.

세 번의 패스로 구성되며, 각 패스는 다음 패스보다 저렴합니다: 공간 그래프(스크립트, 수 초 소요), 기하학적 프로브(엔진 또는 모델링 도구, 수 분 소요), 시점 높이 검토(사람 또는 새로운 비평 에이전트). 어떤 패스에서도 차단 항목이 없을 때 건축물은 통과합니다.

월드 브리프 (첫 번째 검사 전에 작성)

프로젝트 환경 문서의 짧은 섹션(약 반 페이지)으로, 모든 검사와 모든 검토자가 읽습니다. 이것이 없으면 검토자는 자신의 시대와 스타일을 기준으로 삼아 잘못된 항목을 지적하게 됩니다.

  1. 설정과 시대: 언제 어디서 (예: "중세 후기 강변 마을", "2300년대 궤도 광산 기지", "1970년대 교외 홍수 폐허", "버섯족 굴")
  2. 누가, 무엇으로 지었는가: 건축자의 기술과 재료, 그리고 그것이 허용하는 것: 스팬(목재 4~6m, 석재 볼트, 철제 트러스, 성장한 산호), 벽 두께, 바닥 하중 지지 방식, 수직 이동 방식(계단, 사다리, 경사로, 엘리베이터, 등반, 비행, 순간이동 패드)
  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보다 가까운 출구는 하나로 계산. 플레이어가 통과할 수 있는 창문은 0.5개로 계산. 외부로의 단방향 낙하는 탈출구로, 나열되지만 계산되지 않음.

바닥 면적explorecontested
100 m² 미만12, 2개 면에
100 ~ 400 m²2, 2개 면에3, 최소 2개 면에
400 m² 초과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로). 알려진 경우 명확한 너비와 머리 공간, 외부로의 링크에는 face와 x, y, 문의 레벨 변경에는 step, 계단에는 riser, tread, risers 및 spiral을 부여합니다. 각 계단 비행을 연결하는 공간 사이의 계단 링크로 모델링. 두 층 사이의 비드롭 링크는 수직 경로로 계산.

보고서, accepted 및 RULES_OFF에서 사용되는 규칙 ID: 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² 이상이거나 2개 이상의 공간 깊이인 경우 최소 하나의 내부 루프.
  • 깔때기 (funnel): 외부에서 앵커 또는 표시된 앵커가 없는 경우 가장 깊은 방까지의 분리된 경로(공간 공유 없음). 하나의 경로는 (C)에서 100 m² 초과 시 BLOCKER, 400 m² 초과 시 FINDING.
  • 수직 경로 (vertical): 각 층에서 입구 층으로 향하는 경로(위 또는 아래). 200 m² 초과 층 또는 (C)에서 100 m² 초과 층에서 최소 VERTICAL_SPACING만큼 떨어진 두 개의 경로.
  • 크기 및 레벨 (door_width, corridor_width, large_width, headroom, small, step): 링크 종류별 너비와 머리 공간, 플레이어보다 좁은 공간, 계단이 없는 단차.
  • 계단 (stair): riser, tread, 보폭 및 비행 길이; 한 건물 내 혼합 riser.
  • 가장자리 (guard): GUARD_DROP을 초과하는 보호되지 않은 낙하.
  • 튜브 및 개구부 (tube, openings): TUBE_LENGTH를 초과하고 분기가 없는 복도; (C) 너무 많은 개구부가 있는 방.

패스 2: 기하학적 프로브 (엔진 또는 모델링 도구)

그래프는 기하학을 볼 수 없습니다. 조립된 건물에 대해 프로젝트 자체 도구로 다음을 실행합니다. 각각은 스크린샷이 아닌 숫자 또는 목록을 생성해야 합니다.

프로브측정실패 조건
걷기 홍수플레이어 크기의 캡슐이 중력을 적용하여 모든 외부 문에서 걷기(네비게이션 메시 빌드 허용).그래프가 도달 가능하다고 말하는 공간에 도달할 수 없거나, 그래프에 없는 곳(틈, 벽 상단, 경로 없는 지붕)에 도달함.
지지모든 바닥, 지붕, 계단, 빔 및 상부 벽에 대해: 그 발자국 아래 요소.어떤 것이 아무것도 위에 있지 않음(1 cm 이상의 공기), 기둥이나 벽이 그 아래에 빔이나 벽이 없는 바닥 스팬 위에 내려앉음, 또는 캔틸레버가 뒷 스팬의 약 1/3을 초과하고 눈에 보이는 브래킷이나 지지대가 없음.
벽 끝모든 벽과 칸막이의 각 끝.끝이 아무것도 닿지 않음(완성된 자유 끝이 아닌 경우), 문이나 창문 개구부 안에 내려앉음, 또는 벽에서 플레이어 너비보다 짧은 거리에서 멈춤.
개구부각 문 양쪽의 바닥 높이, 각 창문을 통과하는 광선.문이 벽, 낙하, 밀봉된 공허 또는 STEP_HEIGHT보다 큰 단차를 향해 열림; 창문이 1 m 이내에서 벽, 바닥 슬래브, 계단 또는 높은 기둥에 의해 막힘; 바닥이나 내부 벽이 외관의 창문을 가로지름.
클리어런스각 경로를 따라 스윕 캡슐, 문 회전 영역, 계단 착륙장.머리 공간이나 너비가 설정 미만으로 떨어짐; 소품, 기둥 또는 칸막이가 문 경로, 착륙장 또는 복도의 명확한 너비 내에 있음.
가장자리모든 걸을 수 있는 가장자리와 그 낙하.GUARD_DROP을 초과하는 낙하에 보호 장치가 없고 의도적으로 표시되지 않음.
겹침벽 속 벽, 벽 속 바닥, 소품 속 벽 교차점.플레이어가 볼 수 있는 수 밀리미터 이상의 교차점.

패스 3: 시점 높이 검토

새로운 검토자(빌드를 보지 않은 사람 또는 비평 에이전트)가 시점 높이에서 걸으며 각 층의 평면도와 단면도를 봅니다. 월드 브리프, 건물의 목적("2가구 농가", "침수된 연구 벙커", "붕괴된 사원", "화물 운반선의 승무원 데크") 및 수락 조건(의도적 막다른 길, 잠긴 문, 붕괴된 구역, 기어가기 공간)이 주어지며 다음 질문에 답합니다:

  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.

관련 스킬