Community生產力與協作github.com

Foolafroas/open-physics

用於代理需要確定性物理模擬的場景,支援 Hermes 平台。強制執行可用性檢查與「建構-步驟-重播」工作流程。

open-physics 是什麼?

此技能提供一套用於建立、推進、查詢及重播確定性物理世界的工具(當其實作完成時)。它專為使用 Hermes 平台的 AI 代理而設計,確保物理模擬是確定性的且可供審查,這對於遊戲測試、碰撞檢測或求解器診斷等場景至關重要。該技能目前處於**預覽階段**,並在 SKILL.md 文件中實施了嚴格的護欄:代理不得使用偽造引擎的輸出,並且必須在對應的 `physics_*` 工具不可用時報告實作尚未完成。未來的工作流程將圍繞一個可重播的循環:建立世界、添加物體、執行固定步數的模擬步驟、查詢結果,然後根據相同的輸入日誌進行重播,以強制執行確定性合約。該實作是一套原創的乾淨房(clean-room)實作,不包含 Havok 程式碼,代理也必須如實報告此點。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Foolafroos/open-physics/tree/HEAD/skills/open-physics

Installed? Explore more 生產力與協作 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Open Physics

使用時機

  • 代理需要建立、推進、查詢或重播一個確定性的物理世界。
  • 遊戲測試員需要接觸、射線投射或求解器診斷資訊,而非視覺猜測。

可用性護欄 — 當前階段

此儲存庫為 pre-alpha 支架。目前尚無 physics_* 工具被註冊。 不得聲稱世界已被模擬、重播結果一致,或建構結果在物理上是正確的。 如果計劃中的工具不可用,請回報原生核心尚未實作,並停止操作,而非使用其他引擎或偽造輸出。

預期的 M0 工作流程

僅在對應工具實際存在後,才使用此循環:

physics_world_create
  → physics_body_add(針對每個物體)
  → physics_step(固定步數)
  → physics_contacts_report / physics_raycast
  → physics_replay(相同輸入日誌;要求結果完全一致)

未來實作的規則:

  1. 保持初始世界描述明確且可序列化。
  2. 絕不能僅因為沒有錯誤就推斷模擬成功;必須檢查最終狀態。
  3. 將確定性視為可測試的合約:相同的輸入和步驟日誌必須產生相同的輸出。
  4. 將最大約束違反量和斷裂衝量與模擬結果一併報告。
  5. 不得將引擎描述為 Havok 或包含 Havok 程式碼。此為原創的乾淨房實作。

相關技能