Codex 遊戲開發 8 項 Skill

Haosen 的原文以開發問題區分 8 項 Skill，包含玩法、程式實作、介面與動作回饋。這些技能來自 7 個儲存庫，主要交付工作方法、參考文件、範本與檢查步驟；安裝後仍需由 Codex 讀取專案、修改程式並執行驗收。

先決定遊戲執行於瀏覽器、Unity 或 Unreal，再選擇目前問題所需的技能。一次限定一個系統或一個畫面，完成檢查後再移交下一項工作。

適用於玩法尚未確定、玩家忽略某種選擇，或團隊對試玩結果有不同解釋時。技能要求區分直接觀察、玩家回報與設計者假設；MDA 等框架用來分析特定問題，不能代替玩家證據。

輸出檔案為 game-design-hypothesis.json。隨附的 references/hypothesis-example.json 提供範例，scripts/validate-design-hypothesis.py 檢查資料契約；通過檢查只代表欄位與內容邊界符合規格，仍需試玩才能判斷假設。

驗收時，設計者能指出哪項觀察會推翻原假設，原型也能獨立切換控制版與變更版。缺少反證，或同時改變速度、獎勵與預警時機，應先縮小比較範圍。

適用於從空白專案建立可玩的網頁遊戲。簡單的 2D 原型可先使用 Canvas；需要 3D 場景時，再依需求選擇 Three.js 等框架。

主流程為讀取輸入、更新狀態、繪製畫面；文件建議以 requestAnimationFrame 驅動循環，並使用時間差處理移動。assets/ 提供起始範本，references/ 分別說明網頁 API、碰撞、控制與發布。

從開始進入遊玩，觸發失敗後重開，分數、障礙與輸入狀態均須重設。若切回分頁後遊戲突然加速、重開後重複計分，先檢查時間差與循環生命週期，再調整視覺效果。

適用於已選定 Unity 或 Unreal、需要修改具體系統的工程。參考檔分別包含 references/unity-patterns.md、references/unreal-cpp.md 與 references/performance-optimization.md；只載入目前引擎與問題需要的內容。

技能要求頻繁生成的物件使用物件池、遊戲邏輯使用狀態機，並定期分析 CPU、GPU 與記憶體。文件中的 60+ FPS 為效能目標，應依目標硬體、畫面設定與壓力場景重新訂定驗收條件。

驗收需在目標裝置或對應引擎執行。程式碼能編譯，無法證明場景切換、物件重用或多人連線已正常運作。

適用於血量、技能冷卻、危險提示與任務目標互相爭奪畫面空間時。先提供現有畫面、玩家目前的任務與目標裝置，再決定常駐資訊、情境提示與可展開內容。

主檔將建立工作導向 references/patterns.md，診斷導向 references/sharp_edges.md，審查導向 references/validations.md。複製技能時保留整個參考目錄；只有主檔會缺少這些工作依據。

驗收時，玩家須能在對應遊戲狀態中辨識重要資訊。截圖可檢查資訊層級；暫停、切換選單與關閉提示仍需互動測試。

適用於介面在手機被裁切、超寬螢幕位置錯誤，或手把能打開選單卻選不到按鈕的情況。技能處理共通架構，具體節點、元件與樣式仍需配合引擎 UI 技能。

畫面開啟時需指定初始焦點，選單以推入與返回管理輸入歸屬。HUD 訂閱 health_changed、score_changed 等事件，避免每一幀重新讀取遊戲內部資料；初始化時也要顯示目前狀態。

驗收需實際走完選單路徑，確認焦點可進入、移動與返回。縮放畫面後，主要按鈕須保持可見且可操作；只測滑鼠不能證明手把導覽可用。

適用於已使用 Three.js 的網頁遊戲。references/ui-patterns.md 要求介面共用單一狀態來源；UI 送出操作意圖，避免在介面層重寫遊戲規則。

