Foolafroos/open-physics

Úsese cuando un agente necesite simulación física determinista en Hermes. Impone comprobaciones de disponibilidad honestas y el flujo de trabajo de construcción-paso-reproducción.

¿Qué es open-physics?

Esta habilidad proporciona a los agentes una interfaz para simulación física determinista dentro del ecosistema Hermes. Es útil para desarrolladores y testers de juegos que necesitan resultados predecibles y verificables, como contactos, raycasts o diagnósticos de solver, en lugar de estimaciones visuales. Actualmente en estado pre-alpha, la habilidad no expone herramientas reales (`physics_*`), pero define el flujo de trabajo previsto: crear un mundo, agregar cuerpos, avanzar pasos fijos, consultar contactos/raycasts y, finalmente, reproducir la misma entrada para verificar que los resultados sean idénticos. La habilidad advierte explícitamente contra el uso de motores sustitutos o salidas fabricadas, y exige reportar la falta de implementación sin engañar sobre la corrección física.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Foolafroos/open-physics/tree/HEAD/skills/open-physics

Installed? Explore more Productividad y colaboración skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Preguntar en tu IA favorita

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

Documentación

Open Physics

Cuándo usarlo

  • Un agente necesita crear, avanzar, consultar o reproducir un mundo físico determinista.
  • Un probador de juego necesita contactos, raycasts o diagnósticos de solver en lugar de estimaciones visuales.

Barrera de disponibilidad — etapa actual

Este repositorio es un andamio pre-alpha. Aún no se ha registrado ninguna herramienta physics_*. No afirme que un mundo fue simulado, que una reproducción coincidió o que una construcción es físicamente correcta. Si las herramientas previstas no están disponibles, informe que el núcleo nativo no está implementado y deténgase en lugar de sustituir otro motor o una salida inventada.

Flujo de trabajo previsto para M0

Use este bucle solo después de que las herramientas correspondientes existan realmente:

physics_world_create
  → physics_body_add (para cada cuerpo)
  → physics_step (número fijo de pasos)
  → physics_contacts_report / physics_raycast
  → physics_replay (mismo registro de entrada; exigir resultados idénticos)

Reglas para la implementación futura:

  1. Mantenga la descripción inicial del mundo explícita y serializable.
  2. Nunca infiera el éxito de la simulación a partir de la ausencia de un error; inspeccione el estado resultante.
  3. Trate el determinismo como un contrato verificable: las mismas entradas y el mismo registro de pasos deben producir salidas idénticas.
  4. Informe la violación máxima de restricciones y los impulsos rotos junto con los resultados de la simulación.
  5. No presente el motor como Havok ni como si contuviera código de Havok. Es una implementación original de sala limpia.

Skills relacionados