四十九個 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,機會更大一些。這裡真正有意思的是,有人把組織架構寫下來了,包括專家必須往上求助然後等著的那部分。
相關文章
一份社群維護的點擊表,關掉了中國品牌 Android 系統裡的廣告
它不動系統,不解鎖,不刷機,只把廠商本來就留出來的開關一個個撥過去。代價是這份名單得一直有人續寫。
GPT Image 2.6 守住 token 價格,帳單卻變貴了
GPT Image 2.6 沿用 2.5 的全部 token 費率,每張圖卻更貴,因為更多工作現在花在輸出 token 上。上線十一天,定價結構說得比排行榜更多。
有人從外部重寫了 IDM,並寫下自己沒碰過的部分
Mister Download Manager 用 Rust 重寫了 Internet Download Manager 的下載流程,聲稱速度快 5 倍、支援 86 種語言。更值得細讀的,是它解釋如何在不複製任何程式碼的前提下完成重寫的那一段。
Rune 是一個 Rust UI 框架,設計初衷是讓 agent 能檢查自己的工作
Rune 能無頭繪製、匯出元素樹並接受腳本化輸入,這讓編碼 agent 拿到截圖永遠給不了的東西,一個可 diff 的訊號。這個框架仍是預先發布版,不接受 pull request。