只有手機為目標裝置時才加入手機控制。觸控除了按下事件，也需處理 pointercancel、lostpointercapture 等取消情況，避免角色在手指離開後持續移動。

驗收包括重開後沒有舊分數、選單不遮住下一個決策，以及所有按鈕有可辨識的焦點與停用狀態。美術介面能顯示，仍需確認操作確實改變遊戲狀態。

適用於碰撞、命中或拾取已正確發生，但玩家感受不到回應的情況。先確認 on_hit 等事件存在，再挑選少量回饋通道；錯誤的碰撞或扣血邏輯應先修正。

震屏應作用於相機或視覺偏移，避免改變碰撞物件。命中停頓需用不受遊戲時間縮放影響的計時方式恢復，並處理重疊事件；效果應衰減，且不能阻斷下一次操作。

驗收需重複操作與連續觸發，觀察回饋衰減、輸入與恢復狀態。單張截圖無法驗證時間尺度或連續輸入。

適用於已決定使用 Higgsfield 平台、需要其範本與房間機制的遊戲。開始前準備 Higgsfield CLI、帳號、Git 與 Bun，確認帳號狀態及生成服務的額度與費用。

官方遊戲流程使用下列入口。--category 必須為遊戲類型；範例的子網域需改成尚未使用的名稱。舊的 higgsfield game 指令已移出現行流程。

建立後先讀取範本的 app/AGENTS.md。app/src/logic.js 的 6 個匯出為 meta、setup、validateAction、applyAction、isGameOver 與 viewFor；輸入合法性由 validateAction 檢查，玩家可見資料由 viewFor 決定。

在專案的 app/ 執行檢查；依官方流程，規則檢查、測試與建置分別使用下列命令。

higgsfield website deploy 會部署可公開存取的遊戲；higgsfield website publish 另外將作品列入社群。刊登前需填寫 app/src/app-meta.json 的標題、說明與封面等欄位。要驗證多人房間，使用相同房間路徑開啟多個瀏覽器分頁，並測試非法操作與資料可見範圍。

不同來源的外掛安裝命令分別面向 GitHub Copilot、Claude Code 或 Antigravity，不能直接視為 Codex 命令。手動取用時，以包含 SKILL.md 的資料夾為單位，連同 references/、scripts/ 與 assets/ 等實際存在的子目錄一起保留。

遊戲技能庫的安裝文件列出 Codex 的專案目錄 .agents/skills/ 與使用者目錄 ~/.agents/skills/。專案限定的做法如下；使用前先檢查檔案與腳本，遇到同名目錄時先比較內容並備份，避免直接覆寫。

1. 取得所選儲存庫，記錄使用的 commit，找到上表的技能目錄。

2. 將選定技能的整個目錄複製至專案 .agents/skills/，保持技能名稱與內部相對路徑。

3. 在新的 Codex 工作階段檢查 /skills 是否列出技能，再於任務中明確指定名稱。若未被辨識，直接提供本機 SKILL.md 路徑讓 Agent 讀取，並檢查宿主的載入設定。

4. 要求 Agent 先讀主檔及本次任務需要的參考檔，再回報改動範圍與驗收方法。文件中的其他技能名稱，需有相對應檔案才能載入。

此案例限定一關瀏覽器 2D 遊戲，先使用簡單圖形。各階段使用同一份規則、狀態及驗收清單，避免每換一項技能就重寫整個專案。

若加入手機或手把，以 game-ui-ux 檢查版面、焦點與輸入切換；已改用 Three.js 時，再加入 threejs-game-ui-designer。Unity／Unreal 的實作階段改用 game-developer；採用 Higgsfield 時，依其範本契約重新確認實作位置。

本例可把桌面 1440 px 與手機 390 px 設為候選檢查尺寸，並依實際玩家裝置補充尺寸與輸入設備。這是案例的驗收設定，不能代替引擎或其他遊戲的裝置需求。