---
name: gemini-cli-control
description: Controls Gemini CLI from an editor agent (e.g. Antigravity Flash). Delegates file edits and heavy tasks to CLI via headless commands, formulates prompts with explicit path and scope, interprets CLI output, and reports to the user. Use when the user works with Antigravity plus Gemini CLI, when delegating code edits or analysis to CLI, or when the user asks how to drive Gemini CLI from the agent.
---

# Gemini CLI 制御（エージェント用）

エージェント（Antigravity）が**司令塔**となり、Gemini CLI をヘッドレスで呼び出して「編集・解析・複数ステップ」を完遂させるための入口。

## 司令塔（Antigravity）の基本思想

1.  **意思決定はエージェントが行う**: Gemini CLI は「実行役」であり、その出力（Planや解析結果）をそのまま鵜呑みにせず、Antigravity が精査・判断して次の一手を決める。
2.  **複数ターンのキャッチボール**: 1回のコマンドで全てを終わらせようとせず、Plan作成 → 精査 → 修正 → 合意 → 実装 というステップを Antigravity が制御する。
3.  **ファイル操作・重い処理の委譲**: 実際のコード編集、大規模検索、ビルド等は Gemini CLI に任せ、Antigravity はその結果を解釈してユーザーに報告する。

## 万能型としての運用原則

- **まずユーザーが明示した対象と目的だけで処理する**。最初から勝手に対象ファイル・周辺資料・追加文脈を広げない。
- **追加ファイル・追加 resources は必要条件がそろったときだけ読む**。曖昧さの解消、設計上の判断、実装上の必要、エラー切り分けがある場合のみ広げる。
- **質問整理・不足情報確認・短い往復では通常の `gemini -p` を優先する**。`--approval-mode=plan` は設計や仮 plan が明示的に必要な場合のみ使う。
- **`--output-format json` は機械処理が必要な場合のみ使う**。短い自然文の返答で足りるときは使わない。
- **迷ったら、まず最小スコープ・通常モード・短い返答を選ぶ**。必要が生じた時点でだけ広げる。

## 最小読込ルール（トークン節約）

- **このスキルが発動したら、作業開始前に必ず 2 つだけ読む**: [manual-for-agent.md](resources/manual-for-agent.md) と [agent-behavior.md](resources/agent-behavior.md)。
- **この 2 つを読まずに、CLI 実行・Plan 判断・実装判断を始めない**。
- **その他の resources は必要時のみ読む**。まとめて読まず、必要になったタイミングで読みに行く。
- **必要時の追加読取は自己判断で飛ばさない**。下の「状況別の追加読込フロー」に当てはまるときは、該当 resources を Read してから次に進む。
- **以下のどれかに当てはまったら、該当するリソースを開いて読む**（Read してから判断・実行する）。
  - **判断・意思決定に迷うとき**: [agent-behavior.md](resources/agent-behavior.md)（司令塔の責務・委譲・安全境界・Plan精査）。
  - **技術的な実行手順を知りたいとき**: [manual-for-agent.md](resources/manual-for-agent.md)（コマンド形・プロンプト設計・Windows/Git Bash・トークン節約）。
  - **オプション・終了コードを確認するとき**: [reference.md](resources/reference.md)（早見表・公式リンク）。
  - **定型プロンプトを使うとき**: [prompt-templates.md](resources/prompt-templates.md)。
  - **trusted folder / 編集ブロック時**: [trusted-folder.md](resources/trusted-folder.md)。
  - **エラー・症状の切り分け**: [troubleshooting.md](resources/troubleshooting.md)（既存資料へのインデックス）。

## 状況別の追加読込フロー

- **曖昧要件・会話往復型・条件追加あり**: [conversation-patterns.md](resources/conversation-patterns.md) と [prompt-templates.md](resources/prompt-templates.md) を Read してから、質問返しまたは仮 plan に進む。
- **Plan の評価・実装に進むか迷う**: [agent-behavior.md](resources/agent-behavior.md) を再読してから判断する。
- **シェル別の実行手順を使う**: [manual-for-agent.md](resources/manual-for-agent.md) の Windows / シェル別手順を見てから `cd` と `gemini` を送る。
- **終了コード・オプション・CLI 挙動の確認**: [reference.md](resources/reference.md) を Read してから判断する。
- **権限エラー・trusted folder・編集ブロック**: [trusted-folder.md](resources/trusted-folder.md) を Read してから案内・再試行する。
- **エラー・異常終了・期待外れの出力**: [troubleshooting.md](resources/troubleshooting.md) を Read し、必要なら [reference.md](resources/reference.md) も読む。

## いつこのスキルを使うか

- ユーザーが Antigravity + Gemini CLI で開発している／CLI で編集・解析をさせたいと言っている。
- コード編集・複数ファイル変更・検索・ビルド・詳細解析など、**ファイル・ターミナルが必要な作業**を任せたいとき。
- **仕様が曖昧・後から条件が増える・会話で要件を詰める**題材（会話往復型）でもこのスキルを使う。条件衝突時は [agent-behavior.md](resources/agent-behavior.md) 7.4 を参照。
- 「編集・実行・大量読み取り」かどうか迷ったら → CLI に委譲する。詳細な委譲判断は [agent-behavior.md](resources/agent-behavior.md)。

