gemini

@rules/routing.md

Gemini スキル

<output_language>

ユーザー向けの成果物、保存するアーティファクト、レポート、計画、生成ドキュメント、要約、引き継ぎメモ、コミット／メッセージの下書き、検証メモは、このスキルの正規ファイルが英語で書かれていても、すべてデフォルトで韓国語にしてください。

ソースコードの識別子、CLI コマンド、ファイルパス、スキーマキー、JSON/YAML フィールド名、API 名、パッケージ名、固有名詞、引用したソースの抜粋は、必要な言語または原文のままにしてください。

ユーザーが明示的に別の言語を求めた場合、既存の対象アーティファクトの一貫性を保つため別の言語を維持する必要がある場合、または機械可読な契約で英語のトークンが正確に必要な場合に限り、別の言語を使用してください。ローカライズされたテンプレートやリファレンスがある場合（例：*.ko.md や *.ko.json）、ユーザー向けのアーティファクトにはそちらを優先してください。

</output_language>

公式の Google Gemini CLI を、推論、調査、プランモードのレビュー、セッションの継続に使用します。CLI は -p / --prompt を付けてヘッドレスで呼び出す必要があります。位置引数のプロンプトを指定すると、対話型 REPL が開きます。

<instruction_contract>

フィールド	契約
Intent	ユーザーが Gemini CLI または Gemini モデルを明示的に求めた場合に、安全な gemini CLI 呼び出しを構築、実行、または説明します。
Scope	Gemini CLI のコマンド形式、ヘッドレスでのプロンプト使用、承認モードの選択、ユーザーが求めた場合に限るモデル選択、再開フロー、実行前チェック、結果の要約を担当します。
Authority	ユーザーの意図とローカルプロジェクトのルールを最優先します。現在の動作が重要な場合は、インストール済み CLI のヘルプと公式 Gemini CLI ドキュメントに従います。
Evidence	実行前チェック、コマンド形式、CLI の出力、承認モード、確認された警告／エラーに基づいて回答します。
Tools	ユーザーが CLI の実行を希望する場合に限り、シェル実行を使用します。それ以外の場合はコマンドを提示するか、別の方法に切り替えます。
Output	使用または推奨した正確なコマンドを示し、出力／警告を要約し、CLI／モデルのトークンはそのまま維持します。
Verification	コマンド構築前に gemini がインストールされていることを確認し、非対話型の実行では -p を使用していること、編集モード／yolo モードが明示されていること、モデルの上書きがユーザーの要求によるものであることを確認します。
Stop condition	要求された Gemini コマンドを構築または実行し、その結果、警告、または阻害要因を報告した時点で終了します。

</instruction_contract>

デフォルト

パラメーター	デフォルト
モデルの選択	ユーザーが -m pro、-m flash、-m flash-lite、または特定の ID を明示的に求めない限り、Gemini CLI のデフォルト（-m auto）を使用します。
承認モード	--approval-mode default（ツール呼び出しのたびに確認します）
ヘッドレスモード	-p / --prompt
再開対象	gemini --resume latest（または直近のセッションには gemini -r）
出力形式	text（呼び出し元が構造化出力を必要とする場合に限り、--output-format json を使用します）

ユーザーが明示的にモデルを指定しない限り、-m を指定しないでください。自動ルーティングでは、推論に Pro、実行に Flash が選ばれます。

ルーティング

Gemini CLI または Gemini セッションが実際に必要な場合に限り、このスキルを使用します。

• 依頼が対象範囲外の可能性がある場合は、コマンドを構築する前に rules/routing.md を読んでください。
• ユーザーが Gemini CLI を必要とせず、一般的な文章作成、ランブックの整理、ローカルでの編集を求めている場合は、直接編集するか別のスキルに切り替えてください。

例

該当する例：

• 「Gemini を使ってこのアーキテクチャをレビューし、リスクを列挙してください。」
• 「gemini -p を実行して、現在の API の動作を調査してください。」
• 「Gemini Pro に、この設計上のトレードオフについて推論させてください。」
• 「最新の Gemini セッションを再開して、分析を続けてください。」

該当しない例：

• 「このランブックを読みやすく書き直してください。」
• 「このローカルコードを直接編集してください。」
• 「このリポジトリ用の新しいスキルを作成してください。」

境界の例：

• 「Gemini CLI の承認モードを調査して説明してください。」 ユーザーが gemini CLI の使用を求めている場合に限り、このスキルを使用します。それ以外の場合は、調査または直接のドキュメント作業に切り替えてください。

重要：ヘッドレスモード

非対話型の Gemini 実行では、必ず -p / --prompt を使用してください。位置引数でプロンプトを指定すると、対話型 REPL が起動し、自動化が停止します。

# Correct — non-interactive
gemini --approval-mode default -p "your prompt here"

# Interactive (do not use for automation)
gemini "your prompt here"

プロンプトを設定してから対話を続ける必要がある場合は、代わりに -i / --prompt-interactive を使用してください。-p は、1 回限りの自動実行用です。

タスクの実行

承認モードの変更、サンドボックスの追加、モデルの選択、セッションの再開を行う前に、具体的なコマンド例について references/recipes.md をお読みください。

承認モードの選択

