Gemini CLI 退場升級為 antigravity Gemini 配置與 Skill 遷移 agy

AI Agent 遷移 是指將舊版 Gemini 代理設定升級為新一代 Antigravity (簡稱 agy) 架構的過程。由於 Google 宣布 Gemini CLI 即將迎來終止服務 (Sunset)，為了確保專案內的自動化優化工作流不受影響，我們必須進行平台轉移。新一代的 agy 提供了更靈活的 Workspace Customizations 專案自訂機制，能將規則檔與 Skill 標準化儲存於 .agents 中。本篇指南將以三步驟示範完整遷移流程：第一步是安裝與環境變數設定，第二步是認證與初始化，第三步是專案目錄遷移與配置更新。

可以參考之前的 AI Agent Skill 實戰，了解更多關於本地代理優化寫作的背景。

一、 安裝與環境變數設定

為什麼需要遷移？ Gemini CLI Sunset 的背景

Google 官方已於近期發布 Gemini CLI 的終止服務通知 (Sunset)。Antigravity 平台與其 agy 命令列工具（CLI）是 Google 專為新一代 AI 協同開發所推出的官方指定繼任者。 為了避免服務中斷，並享受到更快速的 TUI (Terminal User Interface) 交互體驗，開發者需要儘速將現有的工作區設定進行轉移。

在 Windows 環境下，我們可以開啟 PowerShell 並執行官方提供的安裝指令：

1

irm https://antigravity.google/cli/install.ps1 | iex

解決 PATH 變數未即時生效警告

在安裝過程中，可能會在主控台看見以下警告訊息：

1
2

Warning: C:\Users\break\AppData\Local\agy\bin is not present in your active Environment PATH.
Please restart your active terminal session, or add it manually if needed.

雖然安裝程式已成功將 agy.exe 放置於使用者的 AppData 目錄下，且在 Windows 註冊表中寫入了使用者層級的 PATH，但當前執行中的 PowerShell 視窗並不會即時收到環境更新廣播。

此時如果直接執行 agy 會發生找不到指令的錯誤。為了不重啟視窗以保留終端機的對話歷史，我們可以使用以下 PowerShell 指令重新載入系統與使用者的 PATH 變數：

1

$env:Path = [System.Environment]::GetEnvironmentVariable("Path","User") + ";" + [System.Environment]::GetEnvironmentVariable("Path","Machine")

執行後，PATH 就會即時更新，無須關閉或重開 any 終端機視窗。

二、 認證與初始化設定

當順利將 agy 加入路徑後，輸入 agy 啟動全新的終端機介面。

1. 啟動 OAuth 認證流程

首次執行 agy 時，系統會提示按下 Enter 鍵。這會自動開啟瀏覽器並進入 Google 的認證頁面。完成 Google 帳號授權後，網頁會提供一組授權碼，將該授權碼貼回終端機中即可完成認證。

2. 選擇終端機介面配色

認證完成後，agy 會在 TUI 中呈現色彩豐富的預覽畫面，引導選擇適合的配色方案：

• terminal
• light
• dark
• tokyo night (推薦，具備清晰的工具呼叫與 Thought Process 思考流程區隔)

3. 一鍵導入舊版擴充

在初始化最後一步，agy 會主動偵測系統中是否曾安裝過 Gemini CLI，並提供一鍵移轉選項：

1
2
3
4
5

Migration options:
 
    [x] Import extensions from Gemini CLI (1 found: superpowers)
 
  >  Next 

這項設計極具貼心，大幅減少了開發者因 Gemini 退場而重新手動設定的時間。

三、 專案目錄遷移與配置更新

完成全域 agy 初始化後，接著要將專案內部的 Skill 設定從舊版 Gemini 架構遷移至全新的 Workspace Customizations 結構。Workspace Customizations 專案自訂機制是 Antigravity 平台的核心，能透過 .agents 目錄實現零配置的 Skill 自動感知與規則加載。

下圖展示了整個專案目錄的轉移對應關係：

1
2
3
4
5
6
7
8
9
10
11

