睡一覺起來,AI 把剩下四個階段做完了:一晚做出孩子的原創 3D 方塊遊戲
11 月 2 日晚上 7 點 47 分,我打開 Claude Code(一個會自己讀檔、寫程式、執行指令的 AI 助理),打的第一句話是:「什麼是麥塊?」麥塊就是 Minecraft,一款用方塊蓋世界的遊戲。
晚上 9 點 47 分,遊戲已經做完前兩個階段:自由建造,和用積木寫程式指揮機器人。我截了一張圖,說版面比例不好,接著交代:「我想去睡覺了,你直接完成 6 個階段設計與實作,所有的設計依你的建議走……我明早直接在部署環境測試。」
晚上 10 點 59 分,剩下的四個階段全部上線,也就是放到網路上、任何人都打得開。從第一個問題到全部上線,大約 3 小時 12 分;我去睡覺之後的那一段,大約 72 分鐘。AI 能在沒人盯著的時候做完,是因為它會自己執行檢查、自己上線,不用等我按按鈕。
這款遊戲叫「方塊星球」,給國小孩子在家玩:可以自由蓋房子、闖關解任務,還能用積木寫程式指揮機器人。程式幾乎都是 Claude Code 寫的。我做的事是:說清楚要什麼、自己玩一次、指出哪裡不對,還有睡前把話交代清楚。
遊戲在這裡:方塊星球。用平板或電腦都能玩;進遊戲要輸入通關密語,就是當天的月日四碼(例如 11 月 3 日輸入 1103)。
遊戲長什麼樣子
- 自由建造:用 16 種方塊蓋東西,每個玩家最多 6 個世界,蓋好可以拍照存進相簿。
- 任務:16 關,依年級分成三個分頁,低年級 6 關、中年級和高年級各 5 關。題目結合數學,例如數數、面積、周長、對稱、體積、比例;中高年級還有「能量線路」,要用電源、導線、開關把燈點亮、把門打開。
- 程式機器人:用程式積木拼出指令,指揮機器人移動、放方塊。每關最多三顆星,用的程式積木越少,拿到的星星越多。(這篇的「方塊」指蓋房子用的建材,「程式積木」指寫程式用的拼塊,兩者不同。)
- 收藏:12 個徽章、方塊圖鑑、相簿。
- 給孩子讀的設計:所有文字都有注音,也有「念給我聽」按鈕。
- 給家長的設計:家長頁要先答對一題乘法才能進去;有休息提醒;同一台平板可以有好幾個孩子各自的存檔。

它是一個 PWA,也就是可以像 App 一樣加到平板主畫面、沒網路也能玩的網頁。整體風格刻意做得跟我之前給孩子做的闖關學習遊戲小一冒險島一樣,讓兩款遊戲看起來是同一個系列。
先查資料,需求一句一句補上去
一開始我對這個遊戲的想像很模糊。我請 AI 先上網查資料、整理成文件,然後一句一句補需求:
- 「在家玩,我要部署的網站都要免費的解決方案」
- 「自由蓋東西、闖關解任務,這是基礎玩法,有教育版(Minecraft Education),常被用在程式和 STEM 教學,這個你也可以設計一下」
- 「我還需要有教學,引導式,遊戲中的文字都要有注音」
- 「我說的小朋友,是國小的程度,需要分等級,低、中、高的遊戲難度」
最後一句是:「你上網找一下還有哪些設計是我沒想到的,你可以幫我一起規畫。」
從 7 點 47 分到 8 點 07 分,這二十分鐘問出來的需求,後來變成一份設計文件,也就是動手前寫下「要做什麼、不做什麼」的說明書。裡面有一句話影響了很多後來的決定:**孩子在家自己玩,沒有老師在旁邊帶,所以遊戲本身要負責教學和引導。**所以文字全部加注音、有「念給我聽」、有新手教學,機器人也兼任提示和休息提醒。
想做麥塊,但不能做成山寨版
Minecraft 的教育版常被學校拿來教程式。我想要的是「用方塊世界學東西」這個做法,不是一款改了名字的 Minecraft。
所以設計文件除了寫「要做什麼」,還寫了一段「反目標」,也就是做到了就算失敗的事情。第一條就是:看起來像 Minecraft 的複製品或改名版,例如用它的名稱、方塊外觀、生物、角色,或照抄它的合成表(用哪些材料可以做出哪些道具的配方)。
這條規則落實在幾個地方:
- 名稱和故事原創:孩子扮演降落在方塊星球的小小拓荒隊員,帶著一台機器人,把星球上故障的古老裝置修好。這個故事是 AI 提的。
- 方塊圖樣原創:每種方塊是一個顏色加一種花紋,例如磚塊是紅底磚紋、電源是黃底閃電。
- 音效原創:遊戲裡沒有任何音效檔。所有聲音都是遊戲執行時由程式算出來的,像電子琴按下去才發出聲音。背景音樂只用五聲音階,聽起來比較柔和。
- 用測試擋住:自動測試是一段專門檢查程式有沒有出錯的程式,每次修改都會跑一遍。專案裡有一個測試會檢查程式碼和網頁裡有沒有出現「minecraft」「麥塊」「我的世界」這幾個字,出現了測試就不通過。

