Communitygithub.com

vérification-agencement-bâtiments

Vérifie qu'un bâtiment, un intérieur ou un environnement fermé généré ou construit à la main est structurellement cohérent et correctement praticable.

Qu'est-ce que vérification-agencement-bâtiments ?

Cette compétence permet de valider la structure et la circulation dans tout type d'espace fermé (maisons, bureaux, bunkers, vaisseaux, temples, ruines, grottes, complexes, stations) généré par un agent ou construit manuellement. Elle agit comme un inspecteur impartial, indépendant du moteur de jeu ou du genre. Le processus se déroule en trois passes : d'abord un script d'analyse du graphe spatial (rapide, en secondes), puis des sondes géométriques dans l'outil de modélisation ou le moteur (quelques minutes), et enfin une revue à hauteur d'œil par un humain ou un agent critique. Elle utilise un 'brief monde' pour adapter les règles au contexte (époque, matériaux, style, usage). Idéale pour relire une production d'agent avant d'accepter un prefab, ou pour écrire des règles d'agencement pour un kit.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Vérification d'agencement de bâtiments

Les kits modulaires permettent de placer un mur n'importe où sur la grille, et les générateurs et agents font exactement cela : des murs qui se terminent au milieu d'une pièce ou traversent une fenêtre, des portes qui s'ouvrent sur un mur ou un vide, des pièces inaccessibles, des escaliers qui arrivent face à un mur, des boîtes à une seule porte et des couloirs qui ne bifurquent jamais. Cette compétence est la vérification qui les rattrape. Elle juge l'agencement et la structure, pas la finition ni les matériaux.

Elle fonctionne pour tout cadre, époque et style artistique, car elle juge chaque espace selon la logique propre du monde, écrite une fois dans un brief monde (ci-dessous) : un donjon en pierre selon la façon dont les maçons construisent et dont une garnison vit, un vaisseau spatial selon la façon dont son équipage se déplace et ce que sa coque transporte, une grotte selon la façon dont l'eau l'a creusée et dont ses habitants l'utilisent, un village de dessin animé selon les règles de son style. Les codes de construction modernes ne sont que le recours par défaut lorsqu'un projet ne dit rien.

Trois passes, dans l'ordre, car chacune est moins coûteuse que la suivante : le graphe spatial (un script, quelques secondes), les sondes géométriques (dans le moteur ou l'outil de modélisation, quelques minutes), et la revue à hauteur d'œil (une personne ou un agent critique frais). Un bâtiment est validé lorsqu'aucun blocage ne subsiste dans aucune passe.

Le brief monde (à écrire avant la première vérification)