## 最短の 1 回の流れ

1. まず [manual-for-agent.md](resources/manual-for-agent.md) と [agent-behavior.md](resources/agent-behavior.md) を Read する。
2. タスクを **1 回の `gemini -p` で 1 タスク**に分解する。
3. **条件が未確定**（曖昧要件・途中で条件追加・衝突しうる仕様）のときは、[conversation-patterns.md](resources/conversation-patterns.md) と [prompt-templates.md](resources/prompt-templates.md) を Read してから、質問返しまたは仮 plan に進む。**実装はしない**。
4. 実装・調査・設計を含む依頼では、まず **Plan / 分析 / 調査のターン**を先に作る（いきなり実装しない）。
5. プロンプトに **作業場所・対象（パス・範囲）・指示** を明示する。定型が必要なら [prompt-templates.md](resources/prompt-templates.md) を Read する。編集時は `--approval-mode=yolo` を付ける（`--yolo` は互換用。`--approval-mode` と併用不可）。
6. ターミナル起動後は**少し待ってから**コマンドを送る。**`cd` と `gemini` は別送**（`&&` でつなげず、先に `cd`、その後に `gemini -p "..."`）。実行前に [manual-for-agent.md](resources/manual-for-agent.md) のシェル別手順を確認し、**Git Bash では `/c/...` 形式の絶対パス**、CMD / PowerShell では Windows の絶対パスで移動する。
7. **ターミナル出力（stdout / stderr・終了コード）を Antigravity 側で必ず取得**し、解釈してから次を決める。終了コードや CLI 挙動が曖昧なら [reference.md](resources/reference.md) を Read してから判断する。
8. Plan 返答時は **実装に進まず**、Antigravity が Plan を精査し、必要なら [agent-behavior.md](resources/agent-behavior.md) を見直して修正依頼を繰り返す。実装は最終 Plan 了承後のみ。条件衝突時は 7.4。
9. エラー・権限問題・期待外れの出力が出たら、自己判断で流さず [troubleshooting.md](resources/troubleshooting.md) または [trusted-folder.md](resources/trusted-folder.md) を Read してから再試行・案内する。

## 短い往復運用ルール

- **長文 1 回より、短文の複数ターンを優先する**。調査・判断・実装を 1 回に詰め込まず、`質問 -> 出力取得 -> 次質問` の反復で進める。
- **1 ターン 1 目的**にする。1 回の `gemini -p` では、「不足情報の質問」「仮 plan」「差分確認」「次の一手の提案」など、役割を 1 つに絞る。
- **短い返答を作るときは、[prompt-templates.md](resources/prompt-templates.md) の「短い往復向け定型」を優先して使う**。毎回ゼロから書かず、既存の定型を流用して速く安定させる。
- **CLI には短く返させる**。必要に応じて「3 行以内」「箇条書き 2 点」「質問だけ返す」「JSON の key だけ返す」「実装しない」など、返答形式を明示する。
- **各ターンの後で、必ずターミナル出力を取得する**。返答を読まずに次の質問へ進まない。
- **Antigravity は、取得した返答を短く要約してから次のプロンプトを作る**。CLI の全文をそのまま次ターンへ貼らず、必要な文脈だけ 3〜5 文程度で渡す。
- **曖昧要件では、いきなり実装しない**。最初は「不足情報の質問」か「前提つき仮 plan」だけを返させる。
- **Plan が返ってきたら、その場で実装に進まない**。Antigravity が内容を確認し、必要なら「ここを具体化して」「この条件を反映して」と短く再質問する。
- **デバッグ時は、原因候補を絞らせる質問を優先する**。「原因を 1 つに絞るなら何か」「次に試すコマンドを 1 つだけ」など、切り分けに使う。
- **長い説明より、次の一手を重視する**。CLI には「今すぐやるべきことを 1 つだけ」「確認事項を 2 つだけ」など、行動につながる返答を求める。
- **会話が長くなったら、Antigravity 側で途中要約を挟む**。過去の CLI 出力を全部引きずらず、「ここまでの要点」を短く再整理してから続ける。

## 参照（resources）

| 資料 | 読むタイミング |
|------|----------------|
| [agent-behavior.md](resources/agent-behavior.md) | 委譲判断・安全・再試行・Plan 精査・複数ターン |
| [manual-for-agent.md](resources/manual-for-agent.md) | 実行手順・コマンド・プロンプト・Windows・トークン節約 |
| [reference.md](resources/reference.md) | オプション・終了コード・IDE・信頼フォルダ・公式リンク |
| [prompt-templates.md](resources/prompt-templates.md) | 定型プロンプト（質問返し・衝突整理・Plan 再作成含む） |
| [trusted-folder.md](resources/trusted-folder.md) | trusted folder 確認・設定・症状 |
| [troubleshooting.md](resources/troubleshooting.md) | エラー・症状の切り分け（参照インデックス） |
| [conversation-patterns.md](resources/conversation-patterns.md) | 会話往復型の典型フロー・質問観点 |
| [detailed-guide.md](resources/detailed-guide.md) | インストール〜公式リンク（補足） |
| [terminal-recommendation.md](resources/terminal-recommendation.md) | ターミナル推奨（Git Bash）・chcp は CMD 専用 |