其他素材也都用免費授權:字型是開放授權的注音字型,積木編輯器 Blockly 是開源的,網站放在 Cloudflare 的免費方案上。
反目標清單裡還有幾條也很重要:不收集孩子的個人資料、不把資料傳出裝置,也不用轉蛋、每日登入獎勵這類設計刻意拉長孩子的遊玩時間。
睡前那段話,AI 怎麼接手
我睡前那段話,其實交代了四件事:
- 先修我截圖指出的版面比例。
- 剩下的階段,設計照 AI 的建議走。
- 要有選單,因為不同階段有不同玩法。
- 要能自動更新,我隔天早上直接在網路上的正式版測。
AI 接手後,先調好版面和自動更新,再把第 3 到第 6 階段的設計寫成一份文件。接著每個階段照同一套流程跑:
- 開一個分支(從主線複製出來的平行版本,改壞了不影響主線)。
- 交給 subagent 實作。subagent 是主 AI 派出去做單一工作的小幫手,每個只負責一個階段,不會被其他階段的細節干擾。
- 自動測試全部通過,才合併回主線、部署上線。
- 在瀏覽器裡實際打開,看版面有沒有跑掉,有問題就修。
四個階段的順序是:玩家檔案和主選單、任務與判定、能量線路和中高年級任務、收藏與聲音。最後一個修正在 10 點 59 分上線。
AI 自己抓到的問題
這段我最在意的,不是它做得多快,而是它有沒有發現自己的錯。從紀錄裡看,有幾個問題是它自己抓到的:
- 設計文件本身算錯:有兩關「用幾塊程式積木以內可以拿三顆星」的門檻訂得太嚴,照文件做的話,三顆星永遠拿不到。實作的 subagent 發現後,把門檻調成拿得到的數字。
- 新手教學看不到:新手教學放在低年級分頁的第一關。中、高年級的新玩家一進任務,會直接落在自己年級的分頁,就錯過了教學。它先寫了一個測試,確認問題真的會發生,修好後測試通過,以後也不會再壞;修法是「還沒做教學的人,先停在低年級」。
- 最矮的螢幕會破版:除了平板,也要顧到手機。手機橫放、扣掉瀏覽器工具列,畫面只剩 667×325 像素。主選單卡片上的「從這裡開始!」標籤會把卡片撐破,於是改成浮在卡片上緣的綠色小泡泡,綠色也調深到白字夠清楚。
- 舊版本卡住新版本:為了沒網路也能玩,遊戲會把檔案存一份在平板上。一開始的更新方式是「新版下載好了,等使用者同意再換」,結果已經裝到主畫面的 App 一直停在舊版。它改成「在選單時直接換新版;玩到一半只提示有新版本,按了先存檔再換」。
也有它沒照設計文件做的地方。文件原本說,過關可以解鎖新方塊,也可以解鎖機器人的新程式積木。但第 2 階段做程式機器人時,所有程式積木一開始就全部給孩子用了,後來就沒有再收回來,過關獎勵只剩新方塊。
早上醒來,我改了什麼
隔天早上 9 點多,我打開正式版。整體功能都在,但有兩件事我不滿意。
第一件是選單:「方格會不會太大,另外你的風格可以和〔小一冒險島〕類似嗎」。它把背景換成方塊風格的天空、雲、山丘和草地,卡片改成白框加陰影,主選單改成彩色小卡。

