Gemini スキルガイド

Gemini を使用する場面

• ユーザーからの使用指示を受けた場合
• コードレビュー: 複数ファイルに対する包括的なコードレビュー
• プランレビュー: アーキテクチャプラン、技術仕様書、プロジェクトロードマップの分析
• 大規模コンテキスト処理: 200k トークン以上のコンテキストが必要なタスク（全体的なコードベース、ドキュメントセット）
• 複数ファイルの分析: 多数のファイル間における関係性とパターンの把握

⚠️ 重大な警告: バックグラウンド/非対話モード

バックグラウンドまたは非対話的なシェル（Claude Code ツール呼び出しなど）で --approval-mode default を使用してはいけません。承認プロンプトの提供ができず、無限に待機し続けます。

自動実行/バックグラウンドレビューの場合:

• ✅ 完全自動実行には --approval-mode yolo を使用
• ✅ または タイムアウトでラップ: timeout 300 gemini ...
• ❌ 対話型ターミナルなしで --approval-mode default を使用してはいけません

Gemini がハングしている症状:

• 20分以上実行中で CPU 使用率が 0%
• ネットワークアクティビティなし
• プロセス状態が 'S'（スリープ中）

ハングしたプロセスの修正:

# ハング確認
ps aux | grep gemini | grep -v grep

# 必要に応じて終了
pkill -9 -f "gemini.*gemini-3-pro-preview"

タスク実行手順

1. ユーザーに対して（AskUserQuestion 経由で）使用するモデルを1 つのプロンプト内で質問してください。利用可能なモデル:

   • gemini-3-pro-preview ⭐ (フラッグシップモデル、コーディングと複雑な推論に最適、ソフトウェアエンジニアリングで 2.5 Pro より 35% 優秀)
   • gemini-3-flash (サブ秒レイテンシ、3 Pro から抽出、速度が重要なタスクに最適)
   • gemini-2.5-pro (レガシーオプション、全体的にバランスの取れたパフォーマンス)
   • gemini-2.5-flash (レガシーオプション、思考機能を備えたコスト効率的)
   • gemini-2.5-flash-lite (レガシーオプション、最速の処理)

2. タスクに基づいて承認モードを選択:

   • default: 承認を求めるプロンプト（⚠️ 対話型ターミナルセッションのみ）
   • auto_edit: 編集ツールのみ自動承認（コードレビューと提案用）
   • yolo: すべてのツールを自動承認（✅ バックグラウンド/自動タスクに必須）

3. 適切なオプションでコマンドを組み立てます:

   • -m, --model <MODEL> - モデル選択
   • --approval-mode <default|auto_edit|yolo> - ツール承認の制御
   • -y, --yolo - --approval-mode yolo の別表記
   • -i, --prompt-interactive "prompt" - プロンプトを実行して対話的に継続
   • --include-directories <DIR> - ワークスペースに含める追加ディレクトリ
   • -s, --sandbox - サンドボックスモードで実行（隔離用）

4. バックグラウンド/自動タスクでは、常に --approval-mode yolo を使用するか、タイムアウトラッパーを追加してください。非対話シェルでは default を使用してはいけません。

5. コマンドを実行して出力をキャプチャします。バックグラウンド/自動モード:

   # 推奨: バックグラウンドタスクには yolo を使用
   gemini -m gemini-3-pro-preview --approval-mode yolo "Review this codebase for security issues"
   
   # または タイムアウト付き（5分制限）
   timeout 300 gemini -m gemini-3-pro-preview --approval-mode yolo "Review this codebase"
   

6. 初期プロンプト付きの対話型セッション:

   gemini -m gemini-3-pro-preview -i "Review the authentication system" --approval-mode auto_edit
   

7. Gemini 完了後、ユーザーに告知: 「Gemini の分析が完了しました。フォローアップ分析のために新しい Gemini セッションを開始するか、検出結果の探索を続けることができます。」

クイックリファレンス

ユースケース	承認モード	主要フラグ
バックグラウンドコードレビュー	yolo ✅	-m gemini-3-pro-preview --approval-mode yolo
バックグラウンド分析	yolo ✅	-m gemini-3-pro-preview --approval-mode yolo
タイムアウト付きバックグラウンド	yolo ✅	timeout 300 gemini -m gemini-3-pro-preview --approval-mode yolo
対話型コードレビュー	default	-m gemini-3-pro-preview --approval-mode default（対話型ターミナルのみ）
自動編集付きコードレビュー	auto_edit	-m gemini-3-pro-preview --approval-mode auto_edit
自動リファクタリング	yolo	-m gemini-3-pro-preview --approval-mode yolo
速度重視バックグラウンド	yolo ✅	-m gemini-3-flash --approval-mode yolo
コスト最適化バックグラウンド	yolo ✅	-m gemini-2.5-flash --approval-mode yolo
マルチディレクトリ分析	yolo（バックグラウンド時）	--include-directories <DIR1> --include-directories <DIR2>
プロンプト付き対話型	auto_edit または default	-i "prompt" --approval-mode <mode>

モデル選択ガイド

