Communitygithub.com

建物レイアウトチェック

生成または手作業で作られた建物、内装、密閉環境(家、オフィス、バンカー、船、寺院、遺跡、洞窟、複合施設、駅など)が構造的に妥当で、適切に歩行可能かどうかをチェックします。動線パス、壁の始端と終端、ドアの接続先、階段の踊り場と頭上の高さ、孤立した部屋の有無、開口部を塞ぐ壁、十分な出口、短い袋小路、ループ構造、戦闘や逃亡時の複数の垂直経路などを評価します。エンジンやジャンルに依存せず、スペースグラフチェッカースクリプトが付属します。エージェントやジェネレーターが生成した建物やレイアウトをレビューする際、プレハブを受け入れる前、またはキット用のレイアウトルールを作成する際に使用します。

建物レイアウトチェック とは?

このスキルは、ゲームやシミュレーション環境における建物やレイアウトの構造的妥当性と歩行可能性を評価するためのものです。特に、AIエージェントやプロシージャル生成によって作成された結果をレビューするために設計されています。スキルは3つのパスで構成されています。最初のパスはスペースグラフスクリプトで、JSON形式の空間とリンクのグラフを解析し、到達可能性、出口数、行き止まり、ループ、漏斗構造、垂直経路、寸法、階段などのルールをチェックします。2番目のパスは幾何学的プローブで、ゲームエンジンやモデリングツール内でウォークフラッド、サポート、壁の端、開口部、クリアランス、エッジ、オーバーラップを検証します。3番目のパスは目線高さレビューで、人間または別のAIエージェントが建物を実際の視点で歩き、壁や部屋の目的、空間の連続性、照明、音響などを評価します。このスキルは、ワールドブリーフ(設定や様式のルールを記述した文書)に基づいて評価を行い、現実世界の建築基準だけでなく、ファンタジーやSF、崩壊した遺跡などあらゆる設定に対応します。Claude Code、Cursor、CodexなどのAIエージェントと連携し、生成結果の品質を自動的に保証するために使用されます。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

建物レイアウトチェック は何をしますか?

モジュラーキットを使うと、グリッド上のどこにでも壁を簡単に配置できます。そして、ジェネレーターやエージェントはまさにそれを実行します。部屋の真ん中で終わったり窓を横切る壁、空白の壁や落下地点に面して開くドア、誰も到達できない部屋、壁に向かって到着する階段、一つのドアしかない箱、決して分岐しない廊下などです。このスキルは、それらをキャッチするチェックです。仕上げや素材ではなく、レイアウトと構造を判断します。

あらゆる設定、時代、アートスタイルで機能します。なぜなら、すべての空間を世界独自の論理で判断するからです。その論理はワールドブリーフ(後述)に一度だけ書き留められます。石造りの砦は石工の建築方法と守備隊の生活様式に基づき、宇宙船は乗組員の動き方と船体の構造に基づき、洞窟は水の侵食と住人の利用方法に基づき、漫画の村はそのスタイルが定めるルールに基づいて判断されます。現代の建築基準は、プロジェクトが何も指定していない場合のフォールバックに過ぎません。

3つのパスを順に実行します。それぞれが次のパスよりも低コストだからです。スペースグラフ(スクリプト、数秒)、幾何学的プローブ(エンジンまたはモデリングツール内、数分)、目線高さレビュー(人間または新しい批評家エージェント)。どのパスにもブロッカーが残っていなければ、建物は合格です。

ワールドブリーフ(最初のチェック前に作成)

プロジェクトの環境ドキュメント内の短いセクション(半ページ程度)で、すべてのチェックとすべてのレビュー担当者が読みます。これがないと、レビュー担当者は自分自身の時代やスタイルに頼ってしまい、間違った点を指摘することになります。

  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歩幅のルール:蹴上の2倍と踏面の合計。時代を問わず有効で、踏面に対して急な階段を検出する。螺旋階段には適用されない。スクリプト
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一つの面でこれより近い出口は1つとしてカウント。2つの垂直ルートは少なくともこれだけ離れている必要がある。スクリプト
MAX_ROOM_OPENINGS4(C) 一つの部屋または部屋への最大開口部数。スクリプト
MIN_SPACE_AREA1.0最小の使用可能なスペース。スクリプト
GUARD_HEIGHT1.00 から 1.10手すりが必要な場合のその高さ。プローブ
LAYOUT_SOURCEプロジェクトのレイアウトデータ計画の出所:レシピやマニフェスト、レベルエクスポート、手描きの計画。パス1への入力

