ブログ記事
- Cursor
- プロンプト
- AI活用
- 初心者
- Cursor運用
- Tips
Cursorに参照ファイルを確認させるプロンプトの書き方
"Cursorのエージェントが意図しないファイルを読み込まないよう、依頼文に一文追加するだけで参照ファイルを事前確認させる方法を実測ベースで解説します。"
この記事の結論
- 依頼文の末尾に「参照するファイルは作業前に一覧で確認してください」と一文追加するだけで、Agentが読み込むファイルを事前に把握できます
- 「使う前に一覧を出して」と具体的な動作を指定すると再現しやすくなります
- 添付素材は「明示的に添付したものだけ」と条件を書くと、想定外のファイル混入を防ぎやすくなります
なぜ参照ファイルの確認が必要なのか
CursorのAgent(エージェント)モードは、指示を読んで自律的に関連ファイルを探して作業します。これは便利な反面、意図していないファイルまで読み込んで処理してしまうことがあります。
たとえば「このコンポーネントを修正して」と依頼したとき、Agentが似た名前の別ファイルも参照し、意図しない変更が広がるケースです。
実際に筆者が試した範囲では、依頼文に参照ファイルの事前確認を求める一文を追加するだけで、この問題がかなり防ぎやすくなりました。
手順:依頼文に3点追加するだけ
1. 「参照するファイルは作業前に一覧で確認してください」を末尾に追加する
○○のコンポーネントを修正してください。
参照するファイルは作業前に一覧で確認してください。
これだけで、AgentはまずどのファイルをListするか報告してから作業に入るようになります。
2. 追加素材は「明示的に添付したものだけ」と条件を書く
source.md などの設計メモを渡している場合は、読んでほしいファイルを明示します。
参照するファイルは添付した source.md のみです。
それ以外のファイルは作業前に確認してから使用してください。
3. 想定外のファイルが出てきたら一旦停止して確認する
Agentが一覧に出してきたファイルに見覚えのないものがある場合は、作業前にキャンセルして読み込み順を見直しましょう。「一覧を出させる」のは、このキャンセルタイミングを確保するための手順です。
テンプレート(コピー用)
【依頼内容をここに書く】
---
参照するファイルは作業前に一覧で確認してください。
明示的に添付したファイル以外を使用する場合は、使用前に確認してください。
まとめ
| やること | 効果 |
|---|---|
| 「作業前に一覧で確認」と書く | Agentが着手前にファイルリストを出す |
| 「添付したものだけ」と限定する | 意図しないファイルの自動参照を抑制 |
| 一覧に不明ファイルがあればキャンセル | 想定外の変更が広がる前に止められる |
たった一文の追加ですが、Cursorを使い始めた段階では特に効果を感じやすいはずです。ぜひ次の依頼文から試してみてください。
次に読む
本記事は2026年6月1日時点の動作をもとに記載しています。Cursorのエージェント仕様は変更される場合があります。重要な判断は公式ドキュメントで確認してください。