拒絕讓進度條卡死開發！Antigravity 子代理人 (Subagents) 實戰：打造「後景無感」的雲端資料庫同步架構

嗨，我是 Eric。時間來到 2026 年，如果你還在盯著終端機的進度條發呆，看著資料庫遷移（Migration）或同步（Sync）跑完才能繼續寫下一行 Code，那你真的該更新一下你的開發軍火庫了。自從 Google Antigravity 成為我們日常開發的 Agentic IDE 主力後，「單一代理人」（Single Agent）的線性工作模式已經無法滿足資深工程師的需求。誰想要等 AI 寫完 SQL 才能繼續修前端的 Bug？

這就是為什麼今天我們要聊 Antigravity 子代理人 (Subagents) 的進階應用。這不只是一個「多工」的概念，而是如何在開發環境中，利用主代理人（Main Agent）派發任務給子代理人，實作一個「完全後景化」的雲端資料庫同步系統。這套架構讓你在開發 WordPress 或 Laravel 專案時，地端資料庫與雲端（可能是 Neon Serverless 或 Supabase 2.0）之間的資料流動，完全不會佔用你的主開發線程。

為什麼你需要 Antigravity Subagents？

在 2024 年代，我們習慣用 VS Code 配合 Copilot，那時候我們是「駕駛」，AI 是「副駕駛」。但在 2026 年的 Antigravity 環境下，我們更像是「指揮官」。

然而，許多開發者在使用 Antigravity 時，常常犯一個錯誤：把所有任務都塞給同一個 Agent context。例如，你叫 Agent 幫你重構一段 WooCommerce 的結帳邏輯，同時又要它去同步 50 萬筆訂單資料到測試區的雲端資料庫。結果就是，Agent 的 Token 窗口被塞爆，推理速度變慢，甚至在等待資料庫回應時「卡住」，導致你無法繼續下達新的指令。

Subagents (子代理人) 的出現就是為了解決這個問題。它們是輕量級、任務導向的執行單元，擁有獨立的 Context Window 和執行緒。我們可以設計一個架構：

• Main Agent (指揮官)： 負責與你對話，處理核心商業邏輯與程式碼架構。
• Sync Subagent (苦力)： 專門負責資料庫 I/O，監聽地端變更並默默推送到雲端，出錯了自己重試，不用回報給指揮官（除非徹底失敗）。

架構設計：實作背景同步的雲端資料庫建置

我們要實作的場景是：當你在本地開發環境（Localhost）對 WordPress 資料庫進行操作（例如匯入新的產品資料或是修改了 Schema）時，一個背景運作的 Subagent 會自動偵測，並將這些變更同步到開發用的雲端資料庫，讓你的遠端協作隊友也能即時看到變更。

1. 定義 Subagent 的權限範圍 (Manifest)

在 Antigravity 專案根目錄的 .gravity/agents.yaml 中，我們需要定義一個專門處理資料庫的子代理人。這裡的關鍵是 isolation_level，我們要設為 background，這是 2025 年底 Google 推出的新屬性，允許 Agent 在背景「無頭」運行。

# .gravity/agents.yaml

agents:
  - id: "main_architect"
    role: "primary"
    capabilities: ["code_edit", "file_system", "terminal"]

  - id: "db_sync_worker"
    role: "subagent"
    isolation_level: "background" # 關鍵：背景執行，不佔用主對話視窗
    parent: "main_architect"
    trigger: 
      - event: "file_change"
        pattern: "**/*.sql"
      - event: "database_mutation"
        connection: "local_mysql"
    capabilities: ["database_connect", "api_request"]
    memory_limit: "2GB" # 限制記憶體，避免吃掉開發機資源

這段設定告訴 Antigravity：只要本地資料庫有變動，或者有 SQL 檔案被修改，就喚醒 db_sync_worker 這個子代理人。

2. 撰寫同步邏輯：Subagent 的大腦

雖然 Subagent 是 AI，但我們不能讓它每次都「重新思考」怎麼同步，那樣太慢且容易出錯。我們需要餵給它一段「標準作業程序」（SOP），這在 Antigravity 中稱為 Workflow Context。

我們在 WordPress 外掛目錄中創建一個專用的同步腳本，讓 Subagent 去執行。這裡我們用 PHP 來寫，因為這也是我們專案的原生語言。

<?php
// wp-content/plugins/gravity-sync/sync-handler.php

namespace Gravity\Sync;

class CloudSync {
    protected $cloud_endpoint;
    protected $api_key;

    public function __construct() {
        // 2026年我們通常從 Antigravity 的 Secure Vault 讀取憑證
        $this->cloud_endpoint = getenv('GRAVITY_CLOUD_DB_URL');
        $this->api_key = getenv('GRAVITY_SUBAGENT_TOKEN');
    }

