Antigravity プロンプトが機能する条件
Antigravity プロンプトは、広い意図を観察できる作業に変えたときに機能します。「アプリを良くして」では終了条件がありません。「請求書の合計が二重に丸められる理由を調べ、計算部分だけを直し、再現テストを一つ追加して差分を示して」と書けば、目的、範囲、停止点が決まります。デスクトップ、Antigravity CLI、複数ツールを使うワークフローでも同じ考え方が使えます。
このページはプロンプトの設計と再利用できる例を扱います。Antigravity Workflows のガイドは繰り返し処理、権限、チェックポイントを説明し、Antigravity CLI のガイドはインストールとコマンドを説明します。テーマを分けることで、プロンプトが設定変更や無関係なモジュールの改修を暗黙に要求することを防げます。
回答に書かれたファイル、コマンド、証拠を自分で確認するまでは、回答を提案として扱ってください。目に見える受け入れテストを含む短いプロンプトは、可能な機能をすべて列挙した長い文章より実用的です。恒久的なルールはリポジトリや確認済み設定に置き、現在のプロンプトは今回の判断に集中させます。
4つの要素で作るプロンプト
信頼できる Antigravity プロンプトは、目的、コンテキスト、制約、証拠という4つのブロックに分けられます。短い質問なら見出しを付けなくても構いませんが、コード、認証情報、外部ツール、複数ファイルが関係する場合は明示すると安全です。失敗したときに不足した部分も分かります。
目的は動詞と対象で書きます。パーサーを調べる、ルートを追加する、APIを比較する、テストを説明する、差分をレビューする、といった形です。コンテキストには場所と既知の事実を含めます。制約には変更してはいけないもの、許可されたコマンド、書き込みの可否を含めます。証拠は対象テスト、生成されたHTML、残った不確実性の説明などです。
受け入れ条件は現実的にします。「バグをゼロにする」は一回の依頼では測れません。指定したテストが通る、404が200になる、表に期待した行が現れる、という条件なら測定できます。実行できないコマンドがある場合はその事実と、人が実行できる正確なコマンドを返すように頼みます。
目的
特定、計画、修正、説明、テスト、レビューのうち、今回必要な最小の結果を示します。
コンテキスト
作業フォルダー、ファイル、フレームワーク、エラー、期待する動作、信頼できる資料を示します。
制約
編集可能なパス、禁止操作、依存関係、セキュリティ境界、停止条件を決めます。
証拠
成功を示すコマンド、差分、画像、出力、未解決の質問を具体的に指定します。
計画とプロジェクト理解のためのプロンプト
大きな変更や初めて触るリポジトリでは、実装前に計画プロンプトを使います。実際のツリーを調べ、参照したパスを示すよう求めてください。良い計画は推測による全面改修ではなく、必要最小限のファイル、リスク、正しさを確かめる検証を示す地図です。
不明点も列挙させます。ビルドコマンド、認証方法、翻訳データの場所が複数あるなら、選択肢と確認した方法を分けて書かせます。推測した README やフレームワークが、その後の変更の根拠になるのを防げます。
計画を読んでから、承認した部分だけを実装する新しいプロンプトを送ります。調査と書き込みを分けるとチェックポイントが残り、範囲外の変更を断りやすくなります。
01. リポジトリを地図にする
このリポジトリをファイル変更なしで調べてください。フレームワーク、入口、ビルド、テスト、設定、[動作]を制御する主要3ファイルを特定し、各パスと未確認事項を示してください。役立つ理由: 実装前に事実とパスを揃えられます。
02. 依頼を計画に変える
[目的]を5段階の実装計画にしてください。編集は[許可されたパス]だけに限定し、各段階の成果と検証、前提、依存、戻す地点を書いてください。まだファイルは変更しないでください。役立つ理由: レビューしやすい順序と境界ができます。
03. 所有者を探す
[入力またはルート]が[観測された出力]になるまで追跡してください。公開入口から関数やテンプレートをたどり、真のソースと修正すべきファイルを短いグラフで示してください。役立つ理由: 実際に動作を所有するモジュールだけを変更できます。
実用的な Antigravity プロンプト15例
次の Antigravity プロンプトは意図的に短くしています。角括弧の値を置き換え、不要な手順を削除し、実際のコマンドや期待する出力を足してください。プロジェクト理解、実装、デバッグ、テスト、レビュー、文書化という検索意図をカバーします。
リポジトリの地図
プロジェクトツリーを調べ、実行環境、入口、ビルド、テスト、デプロイ経路を要約してください。
知らないコードを触る前に使います。要件を分ける
この依頼を必須、範囲外、未解決の質問、受け入れ条件に分けてください:[依頼]。
チケットに複数の目的が混ざるとき。最小設計
[目的]を満たす最小設計を提案し、2つの案とコストを比較してから選んでください。
新しい抽象化を足す前に使います。範囲を絞った実装
[パス]に[動作]を実装してください。既存APIとスタイルを保ち、変更ファイルと対象テストを示して止めてください。
小さなパッチに使います。安全なリファクタリング
[モジュール]の重複を探し、保つべき動作を列挙した計画を提示して、承認後だけ変更してください。
整理で動作が変わりそうなとき。バグを再現する
[エラー]を最小の入力で再現し、コマンド、出力、最初に間違った値を修正前に記録してください。
再現手順が不完全なとき。回帰をデバッグする
失敗した経路と最後に正しかった動作を比較し、可能性の高い原因を一つ検証して証拠を示してください。
Antigravity のデバッグ作業に。回帰テスト
[バグ]のテストを一つ追加してください。修正前は失敗し、修正後は通り、無関係な fixture は使わないでください。
修正を長く保つために。テストの切り分け
[変更]に最も近いテストを実行し、製品、テスト、環境、依存関係の失敗を分けてください。
赤いテストに複数の原因があるとき。コードレビュー
この差分を正しさ、安全性、互換性、足りないテストの観点でレビューし、パスと行を添えて重大度順に報告してください。
生成コードを受け入れる前に。移行チェックリスト
[旧]から[新]への移行を計画し、データ形、互換期間、ロールバック、確認クエリを含めてください。
状態や利用者がある変更に。ドキュメント更新
実装を読み、古くなった説明だけを更新してください。変わった動作を引用し、例は実行可能に保ってください。
動作を変えた後に。性能の計測
[操作]を再現可能な小さなサンプルで測定し、基準値、ボトルネック、低リスクの改善を示してください。
推測で最適化する前に。リリースレビュー
バージョン、変更履歴、ビルド、テスト、リンク、ロールバックを確認し、証拠付きのブロッカーを列挙してください。
公開する前に。結果を説明する
何をなぜ変更し、どう検証し、何が不確実かをファイルパス付き5項目で説明してください。
監査できる引き継ぎに。実装とデバッグのプロンプト例
実装プロンプトでは、新しい動作を頼む前に既存動作を守る条件を書きます。変更してよいファイル、安定させるAPIやマークアップ、対象パスを通るテストを指定してください。別の問題を見つけたら、同じパッチで黙って直さずフォローアップとして記録させます。
デバッグでは理論より先に再現を求めます。正確な入力、コマンド、応答、期待する出力、環境を含め、一つの仮説と一つの狭い検証を依頼します。これで推測による修正の一覧を避け、関係ないコードを変えるパッチを拒否できます。
コードブロックを含める場合は短くし、置き場所を示します。差分とテスト結果、検討したが変更しなかったファイルを求めると、範囲が記録されます。
04. 停止条件付きで実装
[ファイル]に[動作]を追加してください。公開シグネチャと既存エラー文を保ち、[コマンド]だけを実行して差分を示し、コミット前に止めてください。役立つ理由: 不要なリファクタリングへの拡大を防ぎます。
05. 証拠からデバッグ
次の失敗を再現してください:[コマンド/入力と出力]。コードを調べ、一つの仮説と反証できる確認を実行してから、最小パッチと回帰テストを提案してください。役立つ理由: 考え方を反証可能にします。
06. 生成コードをレビュー
この差分を保守担当者としてレビューしてください。境界、セキュリティ、アクセシビリティ、翻訳、テストを確認し、先に指摘だけを返して編集しないでください。役立つ理由: 受け入れ前に独立した確認を行えます。
07. 失敗した試行を直す
前の試行は[エラー]で失敗しました。現在のファイルと出力を読み、動く変更を保ったまま差分だけを修正し、[確認]を再実行して残る不確実性を報告してください。役立つ理由: 古いパッチを繰り返し適用しません。
CLI、ファイル、メディア、サブエージェント用のプロンプト
Antigravity CLI のプロンプトでは、複数行テキスト、ファイル参照、貼り付けたメディアをどう扱うかが重要です。キー操作と送信方法は公式のプロンプト資料を確認してください。ファイルが読み取り専用のコンテキストなのか、編集対象なのか、コピーしてはいけない例なのかをプロンプトに書きます。
ファイルを一つ示したからといって、コンピューター全体を調べる許可にはなりません。必要最小限のフォルダーまたはファイルを指定し、画像やログについて何を証明するかを説明します。秘密、Cookie、秘密鍵、本番データは貼り付けないでください。
サブエージェントは独立した確認に役立ちます。一人につき一つの質問と証拠付きの短い報告を求め、矛盾した報告は親のタスクで判断します。異なる変更を自動的に統合しないでください。