第二件是更新:「我要有一個更新按鍵,同〔小一冒險島〕,因為 cache 問題」。前面說過,遊戲會把檔案存一份在平板上(這就是 cache,快取);就算自動更新改好了,偶爾還是會卡在舊版。它照小一冒險島的做法加了一個「更新」按鈕:先確認有網路,清掉平板上存的舊檔案,再重新載入。孩子的存檔不會被清掉。
還沒驗證的地方
一個晚上做出來的東西,有些地方還沒有人真的試過:
- iPad 實機的觸控操作
- 音效實際聽起來怎麼樣
- 各種螢幕尺寸
- 幾關中高年級的任務,還沒在瀏覽器裡從頭玩過一次
自動測試有 536 個,全部通過,但測試只能證明程式照規格動作,不能證明孩子覺得好玩。
這次的做法
回頭看,這一晚有三件事讓後半段可以交出去:
- 先寫反目標。 設計文件除了「要做什麼」,也寫了「做到就算失敗」的事,AI 照自己的建議做決定時,就不會走歪成山寨版。
- 睡前把話交代清楚。 要修的版面、設計誰拍板、要有選單、要能自動更新,四件事講完才去睡。
- 每個階段都要測試過才上線。 測試沒過不合併、不上線,再到瀏覽器實際打開看一次。
測試過了,不等於好玩。早上的選單風格和更新按鈕,就是要有人實際打開,才會發現的問題。
幾個數字和技術選擇
給有興趣的人參考,看不懂可以直接跳過:
- 規模:61 個版本紀錄(commit);遊戲程式 6,170 行,測試程式 5,187 行,都是 TypeScript。
- Three.js:在網頁上畫 3D 畫面的工具,方塊世界就是用它畫的。
- Blockly:Google 開源的積木程式編輯器。孩子拼好的積木,會先轉成遊戲自己定義的指令清單,再一步一步執行;不會把它當成真正的程式碼直接丟給瀏覽器跑,比較安全。機器人也是先在世界的複本上試跑一次,再一步一步播放給孩子看。
- Web Audio:瀏覽器內建的聲音功能,可以用程式即時產生聲音。
- 存檔:存在平板的瀏覽器裡(IndexedDB),不會傳到網路上。
- 部署:Cloudflare Workers 的免費方案。
名詞解釋
- Claude Code:Anthropic 做的 AI 程式助理,可以在電腦上讀檔案、寫程式、執行指令。
- Minecraft(麥塊):一款用方塊蓋世界的遊戲,有給學校用的教育版。
- STEM:科學、科技、工程、數學四個領域的合稱。
- PWA:可以像 App 一樣安裝到手機或平板主畫面、離線也能用的網頁。
- 設計文件:動手前寫下「要做什麼、不做什麼、怎樣算成功」的說明書。
- 反目標:設計文件裡「做到了就算失敗」的清單,用來防止專案走歪。
- 五聲音階:只用五個音組成的音階,聽起來柔和、不容易刺耳。
- 自動測試:一段檢查程式有沒有照預期動作的程式,每次修改後自動跑一遍。
- 分支:從主線複製出來的平行版本,可以放心修改,確定沒問題再合併回主線。
- subagent:主 AI 派出去專門做一件事的小幫手,做完回報結果。
- 部署:把新版本放上網路,讓大家看到更新後的網站。
- cache(快取):瀏覽器把網站檔案存一份在裝置上,下次打開比較快、離線也能用;副作用是可能一直用到舊版。
- commit:把一次修改存成一個版本紀錄。
- TypeScript:一種寫網頁程式的語言,會幫忙檢查資料型別寫錯的地方。
- Three.js:在網頁上畫 3D 畫面的工具。
- Blockly:用拼積木的方式寫程式的編輯器。
- IndexedDB:瀏覽器內建的資料庫,可以把資料存在使用者自己的裝置上。
- Cloudflare Workers:Cloudflare 提供的網站託管服務,這裡用的是免費方案。