← 返回部落格
Ai預計閱讀 9 分鐘

四十九個 agent、七十四個 skill,和一間先問再動手的遊戲工作室

發布於 2026年11月8日
四十九個 agent、七十四個 skill,和一間先問再動手的遊戲工作室

這個月的 GitHub 週榜上,很多倉庫都在幫 Claude Code 套一層更好看的介面。Donchitos/Claude-Code-Game-Studios 做的事沒那麼時髦:它給這個工作階段配了一張組織架構圖。倉庫是範本,不是應用程式。clone 下來,在根目錄開啟 Claude Code,助理就繼承了一套歸檔規則、一套關於誰能決定什麼的規定,以及 74 個斜線指令。一週漲了約 5,700 顆星,現在是 36,845。

標題數字是 49 個 agent、74 個 skill、15 個 hook、14 條規則、62 個文件範本。agent 數量是最容易灌水的東西,所以這個數字反而是最沒意思的部分。值得讀的是難造假的那部分:一套帶往上呈報路徑的委派模型,以及會檢查 subagent 是否真的照做的 hook。

三層結構,每一層都有理由

49 個 agent 是照工作室的方式排的。

第一層是三個總監:creative-director、technical-director 和 producer。第二層是部門主管:game-designer、lead-programmer、art-director、audio-director、narrative-director、qa-lead、release-manager 和 localization-lead。第三層是三十來個專家,涵蓋玩法、引擎、AI 與網路程式設計、關卡與經濟設計、技術美術、音效設計、寫作、世界觀、UX、原型、效能、DevOps、分析、安全、QA、無障礙、live ops 和社群。

它們之間怎麼說話,README 裡寫得很清楚,比多數多 agent 方案都嚴:

只能縱向委派,總監到主管,主管到專家。允許橫向諮詢,但同層 agent 不能跨領域做有約束力的決定。有分歧就往上呈報到共同的上一層,設計上的爭論歸 creative-director,技術上的歸 technical-director。跨部門改動走 producer。任何 agent 沒有明確委派,不得改自己領域之外的檔案。

最後這條是實戰裡最要緊的。多數多 agent 的失敗出在範圍,不在推理:一個被叫去修燈光 bug 的 agent,順手把存檔系統重寫了。把領域邊界寫下來,再由必須走委派流程的主管執行,這個辦法粗糙,但有用。

模型分級是一筆預算帳

每個 agent 在 frontmatter 裡宣告模型。三個總監要 Opus。lead-programmer 和十五個專家指定 Sonnet。剩下三十個繼承你目前工作階段跑的模型。

README 在這件事上直白得少見:把這些層級當成角色的資歷,別當成帳單,因為工作室大部分跑在你已經有的模型上。這是 agent 框架談成本時比較誠實的說法。實際支出是一個工作階段,加上少數幾次 Opus 呼叫,用在會決定後面一切的那個決策上,這筆錢花得不冤。

hook 到底在查什麼

十五個 hook 掛在工作階段事件上。有兩個值得點名。

`log-agent.sh` 和 `log-agent-stop.sh` 在 subagent 啟動和結束時寫稽核日誌。這是記帳,成本很低。

`validate-agent-artifact.sh` 才有意思。它在 agent 停止時觸發,如果這個 subagent 從來沒寫出任務書裡點名的檔案,就發出警告。這個檢查很小,針對的是一種具體故障,跑過平行 agent 的人都遇過:subagent 回報成功,編排者往下走,檔案根本不存在。在 stop 事件上抓是對的,因為那是上層還留著脈絡、可以重新派發的最後一刻。

其餘 hook 涵蓋 commit、push、資源變更、設計文件讀寫、註冊表和 session 生命週期。可選工具缺失時,hook 會安靜降級,只有一個例外是故意的:暫存了資料 JSON 的 commit,在沒有 Python 時會被攔下,因為驗證器跑不起來。

需求清單裡藏著坑