検証、権限、プロンプトの限界
人が結果を受け入れるか判断できるとき、プロンプトは完了します。正確な確認方法、出力、実行環境を求めてください。テストが成功しても、壊れたリンク、誤った言語、危険な権限変更を見逃すことがあります。リスクに合った証拠を選びます。
ワークフローを覚える間は権限を狭く保ちます。シェルコマンドを説明することは、破壊的なコマンドを実行したりワークスペースの外を読んだりする許可ではありません。書き込み、ネットワーク、認証情報、移行、リリースには承認を要求します。アクセスできない場合は停止し、不足した証拠を説明させます。
長いプロンプトにも限界があります。同じログやコピーした文書は受け入れ条件を隠します。安定したルールは確認済みファイルにまとめ、信頼できる資料へリンクし、今回の判断に集中します。失敗したら文章を増やすのではなく、不足したブロックを書き直します。
- 正しい層を確認する。 変更が複数の層にまたがるときは、単体テストとルート、HTML、権限、画面出力を組み合わせます。
- 書き込みを明示する。 許可したパスを指定し、差分を確認してから受け入れます。プロンプトは全体の許可ではありません。
- 個人情報を守る。 プロンプト、ログ、画像、成果物から秘密や個人データを除きます。
- 証拠がなければ止める。 調べられなかったものを推測で埋めず、未確認として報告させます。
- 復旧を記録する。 エラー、試した修正、新しい確認方法を残し、次の実行を事実から始めます。

