Composer

概要

Composer 開発者ガイド

Composer へようこそ

Composer はエディターに統合された AI プログラミングアシスタントです。これを使用して、ワークフローを離れることなくコードを探索し、新機能を記述し、既存のコードを変更することができます。⌘I で開き、⌘N で新しい Composer を作成します。

https://mintlify.s3.us-west-1.amazonaws.com/cursor/images/composer/empty-composer.png

Agent

⌘. を使用して Agent を有効にし、コードベースを積極的に処理するプログラミングパートナーを取得します:

  • 自動的に関連するコンテキストを取得(@Recommended を試してください)
  • ターミナルコマンドを実行
  • ファイルを作成および変更
  • コードを意味的に検索
  • ファイル操作を実行

Agent は停止する前に最大 25 回ツールを呼び出すことができます。それ以上必要な場合は、[email protected] までお知らせください!

現在、Agent は Claude モデルのみをサポートしています。

各ツール操作は、個別のリクエストとしてクォータにカウントされます。

通常モード

通常モードは、コードの探索と生成のコア機能を提供します:

  • コードベースとドキュメントを検索
  • ウェブ検索を使用
  • ファイルを作成および記述
  • 拡張された @ シンボルコマンドにアクセス

コンテキストの使用

@ を入力すると、現在の作業に基づいたコンテキストオプションが表示されます。矢印キーでナビゲートし、Enter を押して選択し、@ の後にフィルタリングを入力します。Ctrl/⌘ M を使用してファイルの読み取り方法を切り替えます。Agent の @Recommended は自動的に関連するコンテキストを取得します。

https://mintlify.s3.us-west-1.amazonaws.com/cursor/images/context/@-symbols-basics.png

# ファイル選択

# の後にファイル名を入力して特定のファイルにフォーカスします。これを @ シンボルと組み合わせてコンテキストを正確に制御します。

コンテキストタグ

チャットの上部にあるタグは、アクティブなコンテキストを表示します。タグを追加または削除して、Composer が表示する内容を調整します。# を使用してファイルを選択すると、それらのファイルがタグとして表示されます。

変更の生成と適用

Composer が変更を提案する場合:

  • 差分ビューで変更を確認
  • 提供されたボタンを使用して変更を受け入れるか拒否
  • 必要に応じてチェックポイントを使用して元に戻す

チェックポイント

コードを生成するたびに、Composer はチェックポイントを作成します。チェックポイントの横にある checkout をクリックして、以前のバージョンに戻ることができます。現在の変更が気に入らず、以前の状態に戻したい場合に便利です。

https://mintlify.s3.us-west-1.amazonaws.com/cursor/images/composer/checkpoints.png

履歴

履歴を使用して、以前の Composer セッションとチャットにアクセスします。Cursor Tab の右側にある履歴アイコンから開きます。過去の composer とチャットのリストが表示され、それらを再訪、名前変更、または削除できます。

Composer がフォーカスされている場合、⌘+⌥+L または Ctrl+Alt+L を使用して開きます。

https://mintlify.s3.us-west-1.amazonaws.com/cursor/images/composer/history.png

レイアウト

Composer は 2 つのレイアウトモードを提供します:

  • パネル:左側にチャットのサイドバー、右側にコードエディター。
  • エディター:通常のコード表示に似た単一のエディターウィンドウ。移動、分割、別のウィンドウに配置することもできます。

ベータ機能

lint 問題の反復処理

Composer は、ほとんどのプログラミング言語で生成されたコードの linting 問題を修正しようとします。この機能が有効になっている場合、Composer が lint エラーを検出すると、自動的に修正を試みます。現在、1回のイテレーションのみがサポートされています。

https://mintlify.s3.us-west-1.amazonaws.com/cursor/images/composer/iterate-on-lint.png

一部の言語(例: Rust)では、ファイルを保存した後に lint エラーが表示されるため、この機能がすべての言語で有効であるとは限りません。

よくある質問

Chat と Composer の違いは何ですか?

Cursor Chat は、コードの検索と理解を支援します。コードベースを探索したり、質問をしたり、説明を取得するために使用します。⌘⏎ を使用してコードを検索できます。

Composer は、コードの作成と編集を支援します。新しいコードを生成し、変更を直接ファイルに適用できるワークスペースを提供します。