Gemini CLI Knowledge
Gemini CLI の仕様と使い方に関する包括的な知識を提供するスキル。
利用可能なモデル
Auto オプション（推奨）
| モデル | 説明 |
|---|---|
| Auto (Gemini 3) | システムがタスクに最適な Gemini 3 モデルを自動選択 |
| Auto (Gemini 2.5) | システムがタスクに最適な Gemini 2.5 モデルを自動選択 |
手動選択モデル
| モデル | 特徴 | 用途 |
|---|---|---|
| gemini-3-pro-preview | 高度な推論、創造性 | 複雑なタスク、深い分析 |
| gemini-3-flash-preview | 高速レスポンス | シンプルなタスク、クイック応答 |
| gemini-2.5-pro | Pro の安定版 | 本番環境での複雑なタスク |
| gemini-2.5-flash | Flash の安定版 | 本番環境での高速処理 |
モデル選択のベストプラクティス
- •Auto 推奨: ほとんどのユーザーにとってバランスの取れた選択肢
- •Pro 選択時: より高度な推論と創造性が必要な複雑なタスク向け
- •Flash 選択時: 高速な結果が必要なシンプルなタスク向け
モデル変更方法
code
# セッション中に変更 /model # 起動時に指定 gemini --model gemini-3-pro-preview
注意: /model コマンドはサブエージェントのモデルを上書きしない。
Gemini 3 プレビュー有効化
Gemini 3 プレビューモデルを使用するには:
- •
/settingsコマンドを実行 - •Preview Features を有効化
スラッシュコマンド一覧
会話管理
| コマンド | 説明 |
|---|---|
/chat save <tag> | 現在の会話履歴をタグ付きで保存 |
/chat resume <tag> | 保存した会話を再開 |
/chat list | 保存済みタグの一覧表示 |
/compress | チャット文脈全体を要約に置き換えてトークン節約 |
表示・設定
| コマンド | 説明 |
|---|---|
/clear | ターミナル画面をクリア（Ctrl+L でも可） |
/settings | 設定エディタを開く |
/theme | ビジュアルテーマを変更 |
/model | Gemini モデルを選択 |
ツール・機能
| コマンド | 説明 |
|---|---|
/tools | 利用可能なツールのリスト表示 |
/mcp | Model Context Protocol サーバーを管理 |
/memory | AI の教示的文脈を管理（GEMINI.md から読み込み） |
/extensions | アクティブな拡張機能を表示 |
その他
| コマンド | 説明 |
|---|---|
/bug <説明> | GitHub に問題を報告 |
/help | ヘルプ情報を表示 |
/quit | Gemini CLI を終了 |
組み込みツール
ファイルシステムツール
| ツール | 別名 | 説明 |
|---|---|---|
list_directory | ReadFolder | ディレクトリ内のファイル一覧表示。glob パターン対応、.gitignore 尊重オプション |
read_file | ReadFile | テキスト、画像（PNG, JPG, GIF）、オーディオ、PDF 読み込み。行範囲指定可能 |
write_file | WriteFile | ファイル書き込み。存在しない場合は作成、親ディレクトリも自動生成 |
glob | FindFiles | glob パターンでファイル検索。修正時刻でソート |
search_file_content | SearchText | 正規表現でファイル内検索。行番号付きで結果返却 |
replace | Edit | ファイル内テキスト置換。前後3行以上のコンテキスト必要 |
シェルツール
run_shell_command
シェルコマンドを実行するツール。
| プラットフォーム | シェル |
|---|---|
| Windows | PowerShell |
| その他 | bash |
引数:
- •
command(必須): 実行するシェルコマンド - •
description(オプション): コマンドの説明 - •
directory(オプション): 実行ディレクトリ
返却値:
- •標準出力・標準エラー出力
- •終了コード
- •バックグラウンドプロセスの PID
対話モード有効化:
code
settings > tools.shell.enableInteractiveShell: true
Web ツール
web_fetch
URL からコンテンツを取得。
- •最大 20 URL を 1 回のプロンプトで処理可能
- •要約、比較、情報抽出に対応
- •Gemini API アクセス不可時はローカルからフォールバック取得
google_web_search
Google Search 経由で Web 検索を実行。
- •ソース付きの要約を返却
- •生の検索結果リストではなく処理された要約
使用例:
code
google_web_search(query="AI 最新ニュース 2025")
メモリツール
save_memory
セッション間で情報を保存・回想。
- •保存先:
~/.gemini/GEMINI.md - •簡潔で重要なファクト用に設計
- •大量データや会話履歴の保存には不向き
使用例:
code
save_memory(fact="My preferred programming language is Python.")
タスク管理ツール
write_todos
複雑なタスクを管理するためのツール。
CLI フラグ
| フラグ | 説明 |
|---|---|
--yolo | ツール実行の許可プロンプトをスキップ（自動実行） |
--model <model> | 起動時に使用モデルを指定 |
使用例:
bash
# 許可プロンプトなしで実行 gemini --yolo "ファイル一覧を表示して" # モデル指定で起動 gemini --model gemini-3-pro-preview
拡張機能システム
概要
Gemini CLI 拡張機能は、プロンプト、MCP サーバー、カスタムコマンドを使いやすい形式にパッケージ化するツール。
拡張機能構造
code
my-extension/ ├── gemini-extension.json # マニフェスト ├── commands/ # カスタムコマンド（TOML 形式） │ └── my-command.toml ├── hooks/ │ └── hooks.json # フック定義 └── prompts/ # プロンプトテンプレート
カスタムコマンド
commands/ ディレクトリに TOML ファイルを配置。
例: gcp 拡張機能
- •
/deployコマンド - •
/gcs:syncコマンド
フック
hooks/hooks.json で定義。特定のライフサイクルイベントで Gemini CLI の動作をインターセプト・カスタマイズ可能。
MCP サーバー統合
gemini-extension.json の mcpServers マップで設定。起動時に自動読み込み。
優先度: settings.json > 拡張機能設定
変数置換
| 変数 | 説明 |
|---|---|
${extensionPath} | 拡張機能のルートディレクトリ |
${workspacePath} | 現在のワークスペースパス |
拡張機能管理コマンド
bash
# インストール gemini extensions install <name> # アンインストール gemini extensions uninstall <name> # 有効化/無効化 gemini extensions enable <name> gemini extensions disable <name>
メモリシステム（GEMINI.md）
概要
~/.gemini/GEMINI.md ファイルで AI の教示的文脈を管理。
用途
- •ユーザー設定の記憶
- •プロジェクト情報の保存
- •よく使うパターンの定義
管理方法
code
# CLI から管理 /memory # 手動編集も可能 vim ~/.gemini/GEMINI.md
セキュリティ機能
ツール実行確認
- •ファイル修正やコマンド実行時に確認プロンプト表示
- •
--yoloフラグでスキップ可能
サンドボックス制限
- •すべてのツールはサンドボックス制限の対象
- •
rootDirectory内でのみ動作
コマンド制限
tools.core と tools.exclude で許可・ブロックするコマンドを指定。
注意: 制限機能はセキュリティメカニズムではなく、信頼できないコードの実行には不適切。
インストール方法
bash
# npm npm install -g @google/gemini-cli # Homebrew brew install gemini-cli
よくある質問
Q: モデルを変更するには？
code
/model
または起動時に --model フラグ。
Q: 会話を保存するには？
code
/chat save my-session
Q: 保存した会話を再開するには？
code
/chat resume my-session
Q: Web 検索を行うには？
プロンプトで検索を依頼するだけ。Gemini が自動的に google_web_search を使用。
Q: 許可プロンプトをスキップするには？
bash
gemini --yolo "コマンド"