Antigravity プロンプト FAQ
最も良い Antigravity プロンプトとは何ですか?
結果、確認できるコンテキスト、ファイルと操作の制約、証拠を含むものです。地図、実装、デバッグ、テスト、レビューの例から始めてください。
開発用プロンプトはどう始めますか?
目的、リポジトリまたはファイル、現在と期待する動作、制約、テストを書きます。不明なコードでは先に計画を依頼します。
Antigravity をデバッグするプロンプトの書き方は?
最小の再現、観測した出力、期待する出力、環境を含めます。パッチより先に仮説と検証を求めます。
複数のファイルを編集するプロンプトは使えますか?
使えますが、許可するパスと理由を列挙し、ファイルごとの差分とテストを求めてください。追加の修正は次のタスクにします。
Antigravity CLI プロンプトには何を入れますか?
公式資料で複数行、ファイル、メディアの扱いを確認し、各ファイルがコンテキストか編集対象かを書きます。秘密は入れません。
回答が曖昧になる理由は?
目的、コンテキスト、受け入れ条件のどれかが不足していることが多いです。具体的な出力、パス、エラー、証拠を追加します。
恒久的な指示を毎回繰り返すべきですか?
安定したルールは確認済みの設定や文書に置き、今回の操作に関係する制約だけをプロンプトに繰り返します。
このテンプレートは公式ですか?
いいえ。編集用の例です。製品動作、CLI の操作、統合の最新情報は公式ドキュメントを参照してください。
確認した資料
- Antigravity CLI 公式プロンプト資料 — プロンプト欄、複数行、ファイル、サブエージェント、メディア入力の公式説明。
- Antigravity CLI ガイド — インストール、コマンド、設定、端末のトラブルシューティング。
- Antigravity Workflows — 反復可能な作業、チェックポイント、権限、検証結果のガイド。
- コミュニティのプロンプト資料 — フェーズと成果物の用語を確認した資料で、公式システムプロンプトとは扱っていません。