Antigravity ワークフロー: 繰り返せるエージェント作業

Antigravity ワークフローとは

Antigravity ワークフローは、開発の目的から確認済みの結果までを繰り返し進める方法です。エディター、ターミナル、ブラウザー操作、Skill、MCP サーバーのどれか一つ、または複数を組み合わせます。単なるプロンプトではありません。開始状態、許可された操作、一時停止する場所、完了を示す証拠までを含めます。

良い Antigravity ワークフローは、テストできる程度に狭い範囲を持ちます。「このプロジェクトを改善して」では終了条件がありません。「失敗したテストを読み、パーサーだけを変更し、対象テストを実行し、差分を示して commit 前に止まる」なら、出力と安全な停止点が明確です。各操作面の詳細は CLI、Skills、MCP の案内を参照してください。

実行前にワークスペースを準備する

対象のリポジトリを開き、ブランチを確認し、変更される可能性のあるファイルを調べます。必要なターミナルコマンドは一度手動で実行し、名前、終了コード、環境を把握します。ブラウザーや MCP を使う場合は、書き込みを許可する前に読み取り専用の要求を試します。

入力と出力を平易な言葉で書きます。対象ファイルやドメイン、許可するツール、制限、人が判断する地点を含めてください。パスワード、トークン、決済情報、個人データをプロンプトやログに入れません。初回はテストブランチか使い捨てフォルダーを使います。

1. 1. 開始状態を固定するリポジトリ、ブランチ、バージョン、触れてよいファイルやアカウントを記録します。
2. 2. 出力を一つにする成果物、テスト結果、ページ状態、レポートのいずれか一つを選び、失敗を見えるようにします。
3. 3. 読み取り専用で練習する編集、送信、アカウント変更の前に経路を調べて説明します。
4. 4. 確認点を置く依存関係の追加、ネットワーク書き込み、公開、削除、デプロイの前で停止します。

固定のワークフローファイル形式や永久に変わらないフラグを主張するページではありません。新しい連携を自動化する前に公式資料を確認してください。

Antigravity ワークフローで使えるプロンプトとコマンド

ワークフロー用のプロンプトには、役割、開始時の状況、許可された操作、期待する証拠を明記します。「このリポジトリで X を調べ、最小の変更を計画し、Y だけを編集し、Z を実行し、結果を示して W の前で止まる」という形が使えます。エージェントが使った正確なコマンドやツール名も返すよう求めます。

対話式のコマンドとシェルコマンドを混同しないでください。CLI のヘルプ、セッション内の操作、ターミナルテスト、MCP 呼び出しは範囲と失敗の仕方が異なります。ワークフロー内で操作面を名前付きで示します。

スコープ、権限、ワークフローの設定

ワークフローの安全性は、一つの切り替えよりも範囲の定義で決まります。プロジェクトのコマンドはリポジトリに近づけ、個人の設定は分け、ツール権限を具体的にします。読み取りと書き込み、テストとインストーラー、公開ページの確認と認証済みアカウントの変更は別物です。

検証した手順を Skill にまとめるときは、前提条件、入力、期待する出力、失敗時の処理、検証を含めます。広いシェルコマンドやネットワーク書き込みを、分かりやすい名前の裏に隠さないでください。

workflow:
  goal: "一つのパーサーを更新し対象テストの成功を証明"
  allowed: [read_files, edit_target, run_focused_test]
  review_before: [install_package, network_write, delete, publish]
  output: [diff_summary, test_result, remaining_risks]

• プロジェクトの範囲 — リポジトリ内の指示を使い、コマンドとファイル境界をチームで再現できるようにします。
• ユーザーの範囲 — 個人のモデル、ターミナル、表示設定を共有動作から分離します。
• ツールの範囲 — MCP サーバー、ブラウザのドメイン、シェルコマンドをワイルドカードなしで指定します。
• 確認の範囲 — 前の手順が自動でも、人の確認が必須な操作を一覧にします。

五つのパスで作る繰り返し可能な Antigravity ワークフロー

一つ目は発見です。関係するファイル、ページ、課題、テスト出力を読み、目的を言い直します。二つ目は計画で、最小の変更と使うツールを示します。計画が依頼を理解していなければ停止します。

三つ目で実行し、四つ目で対象を絞った確認を行って出力を受け入れ条件と比較します。五つ目では変更パス、証拠、未解決のリスク、次に人が判断することを報告します。この分離はコンテンツのビルド、CLI 作業、ブラウザー検査、MCP 調査に共通して使えます。

Antigravity の変更に合わせてワークフローを更新する

エージェント製品は変化します。更新後はコマンド、権限、モデル、連携の出力が変わることがあります。Antigravity、モデル、シェル、MCP サーバーを更新したらワークフローを確認してください。先月成功したことは、今日も安全だという証明になりません。

確認した日付、ビルドまたは資料のページ、検証した手順を記録します。現在の動作を確認できない場合は、不確実性が解消するまで読み取り専用か手動の手順に戻します。

Antigravity ワークフローのセキュリティ規則

ワークフローを権限の文書として扱います。共有またはインストールする前に、読めるファイル、実行できるコマンド、接続できる外部ドメイン、起こり得る副作用を確認します。

コマンド引数、作業ディレクトリ、ネットワーク、パッケージスクリプト、環境変数、削除や公開の経路を点検します。秘密はプロンプトとログから分離し、テスト用アカウントを使い、終了時に権限を取り消します。

• パスワード、API キー、復旧コード、顧客データをワークフローの文章と証拠に入れません。
• パッケージの導入、アップロード、Webhook、外部メッセージは手動で確認します。
• 認証が必要な操作には専用のブラウザプロファイルかテストアカウントを使います。
• 破壊的なファイル操作と Git 操作を自動経路から外します。
• 実行する人に前提条件と戻し方を共有します。

失敗したワークフローを調べる

まだ失敗する最小のパスまで問題を小さくします。権限を変える前に、開始状態、正確なツール呼び出し、表示された結果、受け入れ条件を比較してください。

エージェントが別の計画を立てる

対象ファイル、出力、停止条件を言い直します。まず計画だけを求め、境界を直してから編集します。

コマンドが見つからない

通常のターミナルで実行し、PATH とシェルの方針、インストール済みのバージョンを記録します。

ツールが一部のデータしか返さない

応答を保存して欠落フィールドを示し、停止します。一時的なエラーだと確認できる場合だけ再試行します。

もっともらしいが間違った結果になる

最終 URL、ファイルパス、テスト出力、状態を受け入れ条件と比較します。古い結果や途中結果は失敗として扱います。

権限の確認が何度も出る

コマンド、パス、アカウント、ツールのどれが変わったかを確認し、ワイルドカードを与えず規則を狭めます。