graph TD
    subgraph Old Setup (Gemini)
        G1[D:/github/hexo-blog/GEMINI.md]
        G2[D:/github/hexo-blog/.gemini/skills/hexo-seo-aio]
    end
    subgraph New Setup (agy)
        A1[D:/github/hexo-blog/.agents/AGENTS.md]
        A2[D:/github/hexo-blog/.agents/skills/hexo-seo-aio]
    end
    G1 -->|搬移與重新命名| A1
    G2 -->|搬移與重新命名| A2

1. 重命名隱藏目錄與規則檔案

在專案根目錄下，執行以下指令以完成符合 agy 規格的改動：

• 重命名目錄：將舊的 .gemini 資料夾改名為 .agents。
• 重命名規則檔：將舊 of GEMINI.md 規則檔案搬移至 .agents/AGENTS.md，因為 agy 會自動讀取並載入此處的 Rules 作為專案等級的限制規範。

2. 更新 Skill 設定與關聯路徑

在完成搬移後，還需要手動修改相關檔案的內部引用路徑。關於如何設計與包裝這樣的 Skill 數位資產，可以深入參考 AI Agent Skill 開發指南。

修改 AGENTS.md

將原本 references 的隱藏路徑與 CLI 使用說明，全面升級為 agy 格式：

1
2
3
4
5
6
7
8
9
10

- - `.gemini/skills/hexo-seo-aio/`: Specialized AI instructions for SEO/AIO tasks.
+ - `.agents/skills/hexo-seo-aio/`: Specialized AI instructions for SEO/AIO tasks.
 
- ## 🧠 Gemini CLI Usage
-
- When using Gemini to assist with this project, refer to the `hexo-seo-aio` skill:
- `activate_skill("hexo-seo-aio")`
+ ## 🧠 agy CLI Usage
+
+ When using `agy` to assist with this project, the `hexo-seo-aio` skill is automatically loaded from the `.agents/skills/` directory.

修改 SKILL.md

將自動化清理腳本的呼叫路徑，更換為以 .agents 開頭的路徑：

1
2

- 1. Run `python hexo-seo-aio/scripts/tag_cleanup.py`.
+ 1. Run `python .agents/skills/hexo-seo-aio/scripts/tag_cleanup.py`.

修改 tag_cleanup.py

微調 docstring 中的文字，將 Gemini CLI 更新為 agy CLI：

1
2

-     Outputs a summary for Gemini CLI.
+     Outputs a summary for agy CLI.

四、 E-E-A-T 實戰與 GEO 優化建議

在將 Skill 轉移至 agy 後，AI 代理不需要再透過手動命令激活，而是會根據專案目錄中的 .agents/skills/ 自動感知並載入。

為了讓文章更易被搜尋引擎與 AI 檢索系統 (例如 Google AI Overviews、Perplexity 等) 引用，我們彙整了以下的系統結構化事實。更多的 AI 搜尋時代內容佈局思維，請參閱 Hexo SEO 自動化與 AIO 實踐。

五、 常見問答 FAQ

Q1： 為什麼 .gemini 需要更名為 .agents？

A1： Antigravity 平台的專案自訂規則與 Skill 自動偵測目錄預設是 .agents。更名後，無論是在 agy 的 TUI 終端機還是 Antigravity IDE 中，AI 代理都能在啟動時自動探索並套用該目錄下的配置。

Q2： 遷移後原本的 Skill 還能正常運作嗎？

A2： 可以。舊有的 Skill 目錄結構與 YAML Front-matter 設計完全相容，唯一需要注意的是在 SKILL.md 或是自訂腳本中若有寫死 .gemini 的實體路徑，必須同步更新為 .agents。

Q3： 如何解決 Windows 上 PATH 變數未即時更新的問題？

A3： 可以開啟 PowerShell 執行 $env:Path = [System.Environment]::GetEnvironmentVariable("Path","User") + ";" + [System.Environment]::GetEnvironmentVariable("Path","Machine")。此指令會強制合併並更新當前 session 的環境變數，省去重開視窗或重啟電腦的繁瑣步驟。

• ← 上一篇