    public function push_changes($table, $data) {
        // 模擬將資料推送到雲端 API
        $response = wp_remote_post($this->cloud_endpoint . '/sync/' . $table, [
            'headers' => [
                'Authorization' => 'Bearer ' . $this->api_key,
                'Content-Type'  => 'application/json',
                'X-Agent-ID'    => 'db_sync_worker' // 標記是由子代理人執行的
            ],
            'body' => json_encode($data),
            'blocking' => true, // 對 Subagent 來說是阻塞，對使用者來說無感
            'timeout' => 30
        ]);

        if (is_wp_error($response)) {
            // 這裡不僅是紀錄 Log，還要觸發 Antigravity 的 Alert Event
            do_action('gravity_agent_alert', 'Sync failed: ' . $response->get_error_message());
            return false;
        }

        return true;
    }
}

這段程式碼看起來很普通？重點在於誰去執行它。在傳統開發中，這可能會掛在 WP 的 save_post hook 上，導致你按更新文章時轉圈圈轉很久。但在 Antigravity 架構下，db_sync_worker 會監聽資料庫 Binlog 或 Hook 事件，然後在獨立的行程中執行這段 PHP，完全不影響你的操作體驗。

3. Subagent 的通訊協定：Agent RPC

最有趣的部分來了。如果同步失敗了怎麼辦？我們不希望 Subagent 直接在我們的 Terminal 噴錯，這會打斷我們寫 Code 的心流（Flow）。Antigravity 2.6 引入了 Agent RPC (Remote Procedure Call) 機制。

我們可以設定 Subagent 在遇到「無法解決的衝突」時（例如雲端資料庫被鎖定，或 Schema 嚴重不合），才向 Main Agent 發送訊號。這時，Main Agent 會優雅地在你的 IDE 側邊欄彈出一個通知：「嘿 Eric，雲端同步有點問題，要我現在修復它，還是稍後再說？」

這就是我要強調的「主動性」與「干擾控制」。

// .gravity/workflows/error-handling.js

// 當子代理人發出 'sync_critical_error' 時觸發
antigravity.onEvent('sync_critical_error', async (payload) => {
    const decision = await antigravity.ui.askUser({
        title: "雲端同步衝突",
        message: `子代理人回報資料表 ${payload.table} 同步失敗。`,
        options: ["忽略", "強制覆蓋雲端", "查看 Diff"]
    });

    if (decision === "查看 Diff") {
        // 喚醒主代理人進行深度分析
        await antigravity.agents.get('main_architect').executeTask('analyze_db_diff', payload);
    } else if (decision === "強制覆蓋雲端") {
        // 指揮子代理人重試
        await antigravity.agents.get('db_sync_worker').executeTask('force_push', payload);
    }
});

進階技巧：利用 Subagent 進行資料「預熱」

除了同步，我最近還發現一個超好用的技巧：資料預熱 (Data Warming)。當我在本地開發一個複雜的 WooCommerce 報表頁面時，我可以先叫 Subagent：「嘿，去幫我生成 10 萬筆測試訂單，要符合常態分佈，每筆訂單間隔 5 分鐘。」

以前這需要寫 Seeders 然後跑半天。現在，Subagent 就在背景默默生成 SQL Insert，而我可以繼續寫前端的 Vue.js 元件。等到我前端寫好，切換到瀏覽器一看，10 萬筆資料已經在那裡等我了。這種「零等待」的開發體驗，一旦習慣了就真的回不去了。

資深工程師的忠告

引入 Subagents 雖然強大，但也有幾個坑要小心：

1. 資源控管： 雖然是背景執行，但如果開太多 Subagents，你的 Mac mini M4 還是會發燙。記得在 YAML 檔中設定 concurrency_limit。
2. 資料競爭 (Race Conditions)： 確保你的同步邏輯有處理樂觀鎖（Optimistic Locking），否則背景 Agent 和你的手動操作同時修改同一筆資料時，會發生慘劇。
3. Token 成本： Subagent 也是會消耗 API Token 的。如果是重複性的簡單邏輯，盡量寫成固定的 Shell Script 或 PHP 讓 Agent 呼叫，而不是讓 Agent 每次都用 LLM 去生成邏輯。

Antigravity 的強大在於它不僅僅是一個 IDE，它是一個數位團隊的指揮中心。善用 Subagent，你就不再是一個人在戰鬥，而是一個帶著一群專業工兵的架構師。

延伸閱讀

想更深入了解 Antigravity 的應用，建議參考以下幾篇深度文章，這能幫助你建立更完整的 AI 開發思維：

• Google Antigravity 賦予 AI 「上帝視角」？資深工程師教你配置 3 道防線，杜絕 Agent 誤刪專案的慘劇
• 一個人抵一個團隊？Google Antigravity 多代理人（Multi-Agent）開發工作流實戰：從架構設計到自動部署
• AI 寫 Code 不只是自動補全！Antigravity『任務導向』開發實戰：讓 AI 幫你規劃、實作、驗證一條龍