安裝是 README 裡的四行,其中一行是警告。

git clone https://github.com/Donchitos/Claude-Code-Game-Studios.git my-game
cd my-game
claude

然後輸入 `/start`。系統會問你現在處在哪個階段,從完全沒頭緒到已經有專案,然後把你導到一條工作流程上。也可以直接跳到 `/setup-engine godot 4.7`、`/brainstorm` 或 `/project-stage-detect`。

那句警告是:請在放著 `CLAUDE.md` 和 `project.yaml` 的資料夾裡啟動 Claude Code。在 `src/` 裡啟動,專案的 hook、deny 規則和先問再做的模式全部都會被跳過。你拿到的是一個沒有任何結構的助理,而且沒有任何提示。

相依項目是 Git、Claude Code(建議用原生安裝器,`npm install -g @anthropic-ai/claude-code` 在 Node 22+ 上也能用)、Python 3 和 Bash。Python 3 並不像看起來那樣可有可無:每個 skill 和 hook 都要透過它讀 `project.yaml`,沒有 Python,所有設定會默默退回預設值。默默退回比直接崩掉更糟,因為工作室帶著錯的設定繼續跑,直到某條規則該觸發卻沒觸發才有人發現。jq 建議裝上,用於 hook 驗證。

主要開發環境是 Windows 10 加 Git Bash,hook 也在 macOS 內建的 bash 3.2 和 Linux 上測過。`notify.sh` 在 Windows 上用 PowerShell 發系統通知,在其他平台什麼都不做,所以桌面通知目前只有 Windows 有。

九個引擎專家,你只需要其中一個

範本為 Godot 4、Unity 和 Unreal Engine 5 各帶一套 agent。每套一個 lead 加幾個子專家:Godot 是 GDScript、shader 和 GDExtension;Unity 是 DOTS/ECS、shader 與 VFX、Addressables 和 UI Toolkit;Unreal 是 GAS、Blueprints、replication 和 UMG/CommonUI。

三套都留在同一個倉庫裡是合理的對沖,代價是倉庫裡裝了大量你永遠不會載入的文字。README 的客製化章節自己說,用不到的 agent 檔案就刪掉,這建議是對的,也是沒有人會做的活。

與自主無關的那部分

README 明說這東西不是自動駕駛,協作協議也撐得住這個說法。agent 提議前先問。它們給兩到四個選項,附上取捨。由使用者決定。定稿前先給草稿。沒有確認就不寫任何東西。`guided` 和 `autonomous` 模式會拿掉一部分確認來換速度,README 指向自己的安裝文件,講怎麼進自動模式。

框架本身還有一套測試裝置。`studio-tests/` 把 74 個 skill 和 49 個 agent 編成目錄,每個類別各有評分量表和行為規格,`/skill-test` 跑靜態 linter,含七項合規檢查,也可以跑類別量表或規格斷言。`/skill-improve` 跑測試、修復、複測的循環,分數沒漲就回滾。把框架和遊戲分開測,是讓改框架這件事還能做下去的前提。

這東西到底是幹什麼用的

README 在一個小標題裡問了自己一個尷尬問題:它產出的是遊戲,還是文件?一個自帶 62 個文件範本、每個里程碑都有閘門的範本,賭的是個人開發死在流程上,不是死在程式碼上。這個賭注站得住。AI 協助的個人專案,常見的翻車方式是一個沒人記下來的硬編碼魔數、一份描述著三個版本前那款遊戲的設計文件、一個帶著壞掉的新手引導送出去的建置,只因為沒人跑冒煙檢查。

49 個 agent 解決不了這些。一條在玩法程式碼被改動時觸發的路徑規則、一個建置前必須跑的 `/smoke-check`、一個在驗證器跑不起來時攔下 commit 的 hook,機會更大一些。這裡真正有意思的是,有人把組織架構寫下來了,包括專家必須往上求助然後等著的那部分。

相關文章