跳至主要內容

給 Antigravity 使用者

Antigravity 運行代理。
Maguyva 給它們地圖。

Antigravity 是代理優先的 IDE：代理會跨編輯器、終端機與瀏覽器進行規劃與修改。在真正的 monorepo 上，它們仍然需要一張地圖，才知道哪個檔案才是重點。Maguyva 會為你的程式碼庫建立索引，並透過 MCP 回傳（語意、AST、圖譜與文字），所以「驗證邏輯在哪裡發生」這個問題，得到的會是真正的驗證流程，而不是七個測試 mock。

免費開始閱讀 Antigravity 設定說明

Free 方案：3 個儲存庫, 最多 5 萬行索引儲存庫行數，免信用卡。

Antigravity 運行代理。Maguyva 告訴它該碰哪個檔案。

每一層各自負責什麼

四個部分，各司其職。

// 代理 IDE

Antigravity

你的代理在這裡規劃、修改與驗證。

// 手動脈絡

@ mentions + 規則

手動提供脈絡在程式碼庫夠小時很好用，直到規模變大。

// 程式碼庫

Maguyva

透過 MCP 自動提供程式碼庫事實。

// 誰付費

以工作區計費，而非席位

代理不需要付席位費。查看價格

Antigravity 運行代理，就放手讓它做。

代理 IDE 本身不是問題。Agent Manager、跨介面執行，以及規則檔案都非常出色，你也已經在用它們來做：

  • 跨編輯器、終端機與瀏覽器規劃並運行代理。
  • 當變更範圍侷限於單一區域時，進行多檔案修改。
  • 用代理規則定義程式碼庫慣例與風格規範。
  • 用 @-mentions 把特定檔案拉進脈絡中。

繼續這樣做，這些都不會消失。

但在真正的 monorepo（有工作區依賴的 TypeScript、Python 服務、混合套件）中，只要相關檔案還沒進入代理的視野，代理的脈絡就會出問題。

你已經試過的手動解法，以及它們會在哪裡失靈

四種手動解法，各自搭配對應的失效模式。左邊＝你現在的做法。右邊＝它會在哪裡出問題。

// the fix

// 提及檔案

你用 @-mention 標出你認為重要的三個檔案。代理能在裡面乾淨地修改。

// where it breaks

// 提及只是猜測

這只有在你已經知道涉及哪些檔案時才有用。自主代理需要的，正是那些你根本不知道該提及的檔案。

// the fix

// 貼上程式碼片段

你把另一個套件裡的 200 行程式碼貼進代理，好讓它有足夠的脈絡。

// where it breaks

// 貼上的程式碼會過時

你早上 9 點貼上的片段，反映不出隊友在 11 點完成的 rebase。代理正在對著這個套件的幻影版本進行修改。

// the fix

// 寫一份脈絡文件

你寫了一份代理規則檔案或架構說明文件。今天它是對的。

// where it breaks

// 文件過時的速度比程式碼快

任何手寫的東西都會過時。程式碼才是真相來源。一份說明佇列架構的文件，可能只對了一週，之後就永遠錯了。

// the fix

// 保留規則檔案

你新增代理規則來規範命名、lint 與建置指令，對於行為規範很有效。

// where it breaks

// 規則 ≠ 索引

規則很適合放 “commit 前務必先執行 pnpm tsc -b” 這類內容。但它們並不是一份可查詢的索引，涵蓋不了你 monorepo 裡每一個符號、檔案與呼叫點。

Maguyva 是底層的那一層

它不是要取代 Antigravity，而是掛載在它的 MCP 支援上、負責程式碼庫脈絡的那一層。

  • 語意 + AST + 圖譜 + 文字 依意義、結構、依賴關係或字面搜尋。每一筆結果都會回傳檔案路徑與行號。
  • 預設跨套件 涵蓋 monorepo 中每個套件的呼叫點與匯入者，不只是代理目前開啟的那一個。
  • 感知分支 Maguyva 看得到代理正在編輯的那個程式碼版本。
  • 為自主性而生 一個會規劃大量修改的代理，需要事先知道影響範圍，而不是等 CI 變紅才發現。

Antigravity 決定要修改什麼。

Maguyva 告訴代理這次修改會影響到什麼。

三種 monorepo 工作流程

跨套件、跨語言，紮根於真實的呼叫圖，而不是代理的 grep。

// workflow 01

在不提及任何檔案的情況下，找出跨套件的驗證流程

agent> 這個 monorepo 裡，驗證邏輯發生在哪裡？

graph::query("驗證流程")
  packages/web/src/auth/session.ts:42       中介層
  packages/api/src/auth/jwt.ts:88           權杖驗證
  packages/shared/src/auth/types.ts:12      AuthContext
  packages/admin/src/auth/admin-only.ts:31  RBAC 閘門

→ 4 個進入點，橫跨 4 個套件，依呼叫點密度排序。
[exit 0]

你沒有提及檔案，也沒有貼上程式碼片段。代理已經拿到那四個真正重要的檔案，排序正確，可以做出紮根的修改。

// workflow 02

找出真正的實作，而不是測試 mock

agent> normalizePhoneNumber 是怎麼處理 E.164 格式的？

semantic::query("正規化電話號碼 E.164")
  packages/shared/util/phone.ts:88     normalizePhoneNumber()  ← 真正的實作
  packages/api/test/phone.spec.ts:14   jest.mock(...)          ← mock
[exit 0]

名字會騙人，mock 會掩蓋真正的程式碼。Maguyva 會在每個套件中，把真正的實作排在測試 mock 之前。

// workflow 03

在代理重構之前，先確認影響範圍

agent> 這個 monorepo 裡，誰呼叫了 QueueDispatcher.publish？

graph::callers(QueueDispatcher.publish)
  packages/billing/* 中有 3 筆
  packages/audit/* 中有 1 筆
  packages/notifications/* 中有 1 筆
  services/python-worker/* 中有 1 筆  ← 跨語言，透過 gRPC stub
[exit 0]

跨套件，遇到多語言程式碼庫時也跨語言，呼叫點會直接顯示在結果中。自主代理會在動手修改前就知道影響範圍，而不是等 CI 變紅才發現。

在 Antigravity 中設定

三個步驟。Free 方案：3 個儲存庫, 最多 5 萬行索引儲存庫行數，免信用卡。

  1. // step 01

    在 maguyva.ai 索引一個程式碼庫

    挑一個讓你最深刻感受到脈絡痛點的 monorepo。

  2. // step 02

    在 Antigravity 中把 Maguyva 加為 MCP 伺服器

    // ~/.gemini/antigravity/mcp_config.json
{
  "mcpServers": {
    "maguyva": {
      "serverUrl": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer <your-key>"
      }
    }
  }
}

  3. // step 03

    問一個你已經知道答案的問題

    不要一開始就把代理指向整間公司的規模。從一個程式碼庫、一個可驗證的問題開始，例如「跨套件有誰呼叫了 formatInvoice？」

自助註冊，隨時開放。

索引一個你已經熟悉的程式碼庫。

測試一個你能自行驗證答案的問題。

索引您的第一個儲存庫查看相容性文件

Free 方案：3 個儲存庫, 最多 5 萬行索引儲存庫行數，免信用卡。