Google Antigravityに指示を出してみたものの、「思った通りに動いてくれない」「エージェントが何をすればいいか迷っているように見える」と感じたことはありませんか。
Google Antigravityは「タスク」という単位で指示を渡すツールのため、従来のAIチャットとは違う指示の出し方が求められます。この記事では、実際に使える指示の実例を、良い例・悪い例の両方で紹介します。
なぜ指示の出し方でつまずくのか
Google Antigravityでの指示作りにつまずく人には、共通したパターンがあります。
- 普段のAIチャットの感覚で、漠然とした一言だけを投げてしまう
- 一度に欲しい成果物をすべて詰め込みすぎて、エージェントが何を優先すべきか分からなくなる
- 完成形のイメージを自分の中だけで持っていて、言葉にして伝えていない
これらは、Google Antigravityが「対話」よりも「タスクの割り振り」に向いたツールであることを意識できていないために起きます。
良い指示・悪い指示の基本原則
実例に入る前に、共通する考え方を整理します。
- 範囲を区切る: 「アプリ全体を作って」ではなく、「ログイン画面だけを作って」のように、1つのタスクの範囲を絞ります。
- 判断基準を示す: 「見やすくして」ではなく、「文字サイズを16px以上にして」のように、エージェントが判断に迷わない基準を添えます。
- 完了条件を明記する: 「テストを書いて」ではなく、「主要な3つの関数に対するテストを書いて、すべて通ることを確認して」のように、何をもって完了とするかを伝えます。
実例1:バグ修正を頼む場合
悪い例
「ログインがうまくいかないので直して」
良い例
「ログインページで、パスワードを間違えて入力した際にエラーメッセージが表示されない不具合があります。正しいパスワードの場合と同様の検証処理の中で、エラーメッセージの表示だけが漏れている可能性があります。該当箇所を特定し、修正後はパスワードを意図的に間違えて入力し、エラーメッセージが表示されることをスクリーンショットで確認してください」
良い例では、不具合の状況・推測される原因・確認方法まで含めており、エージェントが自己判断する範囲を減らしています。
実例2:機能追加を頼む場合
悪い例
「お問い合わせフォームを追加して」
良い例
「お問い合わせページに、名前・メールアドレス・お問い合わせ内容の3項目を持つフォームを追加してください。メールアドレスは形式が正しいかを送信前にチェックし、不正な形式の場合はエラーメッセージを表示してください。完了後、正しい入力・不正な入力の両方を試し、スクリーンショットで動作を確認してください」
項目・バリデーション内容・確認方法までセットで伝えることで、完成形の認識ずれを防げます。
実例3:複数タスクを並行で進めたい場合
悪い例
「サイト全体を改善して」
良い例(3つのタスクに分割して、それぞれ別に指示)
- 「トップページの表示速度を改善してください。画像の読み込み方法を見直し、改善前後の表示速度を計測して報告してください」
- 「プロジェクトの依存ライブラリを最新版に更新してください。更新後、既存の機能が壊れていないかを一通り確認してください」
- 「お問い合わせフォームのテストコードを作成してください」
大きな目標を一つの指示にまとめるのではなく、独立して進められる単位に分割し、それぞれ別のエージェントに割り振ることで、Agent Manager上で並行して進捗を確認できます。
実例4:曖昧な要望を具体化する場合
悪い例
「もっとおしゃれなデザインにして」
良い例
「配色を、現在のモノトーンから、メインカラーを青系(#2C5F8A程度)に変更してください。ボタンには角丸(8px程度)を適用し、ボタンにカーソルを合わせた際に色が少し明るくなる動きを追加してください。変更後、主要な3ページのスクリーンショットを見せてください」
感覚的な言葉(「おしゃれ」「見やすい」)は、必ず具体的な数値や状態に言い換えるのがコツです。
指示を出した後の確認ポイント
指示を出した後は、Artifactsに表示される「タスクリストと計画書」を必ず確認してください。エージェントが自分の意図と違う解釈をしていないか、作業が実行される前に気づくことができます。計画書の段階で認識のズレがあれば、作業が進む前に修正の指示を出すのが効率的です。
まとめ
Google Antigravityへの指示は、「範囲を区切る」「判断基準を示す」「完了条件を明記する」という3つを意識するだけで、精度が大きく変わります。最初は小さなタスクから練習し、徐々に複数タスクの並行運用に慣れていくのがおすすめです。
画面構成の基本的な理解については、以下の記事もあわせてご覧ください。
▶ Google Antigravityの使い方を深掘り!初心者がつまずかない進め方ガイド
コメント