開始使用 Antigravity IDE

1. 簡介

Antigravity 是代理式開發平台，旨在協助任何人在代理優先時代進行建構。這項服務包含四項主要產品：Antigravity、Antigravity IDE、Antigravity CLI 和 Antigravity SDK。

在本程式碼研究室中，我們只會著重於開發人員適用的 Antigravity IDE。

課程內容

• 瞭解 Antigravity 平台。
• 安裝 Antigravity IDE。
• 探索 Antigravity 編輯器和代理程式面板。
• 斜線指令。
• 自訂項目、MCP 伺服器和技能。

軟硬體需求

您必須在本機系統 (Mac、Windows 和特定 Linux 發行版本) 安裝 Antigravity IDE。此外，您還需要下列項目：

• Chrome 網路瀏覽器。
• Gmail 帳戶 (個人 Gmail 帳戶)。

報表問題

在逐步完成程式碼研究室和使用 Antigravity 時，您可能會遇到問題。

如要回報程式碼研究室相關問題 (錯字、錯誤的操作說明)，請點選本程式碼研究室左下角的「Report a mistake」按鈕開啟錯誤：

如要回報 Antigravity 相關錯誤或要求功能，請在 Antigravity 中回報問題。如要回報產品意見，請按一下 Antigravity 產品左下角的「設定」，然後選擇 Provide Feedback 選項。

2. Antigravity Platform

在著重介紹 Antigravity IDE 之前，我們先來瞭解 Antigravity 平台。

Antigravity 包含 4 項獨立產品：

• Antigravity：旗艦獨立應用程式，也是您平行管理多個本機代理程式的指令中心。
• Antigravity IDE：功能齊全的代理式 IDE，適合開發人員使用。
• Antigravity CLI：指令列介面，可透過終端機與代理互動。
• Antigravity SDK：開發人員工具，可透過程式輔助方式將 Antigravity 整合至自家系統。

雖然所有產品都提供相同的 Antigravity 代理程式，但互動程度不同。

在 Antigravity 中，您會與代理程式進行更高層級的互動。在與代理程式的對話中，您只要說明要建構的內容，程式碼相關事宜就交給代理程式處理。您會看到生成的程式碼，但不一定需要自行深入瞭解程式碼。

在 Antigravity IDE 中，您處於較低的程式碼層級。你還是可以透過代理程式面板與代理程式交談，但也能完整查看程式碼，並在生成及編輯程式碼時取得代理程式的協助。

在 Antigravity CLI 中，您會透過指令列介面使用代理程式。同樣地，您還是可以與代理程式對話，並要求生成及編輯程式碼，但所有作業都會在終端機中進行。

你可以自行選擇要加入的等級。一般來說，您會在 Antigravity 中從較高的層級開始建構，隨著複雜度增加，您會切換至 Antigravity IDE 進行程式設計，或使用 Antigravity CLI 執行更適合終端機的工作。

3. 安裝

如果您已安裝 Antigravity 應用程式，但尚未安裝 Antigravity IDE，右上角應該會顯示「Install IDE」按鈕：

您可以按一下該按鈕，或直接前往 Antigravity IDE 下載頁面，為您的作業系統 (macOS、Windows、Linux) 下載並安裝 Antigravity IDE。

安裝完成後，您應該會看到歡迎畫面：

登入 Google 帳戶，然後選擇主題，繼續安裝程序。

系統會詢問您要如何使用 Antigravity IDE 代理程式。在這個畫面中，您可以調整代理程式的終端執行政策、審查政策和 JavaScript 執行政策。目前請選擇「Review-driven development」。

在後續畫面中，您可以設定擴充功能和 agy-ide 指令列工具。建議只安裝需要的擴充功能。

Antigravity IDE 也提供外掛程式，內含技能和 MCP 的封裝集合，可協助代理程式使用 Google 開發人員產品。選擇您認為對工作有幫助的課程：

