Google AntigravityのArtifactsを使いこなす検証テクニック

Google Antigravityを使っていて、「エージェントの作業結果をどう確認すればいいか分からない」「本当に正しく動いているのか不安なまま承認してしまっている」と感じていませんか。

Artifactsは、Google Antigravityがエージェントの作業内容を「証拠」として提示してくれる仕組みです。この記事では、Artifactsを使いこなし、安心して検証しながら作業を進めるためのテクニックを紹介します。

なぜArtifactsの確認でつまずくのか

Artifactsを活用しきれない人には、共通したパターンがあります。

• Artifactsが表示されていることに気づかず、エージェントの報告を言葉だけで信じてしまう
• 表示されている情報量が多く、どこを重点的に見ればいいか分からない
• 承認のタイミングが分からず、気づいたら作業がどんどん進んでしまっている

これらは、Artifactsという「確認のための仕組み」の存在と使い方を把握できていないために起きます。

Artifactsに含まれる4つの要素

Artifactsには、主に次の4種類の情報が含まれます。画面右上の切り替えボタンから、Artifactsのビューを表示できます。

• タスクリストと計画書: エージェントが作業前に立てる手順。内容を編集したり、承認・却下したりできます。
• コードの差分(Diff): どのファイルの、どの行が、どのように変わったかを一覧できる形式です。
• スクリーンショット: 作業前後の画面の見た目を比較できる画像です。
• ブラウザでの操作記録: ブラウザ拡張機能を使った検証の際、エージェントがどう操作したかの記録(動画を含む)です。

これらを「結果の報告」ではなく「証拠」として扱うのが、Artifactsの本来の役割です。

計画書の段階でチェックすべきこと

作業が始まる前に提示される計画書(タスクリスト)は、最も重要な確認ポイントです。ここでのチェックが甘いと、後から手戻りが発生しやすくなります。

• 手順の順番がおかしくないか: 依存関係のある作業が、誤った順番になっていないか確認します。
• 想定していない範囲まで手を広げていないか: 依頼した内容より広い範囲を変更しようとしていないか確認します。
• 不明点が計画書に反映されているか: エージェントが前提条件を誤解していないか、計画の文面から読み取ります。

少しでも違和感があれば、作業を承認する前に「〇〇の手順は不要です」「△△の前提が違います」とフィードバックを返し、計画を修正してから進めるのが安全です。

コードの差分(Diff)を見るときのポイント

コードに詳しくない人でも、差分を見る際に押さえておきたい最低限のポイントがあります。

• 変更されたファイルの数が、依頼内容と見合っているか: 1つの小さな修正のはずが、大量のファイルが変更されている場合は、意図しない範囲まで手が入っている可能性があります。
• 削除された行が多すぎないか: 大幅な削除がある場合は、既存の機能に影響がないか、動作確認を入念に行う必要があります。

細部のコードを読み解けなくても、「変更量が依頼内容に見合っているか」という大枠の感覚で見るだけでも、異常に気づきやすくなります。

スクリーンショットでの検証を習慣化する

見た目に関わる変更を依頼した場合は、必ず作業前後のスクリーンショットを確認する習慣をつけてください。文章での報告だけでは気づけない、レイアウト崩れや表示の乱れを視覚的に発見できます。

依頼の段階で「変更後、該当ページのスクリーンショットを提示してください」と明記しておくと、スクリーンショットの提示を確実に引き出せます。

ブラウザ操作の記録を検証に活用する

ブラウザ拡張機能を導入している場合、エージェントがブラウザを操作しながら動作確認を行った記録もArtifactsに残ります。クリックやスクロール、入力といった操作の過程を振り返ることで、「どのパターンまで確認されたか」「確認されていないパターンは何か」を把握できます。

特に、エラーが起きるはずの入力(不正な値の入力など)に対して、エージェントがきちんと確認を行ったかどうかは、この記録を見れば分かります。

承認前の最終チェックリスト

作業完了の報告を受けたら、次の順番でArtifactsを確認する習慣をつけると、検証漏れを防げます。

1. 計画書どおりに作業が行われたか
2. コードの差分が依頼内容の範囲に収まっているか
3. スクリーンショットで見た目に問題がないか
4. ブラウザ操作の記録で、想定される入力パターンが確認されているか

この順番で確認してから承認することで、「とりあえず動いているから大丈夫だろう」という曖昧な判断を避けられます。

まとめ

Artifactsは、Google Antigravityを安心して使いこなすための核となる機能です。計画書・差分・スクリーンショット・操作記録という4つの要素を、それぞれ目的を持って確認する習慣をつけることで、エージェント任せにしすぎない、信頼できる開発の進め方ができるようになります。

タスクの指示の出し方については、以下の記事もあわせてご覧ください。

▶ Google Antigravityのタスク指示の出し方実例集