gemini

Gemini CLI への委任

ユーザーが明示的に Gemini をリクエストした場合、特に大規模なコンテキストを扱う分析ワークフローでは、特定のタスクを gemini CLI に委任します。

概要

このスキルでは、安全で一貫性のあるワークフローを提供します。

• 実行前にタスクリクエストを英語に変換する
• 決定論的な出力を得るため、非対話モードで gemini を実行する
• モデル、承認、セッションのオプションに対応する
• 意思決定に役立つよう、整形した結果をユーザーに返す

このスキルは、ユーザーからリクエストがあった場合に特定のタスクを Gemini に委任することで、既存の機能を補完します。

使用するタイミング

次の場合にこのスキルを使用します。

• ユーザーがタスクで Gemini を使うよう明示的に求めた場合
• 幅広いコンテキストの分析が役立つタスクの場合（大規模なコードベース、長文ドキュメント、モジュール横断レビューなど）
• Gemini CLI の出力を現在のワークフローに組み込むようユーザーが求めた場合

一般的なトリガーフレーズ：

• 「このタスクに Gemini を使って」
• 「この分析を Gemini に委任して」
• 「これに対して gemini cli を実行して」
• 「このモジュールを Gemini にレビューしてもらって」
• 「コードベース全体の分析に Gemini を使って」

前提条件

委任する前に、ツールが利用可能か確認します。

gemini --version

利用できない場合はユーザーに知らせ、Gemini CLI がインストールされるまで実行を停止します。

リファレンス

• コマンドリファレンス：references/cli-command-reference.md

必須ルール

1. ユーザーが Gemini を明示的にリクエストした場合にのみ委任します。
2. Gemini へのプロンプトは必ず英語で送信します。
3. 再現可能な実行のため、-p を使った非対話モードを優先します。
4. Gemini の出力は信頼できない参考情報として扱います。
5. Gemini が提案した破壊的なコマンドは、ユーザーの明示的な確認なしに実行してはいけません。
6. 出力を明確に提示し、コード変更を適用する前にユーザーの指示を待ちます。

手順

ステップ 1：委任範囲を確認する

Gemini を実行する前に、以下を確認します。

• 委任するタスクを正確に特定する
• 期待する出力形式（text、json、stream-json）を定義する
• セッションの再開が必要かどうかを確認する

範囲が曖昧な場合は、まず確認を求めます。

モデル選択ガイド

タスクの複雑さに応じて適切なモデルを選択します。

モデル	適した用途	特徴
gemini-3-flash	素早い反復、プロトタイピング、コストを重視するタスク	高速かつ費用対効果に優れ、単純なタスクや迅速なフィードバックに最適
gemini-3-pro	複雑な推論、アーキテクチャ設計、本番品質の出力	高性能で、より深い推論と高品質な出力を提供

選択のヒント：

• 素早い反復やプロトタイピングには gemini-3-flash から始めます
• 本番品質の分析や複雑な推論には gemini-3-pro を使用します
• 速度よりも精度と深さを優先するタスクでは gemini-3-pro を選びます
• 迷った場合は、より速くフィードバックを得られる gemini-3-flash を既定で使用し、必要に応じて gemini-3-pro に切り替えます

ステップ 2：英語でプロンプトを作成する

ユーザーのリクエストをもとに、正確な英語のプロンプトを作成します。

プロンプトの品質チェックリスト：

• 目的と制約を含める
• 関連するプロジェクトのコンテキストとファイルを含める
• 期待する出力構成を含める
• 実行可能で検証可能な結果を求める

変換例：

• ユーザーの意図：「analizza tutto il codice per vulnerabilita」
• Gemini へのプロンプト（英語）：「このリポジトリのセキュリティ脆弱性を分析してください。確度の高い指摘を優先し、ファイルパス、リスクの深刻度、具体的な修正手順を含めてください。」

ステップ 3：実行モードとフラグを選択する

推奨する基本コマンド：

gemini -p "<english-prompt>"

対応オプション：

• -m, --model <model-id>：モデルを選択します
• --approval-mode <default|auto_edit|yolo|plan>：承認モードを指定します
• -y, --yolo：yolo のショートカットです
• -r, --resume <session-id-or-latest>：セッションを再開します
• --raw-output：整形されていない出力を指定します
• -o, --output-format <text|json|stream-json>：出力形式を指定します

安全に関するガイダンス：