床面積あたりの出口(すべての歩行可能な内部階を合計)。同じ面でEXIT_SPACINGより近い出口は1つとしてカウント。プレイヤーが通り抜けられる窓は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、階段の場合は蹴上、踏面、段数、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 m²以上、または2スペース以上の深さの場合、少なくとも一つの内部ループ。
  • 漏斗(funnel):外部からアンカーまで、またはアンカーがマークされていない場合は最も深い部屋までの別々のルート(スペースを共有しない)。一つのルートは、(C)で100 m²超の場合はブロッカー、400 m²超の場合はフィンディング。
  • 垂直ルート(vertical):各階から入口階へのルート(上または下)。200 m²以上の階、または(C)で100 m²以上の階では、少なくともVERTICAL_SPACING離れた2つのルートが必要。
  • サイズとレベル(door_width、corridor_width、large_width、headroom、small、step):リンクの種類による幅と頭上空間、プレイヤーより狭いスペース、階段のない段差。
  • 階段(stair):蹴上、踏面、歩幅、フライトの長さ。一つの建物内での蹴上混合。
  • エッジ(guard):GUARD_DROPを超える無防備な落下。
  • チューブと開口部(tube、openings):TUBE_LENGTHを超え、分岐のない廊下。(C)開口部が多すぎる部屋。

パス2:幾何学的プローブ(エンジンまたはモデリングツール内)

グラフはジオメトリを見ることができません。これらをプロジェクト独自のツールで組み立てられた建物に対して実行します。各プローブは数値またはリストを生成する必要があり、スクリーンショットではありません。

プローブ測定内容失敗条件
歩行洪水プレイヤーサイズのカプセルが、重力に従ってすべての外部ドアから歩く(壁はソリッドとして扱う。ナビゲーションメッシュの構築でも可)。グラフが到達可能と呼ぶスペースに到達できない、または歩行がグラフにない場所(隙間、壁の上、ルートのない屋根)に到達する。
サポートすべての床、屋根、階段、梁、上部の壁について:そのフットプリント内の下の要素。何もないところに載っている(1 cm以上の隙間)、柱や壁の上端が下に梁や壁のない床スパンに着地している、片持ち梁が後方スパンの約3分の1を超え、目に見えるブラケットや支柱がない。
壁の端すべての壁と仕切りの各端。端が何にも接していない(完成した自由端ではない)、ドアや窓の開口部の内側に着地している、またはプレイヤーの幅よりも短い距離で壁の手前で止まっている。
開口部各ドアの両側の床の高さ、各窓を通る光線。ドアが壁、落下、密閉された虚空、またはSTEP_HEIGHTより高い段差に面して開く。窓の背後1m以内に壁、床スラブ、階段、または高い支柱によって塞がれている。床または内壁がファサードの窓を横切っている。
クリアランス各ルートに沿った掃引カプセル、ドアのスイングエリア、階段の踊り場。設定値未満の頭上空間または幅がある。支柱、柱、仕切りがドアの経路、踊り場、または廊下のクリア幅内に立っている。
エッジすべての歩行可能なエッジとその落下。GUARD_DROPを超える落下に手すりがなく、意図的とマークされていない。
オーバーラップ壁と壁、壁と床、支柱と壁の交差部分。プレイヤーが見える数ミリを超える交差。

パス3:目線高さレビュー

新しいレビュー担当者(ビルドを見たことがない人間または批評家エージェント)が、目線の高さで歩き、各階の平面図と断面図を見ます。彼らにはワールドブリーフ、建物の目的(「二家族用の農家」「浸水した研究バンカー」「崩壊した寺院」「貨物運搬船の乗組員デッキ」)、および受入条件(意図的な行き止まり、施錠されたドア、崩壊したセクション、這うスペース)が与えられ、以下の質問に答えます:

  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.

関連スキル