Cursor @ 記号
Cursor では、@@ 記号は、さまざまなコンテキスト情報にすばやくアクセスして参照するための強力なツールであり、ユーザーが AI とより効率的に対話するのに役立ちます。
あらゆる AI インタラクションシナリオ(例:⌘Kコマンドパレット、チャットウィンドウ、またはターミナル)で「@」を入力すると@、コンテキスト関連メニューがトリガーされ、現在のプロジェクトで最も関連性の高いリソース(ファイル、コードスニペット、ドキュメントなど)が自動的にフィルタリングされて推奨されます。

キーボード操作:↑/↓方向キーでナビゲートし、Enter で選択を確定します。選択した対象がカテゴリの場合(例:@Files)、リストはそのカテゴリ配下の具体的なリソースをさらにフィルタリングします。
ファイル読み取り戦略:ファイル参照では、Tab キーでCtrl/⌘ M「完全読み取り」または「要約読み取り」モードに切り替えられます(例:全文引用または主要部分のみの引用)。
@ 記号
@@ 記号は以下の主要なコマンドをサポートしています:
| 機能 | 説明 | 使用シーン |
|---|---|---|
| @Files | ファイル全体をコンテキストとして参照します。ファイルパスのプレビューとチャンク処理をサポートします。 | コードファイルやドキュメントなど、特定のファイルの内容を参照する必要がある場合。 |
| @Folders | フォルダ全体をコンテキストとして参照します。 | プロジェクトディレクトリなど、多数のファイルをコンテキストとして提供する必要がある場合。 |
| @Code | 特定のコードスニペットをコンテキストとして参照します。 | 特定のコードスニペットに対してクエリや操作を行う必要がある場合。 |
| @Codebase | コードベースから重要なファイルやコードブロックを検索し、関連性に基づいて並べ替えます。 | コードベース全体から関連するコードやファイルを検索する必要がある場合。 |
| @Git | Git のコミット、差分、またはプルリクエストをスキャンして、問題の発見に役立てます。 | コミット履歴やコード差分など、Git 関連情報を分析する必要がある場合。 |
| @Web | Web 情報を追加のコンテキストとして検索します。 | 最新の Web 情報や外部リソースを取得する必要がある場合。 |
| @Docs | プリセットされたサードパーティ製のドキュメントやカスタムドキュメントを参照します。カスタムドキュメントの追加をサポートします。 | 外部ドキュメントやカスタム知識ベースを参照する必要がある場合。 |
| @Definitions | 近くにあるすべての定義をコンテキストとして参照します。 | 現在のコード内の変数や関数などの定義を参照する必要がある場合。 |
| @Chat | 現在のチャットメッセージをコンテキストとして追加します。 | チャットで以前の会話内容を参照する必要がある場合。 |
高度な使用テクニック
コマンドの組み合わせ:入力すると@Files src/utils/helper.js @Codebase、指定したファイルを参照しつつコードベース全体のコンテキストを関連付けることができ、高度にカスタマイズされたコードを生成できます。
動的リソースの統合:「@」で始まるリンクを貼り付けると、@(例:@https://api.example.com/docs)、Cursor は自動的にコンテンツを解析してコンテキストに組み込みます。
プライバシーと設定管理:「.cursorignore」ファイル(.gitignore と同様)を使用して、.cursorignore機密ファイルやディレクトリのインデックスを除外します。Settings > Features > Docs でカスタムドキュメントリンクを追加して、@Docs@Docs の適用範囲を拡張できます。
典型的なユースケース例
1、コード生成
- プロンプト:ユーザーログイン機能を生成する@Files src/models/user.js @Docs https://jwt.io/introduction
- 結果:既存のユーザーモデルと JWT 公式ドキュメントに基づいて、安全な認証ロジックを生成します。
2、エラー調査
- プロンプト:このエラーの原因を説明する@Code 12-25 行 @Git HEAD~1
- 結果:コードスニペットと最近のコミット履歴を組み合わせて、潜在的な問題を分析します。
3、複数ファイルにわたるリファクタリング
- プロンプト:クラスコンポーネントを関数コンポーネントに変更する@Folders src/components @Codebase
- 結果:一括変換し、グローバルスタイルと状態管理の互換性を確保します。