Cursorに参照ファイルを確認させるプロンプトの書き方

公開 2026年6月1日更新 2026年7月18日

CursorのAgentが意図しないファイルを読み込まないよう、依頼文に一文追加して参照ファイルを事前確認する方法を実測ベースで解説。過多コンテキスト時の絞り込み・分割の対処もまとめます。

Cursor
プロンプト
AI活用
初心者
Cursor運用
他1

CursorのAgent（エージェント）に依頼すると、指示を読んで関連ファイルを探してくれます。便利な一方で、似た名前の別ファイルまで読み込んだり、添付が多すぎてコンテキスト（文脈として渡る情報）が膨らんだりすることがあります。

本記事は Cursor 開発シリーズの Spoke #6（参照ファイル・コンテキスト指定） です。依頼文に一文足して参照ファイルを事前確認する実運用を残しつつ、過多コンテキスト時の対処も整理します。シリーズ入口は Cursor 開発ガイドです。

この記事の結論

依頼文の末尾に「参照するファイルは作業前に一覧で確認してください」と一文追加するだけで、Agentが読み込むファイルを事前に把握しやすくなります

「使う前に一覧を出して」と具体的な動作を指定すると再現しやすくなります

添付素材は「明示的に添付したものだけ」と条件を書くと、想定外のファイル混入を防ぎやすくなります

一覧が長すぎる・無関係なファイルが増えたときは、添付の絞り込み・不要ファイルの除外・依頼の分割でコンテキストを軽くします

なぜ参照ファイルの確認が必要なのか

CursorのAgentモードは、指示を読んで自律的に関連ファイルを探して作業します。これは便利な反面、意図していないファイルまで読み込んで処理してしまうことがあります。

たとえば「このコンポーネントを修正して」と依頼したとき、Agentが似た名前の別ファイルも参照し、意図しない変更が広がるケースです。

実際に筆者が試した範囲では、依頼文に参照ファイルの事前確認を求める一文を追加するだけで、この問題がかなり防ぎやすくなりました。

チャットでファイルやフォルダを渡すとき（執筆時点では @ による参照が使われることが多いです）も、渡す範囲の明示と作業前の一覧確認をセットにすると扱いやすいです。画面上の操作名・メニュー配置はバージョンで変わることがあるため、未確認の手順は断定せず、重要な判断は公式ドキュメントで確認してください。

手順：依頼文に3点追加するだけ

1. 「参照するファイルは作業前に一覧で確認してください」を末尾に追加する

○○のコンポーネントを修正してください。
参照するファイルは作業前に一覧で確認してください。

これだけで、AgentはまずどのファイルをListするか報告してから作業に入るようになります。

2. 追加素材は「明示的に添付したものだけ」と条件を書く

source.md などの設計メモを渡している場合は、読んでほしいファイルを明示します。

参照するファイルは添付した source.md のみです。
それ以外のファイルは作業前に確認してから使用してください。

3. 想定外のファイルが出てきたら一旦停止して確認する

Agentが一覧に出してきたファイルに見覚えのないものがある場合は、作業前にキャンセルして読み込み順を見直しましょう。「一覧を出させる」のは、このキャンセルタイミングを確保するための手順です。

過多コンテキストの対処

参照確認の一文を入れても、一度に渡すファイルが多すぎる・依頼範囲が広いと、一覧が長くなり、応答が重く感じたり、意図と違うファイルが増えたりすることがあります。筆者の運用では、次の順で軽くしています（件数やトークン数の「正解値」は保証しません）。

添付を絞る — 今回の依頼に必要なファイル・フォルダだけを渡す
一覧を確認する — 作業前に出たリストに不要なパスがないか見る
不要なものを外す — 見当違いのファイルは参照から外し、条件を書き直してから再開する
大きな依頼を分割する — 「調査」「方針」「実装」など、1チャット1目的にする

恒常的に巨大な生成物（node_modules など）を読ませたくない場合は、.cursorignoreでtoken・コンテキストを抑える方法もあわせて検討してください。Agentにどこまで任せるかの方針は、Cursor Agentは記事一括公開と基盤横断変更に絞って使うが参考になります。モード自体の切り替えは Cursorモード使い分けガイド（#2）を参照してください。

テンプレート（コピー用）

【依頼内容をここに書く】

---
参照するファイルは作業前に一覧で確認してください。
明示的に添付したファイル以外を使用する場合は、使用前に確認してください。

まとめ

やること	効果
「作業前に一覧で確認」と書く	Agentが着手前にファイルリストを出す
「添付したものだけ」と限定する	意図しないファイルの自動参照を抑制
一覧に不明ファイルがあればキャンセル	想定外の変更が広がる前に止められる
添付の絞り込み・依頼の分割	過多コンテキストを実運用で軽くする

たった一文の追加ですが、Cursorを使い始めた段階では特に効果を感じやすいはずです。ぜひ次の依頼文から試してみてください。

次に読む

本記事は2026-07-18時点の動作をもとに記載しています。Cursorのエージェント仕様・UI・@ 参照の操作名は変更される場合があります。重要な判断は公式ドキュメントで確認してください。