Best For
想讓 AI agent（特別是 Claude Code）在沒有 GUI 的情況下創作、測試或遊玩 RPG / 視覺小說內容的開發者。如果你正在探索由 LLM 全程驅動的遊戲化教學或互動敘事，這是目前唯一從底層就為此設計的無頭引擎。
How I Actually Use It
我評估 RPG-Harness 的出發點，是看它能否成為生技遊戲化教學模組的基礎元件。核心運作邏輯很直覺：一個遊戲就是一個資料夾，裡面放 Markdown 和 YAML 檔案。執行 rpgh step，透過 stdin 傳入 JSON 格式的決策，stdout 就會回傳更新後的遊戲狀態。不需要視窗、不需要渲染器、不需要額外的 SDK。
這個專案內建兩個 Claude Code skills：rpg-harness-player（用來玩遊戲）和 rpg-harness-author（用來撰寫遊戲內容）。把 SKILL.md 檔案放進 Claude Code 環境，AI 就能立即知道如何與任何遊戲資料夾互動。
我測試了旗艦示範遊戲「妖刀奇譚」，它展示了 15 個 lifecycle hook、完整的 Condition AST，以及複合觸發器。架構扎實且具備擴展性。
Where It Is Strong
- Headless step API 是純函式設計的典範。 JSON 輸入、JSON 輸出，沒有隱藏狀態，完全可腳本化。這正是 AI 原生工具該有的樣子。
- 遊戲等於資料夾。 不需要
package.json，不需要node_modules。內容創作者完全不必接觸 Node 生態系。 - 內建 Claude Code skills。 player 和 author 協定隨裝即用，AI 整合零設定。
- 一個引擎驅動三種遊戲模式。 純視覺小說、訓練模式、射擊提取模式都跑在同一個狀態機上，且保留了擴展空間。
Where It Fails
- Pre-alpha 階段，僅 1 個 commit，0 個正式版本。 API 尚未凍結，隨時可能大幅變動。
- 需要 Bun 執行環境。 並非所有環境預設安裝 Bun，對已標準化 Node 或 pnpm 的工作流會產生摩擦。
- 戰鬥模組、訓練模組與 web 前端尚未完成。
rpgh studio指令標註為「PR-stage」（尚未可用）。 - 社群極小。 評測時 GitHub 僅 17 顆星。若作者停止維護，沒有生態系可以接手。
Pricing, Difficulty, and Risk
價格： 免費，MIT 授權，無商業限制。
上手門檻： 進階。你需要熟悉 TypeScript monorepo、Bun 執行環境，以及 CLI 驅動的遊戲設計。沒有 GUI 可以退而求其次。
風險： 因 pre-alpha 狀態導致的高度不穩定風險。API 介面幾乎可以確定會改變。資料風險可忽略，所有運算都在本機執行，不涉及雲端傳輸。供應鏈可稽核（Bun + TypeScript，無不透明的二進位檔）。
Verdict
RPG-Harness 的設計哲學精準到位：一個無頭、純函式的遊戲引擎，把 AI 視為一等公民的玩家與作者。如果你今天就需要一個可投入生產的工具，請另尋他處。但如果你想關注一個架構優雅的專案逐步成熟，未來有可能成為 AI agent 與遊戲世界互動的標準方式，現在先加入書籤，等它發佈第一個正式版本時再回來。