Une courte section dans la documentation d'environnement du projet, environ une demi-page, que chaque vérificateur et chaque relecteur lit. Sans cela, les relecteurs se rabattent sur leur propre époque et style et signalent les mauvaises choses.

  1. Cadre et période : où et quand (par exemple « ville fluviale médiévale tardive », « station minière orbitale, années 2300 », « ruines d'une banlieue des années 1970 après une inondation », « terriers de champignons anthropomorphes »).
  2. Qui l'a construit, avec quoi : la technologie et les matériaux des constructeurs, et ce que cela permet : portées (bois de 4 à 6 m, voûtes en pierre, fermes en acier, corail cultivé), épaisseur des murs, comment les planchers sont soutenus, comment le déplacement vertical fonctionne (escaliers, échelles, rampes, ascenseurs, escalade, vol, téléporteurs).
  3. À quoi il sert, et ce qui lui est arrivé : son objectif d'origine, son utilisation actuelle (habité, abandonné, occupé par quelqu'un d'autre, en ruine) et les événements qui l'ont changé (siège, inondation, effondrement, végétation envahissante). Les dégâts doivent avoir une cause dans ce monde.
  4. Les règles du style artistique : réaliste, stylisé, exagéré, low-poly ou jouet, et ce qu'il fait aux proportions (portes surdimensionnées, murs trapus, verticales bancales) et aux détails. Un monde stylisé peut délibérément tordre les proportions réelles ; le brief indique jusqu'où.
  5. Qui s'y déplace : la taille du joueur et ses déplacements (marche, accroupi, rampement, escalade, saut, nage, vol), les compagnons, créatures et véhicules qui doivent passer, et si les espaces sont explorés, construits, combattus ou traversés en fuite (cela définit PROFILE).
  6. Exceptions délibérées : ce que ce monde fait qu'un bâtiment moderne ne ferait pas, pour que les relecteurs l'acceptent (créneaux non gardés, échelles au lieu d'escaliers, fortifications à une seule entrée, huttes sans porte, escaliers en colimaçon avec des marches raides, pièces accessibles uniquement par escalade).

Les règles ci-dessous qui disent « sensé », « un constructeur », « un concepteur » ou « une raison » signifient : sensé pour les constructeurs, l'objectif et le style de ce brief.

Paramètres fournis par le projet

Chaque paramètre a une valeur par défaut pour un joueur à échelle humaine, en mètres, avec des proportions modernes. Un projet avec d'autres proportions ou une autre période (une petite créature, un géant, un véhicule, des escaliers médiévaux raides, une unité différente) définit les nombres à partir de son brief monde, pas de la méthode. Dans le script, les paramètres proviennent de l'objet "settings" du graphe, puis de --profile et --site, puis de --set NAME=VALUE (le dernier gagne) ; un nom inconnu est une erreur, donc une faute de frappe ne passe jamais silencieusement.

Type de site et règles désactivées. Certaines règles proviennent de la façon dont les bâtiments sont conçus pour les personnes (sorties par surface au sol, boucles intérieures, pas d'entonnoir unique, part des pièces sans issue, couloirs qui bifurquent). Une grotte, une ruine ou un espace naturel ne les doit pas pour l'exploration, donc avec SITE natural ou ruin et PROFILE explore elles sont signalées comme des notes ; dans contested elles s'appliquent partout, car les combats et les poursuites en ont besoin où qu'ils se produisent. Toute règle peut également être désactivée par le brief monde avec RULES_OFF (par exemple une forteresse avec une seule porte par conception : RULES_OFF=exits,funnel), ou acceptée pour un espace dans la liste accepted du graphe.

ParamètreDéfautSignificationUtilisé par
WORLD_BRIEFaucun (moderne, réaliste, échelle humaine supposée, et le rapport doit le dire)La demi-page ci-dessus.Toutes les passes
PROFILEexploreexplore (exploration, histoire, construction, survie sans combats intérieurs) ou contested (les joueurs combattent, poursuivent ou fuient ici). contested active les règles marquées (C).Script
SITEbuildingbuilding, vessel (vaisseaux, stations, véhicules : traités comme un bâtiment), natural (grottes, canyons, bosquets, glace, récifs) ou ruin.Script
RULES_OFFaucunListe séparée par des virgules des identifiants de règles signalées comme notes uniquement.Script
PLAYER_RADIUS0.40La moitié de la largeur de la capsule de marche.Script
CROUCH_HEIGHT1.10Hauteur libre nécessaire dans les espaces de reptation, passages étroits, nages, échelles, escalades, trappes et fenêtres.Script
MIN_HEADROOM2.10Hauteur libre au-dessus de toute surface praticable qui n'est pas un espace de reptation.Script
MIN_DOOR_WIDTH0.90Largeur libre d'une porte, ouverture, escalier, rampe ou ascenseur.Script
MIN_CORRIDOR_WIDTH1.20Largeur libre d'un couloir ou passage.Script
MIN_SPIRAL_WIDTH0.70Largeur libre d'un escalier marqué "spiral": true.Script
MIN_CLIMB_WIDTH0.60Largeur libre d'une échelle, escalade, trappe ou nage.Script
LARGE_AGENT_DIAMETER0 (aucun)Diamètre de la plus grande créature ou véhicule qui doit passer ; les routes marquées large_route sont au moins 1,5 fois plus larges.Script
STAIR_RISER_MIN, STAIR_RISER_MAX0.10, 0.20Plage de hauteur de marche. Un monde médiéval ou exigü augmente le maximum.Script
STAIR_TREAD_MIN, STAIR_TREAD_MAX0.22, 0.40Plage de giron.Script
STAIR_PACE_MIN, STAIR_PACE_MAX0.55, 0.70La règle de foulée : deux fois la hauteur de marche plus le giron. Elle tient à travers les périodes et détecte les escaliers raides pour leur giron. Non appliquée aux colimaçons.Script
MAX_RISERS_PER_FLIGHT16Un palier au moins aussi souvent (non appliqué aux colimaçons).Script
STEP_HEIGHT0.45La plus haute marche que le personnage escalade sans escalier ; une porte ou ouverture avec un step plus grand est un blocage.Script
GUARD_DROP1.00Un espace praticable avec un edge_drop supérieur à cela nécessite "guarded": true (rambarde, parapet, mur, ou quoi que ce soit que ce monde utilise), ou une condition acceptée disant que le vide est délibéré et se lit comme tel.Script, sonde
TUBE_LENGTH15Couloir ou passage le plus long sans embranchement.Script
DEAD_END_DEPTHexplore 20, contested 10Impasse la plus profonde à partir de sa dernière jonction, en mètres.Script
EXIT_SPACING, VERTICAL_SPACING10, 15Les sorties plus proches que cela sur une même face comptent une fois ; deux routes verticales doivent être au moins aussi éloignées.Script
MAX_ROOM_OPENINGS4(C) Nombre maximal d'ouvertures dans une pièce ou salle.Script
MIN_SPACE_AREA1.0Plus petit espace utilisable.Script
GUARD_HEIGHT1.00 à 1.10Hauteur d'une protection là où elle est nécessaire.Sonde
LAYOUT_SOURCEles données d'agencement du projetD'où vient le plan : une recette ou un manifeste, un export de niveau, ou un plan dessiné à la main.Entrée de la passe 1

Sorties par surface au sol (tous les étages intérieurs praticables ensemble). Les sorties plus proches que EXIT_SPACING sur la même face comptent une fois ; une fenêtre par laquelle un joueur peut grimper compte pour moitié ; une chute à sens unique vers l'extérieur est une échappatoire, listée mais non comptée.

Surface au solexplorecontested
Moins de 100 m²12, sur 2 faces
100 à 400 m²2, sur 2 faces3, sur au moins 2 faces
Plus de 400 m²3, sur au moins 2 faces4, sur au moins 3 faces

Passe 1 : le graphe spatial (script)

Décrivez le lieu comme des espaces et des liens en JSON (format et tous les champs dans templates/space_graph.example.json) et exécutez :

python3 -I scripts/layout_check.py <graph.json> [--profile explore|contested] [--site building|natural|ruin|vessel] [--set NAME=VALUE ...] [--json out.json]
  • Un espace est un endroit où un joueur peut se tenir et qui se lit comme un seul lieu. Types : exterior (le monde extérieur, exactement un), room, chamber (pièces naturelles ou irrégulières), corridor, passage (couloirs naturels), landing, stair (une cage d'escalier), roof, deck, yard, void (scellé). Les pièces, chambres, couloirs, passages, paliers, toits et ponts comptent pour les impasses ; les pièces et chambres comptent pour les ouvertures et la part d'impasses. Donnez à chacun un identifiant, un étage, une surface, et si possible : position (x, y), longueur et largeur (couloirs et passages), hauteur libre, edge_drop et guarded, crawl, anchor (l'espace principal), sealed.
  • Un lien est tout passage entre deux espaces. Types : door, opening, stair, ramp, lift, ladder, hatch, climb, swim, squeeze (passage en rampant), window (une fenêtre par laquelle un joueur grimpe) et drop (à sens unique, de a vers b). Donnez-lui sa largeur libre et sa hauteur libre si connues, face et x, y pour les liens vers l'extérieur, step pour un changement de niveau à une porte, et riser, tread, risers et spiral pour les escaliers. Modélisez chaque volée d'escalier comme un lien d'escalier entre les espaces qu'elle relie ; tout lien non drop entre deux étages compte comme une route verticale.

Identifiants de règles, utilisés dans les rapports, accepted et 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. Une entrée accepted est {"rule": "...", "space": "..."} (ou "link"), ou juste une règle et une raison de l'accepter partout.

Le script rapporte BLOCKER, FINDING, ACCEPTED, NOTE (y compris ce qu'il n'a pas pu vérifier à partir des données fournies) et OK :

  • Accessibilité (reach, return) : chaque espace non scellé accessible depuis l'extérieur avec les déplacements du graphe, et un chemin de retour depuis chacun (les chutes sont à sens unique).
  • Sorties (exits) : nombre, faces et espacement par rapport au tableau.
  • Impasses (dead_end, dead_share) : espaces avec une seule entrée, profondeur de la chaîne depuis la dernière jonction, et (C) la part de pièces sans issue.
  • Boucles (loop) : au moins une boucle intérieure là où le lieu fait plus de 400 m² ou plus de deux espaces de profondeur.
  • Entonnoir (funnel) : routes séparées (ne partageant aucun espace) de l'extérieur vers l'ancre, ou vers la pièce la plus profonde si aucune n'est marquée ; une route est un blocage en (C) au-dessus de 100 m² et une constatation au-dessus de 400 m².
  • Routes verticales (vertical) : routes de chaque étage vers l'étage d'entrée, montantes ou descendantes ; deux, espacées d'au moins VERTICAL_SPACING, sur les étages de plus de 200 m², ou de plus de 100 m² en (C).
  • Tailles et niveaux (door_width, corridor_width, large_width, headroom, small, step) : largeurs et hauteurs libres par type de lien, espaces plus étroits que le joueur, pas de marche sans escalier.
  • Escaliers (stair) : hauteur de marche, giron, foulée et longueur de volée ; hauteurs de marche mélangées dans un même bâtiment.
  • Bords (guard) : chutes non protégées au-dessus de GUARD_DROP.
  • Tubes et ouvertures (tube, openings) : couloirs de plus de TUBE_LENGTH sans embranchement ; (C) pièces avec trop d'ouvertures.

Passe 2 : sondes géométriques (dans le moteur ou l'outil de modélisation)

Le graphe ne peut pas voir la géométrie. Exécutez ces sondes sur le bâtiment assemblé avec les outils du projet ; chacune doit produire un nombre ou une liste, pas une capture d'écran.

SondeMesureÉchoue quand
Inondation de marcheUne capsule de la taille du joueur marche depuis chaque porte extérieure avec gravité, traitant les murs comme solides (une construction de maillage de navigation est acceptable).Un espace que le graphe appelle accessible n'est pas atteint, ou la marche atteint un endroit que le graphe n'a pas (un trou, le dessus d'un mur, un toit sans chemin).
SupportPour chaque sol, toit, escalier, poutre et mur supérieur : l'élément en dessous dans son empreinte.Quelque chose ne repose sur rien (plus d'1 cm d'air), une colonne ou un mur au-dessus atterrit sur une portée de sol sans poutre ou mur en dessous, ou un porte-à-faux dépasse environ un tiers de sa portée arrière sans étai ou contreventement visible.
Extrémités de mursChaque extrémité de chaque mur et cloison.Une extrémité ne touche rien (et n'est pas une extrémité libre finie), se trouve à l'intérieur d'une porte ou d'une fenêtre, ou s'arrête à moins de la largeur du joueur d'un mur.
OuverturesHauteur du sol des deux côtés de chaque porte, un rayon à travers chaque fenêtre.Une porte s'ouvre sur un mur, un vide, un vide scellé ou une marche plus haute que STEP_HEIGHT ; une fenêtre est bloquée dans le mètre derrière elle par un mur, une dalle de sol, un escalier ou un grand accessoire ; un sol ou un mur intérieur traverse une fenêtre sur la façade.
DégagementCapsule balayée le long de chaque route, zones de débattement de porte, paliers d'escalier.La hauteur libre ou la largeur tombe en dessous des paramètres ; un accessoire, une colonne ou une cloison se tient dans le chemin d'une porte, sur un palier ou dans la largeur libre d'un couloir.
BordsChaque bord praticable et sa chute.Une chute de plus de GUARD_DROP n'a pas de protection et n'est pas marquée comme délibérée.
ChevauchementIntersections mur-dans-mur, mur-dans-sol et accessoire-dans-mur.Toute intersection de plus de quelques millimètres qu'un joueur peut voir.

Passe 3 : revue à hauteur d'œil

Un relecteur frais (personne ou agent critique qui n'a pas vu la construction) la parcourt à hauteur d'œil et examine un plan et une coupe de chaque étage. On leur donne le brief monde, le but du bâtiment (« une maison de ferme pour deux familles », « un bunker de recherche inondé », « un temple effondré », « un pont d'équipage sur un cargo ») et les conditions acceptées (impasses délibérées, portes verrouillées, sections effondrées, espaces de reptation), et ils répondent :

  1. Chaque mur a-t-il une raison ? Il enferme une pièce, porte quelque chose, protège un bord, masque une vue, ou (dans une ruine) il est ce qu'il en reste. Un mur qui ne fait rien de cela est supprimé.
  2. Chaque pièce a-t-elle un but et une entrée qui lui convient ? Une salle d'eau depuis un couloir, pas depuis la cuisine à travers une chambre ; un débarras près de ce qu'il stocke ; un poste de garde là où il peut voir ce qu'il garde ; un sas entre pression et

…

[la suite a été tronquée pour la traduction]

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.

Skills associés