Communitygithub.com

diseño-pdi

Diseñar, construir, criticar y enviar puntos de interés (compuestos, pueblos, instalaciones, estaciones, restos, campamentos, ruinas, cuevas) en un juego de mundo abierto de cualquier entorno, período, estilo o género.

¿Qué es diseño-pdi?

Este skill define un método completo para diseñar y enviar Puntos de Interés (PDI) en juegos de mundo abierto. Cubre todo el ciclo de vida: desde el propósito del sitio en el mundo y cómo los jugadores lo encuentran sin marcadores, hasta un breve visual por sitio, flujo dimensionado para jugadores y enemigos grandes, historia contada a través del entorno, colocación de botín, reglas de abastecimiento de accesorios y vehículos, ensamblaje a partir de piezas de kit, una barra de finalización, críticas ciegas calibradas con revisiones aéreas y a la altura de los ojos, sellos del propietario o líder, correcciones de fallo a regla y la regla '¿tiene sentido?'. El skill es útil para cualquier desarrollador de juegos o diseñador de niveles que trabaje en entornos de mundo abierto. Proporciona un proceso estructurado y basado en evidencia que evita puntos débiles comunes como bucles sin salida, puntos de estrangulamiento de embudo, falta de cobertura o recompensas desequilibradas. Está diseñado para integrarse con skills complementarios como `modular-environment-kit-production` (para piezas de kit), `building-layout-check` (para diseño de edificios) y `project-knowledge-system` (para estándares y lecciones aprendidas). El skill se aplica a cualquier plataforma de agente de IA que admita la ejecución de skills (como Claude Code, Cursor, Codex, etc.) y es independiente del motor de juego o herramienta de modelado utilizada. Puede usarse al planificar un PDI, redactar su breve, diseñarlo o decorarlo, revisarlo o configurar un bucle de crítica de PDI.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TayHD/game-agent-skills/tree/HEAD/skills/poi-design

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Diseño de PDI

Un punto de interés se envía cuando se lee como un lugar real que alguien construyó y usó, en el estado que su breve le da (en funcionamiento, ocupado, abandonado, en ruinas o nunca construido en absoluto, como una cueva o una arboleda), y funciona como un mapa diseñado: los jugadores y las criaturas pueden entrar, atravesarlo y salir, los combates tienen forma, y la recompensa vale el riesgo. Pasar las comprobaciones automáticas es necesario y nunca suficiente. Este skill es el método para un sitio completo; los números provienen del mundo del proyecto, el número de jugadores y las criaturas.

Skills complementarios: modular-environment-kit-production (las piezas de las que está construido el sitio y su acabado), building-layout-check (cada edificio dentro del sitio, y el breve del mundo que este skill extiende) y project-knowledge-system (donde viven el estándar, las decisiones y las lecciones). Este skill no los repite; los señala.

Ajustes que proporciona el proyecto

