Gemini CLI -> Antigravity CLI 遷移與對照 Checklist

概念一對一對照表

在開始搬遷工作流前，先看一下兩個命令列工具在專案設定與功能上的核心差異：

遷移 Checklist 與實務指引

1. 安裝與執行檔切換

舊版 @google/gemini-cli 是透過 Node.js npm 安裝；新版 Antigravity CLI 是以 Go 語言編譯的獨立執行檔，安裝方式非常簡單且不再依賴 Node.js：

# macOS / Linux
curl -fsSL https://antigravity.google/cli/install.sh | bash

# Windows (PowerShell)
irm https://antigravity.google/cli/install.ps1 | iex

完成後，您可使用 agy -v 進行確認。日常工作流中的指令請全面從 gemini [指令] 替換為 agy [指令]。同時，建議在您的專案根目錄下執行一次 agy init，這會引導您完成 CLI TUI 的互動式設定，用以配置預設的模型（如 gemini-3.5-flash）、色彩主題以及專案偏好。

2. 將 GEMINI.md 升級為 .agents/rules/

在舊版工作流中，我們透過 /init 產出 GEMINI.md，並把 PM 開發規範、PRD 風格與任務限制寫在裡面。在 Antigravity 體系中：

• 您可以直接在專案根目錄下建立 .agents/rules/ 資料夾，並在此處放置多個 Markdown 格式的規則檔案（例如 AGENTS.md、prd-style.md 等）。
• 新版 Agent 在啟動時會自動針對整個專案進行 Project Indexing，並完整讀取 .agents/rules/ 下的指示，無需每次執行手動初始化。
• (相容性小秘訣) 如果您有許多現成的 GEMINI.md，新版 Agent 也會主動向後相容讀取它，但長期建議將其重命名或移入 .agents/rules/AGENTS.md 以符合現代標準。

3. 導入舊有 Extensions 作為 Plugins

舊版 Gemini CLI 的 Extensions 可以無痛轉換為 Antigravity CLI 的 Plugins。官方提供了專屬的匯入指令：

# 匯入現有的 Gemini extensions
agy plugin import gemini

您也可以手動將客製化 Plugin 檔案移至本地專案的 .agents/plugins/ 或全域 ~/.gemini/antigravity/plugins/ 中，以便在 Agent 對話中調用。

4. 遷移 Custom Skills

以前我們寫的 Skills 會集中在使用者家目錄的全域資料夾。Antigravity 最強大的地方在於專案層級技能 (Workspace-local Skills)：

• 請在您的專案根目錄下建立 .agents/skills/ 資料夾。
• 將您為該專案量身打造的技能檔案（例如 prd_generator/SKILL.md）移入此處。
• 如此一來，任何打開此專案的人（或在 CLI 呼叫 agy 時），都可以直接使用這些本地技能，極大方便了團隊 SOP 的分發與 Git 版控管理。

5. 遷移 MCP Servers 設定

如果您原本在 Gemini CLI 串接了資料庫、Linear 或 Slack 的 MCP (Model Context Protocol) 服務：

• 請將全域的 MCP 設定搬移到：~/.gemini/antigravity/mcp_config.json。
• 如果是專案專屬的 MCP 服務，您可以直接在專案目錄下配置：.agents/mcp_config.json，讓您的工作區能被完美重現。

6. 善用 Agentic Slash Commands

新一代 Antigravity CLI 帶來了非常實用的 Agentic 斜線指令，能協助您執行更長、更複雜的工作：

• /goal：當任務需要深思熟慮且要多次重試時，使用 /goal 讓 Agent 自動跑完規劃、修改、測試與驗收全流程，不達目的絕不罷休。
• /browser：命令 Agent 啟動內部隔離瀏覽器，自動測試 localhost 網頁，並產出截圖或 action video。
• /schedule：排程執行定時任務或測試（類似 cronjob 的概念）。

快速搬遷示範

假設您有一個原本用 Gemini CLI 管理的需求分析專案，以下是典型的搬遷步驟：

1. 安裝新工具

   執行 curl -fsSL https://antigravity.google/cli/install.sh | bash 安裝 agy。
2. 重構規則設定

   在專案目錄下建立 .agents/rules/，將舊的 GEMINI.md 改名為 .agents/rules/AGENTS.md。
3. 搬移客製 Skills

   在專案內建立 .agents/skills/，將本機全域 ~/.gemini/gemini-cli/skills/ 底下的專案專用 skills 移動到此目錄。
4. 匯入擴充功能

   若有使用舊版擴充功能，在終端機執行 agy plugin import gemini。
5. 開始工作

   打開終端機，切換至該目錄，直接執行 agy 啟動對話或任務。

延伸閱讀與官方文獻

• 比較與選型細節：Google Antigravity IDE / CLI 是什麼？和 Cursor、Gemini CLI 差在哪？
• 新版命令列入門：Google Antigravity IDE 教學 (一)：環境建置、Agent Manager 與 CLI 更新
• 官方 Gemini CLI to Antigravity CLI 遷移指南
• Google Developers Blog 公告原文