現在可以開始使用 Antigravity IDE 了。

4. Antigravity IDE 介面

首次啟動 Antigravity IDE 時，應該會看到 Antigravity IDE 主要介面。

你可以先開啟本機資料夾。建議您透過 Terminal 和 New Terminal 選單項目開啟新的終端機。

現在您已準備好編輯器、終端機和代理：

在編輯器中，您輸入程式碼時，Antigravity 會提供 AI 輔助功能。在代理程式面板中，您可以與代理程式對話、選擇不同模型，以及參閱檔案和指令。終端機預設不會提供 AI 輔助，但如果您安裝 Antigravity CLI，即可使用 agy 指令啟動終端機，並在終端機中取得 AI 輔助。

Antigravity 設定

建議查看右下角的「Antigravity Settings」(反重力設定)。其中包含代理程式的基本設定：

「進階設定」提供更多設定，例如代理程式安全模式：

您可以藉此指定代理程式在終端機指令、檔案系統存取權等方面的自由度。請務必查看這些設定，並為專案選擇合適的設定。

5. 編輯者

我們來看看編輯器。建立 Python 檔案 hello.py，探索編輯器功能。

在編輯器的 hello.py 中輸入程式碼時，系統會啟動智慧自動完成功能，按下 Tab 鍵即可接受建議：

你可以按 Tab 鍵跳轉建議，將游標移至程式碼中的下一個邏輯位置。舉例來說，當您完成輸入 main() 時，編輯器會要求您跳至 main 方法：

您也會看到匯入分頁建議，可新增缺少的依附元件：

6. 服務專員面板

右側會顯示服務專員側邊面板。如果沒有顯示，你可以使用 Cmd + L 快速鍵切換。

您可以選擇不同模型類型，使用 @ 納入更多內容，例如檔案、目錄、終端機、MCP 伺服器或 / 指令 (稍後步驟會說明)。

與代理互動最簡單的方式是在對話中提問，但與代理互動的方式不只一種。

如果您已安裝靜態 Linter (例如 Pylint)，發生錯誤時，程式碼中會顯示語法錯誤。將游標懸停在編輯器中的問題上，然後選取 Explain and fix。這會開啟代理面板，顯示代理的說明和可能的修正方式：

你也可以前往 IDE 的 Problems 分頁，然後選取 Send to Agent，讓代理程式嘗試修正這些問題：

您也可以選取終端機輸出內容中含有錯誤的部分，然後按一下 Cmd + L，將該部分傳送給代理程式對話：

與服務專員對話時，輸入視窗頂端會顯示一些圖示：

包括「變更總覽」(查看程式碼變更)、「終端機」(背景程序)、「構件」和「瀏覽器」。

7. 構件

Antigravity 的核心功能是在開發的每個階段輕鬆收集意見回饋。代理執行工作時，會建立不同的構件：

• 編碼前：實作計畫和工作清單。
• 生成程式碼時：程式碼差異。
• 程式碼編寫完成後：逐步說明程式碼的用途，並驗證結果。

Antigravity 會透過這些構件傳達計畫和進度。更重要的是，您也可以透過 Google 文件風格的註解，向服務專員提供意見回饋。這項功能非常實用，可有效引導代理程式朝您期望的方向發展。

讓我們試著建構簡單的應用程式，並瞭解如何在此過程中向 Antigravity 提供意見回饋。

在代理程式側邊面板中，嘗試輸入以下提示：

Build a TODO list application with Python Flask, SQlite DB, and a CRUD frontend. Keep the application simple

這項操作會啟動代理程式，開始規劃及製作實作計畫。

實作計畫

實作計畫會概略說明 Antigravity 的意圖、使用的技術堆疊，以及建議變更的概要說明。

幾秒後，您應該會在對話中看到實作計畫：

如果滿意，可以點選 Proceed 按鈕。如要提供意見回饋，請開啟實作計畫，然後加入 Google 文件樣式的註解，再提交計畫。

