軟體代表作/Promptasy

Promptasy

長時程 AI 代理幾乎自己完成的瀏覽器 3D 遊戲:12 個區域、142 個關卡。

客戶
業餘作品
領域
網頁遊戲
合作形式
獨立專案
角色
開發工程師
期間
2026
狀態
garyhsieh.com/promptasy 公開

起點

一款瀏覽器 3D 遊戲,大部分由 AI 代理自己完成。

Promptasy 是業餘作品。開發以 Claude Code 的長時程目標(/goal)驅動:寫下產品目標與規則,代理一個階段完成一個目標,自己規劃、實作、測試、寫變更紀錄;負責實玩驗收每個里程碑。遊戲的題材是練習寫 prompt:在夜色的 3D 世界裡走到神廟前,一段一段選出句子組成 prompt,當場離線評分。

範圍

  • 3D 世界與角色:three.js,全部程序化生成
  • 12 個區域、142 個關卡、11 種答題方式
  • 離線評分引擎
  • 進度、圖鑑與分享卡
  • 原創配樂 13 首
  • 部署在 garyhsieh.com/promptasy

難題

要讓代理長時間自己做,又不能做歪。

  1. A
    方向要寫清楚

    代理每個階段開工前,先讀產品北極星、變更紀錄與世界設定,才不會偏離產品方向。

  2. B
    每一步都要能自己驗證

    評分、可解性、建置與無頭瀏覽器實玩四層測試,由代理自己跑、自己修。

  3. C
    沒寫過 prompt 的人也要能玩

    早期實玩發現玩家不知道該輸入什麼,於是改成一段一段選出 prompt,選錯也會當場說明原因。

做法

一個階段只完成一個目標,里程碑由人實玩驗收。

每個階段的節奏固定:讀北極星、寫計畫、完成一個目標、跑完測試、寫變更紀錄後推送。v1.2 的每個階段,計畫與差異都先交給另一個模型審查;四個里程碑各有一道實玩閘門。

遊戲本身是純靜態網頁:世界全程序化、不用模型檔,存檔放在瀏覽器裡,評分由離線引擎完成,執行時不呼叫任何外部服務。

讀北極星計畫交另一個模型審查一個階段一個目標四層測試差異審查變更紀錄、推送;里程碑實玩

架構決策

不需要帳號、金鑰或伺服器。

  1. 評分決策規則式離線引擎,可給部分分數,也擋得住堆關鍵字確保不需帳號與金鑰,離線也能玩
  2. 答題方式決策預設一段一段選出 prompt,自由書寫保留為選項確保第一次玩的人也能過關,並知道原因
  3. 上站方式決策以 git submodule 掛進 garyhsieh.com,建置時一起產出確保遊戲保有自己的 repo、測試與版號
  4. 執行環境決策純靜態部署,存檔放在瀏覽器,字型自架確保執行時零外部請求

專案時程

2026.07.31

在 garyhsieh.com/promptasy 上線

7 月 25 日第一個長時程目標;9 月 11 日 v1.2

出處 +
2026 年 7 月2026 年 9 月8 月123
  1. 12026 年 7 月從空 repo 到可以玩,7 月 31 日以 Promptasy 公開上線
  2. 22026 年 8 月v1.1:12 個區域、142 個關卡
  3. 32026 年 9 月v1.2:遭遇戰、垂直世界與故事結局

成果

公開可玩,免帳號、免金鑰。

142個

關卡

離線即時評分,不需帳號或金鑰

12個

區域

瀏覽器即可進入的 3D 世界

3個版本

v1.0 到 v1.2

2026 年 8 月 1 日至 9 月 11 日

  • 公開於 garyhsieh.com/promptasy。
  • 每個關卡的技巧都附官方文件出處。
  • 原始碼開源(MIT)。
  • 原創配樂 13 首,以 Suno 輔助製作。
Promptasy 遊戲畫面:3D 世界中的角色與介面

技術

three.js、Vite、Web Audio。

3D
three.js(WebGL),全部程序化
建置
Vite・vanilla JS
音訊
Web Audio
評分與存檔
離線評分引擎・瀏覽器本機存檔
部署
靜態網頁,掛在 garyhsieh.com
開發
Claude Code 長時程目標(/goal)・跨模型審查
工程備註

224 次提交中 170 次標示 Claude 共同作者(約 76%,依提交訊息統計)評分測試 227,303 項斷言、可解性 2,824 項、無頭瀏覽器實玩 4,990 項81 個可重用評分檢查開發階段:v1 34 個、v2 11 個、v1.2 25 個

更多案例