AjusteSignificadoPredeterminado
WORLD_BRIEFEntorno, período, constructores, estilo artístico, quién se mueve por el mundo (definido en building-layout-check).Requerido antes del primer sitio.
WORLD_PLANEl mapa del mundo con cada sitio, su nivel, las rutas entre sitios, zonas y puntos de referencia.Requerido antes del diseño del sitio.
POI_BRIEFSUn breve visual por sitio (campos a continuación).Docs/Design/World/POIBriefs.json
POI_RUBRICEl estándar de calidad: las filas de la puerta de autocomprobación, las preguntas de los críticos, P0 y P1, las hojas de estándar de área.Docs/Design/World/POIStandard.md
FLOW_RULESReglas de flujo numeradas y medibles y patrones de fallo nombrados (conjunto inicial a continuación).Sección de flujo de este skill
PLACEMENT_RULESDónde va cada tipo de accesorio, por zona, ancla y propósito.Sección de historia de este skill
PROP_LIBRARYEl catálogo aprobado de accesorios y vehículos, una fuente por tipo de accesorio.Requerido; un sitio nunca coloca un accesorio no catalogado.
PROP_POLICYSi se pueden modelar accesorios sueltos para un sitio.No: solo accesorios de estructura y piezas fijadas a edificios; los accesorios sueltos provienen de PROP_LIBRARY; un vacío va a una lista para el propietario.
VEHICLE_CLASSESTipos de vehículos que pueden aparecer y por qué.Solo utilitarios (trabajo, servicio, transporte, militares, agrícolas); poca variedad.
KIT_CONTRACT, FINISH_SPEC, CORE_LIBRARYComo en modular-environment-kit-production.Los valores predeterminados de esos skills
TIERSNiveles de sitio con bandas de tamaño típicas y recuentos de edificios.Punto (un naufragio, campamento, boca de cueva, santuario) de 10 a 40 m, puesto avanzado de 40 a 80 m, estación de 60 a 150 m, compuesto de 80 a 220 m, complejo de 200 a 400 m en 2-4 subáreas, pueblo de 250 a 600 m en 4-6 subáreas alrededor de una plaza
PLAYER_COUNTJugadores por servidor y un tamaño típico de escuadrón.Requerido; establece cuántos grupos debe contener un sitio.
LARGE_AGENT_DIAMETERLa criatura o vehículo más grande que debe pasar (como en building-layout-check); agregue uno por clase de tamaño si hay varios.0 (ninguno)
PROFILE, SITEComo en building-layout-check; la mayoría de los PDI están disputados.disputado, edificio
CRITIC_TARGET, CAMERA_RANGELos juegos enviados cuyos sitios los críticos comparan por nombre; distancias de cámara de trabajo.Nombrado en el breve del mundo; 2-5 m en primera persona
CRITIC_MODELModelo y esfuerzo de razonamiento para cada crítico de PDI.El modelo disponible más fuerte con alto esfuerzo de razonamiento
STUDIO, STAMPSLa superficie de revisión que mira el propietario; dónde se registran los sellos y las banderas y quién puede sellar.Una página de revisión privada con fotogramas, hoja de recorrido, plano y veredictos; sellos del líder, banderas del propietario
RULES_LEDGERDonde se registra cada regla nacida de una falla con su fecha y causa.El registro de decisiones del proyecto más el registro de cambios de POI_RUBRIC
DCC, ENGINEHerramienta de modelado y motor.Elección del proyecto

Principios

  1. Propósito primero. Cada sitio tiene un trabajo en el mundo y un trabajo en el juego; cada edificio, patio, camino y accesorio sirve a uno de ellos.
  2. El diseño se mantiene. Una vez que un sitio se envía, los pases de arte posteriores mantienen sus carriles, entradas, ventajas y llamadas; cambiar cualquiera de ellos lo reabre.
  3. Reutilizar antes que modelar. Los sitios se ensamblan a partir de piezas de kit aprobadas y accesorios catalogados; nada se construye a mano en el motor.
  4. Evidencia sobre afirmaciones. La puerta mide; los críticos juzgan lo que la puerta no puede; los renders y las hojas de recorrido son la evidencia.
  5. Bueno está hecho. Los P0 bloquean; todo lo demás es una lista de tareas pendientes.
  6. ¿Tiene sentido? Nunca agregue, mueva o doble nada solo para satisfacer una fila de la puerta, un crítico o una regla. Si una regla empeora este sitio, pida al líder una excepción con la razón y regístrela.

1. El lugar del sitio en el mundo

Lo que WORLD_BRIEF debe agregar para los PDI. Más allá de la media página que building-layout-check solicita, el breve establece: cómo navegan los jugadores (mapa, brújula, puntos de referencia; si existen marcadores en absoluto), el roster de amenazas con sus clases de tamaño y qué puede escalar, entrar o romper cada una, PLAYER_COUNT y cómo se encuentran los grupos, la economía de recompensas (qué es escaso, qué cuesta morir), y la edad del mundo, el clima y la historia desde que se construyeron los sitios, lo que establece hasta dónde han llegado el desgaste y el crecimiento excesivo.

