Cursor での Gemini 3.1 Pro の最適化：ヒントと修正
Gemini 3.1 Pro は Cursor で利用可能な強力なモデルですが、ユーザーはしばしば隠れた推論、ループ動作、および最適でないツール使用について問題を報告します。このガイドでは、Cursor ワークフローで Gemini の最高のパフォーマンスを得るための実証済みの修正と最適化テクニックを提供します。
Cursor での Gemini の一般的な問題
問題 1：隠れた推論プロセス
Gemini 3.1 Pro はデフォルトで思考プロセスを隠し、どのように解決策に到達したかを理解するのが難しくなります。
問題 2：ループ動作
モデルは時々ループに陥り、同じアプローチを繰り返し試しても進展がありません。
問題 3：ツール使用の不備
Gemini はコードベースの探索のために Cursor の組み込みツール（Read、Grep、Shell）を効果的に使用できない場合があります。
修正：ツール使用の強制と可視化された推論
これらの指示を Cursor システムプロンプトに追加するか、各チャットの開始時に追加してください：
## Gemini 最適化指示
すべてのコードベース操作にツールを使用する必要があります。以下の正確なワークフローに従ってください：
### ステップ 1：探索
- Read ツールを使用して関連ファイルを確認する
- Grep を使用してパターンを検索する
- Shell を使用してファイル構造を確認する
### ステップ 2：各ツール呼び出し後
すべてのツール呼び出し後に、以下を含む可視化されたテキストサマリーを出力してください：
- 何を発見したか
- タスクにとってそれが何を意味するか
- 次に何をするか
### ステップ 3：実装
- 探索に基づいて変更を行う
- 編集後に Read で検証する
- 何が変更されたか、なぜ変更されたかを報告する
### 重要なルール
- ファイルの内容を推測しない——常に Read を使用する
- ツール呼び出し後のサマリーをスキップしない
- 行き詰まった場合、何を試したかを明確に述べ、方向性を求める
- 進捗を追跡するために番号付きステップを使用する
Cursor での設定
方法 1：プロジェクト固有のルール
.cursor/rules/gemini-optimization.mdc を作成してください：
---
description: 'Gemini にツールの使用と推論の表示を強制する'
globs: ['**/*']
alwaysApply: true
---
# Gemini 3.1 Pro の最適化
このモデルがアクティブな場合：
1. **常に最初にツールを使用する** - 変更を行う前に Read、Grep、Shell を使用する
2. **作業を表示する** - 各ツール呼び出し後、可視化されたテキストで発見を要約する
3. **ステップに番号を付ける** - "ステップ 1/5"、"ステップ 2/5" 形式を使用する
4. **ブロッカーを報告する** - 何かが機能しない場合、明確に述べる
5. **変更を検証する** - 編集後にファイルを読み込んで確認する
方法 2：チャットプレフィックス
すべての Gemini チャットを以下で開始してください：
ツールを使用してコードベースを探索してください。各ツール呼び出し後、発見したことと次のステップを要約してください。ステップに番号を付けてください。
ループの防止
ループ検出パターン
Gemini が繰り返し始めた場合、このプロンプトを使用してください：
停止。ループに陥っているようです。
一歩下がって：
1. これまでに試したことを述べる
2. なぜ機能しないかを特定する
3. 全く異なるアプローチを提案する
4. 続行すべきかどうかを尋ねる
予防的なループ防止
ルールに追加してください：
## ループ防止
- 同じエラーが 3 回発生した場合、停止して助けを求める
- 2 回の検索後にファイルが見つからない場合、正しいパスを尋ねる
- 解決策が複雑すぎる場合、よりシンプルな代替案を提案する
- ユーザー確認が必要になる前の最大ツール呼び出し回数は 5 回
ツール呼び出しの最適化
構造化ツール使用
Gemini に特定の順序でツールを使用させます：
## 必要なツールシーケンス
任意のタスクに対して：
1. **Grep** - 関連するコードパターンを検索する
2. **Read** - 見つかった最も関連性の高いファイルを確認する
3. **Shell** - 依存関係とプロジェクト構造を確認する
4. **Plan** - 実装前にアプローチを提示する
5. **Edit** - 変更を行う
6. **Verify** - 変更されたファイルを読み込んで確認する
ファイル探索テンプレート
未知のコードを探索する場合：
[機能] を理解する必要があります。以下をお願いします：
1. コードベースで "[キーワード]" を Grep する
2. 最も関連性の高い上位 3 つのファイルを読む
3. アーキテクチャを要約する
4. 変更を行うべき場所を特定する
5. 編集前に計画を提示する
パフォーマンス比較
| メトリクス | デフォルトの Gemini | 最適化された Gemini |
|---|---|---|
| ツール使用率 | 40% | 95% |
| ループ頻度 | 高 | 低 |
| 推論の可視性 | 隠れている | 可視 |
| タスク完了率 | 60% | 90% |
| ユーザー満足度 | 低 | 高 |
高度な設定：カスタムシステムプロンプト
最大の制御を得るために、Cursor でカスタムシステムプロンプトを設定してください：
- 設定を開く（
Cmd/Ctrl + ,） - "AI 機能" または "チャット" に移動する
- "システムプロンプト" または "カスタム指示" を見つける
- 以下を貼り付ける：
あなたは Cursor IDE を使用する専門ソフトウェアエンジニアです。
重要なルール：
1. 編集前に常に Read/Grep/Shell ツールを使用する
2. すべてのツール呼び出し後に、可視化されたサマリーを出力する
3. 番号付きステップを使用する（ステップ 1/N、ステップ 2/N）
4. 3 回の試行後に行き詰まった場合、助けを求める
5. 変更されたファイルを読み込んですべての変更を検証する
6. 各変更を行った理由を説明する
ワークフロー：
1. 探索 → 2. 計画 → 3. 実装 → 4. 検証 → 5. 報告
特定のシナリオのトラブルシューティング
シナリオ：Gemini がファイルを読まない
修正： ツール使用を明示的に要求する：
変更を提案する前に、Read ツールを使用して src/components/Button.tsx を確認してください。
シナリオ：Gemini が曖昧な回答をする
修正： 構造化された出力を要求する：
以下の形式で回答を提供してください：
1. 現在の状態（何を見つけたか）
2. 問題分析（何が問題か）
3. 解決策（具体的な変更）
4. 検証（どのように機能することを確認するか）
シナリオ：Gemini がプロジェクトコンテキストを無視する
修正： AGENTS.md またはプロジェクトドキュメントを参照する：
まず AGENTS.md を読み、その後に記載されているコーディング標準に従ってこのタスクを実行してください。
クイックリファレンスカード
| 問題 | クイック修正 |
|---|---|
| 隠れた推論 | "段階的な思考を表示する" を追加する |
| ツールを使用しない | "先に Read/Grep/Shell を使用する" を追加する |
| ループ | "行き詰まった場合、3 回の試行後に助けを求める" を追加する |
| 曖昧な回答 | "番号付きステップを使用し、具体的にする" を追加する |
| 誤ったファイル編集 | "編集前に Grep でファイルパスを検証する" を追加する |