AIGD · 協調器
AIGD = AI 遊戲設計。一個可攜帶的 AI 遊戲開發方法論套件:涵蓋腦力激盪 → 系統設計 → 遊玩測試迭代 → 最終化與交接,產出一個交接套件(與平台無關),讓「另一個 AI 可以直接據以開發」;落地實作(選擇技術棧來撰寫客戶端/伺服器)不在此套件中,留給未來專用的落地技能。
狀態:v0(預發行版) — 已通過端到端驗證(真實執行示範 + 儲存庫 README 中的可執行
examples/逐步教學)。patterns/是一個持續成長的入門包(請參閱references/README.md)。
核心模型(詳細內容請參閱參考資料)
- 兩層結構:① 即時專案層(主幹) —
專案計畫書(概念/平台/目標使用者/類型/風格/命名慣例)+清單(系統列表 + 相依圖 + 跨層索引 + 凍結帳本 + 數字範圍註冊表),持續修訂;② 每個系統的生產迴圈。 - 集中式事實來源:列舉/編號/介面合約/設定表屬於專案層;雙重副本(系統 + 全域):驗收條件/資源需求/原型;僅限系統層:規則/後端演算法。
- 每個操作:讀取主幹 → 執行工作 → 寫回主幹。下層發現(新系統/新相依/新列舉/變更概念)會寫回上層。
- 方法論的事實來源:
references/methodology.md、references/README.md。
路由:根據「你這次想做什麼」分派子技能
| 你想做什麼 | 子技能 |
|---|---|
| 概念/核心迴圈/平台/目標使用者/拆分為系統 | aigd-concept |
| 設計一個系統(規則 + 設定測試資料 + HTML 原型) | aigd-system |
| 在遊玩測試後最佳化系統(規則/設定/原型,可重複) | aigd-iterate |
| 最終化系統 → 合約/驗收條件/客戶端-伺服器文件/設計師面向的驗收檢查清單 | aigd-handoff |
| 同步回全域規格/整體原型/實作主指南;在共用項目變更時標記需重新檢查 | aigd-sync |
| UI 截圖 → UI DSL(建立 UI 範式知識庫,供設計時檢索與參考) | aigd-ui-capture |
使用方式
- 先讀取主幹(專案計畫書 + 清單)以判斷:專案已進行到哪一步、這次系統的狀態為何、還缺少什麼。
- 沒有主幹 → 先用
aigd-concept啟動專案(建立主幹)。 - 選擇匹配的子技能並使用 Skill 工具呼叫執行;每個子技能讀寫相同的主幹,保持其一致性與可重入性(可跨工作階段/由另一個 AI 接續處理)。
- 典型路徑:概念(一次)→ 每個系統 {系統 → 迭代…(重複)→ 交接最終化} → 同步(持續)。迭代不會直接進入同步 — 同步的准入條件是系統狀態必須為
Final,且只有交接可以最終化;順序不強制執行,請按需路由。
當沒有主幹時(首次在專案上使用,
專案計畫書/清單還不存在):「讀取主幹」會得到空結果 → 直接路由到aigd-concept來啟動主幹;這是正常情況,不是錯誤。
進入時自我檢查(每次進入 /aigd 時執行 — 主動推進,不要等待使用者猜測)
- 主幹是否存在? 是 → 讀取
project-charter.md+manifest.md;否 → 路由到aigd-concept啟動專案。 - **哪些系統的狀態 ≠
Final?**列出它們,詢問使用者這次要推進哪一個。 - **有
Recheck系統嗎?**提醒先重新檢查(某個共用項目變更了)→ 路由到aigd-sync來解決(重新檢查通過 → 回到Final/ 失敗 → 彈回)。 - **數字範圍衝突 / 相依圖中有循環?**檢查並回報。
狀態轉換(非線性 · 可回退)
概念 ──→ 系統設計 ⇄ 遊玩測試迭代 ──→ 最終化 ──→ 整合
▲ │ │ │(彈回)
│ │ │ ▼
│ └─邊界繪製錯誤──┴────→ 回到遊玩測試 / 回到概念
└────────── 整合發現不相容 / 需要重新拆分 ───────────────────┘
- 任何彈回/重新拆分都會在清單的「回退日誌」中記錄一條記錄,並根據「彈回規則」反向查詢
depended-on-by,將已完成的相依下游系統標記為Recheck(請參閱aigd-handoff/aigd-sync)。 - 範本:
references/templates/(專案計畫書/清單/實作主指南,強型別)。
套件結構(安裝整個套件,不要拆分)
aigd(此協調器,包含 references/ 方法論與範本) + 6 個子技能 aigd-concept / system / iterate / handoff / sync / ui-capture,安裝在此環境技能目錄的同一層級(遵循主機代理,例如 Claude Code 的 .claude/skills/)。子技能本體使用 ../aigd/references/ 來獲取方法論 → aigd/ 必須存在於同一層級(aigd-ui-capture 同樣透過 ../aigd/references/ui-dsl-spec.md 和 scripts/)。單一事實來源,不要分別複製;如果之後想獨立發佈,請升級為外掛程式(請參閱 references/README.md「包裝與可攜性」)。
專案環境建議
- 建議將主幹檔案(
專案計畫書/清單)與設計產出物置於 Git/SVN 版本控管之下;協調器應在每次操作前檢視版本狀態。 - CHANGELOG(變更帳本)輔助版本控管:版本控管記錄「變更了什麼」,CHANGELOG 記錄「為什麼 + 哪個模型」(此方法論是 AI 輔助流程,記錄模型有助於追溯變更來源)。
邊界
- 範圍止於「一個 AI 可以直接據以開發的交接套件」(與平台無關:規則/合約/設定/驗收條件/原型/資源需求)。
- 技術棧選擇與客戶端/伺服器實作 = 下游,不在此套件中。