call-agy

call-agy

公式のローカル agy CLI を、境界を定めたサブエージェントとして使用します。呼び出し元のエージェントはタスクのオーナーのままです。つまり、リクエストの範囲を定め、ハンドオフとワークスペースをレビューし、重要な主張を検証し、統合した結果を報告します。

ルーターのルール

• ユーザーが明示的に $call-agy、agy、または Antigravity の呼び出しを求めたときにトリガーします。明示的な呼び出しは、タスクが些細なものであっても優先されます。
• 承認されたホストポリシーが、特に Antigravity をバックエンドとする実装、デバッグ、レビュー、テスト、分析、または検証パスを求める場合にもトリガーします。
• インストール／ドキュメント／料金に関する質問、求められていない些細な作業、Antigravity を特定しない一般的な「サブエージェントを使う」リクエストではトリガーしません。
• ホストポリシーまたはユーザーがエージェント間の作業を禁止している場合は委任しません。
• 1 回の呼び出しは、観測可能な完了基準を持つ 1 つの焦点を絞ったゴールを担います。無関係な作業は委任する前に分割してください。
• ユーザーが明示的に指定しない限り、CLI のデフォルトのモデル、エフォート、エージェントを維持します。スラッグを推測したり、暗黙に差し替えたりしないでください。

コンパクトなワークフロー

1. スモークテストまたは直接のテキスト返信の場合は、リポジトリの探索とファイルのヒントを省略します。それ以外の場合は、ゴール、完了基準、制約、期待される検証、ワークスペース、および最大 6 つの優先パスを述べるのに十分なローカルコンテキストを読み取ります。広範な調査の場合は、AGY に探索を適切な規模に保ち、無制限の再帰を避け、時間切れになる前に収集したエビデンスを提出するよう伝えます。明示的なターゲットを隠す可能性のある固定的な除外を課さないでください。
2. 実行意図と承認を分離します。計画／読み取り専用の作業にのみ plan を使用し、承認された変更には accept-edits を、コマンドにはスコープ付きの許可ルールを使用します。信頼済みワークスペースのプリセットを使用する前に告知します。
3. OS ネイティブのランチャーを 1 回呼び出します。短いリクエストには --task を、複数行のリクエストには stdin を、優先パスには --file を使用します。
4. status=SUCCESS の場合、報告された output_path を読み取り、実際の差分があれば確認し、リスクに比例したホスト側の検証を実行します。
5. 失敗した場合は、権限とリカバリに従います。診断し、安全なローカル修正を 1 回行い、同じタスクを最大 1 回再試行します。
6. 実質的な結果、検証、制限事項、および既知のプロセス成果物のパスを返します。

ファストパス

正規の実装は scripts/call_agy.py です。この Skill ディレクトリからネイティブランチャーを使用してください。

Windows では、現在の PowerShell プロセスにとどまり、& を使ってランチャーを直接呼び出してください。ネストされた powershell -Command を起動しないでください。短いタスクには --task を使用します。ラッパーは大きなプロンプトのフォールバックをシステムの一時領域にステージングし、実行後に会話単位でグループ化します。

明示的な接続スモークテスト（リポジトリ検出なし）:

& "<skill-directory>\scripts\call_agy.ps1" `
  --task "Reply exactly: Antigravity is connected. Do not inspect files or run tools." `
  --workspace "<absolute-workspace>" --timeout 90s

リポジトリツールを必要とする読み取り専用または計画タスク:

& ".\scripts\call_agy.ps1" --task "Review the request flow and cite relevant files" `
  --workspace . --mode plan --sandbox

plan は実行インテントであり、ホストの権限付与ではありません。ヘッドレスモードでは、シェルコマンドに スコープ付きの permissions.allow ルールが引き続き必要です。ラッパーは計画タスクにはネイティブの 読み取り専用ファイルツールを優先し、暗黙に権限を昇格させるのではなく HEADLESS_PERMISSION_BLOCKED を報告します。

sh ./scripts/call_agy.sh "Review the request flow and cite relevant files" --workspace .

信頼されたワークスペースでの承認済み編集には、この Skill が選択する成功優先プリセットを使用します:

.\scripts\call_agy.ps1 "Fix the bug and run the focused tests" `
  --workspace . --file "src/example.ts" --file "tests/example.test.ts" `
  --mode accept-edits --sandbox --dangerously-skip-permissions

そのプリセットの前に、--dangerously-skip-permissions が Antigravity を全ツール自動承認に変更することをユーザーに伝えてください。--sandbox はターミナル実行を制約しますが、任意のファイル変更を無害にするものではありません。プリセットは、信頼されたワークスペースとプロンプトにおいてユーザーが承認した変更にのみ使用してください。

ユーザーが安全、保守的、またはバイパスなしの動作を求める場合は、次を使用します:

.\scripts\call_agy.ps1 "Fix the bug and report any blocked command" `
  --workspace . --mode accept-edits --sandbox