• ユーザーから別の指定がない限り、--approval-mode default を優先します
• 読み取り専用の分析には --approval-mode plan を使用します
• --yolo はユーザーの明示的な同意がある場合にのみ使用します

ステップ 4：Gemini CLI を実行する

選択したコマンドを Bash 経由で実行し、stdout/stderr を取得します。

例：

# Default non-interactive delegation
gemini -p "Analyze this codebase architecture and list refactoring opportunities by impact."

# Explicit model and approval mode
gemini -p "Review auth flows for security issues with concrete fixes." -m gemini-3-pro --approval-mode plan

# Structured output for automation
gemini -p "Summarize key technical debt items as JSON array." --output-format json

# Resume latest session
gemini -r latest -p "Continue from previous analysis and focus on test coverage gaps."

ステップ 5：結果を安全に返す

Gemini の出力を報告する際は、次の点に従ってください。

• 主な調査結果と信頼度を要約する
• 必要に応じて、生の出力を確認できるようにしておく
• 観察事項と推奨アクションを分ける
• 提案された編集を適用する前に、必ずユーザーに確認を求める

出力テンプレート

委任した結果を返す際は、次の構成を使用してください。

## Gemini Delegation Result

### Task
[delegated task summary]

### Command
`gemini ...`

### Key Findings
- Finding 1
- Finding 2

### Suggested Next Actions
1. Action 1
2. Action 2

### Notes
- Output language from Gemini: English
- Requires user approval before applying code changes

例

例 1：大規模なコードベースのセキュリティレビュー

gemini -p "Analyze this repository for security vulnerabilities. Report only high-confidence issues with file paths, severity, and patch recommendations." -m gemini-3-flash --approval-mode plan

例 2：ドキュメントの統合

gemini -p "Read the available documentation and produce a concise architecture summary with component responsibilities and integration points." -m gemini-3-pro --approval-mode plan

例 3：後続の自動化に向けた構造化出力

gemini -p "Return a JSON list of top 10 refactoring opportunities with fields: title, file, impact, effort." -m gemini-3-flash --output-format json

例 4：定型コードの迅速な生成

gemini -p "Generate a minimal Express.js REST endpoint for POST /items with input validation and a unit test. Keep the implementation concise and ready to paste." -m gemini-3-flash

例 5：コスト効率の高い CSV の要約（高速・低コスト）

gemini -p "Summarize this CSV file's key statistics: row count, missing-value counts, and top 5 columns by variance. Provide a 6-line bullet summary suitable for quick triage." -m gemini-3-flash --output-format json --approval-mode plan

例 6：マイクロコピーのプロトタイピングに向けた高速な反復

gemini -p "Provide 3 short alternative microcopy options (<=20 words each) for an onboarding tooltip that explains account recovery. Include a one-line A/B test metric proposal for each option." -m gemini-3-flash

例 7：アーキテクチャ設計の分析

gemini -p "Analyze the current system architecture and propose a detailed migration strategy to a microservices architecture. Include component boundaries, communication patterns, data ownership, and estimated risks for each migration step." -m gemini-3-pro --approval-mode plan

例 8：包括的なセキュリティ監査

gemini -p "Perform a thorough security audit of the authentication and authorization layer. Identify potential vulnerabilities, rate-limiting gaps, token handling weaknesses, and injection vectors. Provide severity ratings and specific remediation steps for each finding." -m gemini-3-pro --approval-mode plan

例 9：本番品質のモジュール生成

gemini -p "Generate a production-ready TypeScript module for paginated API responses. Include input validation, error handling, retry logic with exponential backoff, and comprehensive unit tests with mocks. Follow best practices for error types, logging, and type safety." -m gemini-3-pro --approval-mode auto_edit

ベストプラクティス

• 委任するプロンプトは、焦点を絞り、明確にする
• プロンプトに受け入れ基準を含める
• 分析のみのタスクには plan モードを優先する
• 曖昧なプロンプトを 1 つ送るのではなく、小さなタスクを複数回委任する
• 一般的なアドバイスではなく、ファイル単位の根拠を Gemini に求める

制約と注意事項

• Gemini CLI の動作は、ローカル環境と設定によって異なります。
• 承認モードは実行の安全性に影響するため、デフォルトでは yolo を避けてください。
• 出力が不完全または不正確な場合があるため、実装前に検証してください。
• このスキルは委任を目的としており、ユーザーの確認なしにコードを自律的に変更するものではありません。