Qué reglas se aplican. Establezca PROFILE y SITE por sitio como en building-layout-check. Las reglas de flujo, cobertura y ventaja en la sección 4 son para sitios disputados, donde los jugadores o criaturas luchan, persiguen o huyen. Un sitio de exploración (un santuario tranquilo, una ruina con historia) mantiene el alcance, la capacidad de ser encontrado, la historia y el acabado, e informa las reglas de combate como notas. Un sitio natural (una cueva, un cañón, una arboleda) no debe una red de calles, perímetro, servicios o nivelación, pero aún debe formas de entrada y salida, una ruta legible, un punto de referencia o lectura de entrada, callejones sin salida poco profundos donde ocurren los combates, y rutas de criaturas grandes que formen un bucle. Una ruina debe lo que sobrevive de su lógica original, y su daño sigue una causa. Los sitios de nivel de punto (un solo naufragio, campamento o boca de cueva) necesitan dos aproximaciones, una razón para detenerse, cobertura cerca de la recompensa y una lectura desde la distancia; los recuentos a escala del sitio (formas de entrada, corte mínimo, tres bucles) comienzan en el nivel de puesto avanzado.

Escriba estas líneas para cada sitio en WORLD_PLAN antes de que alguien dibuje un plano.

  • Rol: para qué fue construido (mover carga, proteger y albergar, estudiar, vivir y comerciar, extraer, adorar) y qué es ahora (abandonado, ocupado por otra persona, en ruinas, recuperado).
  • Nivel y tamaño: de TIERS. Un sitio crece solo hasta donde lo necesitan sus subáreas y plaza, nunca separando los edificios. Los sitios de nivel superior son pocos, los de nivel medio muchos, y cada región contiene un sitio que vale la pena cruzar para llegar a él.
  • Amenaza: quién y qué lo posee (facciones, criaturas, peligros), cómo escala eso con PLAYER_COUNT, y si las criaturas grandes pueden llegar a su núcleo. Donde las criaturas grandes importan, mantienen la ventaja: el sitio les da a los jugadores formas de romper el contacto, no refugios donde un escuadrón las cultive.
  • Recompensa: qué se encuentra aquí que no se encuentra en ningún otro lugar, y su valor en relación con los vecinos. La recompensa sigue al riesgo.
  • Razones de terreno, historia y juego: una línea cada una. Un sitio sin razón de terreno parece caído; uno sin razón de juego es ignorado por los jugadores.
  • Descubrimiento sin marcadores: los jugadores encuentran y reconocen el sitio solo a través del mundo. Use un punto de referencia que despeje lo que sea que oculte el sitio (dosel, techos, dunas, una cresta), legible desde unos 300 m (típico: un mástil, grúa, torre, tanque, chimenea, aguja, casco); carreteras, líneas eléctricas, tuberías y cercas que conducen a él; senderos, humo, luz por la noche, sonido; señales en el propio idioma del mundo. Nunca confíe en un icono de mapa, marcador mundial o indicador HUD.
  • Espaciado y aproximaciones: sitios menores típicos a 500-800 m de distancia, mayores a 1 km o más; dos o tres satélites (puestos avanzados, puestos de control, campamentos) en las aproximaciones de un complejo, a unos 200-600 m de distancia; una línea de cobertura (cerca, zanja, muro, línea de naufragio) a través de terreno abierto a unos 150 m entre sitios; un desvío cubierto a 50-150 m fuera de cada sitio grande para que el camino más corto entre vecinos nunca pase por un patio ancla.
  • Lectura de distancia: cómo se ve el sitio desde 300 m, 100 m y la puerta: una silueta, luego su función, luego sus entradas.

2. El breve visual (uno por sitio, en POI_BRIEFS)

Campos: id, nombre, nivel, tipo, tamaño, lado de acceso, terreno, el programa de construcción (kit, rol, huella, pisos, altura para cada uno), el elemento héroe, el diseño en un párrafo, su estado y condición, y una línea de ambiente. Las imágenes conceptuales hechas a partir del breve son ambiente, no especificación: nunca agregan, fusionan o mueven edificios, y el plano sigue siendo la verdad. Genere cada concepto con una luz, estación, grado y lenguaje de cámara fijos (una vista aérea desde el lado de acceso, un plano superior, una vista a la altura de los ojos desde la aproximación, el primer plano del héroe).

3. Suelo y calles primero

