Cursor のバックグラウンドエージェントを使用した自動化
Cursor 1.0 では、バックグラウンドエージェントが導入されました。これは、AI エージェントが IDE をブロックせずにバックグラウンドでタスクを実行できる強力な機能です。このガイドでは、バックグラウンドエージェントのセットアップ、管理、および最大限の生産性を活かすための活用方法について説明します。
バックグラウンドエージェントとは？
バックグラウンドエージェントにより：
- 長時間実行されるタスク—— 他の作業をしている間も継続
- 並列処理——複数の独立したタスクを同時に実行
- 非同期操作——テスト、ビルド、分析など
- スケジュールされたタスク——特定の時間に実行
前提条件
- Cursor バージョン 1.0 以降
- Pro 以上のプラン（バックグラウンドエージェントには有料プランが必要な場合があります）
- 独立して実行できるタスクを持つプロジェクト
バックグラウンドエージェントの開始
方法 1：コンテキストメニュー
- Composer を開く（
Cmd/Ctrl + I） - タスクの説明を入力
- ... メニュー（その他のアクション）をクリック
- バックグラウンドで実行を選択
方法 2：コマンド
@background コードベース全体を分析してセキュリティ脆弱性を検出し、結果を報告してください。
方法 3：キーボードショートカット
- タスクを作成
Cmd/Ctrl + Shift + Bを押す（設定済みの場合）- エージェントがバックグラウンドで開始
バックグラウンドエージェントの使用例
1. コードベース分析
[バックグラウンド] コードベース全体をスキャンして：
1. すべての TODO コメントを見つける
2. 非推奨 API の使用を特定する
3. テストカバレッジがないファイルをリストする
4. 潜在的なメモリリークを検出する
5. コードの重複を報告する
完了時にサマリーレポートを提供する。
2. テスト実行
[バックグラウンド] 完全なテストスイートを実行：
1. すべての単体テストを実行
2. 統合テストを実行
3. カバレッジレポートを生成
4. 結果を test-results/ に保存
完了時に合格/不合格のサマリーで通知する。
3. ドキュメント生成
[バックグラウンド] API ドキュメントを生成：
1. src/ 内のすべての公開 関数/クラスをスキャン
2. JSDoc/docstring がない場所に作成
3. docs/api/ に markdown ドキュメントを生成
4. ナビゲーションインデックスを作成
既存のスタイルを src/utils/helpers.ts から使用する。
4. 大規模コードベースのリファクタリング
[バックグラウンド] エラーハンドリングをリファクタリング：
1. すべての try/catch ブロックを見つける
2. エラーメッセージを標準化
3. 構造化エラーログを追加
4. カスタムエラークラスを作成
コードベース全体に変更を適用する。
バックグラウンドエージェントの管理
アクティブなエージェントの表示
-
バックグラウンドエージェントパネルを開く：
- 表示 > 外観 > バックグラウンドエージェントを表示
- またはサイドバーアイコンを使用
-
実行中のすべてのエージェントを確認：
- タスクの説明
- 開始時間
- 現在の状態
- 進捗インジケーター
エージェントの状態
| 状態 | 説明 | アクション |
|---|---|---|
| 実行中 | エージェントが積極的に作業中 | 進捗を監視 |
| 一時停止 | エージェントが手動で一時停止 | 再開またはキャンセル |
| 完了 | タスクが正常に完了 | 結果を表示 |
| 失敗 | タスクでエラーが発生 | ログを確認 |
| キャンセル | タスクがユーザーによって停止 | 必要に応じて再起動 |
エージェントの制御
# エージェントを一時停止
cursor agent:pause <agent-id>
# エージェントを再開
cursor agent:resume <agent-id>
# エージェントをキャンセル
cursor agent:cancel <agent-id>
# エージェントログを表示
cursor agent:logs <agent-id>
エージェントの出力と結果
結果のタイプ
-
ファイル変更：エージェントがファイルを変更
- ソース管理パネルで確認
- コミット前に差分を確認
-
レポート：生成されたサマリー
- 指定された場所に保存
- または通知パネルに表示
-
通知：状態更新
- 完了時のデスクトップ通知
- Cursor アイコンのバッジ
結果へのアクセス
バックグラウンドエージェントが完了すると：
- 通知が表示される（有効な場合）
- Cursor のドック/タスクバーにバッジが表示される
- 結果パネルが自動的に開く
- 変更されたファイルがソース管理に表示される
ベストプラクティス
タスクの粒度
大きなタスクを小さなバックグラウンドエージェントに分割：
# 良好：具体的で独立したタスク
[バックグラウンド] 認証モジュールのエラーハンドリングをリ ファクタリング
[バックグラウンド] 支払いモジュールのエラーハンドリングをリファクタリング
[バックグラウンド] 通知モジュールのエラーハンドリングをリファクタリング
# あまり理想的でない：1 つの巨大なタスク
[バックグラウンド] アプリ全体のすべてのエラーハンドリングをリファクタリング
リソース管理
並列バックグラウンドエージェントを制限：
# 推奨される最大並列エージェント数
- CPU 集中型タスク（リファクタリング、分析）には 2-3 個
- I/O バウンド型タスク（ドキュメント、レポート）には 5+ 個
チェックポイント
長時間のタスクにはチェックポイントを使用：
[バックグラウンド] データベーススキーマを移行：
1. バックアップを作成
2. マイグレーションスクリプトを実行
3. データの整合性を確認
4. ロールバックスクリプトを生成
各ステップ後に進捗を保存。
中断された場合、最後のチェックポイントから再開。
モニタリングとログ
エージェントログの表示
- バックグラウンドエージェントパネルを開く
- 完了したエージェントをクリック
- 完全な実行ログを表示
- タイムスタンプとアクションを確認
ログ構造
[2026-06-25 10:00:00] エージェント開始："コードベースセキュリティスキャン"
[2026-06-25 10:00:05] 読み込み：src/auth/login.ts
[2026-06-25 10:00:10] 読み込み：src/auth/register.ts
[2026-06-25 10:00:15] 分析完了：3 件の脆弱性を発見
[2026-06-25 10:00:20] レポート書き込み：security-report.md
[2026-06-25 10:00:25] エージェントが正常に完了
バックグラウンドエージェントのモデル選択
異なるモデルが異なるバックグラウンドタスクに適しています：
| タスクタイプ | 推奨モデル | 理由 |
|---|---|---|
| コード分析 | Claude 3.5 Sonnet | 徹底的で正確 |
| リファクタリング | GPT-4o | 高速で信頼性が高い |
| ドキュメント | Gemini 1.5 Pro | 長いコンテキスト |
| テスト | Claude 3.5 Sonnet | エッジケース検出が優れている |
| セキュリティ監査 | Claude 3 Opus | 深い分析 |
設定でデフォルトモデルを構成：
{
"backgroundAgents": {
"defaultModel": "claude-3-5-sonnet",
"maxConcurrent": 3,
"autoNotify": true
}
}
トラブルシューティング
| 問題 | 解決策 |
|---|---|
| エージェントが開始しない | プラン制限を確認；アップグレードが必要な場合があります |
| エージェントが消える | バックグラウンドエージェントパネルでエラーを確認 |
| 結果が保存されない | タスクの説明で出力パスを指定 |
| エージェントがハングする | キャンセルして再起動；入力待ちの可能性があります |
| CPU 使用率が高い | 並列エージェントを減らす；より軽量なモデルを使用 |
例：完全なバックグラウンドワークフロー
# 朝：分析を開始
[バックグラウンド] コードベースの技術的負債を分析。
優先順位付けされたリファクタリングタ スクのリストを生成する。
# エージェントが実行中に、引き続きコーディング...
# エージェントが完了
[通知] "分析完了：12 件のリファクタリング機会を発見"
# 結果を確認
開く：analysis-results/refactoring-tasks.md
# バックグラウンドでリファクタリングを開始
[バックグラウンド] 分析結果から上位 3 つのリファクタリングタスクを実装する。
# 他の作業を続行...
# 都合の良い時に変更を確認
ソース管理パネルで差分を確認