> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# @メンション

AI との会話にコンテキストを追加し、プロジェクト基準に沿ったコード生成を支援します。コードファイル、プロジェクトフォルダー、ローカル添付ファイル、プロジェクトルールを追加できます。

## コンテキストを追加する方法

| メソッド                 | アクション                             | 説明                                        |
| -------------------- | --------------------------------- | ----------------------------------------- |
| **ボタンをクリック**         | 入力ボックス右下隅にあるコンテキスト選択ボタン `@` をクリック | コンテキストタイプ一覧を表示する選択ウィンドウを開きます              |
| **@ を入力**            | `@` を入力して続けてタイプ                   | リアルタイム検索でファイルやルールを検索し、一致部分をハイライト表示        |
| **ドラッグ＆ドロップまたはペースト** | チャットボックスにファイルや画像をドラッグまたはペーストする    | 対応形式：md, xmind, xlsx, docx, pdf, jpg, png |

## コンテキストの種類

| 種類               | 目的                 | 一般的な使用シーン                         |
| ---------------- | ------------------ | --------------------------------- |
| **@file**        | コードファイルやルールファイルの参照 | 実装の照会、コードのリファクタリング、モジュールの理解       |
| **@folder**      | ディレクトリ全体の参照        | モジュール構造のリファクタリング、テスト生成、複数ファイルクエリ  |
| **@attachments** | ローカルファイルや画像の参照     | モックアップからコード生成、ドキュメント分析、スプレッドシート処理 |
| **@rule**        | プロジェクトルールの参照       | チームスタイルに沿ったコード生成、基準の強制適用          |

## @file

プロジェクト内のコードファイルを参照します。クエリや修正が可能です。

### 追加方法

* `@file` を入力し、ファイル名を入力して検索
* ファイルエクスプローラーからファイルをドラッグしてチャットボックスにドロップ

> ルールファイル（例：`.qoder/rules` ディレクトリ内のファイル）も `@file` 検索で見つけることができます。

## @folder

ディレクトリ全体を参照します。複数の関連ファイルを理解または修正する際に便利です。

### 追加方法

`@folder` を入力し、ディレクトリ名を入力して検索

## @attachments

ローカルファイルや画像を参照し、AI にドキュメント内容の分析、設計図からコード生成、スプレッドシートデータ処理を指示します。

### 対応ファイル形式

| 種類       | 形式            | 使用シーン                       |
| -------- | ------------- | --------------------------- |
| 画像       | jpg, png      | フロントエンドコード生成、レイアウト分析、テキスト抽出 |
| ドキュメント   | md, pdf, docx | コンテンツ分析、情報抽出、コメント生成         |
| スプレッドシート | xlsx          | データ構造分析、処理コード生成             |
| マインドマップ  | xmind         | アーキテクチャ理解、コードフレームワーク生成      |

### 追加方法

* `@attachments` を入力してローカルファイルを選択
* チャットボックスに直接ファイルをドラッグまたはペースト
* 画像は入力ボックスの上部に個別表示され、プレビューに対応

## @rule

プロジェクトルールを参照し、AI に特定のコーディングスタイル、フレームワーク規約、ビジネス基準に準拠させるためのコンテキストです。ルールはモデルの呼び出しごとに永続的かつ再利用可能なコンテキストとして埋め込まれ、チームスタイルや命名規則、フレームワーク使用パターンを一貫して維持します。

### 追加方法

* `@rule` を入力して設定済みルールを選択
* ルールリストが空の場合、設定ページなしでクイックエントリから直接ルールを作成

> ルールファイル（例：`.qoder/rules` ディレクトリ内の `.md` ファイル）は、`@rule` として永続的なコンテキストとして参照することも、`@file` 検索で通常のファイルとして検索することも可能です。

## Add to Chat

ファイル（コードファイルやSpecファイルを含む）は、きめ細かい選択によるコンテキスト追加をサポートしています。ファイル内の任意のコンテンツを選択し、以下の方法で現在の会話に追加できます：

* フローティングメニューの**Add to Chat**をクリック
* ショートカット`Command+L`（macOS）/ `Ctrl+L`（Windows/Linux）を使用

選択したコンテンツはコンテキストとして入力ボックスに添付され、エージェントがあなたの意図をより正確に理解するのに役立ちます。

会話フローの内容も現在のチャットに追加できます —— 会話フローで返信を選択したり特定の内容を引用したりして、**Add to Chat** で入力ボックスに一緒に添付すれば、同じ会話内で前のコンテキストを引き継ぎつつ、再入力の手間を減らせます。

## **ベストプラクティス**

### **コンテキストの種類を組み合わせる**

複数のコンテキストタイプを 1 つのプロンプトで組み合わせ：

```plaintext theme={null}
@src/api.js @tests/api.test.js @rule coding-style
この API モジュールのテストケースを追加し、チームのコーディング基準に準拠させる
```

### **推奨アイテムを活用**

`@` を入力後、Qoder が上位に表示するよく使用されるアイテムをクリックで即時追加：

* **現在編集中のファイル**：編集中のファイル
* **最近開いたファイル**：直近 2 件のアクセスファイル

### **即時検索を活用**

`@` を入力後、タイプを続けるとリアルタイム検索が実行され、一致部分をハイライト表示します。