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

Canonical source: https://maguyva.ai/zh-hant/for-antigravity

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

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

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

## 每一層各自負責什麼

四個部分，各司其職。

### Antigravity

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

### @ 提及 + 規則

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

### Maguyva

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

### 以工作區計費，而非席位

代理不需要付席位費。[查看定價](https://maguyva.ai/zh-hant/pricing)

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

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

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

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

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

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

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

### // 提及檔案

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

### // 提及只是猜測

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

### // 貼上程式碼片段

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

### // 貼上的程式碼會過時

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

### // 寫一份脈絡文件

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

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

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

### // 保留規則檔案

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

### // 規則 ≠ 索引

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

## Maguyva 是底層的那一層

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

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

> Antigravity 決定要修改什麼。
> Maguyva 告訴代理*這次修改會影響到什麼。*

## 三種 monorepo 工作流程

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

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

```text
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]
```

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

### 02. 找出真正的實作，而不是測試替身

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

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

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

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

```text
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 萬行儲存庫程式碼，免信用卡。

### 01. 在 maguyva.ai 索引一個儲存庫

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

### 02. 在 Antigravity 中把 Maguyva 加為 MCP 伺服器

`~/.gemini/config/mcp_config.json`

```json
{
  "mcpServers": {
    "maguyva": {
      "serverUrl": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}
```

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

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

## 索引一個你已經熟悉的儲存庫。

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