リカバリ中もその安全な姿勢を維持してください。危険なフラグを暗黙に追加しないでください。

モデルの呼び出し前に、ラッパーは AGY のバージョンを検証し、~/.gemini/antigravity-cli 配下の 状態ルートと既存のランタイムサブディレクトリを可逆的にプローブします。 ホストのサンドボックスがその状態ディレクトリをブロックする場合、モデル トークンを消費せずに失敗ハンドオフを出力します。また、AGY を起動する前に receipt_path を出力します。この逐次更新される 成果物は、ラッパーまたはホストが実行を中断した場合に、会話 ID、最後のイベント、完了したツール数、診断情報、および ストリーミングされた応答テキストを保持します。

委任契約

Antigravity に次を渡してください:

1. 1 つの具体的なゴールと、何をもって完了とするか
2. 関連する制約と明示的な非ゴール
3. 期待される検証コマンドまたはエビデンス
4. 絶対ワークスペースと、有用な --file ヒントのみ
5. 要求する最終ハンドオフ: 変更/調査結果、検証、および未解決の制限

--file は優先度ヒントであり、アクセス権の付与ではありません。明示的なターゲットがワークスペース外にある場合は、それを含むディレクトリを --add-dir で渡してください。長いタスクや複数行のタスクでは、stdin をパイプし、完全なリクエストの後に閉じてください。

結果と検証

ラッパーの実行が成功すると、少なくとも以下が報告されます。

conversation_id=<id>
output_path=<absolute-markdown-path>
elapsed=<seconds>s
status=SUCCESS

すべての非ドライ実行は、AGY を開始する前に receipt_path=<absolute-markdown-path> を出力します。ラッパーはポーリングではなく AGY のストリームを待機します。有効な init イベントと step_update イベントはアクティビティの期限を更新します。デフォルトでは、AGY の総上限が 2 時間、10 分後にアイドル警告、さらに 5 分間無音が続くと終了となります。ホストのエージェントは、起動前に --timeout、--idle-timeout、--idle-grace でこれらを上書きできます。ホストプロセスのタイムアウトは、ラッパーのウォッチドッグより長く設定してください。

進捗はコンパクトな stderr 行とレシートで示されます。ツールの状態変化、および最大 1 分に 1 回、部分応答の文字数、タイムスタンプ、20 文字の末尾です。これらはホストの判断のための観察情報として扱い、テキストループの自動的な証明とはしないでください。ターミナルの result でターンが完了します。その後、AGY はプロセスツリーのクリーンアップ前に終了するまで 5 秒間与えられます。

限定的な一時的失敗である ERROR + 空の応答 + トークン使用量ゼロ + ツールステップなしの場合、ラッパーは同じ新規呼び出しを 1 回繰り返します。attempts=2 と報告され、これが唯一の再試行予算を消費するため、ホストは 3 回目の試行を開始してはなりません。

• ハンドオフは、実行が成功した後にのみ読んでください。
• 空の最終応答は決して成功として扱われません。ストリーミングされた agent_response.text_delta のテキストは、利用可能な場合に復元されます。それ以外の場合、ハンドオフには最終応答を受信しなかったことが記載されます。
• タイムアウト、または会話 ID を伴う不完全なターミナル結果の場合、ハンドオフの推奨される復旧プロンプトを読んでください。ラッパーがその追加ターンを自動的に起動することはありません。
• ハンドオフは、自動的な真実やタスク完了としてではなく、レビューすべき証拠として扱ってください。
• 編集については、実際のワークスペース/差分を確認し、ホストから関連するテストを再実行してください。
• 以前の Antigravity コンテキストが役立つ場合にのみ再開し、ワークスペース全体の --continue ではなく --conversation <id> を使用してください。
• 標準のハンドオフには、Antigravity に委任された完全に組み立てられたプロンプトが含まれます。prompt_file_path、raw_output_path、またはホストが作成したプロンプト中間ファイルは、それらが存在する場合にのみ記載してください。
• --raw-output および報告されたすべての成果物パスは、機密情報を含む可能性があるものとして扱ってください。

段階的な参照

• セットアップ、複数行/大きなプロンプト、モデルまたはセッションの上書き、オプション、ハンドオフフィールドについては、CLI リファレンス を参照してください。
• 変更、外部ディレクトリへのアクセス、権限の変更、または失敗した実行の再試行の前に、権限と復旧 を参照してください。