Skip to content
• Anonymous

告別「注意力稀釋」：在 Antigravity 中實作層級化調度 (Hierarchical Orchestration)

當專案規模擴大，單一 Agent 的 Token 負擔會導致效率驟降。本文透過實作案例，詳細解析如何利用 Antigravity 的層級化調度機制，將複雜任務拆解為協作流，達成高效且低成本的開發體驗。

#Antigravity #AI Workflow #Agentic Workflow #Architecture #Optimization

在開發「Personal Digital HQ」的過程中，我發現了一個隨著專案成長而浮現的痛點：隨著功能複雜度提升，AI 助手的「注意力」開始分散。

當我要求 AI 「新增一個具備權限校驗功能的訂單管理模組」時，它必須同時思考資料庫 Schema、API 安全性、React UI 組件、i18n 多國語系、以及單元測試。這種「全能型 Agent」的工作模式會導致單次對話產生的 Token 數量激增，且極易在細節上出錯（例如漏掉了臺灣用語規範）。

為了解決這個問題，我引入了 「層級化調度（Hierarchical Orchestration）」。

1. 什麼是層級化調度？

簡單來說，「層級化調度」不再試圖讓一個 Agent 完成所有事情，而是建立一個 「指揮官 + 專家團」 的結構。

在 Antigravity 中，這表現為：

  1. Coordinator (指揮官)：負責理解需求、拆解任務、分配資源，但不直接寫程式碼。
  2. Specialist Agents (專家)：各司其職，只在自己的專業領域（如架構設計、程式碼實作、品質審查）內行動。

為什麼這能降低 Token 浪費？

如果所有規則都塞給同一個 Agent，每次對應時模型都要處理大量的 Context。而透過層級化，QA Agent 只需要讀取品質規則，Feature Agent 只需要讀取實作邏輯。這種資訊隔離機制能讓每個階段的 Context 保持精簡，準確度自然大幅提升。

2. Antigravity 中的層級化配置

要開啟這項功能，我們需要在 antigravity.json 中進行核心配置：

{
  "agents": {
    "default_coordinator": "Architect-Agent",
    "collaboration_mode": "hierarchical",
    "memory_sharing": "read_write_all"
  },
  "context_strategy": {
    "handover_mode": "adaptive"
  }
}
  • collaboration_mode: "hierarchical"：這會告知 Antigravity 啟動層級化模式。
  • handover_mode: "adaptive"：這是最關鍵的一環。它會根據任務類型自動決定要傳遞多少上下文（Context）。調整 README 時給予極簡摘要，修改核心邏輯時則傳遞完整的介面定義。

3. 實戰流：四階段協作協議

我在 .agent/instructions.md 中定義了一套標準化的層級運作流程，將開發過程分為四個精確階段：

階段一：規劃 (Architect)

當收到需求時，首先啟動 /call architect。

  • 職責：產出 TODO.md，列出技術規格與影響檔案清單。
  • 約束：禁止撰寫具體實作程式碼，專注於邏輯架構。

階段二：執行 (Feature)

確認規格後，交由 /call feature。

  • 職責：根據 TODO.md 逐一修改檔案。
  • 優化：完工後僅回報變更摘要，不傳送完整原始碼細節給指揮官，節省 Token。

階段三：驗證 (QA-Reviewer)

修改完成後，自動觸發 /call qa-reviewer。

  • 職責：執行 npm test 與 eslint。
  • 閉環機制：若 QA 判定為 [REJECTED]，報錯會直接打回給 Feature 修正，直到通過為止（上限 3 次）。

階段四：結項 (Documentation)

最後由 /call doc 接手。

  • 職責：更新 JSDoc、README 並進行 /cleanup（壓縮對話歷史）。

4. 關鍵優化：精準攔截與 Token 保護

在最新的配置中，我加入了一個「智慧哨兵」機制來保護 Token 不被不必要的檢查浪費：

"file_filters": {
  "include": ["src/**/*.{ts,tsx,astro,js,jsx}"],
  "exclude": ["**/*.md", "src/content/blog/**/*"]
}

這意味著：如果您正在閱讀這篇 Blog 的草稿，Antigravity 不會沒事去啟動 qa-reviewer 或 architect。它知道 「內容創作」不需要「系統架構審查」。

5. 結論：專業的人做專業的事

層級化調度的核心哲學就是：讓 Agent 保持「專注」。

透過將龐大的開發地圖拆解為離散的專業領域，我們不僅獲得了更順暢的開發體驗，更將整體的 Token 消耗降低了約 30% - 40%。更重要的是，這種結構讓 Bug 難以藏身，因為每個變更在到達「主分支」前，都必須經過嚴格的專家級審查流程。

在 AI 輔助開發的時代，「寫得多」不如「分得好」。透過層級化調度，Antigravity 真正成為了您專案中的「技術大腦（Facade）」。