工作清單

更新實施計畫後，Antigravity 會建立工作清單。這是 Antigravity 建立及驗證應用程式時會遵循的具體步驟清單，也是 Antigravity 傳達進度的管道：

提供意見時，請參考下列訣竅：

1. 在計畫中新增註解時，請務必記得提交註解。這會觸發 Antigravity 更新方案。
2. 有時，Antigravity 會在擬定實作計畫後直接開始編寫程式碼，不會等待你確認。在這些情況下，您仍可對計畫發表意見，然後再次提交。我們隨後會更新程式碼和逐步操作說明。你也可以停止編碼工作、在計畫中新增註解，然後再試一次。

程式碼變更難追蹤

此時，Antigravity 會在新檔案中產生一些程式碼。您可以在代理程式對話側邊面板中 Accept all 或 Reject all 這些變更，不必查看詳細資料。您也可以點按 Review changes 查看變更詳細資料，並在程式碼中新增詳細註解。

逐步操作說明

Antigravity 完成編碼後，會啟動伺服器，並可能開啟瀏覽器來驗證應用程式。接著會進行一些手動測試，例如新增工作、更新工作等。最後，Antigravity 會建立逐步解說檔案，總結驗證應用程式所執行的動作，其中可能包括螢幕截圖或驗證流程 (附上瀏覽器錄影)。

你也可以在導覽中對螢幕截圖或瀏覽器錄製內容加上註解。例如，我們可以新增註解 Change the blue theme to orange theme 並提交。提交註解後，Antigravity 會進行變更、驗證結果，並更新逐步解說

復原變更

最後，如果對變更不滿意，可以在每個步驟後從對話中復原。只要在對話中選擇 ↩️ Undo changes up to this point 即可。

8. 斜線指令

Antigravity IDE 內建斜線 / 指令，在代理程式側邊面板中輸入 /，應該會看到指令清單：

/goal 會指示代理程式執行工作直到完成，/schedule 則可將工作排定為週期性或一次性工作。/grill-me 有助於與服務專員討論計畫，/learn 則有助於從對話中擷取可重複使用的技能或規則。

請試用這些指令，瞭解如何運用。

9. 自訂項目

Antigravity IDE 提供「規則」和「工作流程」兩種自訂選項。

按一下右上角的 ...，然後選擇 Customizations，您會看到 Rules 和 Workflows：

規則可引導代理的行為。您可以提供這些指引，確保代理程式在生成程式碼和測試時遵循指引。舉例來說，您可能希望代理程式遵循特定程式碼樣式，或一律記錄方法。您可以將這些資訊新增為規則，代理程式就會將其納入考量。

工作流程是儲存的提示，您可以在與代理互動時，透過 / 視需要觸發。這些工具也會引導代理程式的行為，但會由使用者視需要觸發。

舉例來說，規則比較像是系統指令，而工作流程則比較像是可依需求選擇的已儲存提示。

「規則」和「工作流程」都可以套用至全域或個別工作區，並儲存至下列位置：

• 全域規則：~/.gemini/GEMINI.md
• 全域工作流程：~/.gemini/config/global_workflows/<YOUR_WORKFLOW_NAME>.md
• 工作區規則：your-workspace/.agents/rules/
• 工作區工作流程：your-workspace/.agents/workflows/

我們在工作區中新增一些規則和工作流程。

新增規則

首先，新增程式碼樣式規則。前往 Rules，然後選取「+Workspace」按鈕。使用下列程式碼樣式規則為其命名，例如 code-style-guide：

* Make sure all the code is styled with PEP 8 style guide
* Make sure all the code is properly commented

接著，我們新增另一項規則，確保程式碼以模組化方式生成，並在 code-generation-guide 規則中提供範例：