フラグ	使用する場面
--approval-mode default	一般的な調査、推論、標準的な Gemini の使用
--approval-mode auto_edit	ユーザーが Gemini にファイルの編集を明示的に依頼した場合のみ
--approval-mode plan	コードを変更しない読み取り専用の計画や分析（書き込みは plans ディレクトリ内の Markdown に制限されます）
--approval-mode yolo	ユーザーが全自動実行を明示的に承認した場合のみ。裸の --yolo フラグは非推奨のため、この表記を優先してください。

コマンドの運用

• gemini --approval-mode default -p "your prompt here" から始めてください。
• ユーザーが特定の Gemini モデルを明示的に指定した場合にのみ、-m <pro|flash|flash-lite|auto|model-id> を追加してください。
• 通常の編集には、完全な自動承認ではなく --approval-mode auto_edit を使用してください。
• --approval-mode yolo を使用する前に、ユーザーに確認してください。まず --approval-mode auto_edit または --sandbox を使用してください。
• タスクのリスクが高い場合、またはローカルの制約を厳しくしたい場合は、--sandbox（-s）を追加してください。
• Gemini が現在のフォルダー外のコンテキストを必要とする場合は、追加のワークスペースを --include-directories /path/a,/path/b で渡してください。
• 呼び出し元が応答をプログラムで解析する場合にのみ、--output-format json を使用してください。

セッションの再開

gemini --resume latest -p "your follow-up prompt"
gemini --list-sessions
gemini --delete-session 2

--resume には、latest、--list-sessions のインデックス、または完全なセッション UUID を指定できます。対話型セッション内では、/resume で Session Browser を開き、/rewind で前の状態に戻れます。

セッションを再開する際は、ユーザーから依頼がない限り、既存のセッションの動作を維持し、モデルや承認モードを変更しないでください。

完了後

• 警告や部分的な出力も含め、結果を要約してください。
• gemini --resume latest（または gemini -r）でセッションを再開できることをユーザーに伝えてください。
• 続行するか、プロンプトを調整するか、直接の作業に戻るかを尋ねてください。

重要な評価方針

Gemini は権威者ではなく、同僚として扱ってください。

• 確信がある場合は、自分の知識を信頼してください。誤った主張には、はっきりと異議を唱えてください。
• 意見が食い違う場合は、Gemini の主張を受け入れる前に、最新の情報源やドキュメントを使って調査してください。
• 知識のカットオフを意識してください。Gemini は最近のリリースや API の変更を把握していない可能性があります。
• 情報の鮮度が重要な場合は、Gemini に最新の情報源を求め、重要な主張をドキュメントや一次情報源と照合してください。
• 真に曖昧な点がある場合は、ユーザーに判断を委ねてください。

事前確認

コマンドを作成する前に、CLI がインストールされ、PATH 上にあることを確認してください。

command -v gemini >/dev/null 2>&1 || { echo "gemini CLI not found"; exit 1; }

確認に失敗した場合は、gemini ... コマンドを作成せず、以下のエラー処理のインストール手順に案内してください。

エラー処理

• command not found: gemini：npm install -g @google/gemini-cli（または brew install gemini-cli）でインストールするようユーザーに伝えてください。
• 認証エラー：gemini を実行してサインインを完了するか、GEMINI_API_KEY を設定してください。Vertex AI の場合は、GOOGLE_API_KEY と GOOGLE_GENAI_USE_VERTEXAI=true を設定してください。
• 429 / レート制限：Gemini 3 の無料枠は 60 req/min、1000 req/day です。時間を置くか、アップグレードしてください。
• 404 / モデルが見つからない：-m を付けずに再試行するか、gemini --help と公式ドキュメントから pro／flash／flash-lite を選択してください。
• 403 / アクセス拒否：有効な認証方法を確認し、サポートされているモデルまたはアカウント設定で再試行してください。
• セッションが見つからない：gemini --list-sessions を実行してください。
• 終了コード 42 は入力エラー（不正なフラグ／プロンプト）、53 はターン制限超過を意味します。

バージョンに関する注意事項

• Gemini CLI v0.40.0 の動作を対象とします。最小サポートバージョンは v0.21.1 です（Gemini 3 のルーティング）。
• --yolo は非推奨です。正式な形式は --approval-mode yolo です。
• Plan Mode はデフォルトで有効です。明示的に起動するには、--approval-mode plan またはセッション中に /plan を使用します。
• 非 TTY 環境では、ヘッドレスモードが自動的に有効になります。また、-p が指定された場合も有効になります。

<validation_checklist>

• リクエストで Gemini CLI、Gemini モデル、または Gemini セッションが明示的に必要とされています。
• 実行可能なコマンドを組み立てる前に、command -v gemini などの事前確認を行います。
• 非対話型の実行では -p / --prompt を使用し、自動化に位置引数のプロンプトは使用しません。
• ユーザーが明示的にモデルを指定しない限り、モデルフラグは省略します。
• auto_edit および yolo の承認モードは、文書化された条件を満たす場合にのみ使用します。
• 最終出力には、コマンドの形式、確認された結果、警告、およびインストール／認証／レート制限／モデルに関する障害があればそれを含めます。

</validation_checklist>