Claude 怎麼協調其他 AI · CLI + File I/O 模式

不用 API、不用 MCP — 用 ~/Documents/agent-council/ 裡的 Markdown 檔案當作 agent 之間的「信封」

① 交代任務 ② 寫 briefing ⑤ 讀 answer ③ CLI 執行 (一行指令完成) ④ 寫入 answer.md (stdout 導向檔案) Developer 人類 · 給目標 + 執行 CLI 最後裁決 agent 的建議 Claude Coordinator · 總指揮 拆解任務 · 寫 briefing · 讀 answer · 綜合判斷 Anthropic Claude (opus / sonnet) ~/Documents/agent-council/ 一個普通資料夾 · agent 之間只透過這裡交換訊息 {agent}-briefing.md 📥 輸入 · Claude 寫 目標 / 關鍵檔案 / 風險點 {agent}-answer.md 📤 輸出 · Agent 寫 分析 / 建議 / code diff Codex Engineer · 專門寫 code 實作功能 · refactor 寫測試 · 修 bug (OpenAI GPT-5 後端) codex exec < briefing.md Gemini Analyst · 分析 + 研究 程式碼審查 效能評估 · 多方案比較 (Google Gemini 3 後端) gemini -p "..." < briefing.md Gemma4 Local Brain · 跑在自己電腦 隱私任務 · 背景批次 摘要 · 預處理過濾器 (Google Gemma 4 · 本機) ollama run gemma4:31b 🔑 核心概念：agent 之間用「檔案當信封」，不用 API、不用 network call 優點 · 斷線重跑不怕 · 可 git diff 看變化 · 人類隨時能介入審閱 · 適合跑 5+ 分鐘的長任務（API timeout 就廢了）

一個具體例子 (Refactor 任務)

  • ① 你跟 Claude 說：「幫我重構 auth 模組」
  • ② Claude 寫 codex-briefing.md：
      「目標：拆掉 auth.py 的嵌套 if / 關鍵檔案：auth.py、test_auth.py / 風險：別改 API 介面」
  • ③ 你貼一行 codex exec --full-auto < briefing.md > answer.md
  • ④ Codex 花 3 分鐘改完，把 diff + 說明寫進 codex-answer.md
  • ⑤ Claude 讀 answer，判斷「這個改法 OK / 有問題」後回報給你

為什麼不直接 API 叫 Codex？

  • 時間長 · refactor / 分析常跑 2-5 分鐘，API call 容易 timeout
  • Context 會爆 · 如果 Claude 把 Codex 的原始輸出塞進自己的 context，一次就吃光 token
  • 不可審閱 · API 回傳的字串看不到、改不了，出問題只能重跑
  • Agent 之間會互污 · 用 API 鏈 3 個 agent，錯誤訊息會互相污染難除錯
  • → 檔案解耦這一切

一條硬規則：禁止委託理解

  • Claude 讀完 answer.md 後必須自己消化
  • ❌ 不准寫「根據 Codex 的建議，請修 X」這種懶惰指令
  • ✅ 要改成「我理解 Codex 指出 X 是問題，因為... 所以決定修 Y」
  • 原因：Agent 是顧問，決策責任在 Claude + 你身上
  • 防止 agent 鏈變成「沒人真的懂」的責任漂移

Multi-Agent Coordination · Claude × Codex × Gemini × Gemma4 · CLI + File I/O Pattern