1. はじめに
Antigravity は、エージェント ファーストの時代に誰でも構築できるように設計されたエージェント型開発プラットフォームです。Antigravity、Antigravity IDE、Antigravity CLI、Antigravity SDK の 4 つの主要なプロダクトで構成されています。
この Codelab では、デベロッパー向けの Antigravity IDE にのみ焦点を当てます。
学習内容
- Antigravity プラットフォームについて理解する。
- Antigravity IDE をインストールします。
- Antigravity エディタとエージェント パネルを確認します。
- スラッシュ コマンド。
- カスタマイズ、MCP サーバー、スキル。
必要なもの
Antigravity IDE は、システム（Mac、Windows、特定の Linux ディストリビューション）にローカルにインストールする必要があります。また、次のものも必要になります。
- Chrome ウェブブラウザ。
- Gmail アカウント（個人用 Gmail アカウント）。
問題の報告
この Codelab と Antigravity を使用する際に、問題が発生することがあります。
Codelab 関連の問題（誤字脱字、誤った手順）については、この Codelab の左下にある Report a mistake ボタンを使用してバグを報告してください。
Antigravity に関連するバグや機能リクエストについては、Antigravity 内で問題を報告してください。Antigravity サービスの左下にある [設定] をクリックして、サービスに関するフィードバックを送信してください。[Provide Feedback] オプションを選択します。
2. Antigravity プラットフォーム
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 実行ポリシーを調整できます。ここでは [レビュー主導の開発] を選択します。
次の画面で、拡張機能と agy-ide コマンドライン ツールを構成できます。必要な拡張機能のみをインストールすることをおすすめします。
Antigravity IDE には、エージェントが Google デベロッパー プロダクトを操作するのに役立つ、スキルと MCP のパッケージ化されたコレクションであるプラグインも付属しています。仕事に役立ちそうなものを選択します。
これで、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 キーを押すと、オートコンプリートが適用されます。
タブ移動の候補が表示され、カーソルをコード内の次の論理的な場所に移動できます。たとえば、main() の入力を完了すると、エディタから main メソッドにジャンプするよう求められます。
また、不足している依存関係を追加するための タブをインポートする提案も表示されます。
6. エージェント パネル
右側にエージェントのサイドパネルが表示されます。表示されていない場合は、Cmd + L ショートカットで切り替えることができます。
さまざまなモデルタイプを選択できます。@ を使用して、ファイル、ディレクトリ、ターミナル、MCP サーバーなどのコンテキストを追加したり、/ を使用してコマンドを追加したりできます（後の手順で説明します）。
エージェントとやり取りする最も簡単な方法は、会話で質問を始めることですが、エージェントとやり取りする方法は他にもあります。
静的リンター（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 は新しいファイルにコードを生成します。エージェント チャットのサイドパネルで、詳細を確認せずにこれらの変更を Accept all または Reject all できます。Review changes をクリックして変更の詳細を確認し、コードに詳細なコメントを追加することもできます。
チュートリアル
Antigravity は、コーディングが完了するとサーバーを起動し、アプリを検証するためにブラウザを開くことがあります。タスクの追加や更新などの手動テストを行い、最後に、アプリの検証のために行ったことをまとめたウォークスルー ファイルを作成します。これには、スクリーンショットやブラウザの録画による検証フローが含まれることがあります。
ウォークスルーでは、スクリーンショットやブラウザの録画にコメントすることもできます。たとえば、コメント Change the blue theme to orange theme を追加して送信できます。コメントが送信されると、Antigravity が変更を行い、結果を確認して、ウォークスルーを更新します。
変更を元に戻す
最後に、各ステップの後に変更に満足できない場合は、チャットから元に戻すことができます。チャットで ↩️ Undo changes up to this point を選択するだけです。
8. スラッシュ コマンド
Antigravity IDE では、組み込みのスラッシュ / コマンドを使用できます。エージェントのサイドパネルで / と入力すると、コマンドのリストが表示されます。
/goal は、エージェントにタスクを完了まで実行するように指示します。/schedule を使用すると、タスクを定期的なタスクまたは 1 回限りのタスクとしてスケジュールできます。/grill-me はエージェントとの計画の調整に役立ち、/learn は会話から再利用可能なスキルやルールを抽出するのに役立ちます。
これらのコマンドを試して、どのように役立つかを確認してください。
9. カスタマイズ
Antigravity IDE には、ルールとワークフローという 2 つのカスタマイズ オプションがあります。
右上隅の ... をクリックして Customizations を選択すると、Rules と Workflows が表示されます。
ルールは、エージェントの動作をガイドするのに役立ちます。これらは、エージェントがコードを生成してテストする際に従うように指定できるガイドラインです。たとえば、エージェントに特定のコードスタイルに従うように指示したり、常にメソッドを文書化するように指示したりできます。これらをルールとして追加すると、エージェントが考慮します。
ワークフローは、エージェントとのやり取り中に / でオンデマンドでトリガーできる保存済みのプロンプトです。また、エージェントの動作をガイドしますが、ユーザーのオンデマンドでトリガーされます。
ルールはシステムの手順に似ており、ワークフローはオンデマンドで選択できる保存済みのプロンプトに似ています。
ルールとワークフローは、グローバルまたはワークスペースごとに適用でき、次の場所に保存できます。
- グローバル ルール:
~/.gemini/GEMINI.md - グローバル ワークフロー:
~/.gemini/config/global_workflows/ - ワークスペース ルール:
.agents/rules/ - 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.
2 つのルールが保存され、準備が整いました
ワークフローを追加する
単体テストを生成するワークフローも定義しましょう。これにより、コードに満足したら単体テストをトリガーできます（エージェントが常に単体テストを生成するのではなく）。
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.」と質問します。
1 ～ 2 分後に、ワークスペースに main.py、bubble_sort.py、binary_search.py の 3 つのファイルが作成されます。また、すべてのルールが実装されていることもわかります。メインファイルは整理されており、サンプルコードが含まれています。各機能は独自のファイルに実装されています。すべてのコードがドキュメント化され、適切なスタイルで記述されています。
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 サーバーをサポートしています。また、Google Cloud サービスと連携する複数の MCP サーバーとの統合も提供されており、数個の構成データでワンクリックでインストールできます。
右上の ... をクリックして、MCP Servers を選択します。ダイアログが表示され、MCP サーバーのリストが表示されます。
たとえば、[Cloud Run] をクリックして、その MCP サーバーをインストールできます。
右上にある Manage MCP Servers をクリックすると、~/.gemini/config/mcp_config.json に MCP サーバーの未加工の設定も表示されます。このファイルに他のカスタム MCP サーバーを追加し、更新ボタンを押すと、Antigravity IDE で認識されます。
構成した MCP サーバーを使用するには、MCP サーバーを必要とするタスクを Antigravity に依頼します。たとえば、cloudrun-mcp サーバーを有効にして、Antigravity に Build and deploy a Cloud Run service と質問できます。これにより、Antigravity は cloudrun-mcp サーバーを探して使用し、Cloud Run サービスを構成してデプロイします。
11. スキル
Antigravity の基盤となるモデルは強力な汎用モデルですが、特定のプロジェクトのコンテキストやチームの標準を把握しているわけではありません。すべてのルールやツールをエージェントのコンテキスト ウィンドウに読み込むと、ツールが肥大化し、コストが増加し、レイテンシが増加し、混乱が生じます。
スキルは、段階的な開示によってこの問題を解決します。スキルは、必要になるまで休眠状態にある専門知識のパッケージです。特定のリクエストがスキルの説明と一致した場合にのみ、エージェントのコンテキストに読み込まれます。
構造とスコープ
スキルはディレクトリ ベースのパッケージです。ニーズに応じて、次の 2 つのスコープで定義できます。
- グローバル スコープ（
~/.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
エージェントは code-review スキルを特定し、詳細を読み込んでから、code-review/SKILL.md ファイルに記載されている手順に沿ってアクションを実行する必要があります。
出力例を以下に示します。
12. おわりに
おめでとうございます！これで、Antigravity IDE のインストール、構成、主な機能の確認が完了しました。
Antigravity プラットフォームの詳細については、次の Codelabs とリファレンス ドキュメントをご覧ください。
その他の Codelab
- 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