* The main method in main.py is the entry point to showcase functionality.
* Do not generate code in the main method. Instead generate distinct functionality in a new file (eg. feature_x.py)
* Then, generate example code to show the new functionality in a new method in main.py (eg. example_feature_x) and simply call that method from the main method.

這兩項規則已儲存完畢，可供使用

新增工作流程

我們也來定義工作流程，產生單元測試。這樣一來，我們就能在對程式碼感到滿意時觸發單元測試 (而不是讓代理程式一直生成單元測試)。

前往 Workflows，然後選取「+Workspace」按鈕。為其命名，例如 generate-unit-tests，並輸入下列內容：

* Generate unit tests for each file and each method
* Make sure the unit tests are named similar to files but with test_ prefix

工作流程也已準備就緒。

試試看

現在來看看規則和工作流程的實際運作情形。在工作區中建立架構 main.py 檔案：

def main():
    pass

if __name__ == "__main__":
    main()

現在，請前往代理程式側邊面板，並詢問代理程式：Implement binary search and bubble sort.

過一兩分鐘後，工作區中應該會出現三個檔案：main.py、bubble_sort.py、binary_search.py。您也會發現所有規則都已實作：主要檔案不會雜亂無章，且包含範例程式碼；每個功能都會在各自的檔案中實作；所有程式碼都已加上註解，且風格良好：

from binary_search import binary_search, binary_search_recursive
from bubble_sort import bubble_sort, bubble_sort_descending


def example_binary_search():
    """
    Demonstrate binary search algorithm with various test cases.
    """
    ...

def example_bubble_sort():
    """
    Demonstrate bubble sort algorithm with various test cases.
    """
    ...

def main():
    """
    Main entry point to showcase functionality.
    """
    example_binary_search()
    example_bubble_sort()
    print("\n" + "=" * 60)


if __name__ == "__main__":
    main()

我們對程式碼感到滿意，現在來看看是否可以觸發生成單元測試工作流程。

前往對話並開始輸入 /generate，Antigravity 就會瞭解我們的工作流程：

選取 generate-unit-tests 並輸入。幾秒後，工作區就會出現新檔案：test_binary_search.py、test_bubble_sort.py，其中已實作多項測試！

10. MCP 伺服器

Model Context Protocol (MCP) 已成為協助代理程式連結外部系統的標準。這類工具可確保代理程式在資料和整合方面保持基礎。

Antigravity IDE 支援本機和遠端 MCP 伺服器。此外，這項服務也整合了多個 MCP 伺服器，可與 Google Cloud 服務搭配使用，只要按一下滑鼠並提供一些設定資料，即可安裝這些伺服器。

按一下右上角的 ...，然後選擇 MCP Servers。這時會顯示對話方塊，其中列出 MCP 伺服器：

例如，您可以點選「Cloud Run」安裝 MCP 伺服器。

按一下右上方的 Manage MCP Servers，您也可以在 ~/.gemini/config/mcp_config.json 中查看原始 MCP 伺服器設定。您也可以在這個檔案中新增其他自訂 MCP 伺服器，然後按下重新整理按鈕，讓 Antigravity IDE 辨識這些伺服器。

如要使用已設定的 MCP 伺服器，可以詢問 Antigravity 需要 MCP 伺服器的問題。舉例來說，您可以啟用 cloudrun-mcp 伺服器，然後向 Antigravity 提出以下要求：Build and deploy a Cloud Run service。這會提示 Antigravity 尋找並使用 cloudrun-mcp 伺服器，設定及部署 Cloud Run 服務。

11. 技能

雖然 Antigravity 的基礎模型功能強大且用途廣泛，但並不瞭解您的特定專案背景或團隊標準。將所有規則或工具載入代理程式的內容視窗，會導致工具膨脹、成本增加、延遲和混淆。

技能會透過逐步揭露的方式解決這個問題。技能是專業知識的特殊套件，在需要時才會啟動。只有在特定要求符合技能說明時，才會載入代理程式的情境。

結構和範圍

