> ## 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.

# Agent モード

Agent モードは、Quest における自律的なプログラミング機能です。Agent が開発タスクをエンドツーエンドで完了します。要件の明確化、ソリューションの計画、コードの実行、結果の検証を、継続的な人的介入なしで自律的に行います。

## 適用シナリオ

* **機能開発とリファクタリング**: 新機能の開発、難しいバグの修正、またはコードのリファクタリングに最適です。明確な技術計画が必要なタスクでは、Spec 駆動シナリオをお勧めします。Agent はプロジェクトのコンテキストを確認し、コーディングを開始する前に全体的な方向性があなたの期待と一致することを確認するための構造化された Spec ドキュメントを最初に生成します。
* **プロトタイプの迅速な検証**: プロダクトのアイデア検証や、ゼロからのデモプロトタイプ構築に最適です。プロトタイプ探索シナリオを選択すると、Spec をスキップして直接コーディングに入ります。概要ファイルエリアのリアルタイムプレビュー機能を使用して、実際の実行結果をすぐに確認できます。
* **自動化ツールの構築**: バッチ処理スクリプト、データクレンジングツール、カスタム CLI スクリプトの作成に最適です。ツール作成シナリオを選択すると、Agent は環境を自動的に評価し、ツールをエンドツーエンドで構築するための最適な技術スタックを選択します。
* **迅速なイテレーションと最適化**: 探索的な調整に最適です。まず Agent に基本的な MVP バージョンを提供させ、初期結果を確認した後、チャットで自然言語の要件（例：「ボタンを大きくする」「ダークテーマに切り替える」）を追加することで、迅速に反復を続けることができます。

## 使用ガイド

### タスクの作成

左側のタスクリスト上部にある **New Quest** ボタンをクリックし、ポップアップパネルで **Agent** モードを選択します。ここで初期要件を指定し、Spec 駆動の実行を有効にするかどうかを選択できます。

### 送信済みメッセージの編集

会話中に重要なコンテキストを見落としたり、誤った指示を出したことに気付いたりした場合は、送信済みメッセージの吹き出しをクリックして編集モードに入ることができます。編集モードでは、以下のことができます：

* **プロンプトの変更**: 入力したテキストを再編集して、より正確にします。
* **添付コンテキストの変更**: メッセージに添付されたファイル、コードスニペット、スクリーンショットの追加、削除、置換を行います。
* **モデルとモードの切り替え**: タスクの難易度に基づいてより強力なモデルに切り替えたり、会話モードを変更したりします。

変更を送信すると、ワークスペースのファイルはそのターンの会話前の状態に安全にロールバックされます。このメッセージ以降に生成されたすべてのファイルの変更は自動的に破棄されるため、負担なく軌道修正できます。

<Note>編集状態では、コンテキスト圧縮やプロンプトのワンクリック最適化機能はサポートされていません。手動で調整する必要があります。</Note>

### Revert

Agent の自律実行中に、望まない技術的アプローチをとったり、現在のターンで生成されたコードに不満があったりする場合は、チャットストリーム内の **Revert** ボタンをクリックできます。ワークスペースはそのターンの操作前の状態に即座に復元され、取り消された内容は Diff View で同期して比較・確認できます。これにより、極めて安全な試行錯誤のスペースが提供されます。

<Note>Experts モードは現在 Revert をサポートしていません。</Note>

## ベストプラクティス

### 良いタスクの説明を書く

「コードを修正して」のような曖昧な指示は避けてください。具体的な目標、希望する技術スタック、および受け入れ基準（例：「ページネーション付きの React テーブルコンポーネントを作成する」）を明確に指定します。`@` を使用して関連するファイルやコードスニペットを参照すると、Agent がプロジェクトのコンテキストを正確に理解するのに大きく役立ちます。

### 適切なシナリオと環境を選ぶ

* **複雑さに応じて**: 複数のファイルが関係する複雑な機能開発には、Spec 駆動モードを使用して明確な計画を確保します。小さなアイデアの迅速な検証には、プロトタイプ探索を使用して Spec をスキップします。
* **環境の分離**: 簡単なローカルの調整には、迅速なフィードバックが得られる Local 環境を使用します。多数のファイルを変更する重い開発には、変更を完全に分離してメインブランチを安全に保つために、Worktree 環境を使用することを強くお勧めします。

### イテレーションを上手く活用する

AI が最初の試行で完璧な複雑なシステムを提供するとは期待しないでください。まず Agent に MVP バージョンを完成させ、全体的な方向性を確認してから、複数回の会話を通じて詳細な要件を継続的に追加します。Spec 駆動モードでは、手動で Spec を編集するのではなく、会話に頼って Agent に Spec を変更させることで、Agent が最適なコンテキスト理解を維持できるようにします。Agent は無制限のイテレーションをサポートしており、実際のエンジニアを指導するのと同じように、完全に満足するまで協力して作業できます。