Diseñe el sitio primero las calles, luego coloque los edificios, luego el espacio abierto, luego los accesorios.

  • Nivelación: las plataformas y los patios son terrazas planas (pendiente transversal típica del 3% o menos) unidas por rampas (típicamente del 10% o menos, con rellanos) y escaleras; los bordes de las terrazas son muros de contención o bancos plantados no más empinados de aproximadamente 1 en 2. Dos o más enlaces entre terrazas; nunca una rampa amurallada. Ningún edificio se encuentra en una pendiente bruta; el terreno nunca se muestra a través de una superficie dura.
  • Calles: una red conectada con una jerarquía (calle principal desde la puerta, calles secundarias, carriles, callejones); cada camino termina en una intersección, una puerta o un radio de giro; los caminos del mundo terminan en una puerta y nunca cruzan el sitio; ningún camino cruza un edificio o un espacio abierto diseñado; los edificios mantienen una acera y un retranqueo de la calzada. Nunca doble un camino solo para romper una línea de visión.
  • Los bordes del agua dentro del sitio están construidos (muro de muelle, revestimiento, grada); el agua unida al mar se encuentra al nivel del mar.
  • Los perímetros pertenecen al rol: muros y torres en una base, muros bajos y setos en un pueblo, una valla de seguridad con una caseta de vigilancia en una instalación. La misma valla en cada sitio es una falla. Las puertas se leen como puertas, en un borde recto más largo que su marco.

4. Flujo (las FLOW_RULES iniciales)

Ejecute el plano del sitio como un gráfico espacial a través de building-layout-check para cada edificio, y mida estos en todo el sitio. Los números son puntos de partida típicos; calíbrelos en los primeros sitios que se envíen.

Formas de entrada y rotación

  • 3-5 formas de entrada para un compuesto, 4-8 para un complejo o pueblo, como máximo unas 8; en al menos 3 caras (2 para un puesto avanzado o estación); ninguna cara lleva más de la mitad. Las formas informales de entrada (una brecha, un alcantarilla, una escalada) tienen un costo: ruido, agacharse, agua.
  • Ningún punto de pie ve más de la mitad de las formas de entrada, o más de 2 dentro de los 60 m.
  • Corte mínimo (la menor cantidad de aberturas que sellan el ancla del exterior) al menos 3 para un compuesto o más grande, 2 para sitios pequeños; entre subáreas al menos 2. Las parcelas enlazadas comparten una costura real, nunca dos esquinas que se tocan.
  • Al menos 3 líneas de rotación salen de un sitio grande hacia diferentes vecinos y formas de entrada.

Puntos de estrangulamiento, bucles y callejones sin salida

  • Puntos de estrangulamiento para jugadores de 1.2 a 3 m de ancho, carriles de 4 a 8 m, rutas de criaturas grandes de al menos 1.5 veces LARGE_AGENT_DIAMETER (y sus bucles son bucles, nunca un callejón sin salida); cada punto de estrangulamiento tiene un desvío de no más del doble de la ruta directa; como máximo un punto de estrangulamiento por carril hacia el núcleo.
  • Al menos tres bucles independientes en todo el sitio, y un bucle a través del interior de cualquier edificio de más de unos 400 m2.
  • Callejones sin salida al aire libre de 15 m de profundidad como máximo y ningún bolsillo de más de 20 x 20 m; en interiores, una habitación de profundidad. Los carriles continúan: ninguno termina en una pared o valla en blanco.

Juego vertical y líneas de visión

  • Como máximo tres planos de piso por área. Cada piso, techo y percha alcanzable tiene dos formas de subir, a unos 15 m de distancia o en caras opuestas; suponga que los enemigos trepadores alcanzan los techos si el juego los tiene.
  • Cada ventaja se declara y mide: al menos dos contra-ángulos de diferentes carriles, una ventaja comparable en otro carril a 60-120 m de distancia, y ninguna ventaja que vea más de aproximadamente el 40% del suelo transitable del núcleo.
  • Una ruptura de línea de visión cada 30-60 m; líneas abiertas largas (más de unos 100 m) solo en uno o dos ejes declarados con una razón (la aproximación principal, un patio de armas, un muelle, una pista de aterrizaje).