技能是目錄式套裝組合，您可以視需求在兩個範圍中定義這些項目：

• 全域範圍 (~/.gemini/config/skills/)：適用於所有 Antigravity 產品 (Antigravity、Antigravity IDE、Antigravity CLI) 和專案。
• 專案/工作區範圍 (<project-root>/.agents/skills/)：這項設定會將技能限制在特定專案內。

典型的技能目錄如下所示：

my-skill/
├── SKILL.md    #(Required) metadata & instructions.
├── scripts/    # (Optional) Python or Bash scripts for execution.
├── references/ # (Optional) text, documentation, or templates.
└── assets/     # (Optional) Images or logos.

現在來新增技能。

程式碼審查技能

這項技能僅提供指令，也就是說，我們只需要建立 SKILL.md 檔案，其中會包含中繼資料和技能指令。讓我們建立一項技能，向服務專員提供詳細資料，以審查程式碼變更是否有錯誤、樣式問題和最佳做法。

在專案資料夾中建立目錄，用於存放技能：

mkdir -p .agents/skills/code-review

在專案資料夾 (例如我們剛才建立的 .agents/skills/code-review) 中建立 SKILL.md 檔案，並加入以下內容：

---
name: code-review
description: Reviews code changes for bugs, style issues, and best practices. Use when reviewing PRs or checking code quality.
---

# Code Review Skill

When reviewing code, follow these steps:

## Review checklist

1. **Correctness**: Does the code do what it's supposed to?
2. **Edge cases**: Are error conditions handled?
3. **Style**: Does it follow project conventions?
4. **Performance**: Are there obvious inefficiencies?

## How to provide feedback

- Be specific about what needs to change
- Explain why, not just what
- Suggest alternatives when possible

請注意，上方的 SKILL.md 檔案頂端包含中繼資料 (名稱和說明)，接著是指令。代理程式載入時，只會讀取技能的中繼資料，並只在必要時載入完整的技能指令。

請讓我們驗證技能。與 Antigravity 展開新對話，詢問已安裝哪些技能。您應該會看到 code-review 技能：

試試看

建立名為 demo_bad_code.py 的新檔案，並在其中加入下列內容：

import time

def get_user_data(users, id):
   # Find user by ID
   for u in users:
       if u['id'] == id:
            return u
   return None

def process_payments(items):
   total = 0
   for i in items:
       # Calculate tax
       tax = i['price'] * 0.1
       total = total + i['price'] + tax
       time.sleep(0.1) # Simulate slow network call
  
   return total

def run_batch():
   users = [{'id': 1, 'name': 'Alice'}, {'id': 2, 'name': 'Bob'}]
   items = [{'price': 10}, {'price': 20}, {'price': 100}]
  
   u = get_user_data(users, 3)
   print("User found: " + u['name']) # Will crash if None
  
   print("Total: " + str(process_payments(items)))

if __name__ == "__main__":
   run_batch()

在 Antigravity 的特定專案中開啟新對話，然後輸入下列提示：review the @demo_bad_code.py file。

Agent 應找出 code-review 技能、載入詳細資料，然後根據 code-review/SKILL.md 檔案中的指示執行動作。

輸出範例如下所示：

12. 結語

恭喜！您已成功安裝、設定並瞭解 Antigravity IDE 的主要功能！

如要進一步瞭解 Antigravity 平台，請參閱下列程式碼研究室和參考說明文件。

其他程式碼研究室

• 開始使用 Google Antigravity
• 使用 Google Antigravity 建構
• 親自體驗 Antigravity CLI
• 使用 Antigravity 建構及部署至 Google Cloud

參考文件

• 官方網站：https://antigravity.google/
• 說明文件：https://antigravity.google/docs/home
• 用途：https://antigravity.google/use-cases
• 下載：https://antigravity.google/download
• Google Antigravity YouTube 頻道：https://www.youtube.com/@googleantigravity