モデル	最適用途	コンテキストウィンドウ	主な機能
gemini-3-pro-preview ⭐	フラッグシップモデル: 複雑な推論、コーディング、エージェンティックタスク	1M 入力 / 64k 出力	Vibe コーディング、76.2% SWE-bench、$2-4/M 入力
gemini-3-flash	サブ秒レイテンシ、速度重視アプリケーション	1M 入力 / 64k 出力	3 Pro から抽出、TPU 最適化
gemini-2.5-pro	レガシー: 全体的に優れたパフォーマンス	1M 入力 / 65k 出力	思考モード、成熟した安定性
gemini-2.5-flash	レガシー: コスト効率的、大量タスク用	1M 入力 / 65k 出力	最高のコスパ ($0.15/M)、思考モード
gemini-2.5-flash-lite	レガシー: 最速処理、高スループット	1M 入力 / 65k 出力	最大速度、最小レイテンシ

Gemini 3 の利点: ソフトウェアエンジニアリングで 35% 高い精度、SWE-bench (76.2%)、GPQA Diamond (91.9%)、WebDev Arena (1487 Elo) で最先端。知識カットオフ: 2025年1月。

近日公開: gemini-3-deep-think 超複雑な推論用、強化された思考機能付き。

一般的なユースケース

コードレビュー（バックグラウンド/自動実行）

# バックグラウンド実行（Claude Code、CI/CD など）
gemini -m gemini-3-pro-preview --approval-mode yolo \
  "Perform a comprehensive code review focusing on:
   1. Security vulnerabilities
   2. Performance issues
   3. Code quality and maintainability
   4. Best practices violations"

# タイムアウト安全付き（5分）
timeout 300 gemini -m gemini-3-pro-preview --approval-mode yolo \
  "Perform a comprehensive code review..."

プランレビュー（バックグラウンド/自動実行）

# バックグラウンド実行
gemini -m gemini-3-pro-preview --approval-mode yolo \
  "Review this architectural plan for:
   1. Scalability concerns
   2. Missing components
   3. Integration challenges
   4. Alternative approaches"

大規模コンテキスト分析（バックグラウンド/自動実行）

# バックグラウンド実行
gemini -m gemini-3-pro-preview --approval-mode yolo \
  "Analyze the entire codebase to understand:
   1. Overall architecture
   2. Key patterns and conventions
   3. Potential technical debt
   4. Refactoring opportunities"

対話型コードレビュー（ターミナルのみ）

# default モードは対話型ターミナルでのみ使用
gemini -m gemini-3-pro-preview --approval-mode default \
  "Review the authentication flow for security issues"

フォローアップ

• Gemini CLI セッションは通常ワンショットまたは対話型です。Codex とは異なり、組み込みのレジューム機能がありません。
• フォローアップ分析のために、前の検出結果のコンテキストで新しい Gemini セッションを開始してください。
• フォローアップアクションを提案する場合、選択したモデルと承認モードを改めて述べてください。
• 各 Gemini コマンド後に AskUserQuestion を使用して、次のステップを確認するか、明確化を収集してください。

エラーハンドリング

• gemini --version または Gemini コマンドが 0 以外で終了した場合、常に停止して失敗を報告してください。
• 失敗したコマンドを再試行する前に指示を求めてください。
• 高い影響を持つフラグ（--approval-mode yolo、-y、--sandbox）を使用する前に、AskUserQuestion を使用してユーザーの許可を求めてください（既に許可を得ている場合を除く）。
• 出力に警告または部分的な結果が含まれている場合、それらをまとめて AskUserQuestion を使用して調整方法を尋ねてください。

ハングしている Gemini プロセスのトラブルシューティング

検出

# ハングしたプロセスを確認
ps aux | grep -E "gemini.*gemini-3" | grep -v grep

# これらの症状を確認:
# - 20分以上実行中
# - CPU 使用率が 0%
# - プロセス状態が 'S'（スリープ）
# - ネットワーク接続なし

診断

# 詳細なプロセス情報を取得
ps -o pid,etime,pcpu,stat,command -p <PID>

# ネットワークアクティビティを確認
lsof -p <PID> 2>/dev/null | grep -E "(TCP|ESTABLISHED)" | wc -l
# 結果が 0 の場合、プロセスはハング状態

解決

# ハングしている Gemini プロセスを終了
pkill -9 -f "gemini.*gemini-3-pro-preview"

# または 特定の PID を終了
kill -9 <PID>

# クリーンアップを確認
ps aux | grep gemini | grep -v grep

予防

• バックグラウンド/自動タスクでは常に --approval-mode yolo を使用してください
• 安全のため タイムアウトラッパーを追加: timeout 300 gemini ...
• 非対話シェルで --approval-mode default を使用してはいけません
• 最初の実行を ps で監視してプロセスが完了することを確認

大規模コンテキスト処理のコツ

1. 具体的に: 分析対象についての明確で体系的なプロンプトを提供
2. include-directories を使用: 関連するすべてのディレクトリを明示的に指定
3. 適切なモデルを選択:
   • 複雑な推論、コーディングタスク、最大の分析品質には gemini-3-pro-preview を使用（推奨デフォルト）
   • サブ秒応答が必要な速度重視タスクには gemini-3-flash を使用
   • コスト最適化された大量処理には gemini-2.5-flash を使用
4. Gemini 3 の強みを活用: ソフトウェアエンジニアリングタスクで 35% 優秀、エージェンティックワークフローと vibe コーディングに優秀
5. 複雑なタスクを分割: 大規模なコンテキストでも、体系的な分析がより効果的
6. 検出結果を保存: Gemini に参照用に保存できる構造化レポートを出力するよう依頼

CLI バージョン

Gemini 3 モデルサポートには Gemini CLI v0.16.0 以降が必要です。バージョン確認: gemini --version