gemini

Gemini スキルガイド

Gemini を使うタイミング

• 起動を求められたとき
• コードレビュー: 複数ファイルにまたがる包括的なコードレビュー
• 計画レビュー: アーキテクチャ計画、技術仕様、プロジェクトロードマップの分析
• 大規模コンテキスト処理: 200k トークンを超えるコンテキストを必要とするタスク（コードベース全体、ドキュメントセット全体）
• 複数ファイル分析: 多数のファイルにわたる関係性とパターンの理解

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

バックグラウンドや非対話シェル（Claude Code のツール呼び出しなど）では、--approval-mode default を絶対に使用しないでください。 応答できない承認プロンプトを無期限に待ち続けてハングします。

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

• ✅ 完全自動実行には --approval-mode yolo を使用する
• ✅ または timeout 300 gemini ... でラップする
• ❌ 対話型ターミナルなしで --approval-mode default を使用しない

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

• 0% CPU 使用率で 20 分以上実行されているプロセス
• ネットワーク活動がない
• プロセス状態が 'S'（スリープ）と表示される

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

# Check if hung
ps aux | grep gemini | grep -v grep

# Kill if necessary
pkill -9 -f "gemini.*gemini-3-pro-preview"

タスクの実行

1. 1 回のプロンプトで、使用するモデルを（AskUserQuestion 経由で）ユーザーに確認します。利用可能なモデルは次のとおりです:

   • 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 を使用するか、timeout ラッパーを追加してください。非対話シェルでは default を絶対に使用しないでください。

5. コマンドを実行し、出力を取得します。バックグラウンド/自動化モードの場合:

   # Recommended: Use yolo for background tasks
   gemini -m gemini-3-pro-preview --approval-mode yolo "Review this codebase for security issues"
   
   # Or with timeout (5 min limit)
   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	バイブコーディング、SWE-bench 76.2%、入力 $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。

一般的なユースケース

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

# For background execution (Claude Code, CI/CD, etc.)
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"

# With timeout safety (5 minutes)
timeout 300 gemini -m gemini-3-pro-preview --approval-mode yolo \
  "Perform a comprehensive code review..."

計画レビュー（バックグラウンド / 自動化）

# For background execution
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"

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

# For background execution
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"

インタラクティブなコードレビュー（ターミナルのみ）

# ONLY use default mode in interactive terminal
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 コマンドがゼロ以外の終了コードで終了した場合は、処理を停止して失敗を報告してください。
• 失敗したコマンドを再試行する前に、指示を求めてください。
• 影響の大きいフラグ（--approval-mode yolo、-y、--sandbox）を使用する前に、すでに許可されていない限り、AskUserQuestion を使ってユーザーに許可を求めてください。
• 出力に警告や部分的な結果が含まれる場合は、それらを要約し、AskUserQuestion で調整方法を尋ねてください。

応答しない Gemini プロセスのトラブルシューティング

検出

# Check for hung processes
ps aux | grep -E "gemini.*gemini-3" | grep -v grep

# Look for these symptoms:
# - Process running 20+ minutes
# - CPU usage at 0%
# - Process state 'S' (sleeping)
# - No network connections

診断

# Get detailed process info
ps -o pid,etime,pcpu,stat,command -p <PID>

# Check network activity
lsof -p <PID> 2>/dev/null | grep -E "(TCP|ESTABLISHED)" | wc -l
# If result is 0, process is hung

解決

# Kill hung Gemini processes
pkill -9 -f "gemini.*gemini-3-pro-preview"

# Or kill specific PID
kill -9 <PID>

# Verify cleanup
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% 優れており、エージェント型ワークフローやバイブコーディングに特に強みがあります
5. 複雑なタスクを分割する：大きなコンテキストがあっても、構造化された分析の方が効果的です
6. 結果を保存する：後で参照できるよう、構造化されたレポートを出力するよう Gemini に依頼してください

CLI のバージョン

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