Cobertura y espacios de combate

  • Cobertura cada 8-15 m a lo largo de cada ruta; ningún punto en un área abierta nombrada a más de 15 m de una cobertura de 1.0 m o más de altura. Cobertura baja de 1.0 a 1.25 m, alta de 1.75 m o más; aproximadamente el 60% de la cobertura de la ruta es baja; cobertura alta en los extremos de los carriles, puertas y esquinas. La cobertura se adapta a su lugar: mobiliario urbano en plazas, carga en patios.
  • Los edificios accesibles tienen dos o más puertas en diferentes caras; los anclajes más, una grande. Las habitaciones sin salida son solo habitaciones de botín deliberadas.
  • Dimensionar los espacios de combate para el enemigo más grande y para el número de grupos: un patio al que una criatura grande puede entrar tiene dos salidas grandes; un sitio alberga dos grupos que llegan desde diferentes lados sin que uno acampe al otro; todavía se lee y recompensa a un solo jugador cuando está vacío.
  • Escenas (una grúa colapsada, una bóveda violada, un vehículo varado, una sala inundada) se encuentran en un carril, tienen dos formas de entrada y salida, y se ven desde la aproximación.
  • Subáreas nombradas que todos pueden llamar de un vistazo ("el parque de tanques", "el almacén azul"); en cada intersección, dos caminos son visibles hacia adelante sin darse la vuelta.

Patrones de fallo para nombrar en las revisiones: esquinas que se besan, embudo de la puerta principal, el foso, patio sin salida, caja de una puerta, trampa de escaleras, techo dios, el tubo, galería de tiro, mapa de adivinanzas, carril muerto, cruce único, pecera, imán de paso, espalda en blanco, botín de borde, laberinto de vallas, callejón sin salida de criatura, vecino vigilado, ancla de un solo plano. Cada hallazgo del crítico nombra su patrón y su solución.

5. Historia a través del entorno

  • El trabajo a la vista: el ancla en el corazón; el rol de cada edificio se ajusta a su posición (puertas de carga en los patios, casetas de vigilancia en las puertas, combustible cerca de los vehículos); servicios visibles (electricidad, agua, combustible, residuos, comunicaciones donde el rol los necesita).
  • El espacio abierto está diseñado: patios, patios de trabajo y almacenamiento, bahías de carga, estacionamiento, refugios para fumadores, recintos para contenedores, toldos, plataformas para generadores, cada uno donde un sitio real lo coloca. Un sitio que se lee apretado falla incluso si las filas de densidad pasan.
  • Qué sucedió aquí: cada patio cuenta una pequeña historia con sus accesorios (descarga interrumpida, un puesto de control, una reparación...

...

[truncado para la traducción]

6. Colocación de botín y accesorios

  • El botín sigue al riesgo: los elementos de mayor valor están en el área más defendida o en la sala más oculta; el botín de nivel medio está en espacios disputados; el botín común está a la vista.
  • Los accesorios cuentan la historia: herramientas, muebles, objetos personales, suministros, cada uno refuerza el rol y el estado del sitio. Los accesorios nunca bloquean el flujo a menos que esa sea su función.
  • Los vehículos se colocan según su clase: los vehículos de trabajo cerca de las áreas de carga, los vehículos de transporte en las carreteras, los vehículos militares en los puestos de control. Cada vehículo tiene un propósito y una historia.

7. Revisión y envío

  • Autocomprobación: ejecute las filas de la puerta de POI_RUBRIC; ningún P0 permanece; los P1 están en una lista de tareas pendientes.
  • Revisión por pares: cada sitio recibe una revisión ciega de al menos dos críticos; los críticos nombran los patrones de fallo y sugieren soluciones.
  • Sello del propietario: el propietario del sitio revisa la evidencia, los hallazgos de los críticos y la lista de tareas pendientes, y sella el sitio como listo para enviar o lo devuelve con banderas.
  • Registro de reglas: cualquier falla que conduzca a una nueva regla se registra en RULES_LEDGER.

8. El bucle de crítica de PDI

Configure un bucle de crítica para cada sitio: un crítico de alto esfuerzo revisa el sitio contra POI_RUBRIC y proporciona comentarios; el diseñador del sitio aborda los hallazgos; el bucle se repite hasta que no queden P0 y los P1 sean aceptables. El modelo de crítico se establece en CRITIC_MODEL.

9. La regla '¿Tiene sentido?'

Antes de enviar, pregunte: "¿Tiene sentido este sitio?" Si una regla, un hallazgo del crítico o una fila de la puerta empuja al sitio en una dirección que no tiene sentido para un lugar real, solicite una excepción al líder. La excepción se registra con la razón.

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.

Skills relacionados