Cursor の Slack 連携を使えば、Slack で @Cursor をメンションしてプロンプトを送るだけで、Background Agents にタスクを直接任せられるよ。

はじめよう

インストール

  1. Cursor integrations にアクセス
  2. Slack の横にある Connect をクリック、またはここから installation page
  3. ワークスペースに Slack 用の Cursor アプリをインストールするよう求められる
  4. Slack へのインストール後、セットアップ完了のために Cursor にリダイレクトされる
    1. GitHub を接続(未接続の場合)し、デフォルトのリポジトリを選択
    2. 従量課金を有効化
    3. プライバシー設定を確認
  5. Slack で @Cursor をメンションして Background Agents の利用を開始

使い方

@Cursor をメンションしてプロンプトを送ろう。これで大半のケースは対応できるけど、下のコマンドでエージェントをカスタマイズすることもできる。 たとえば、会話の中でそのまま @Cursor fix the login bug とメンションするか、@Cursor [repo=torvalds/linux] fix bug のように特定のリポジトリを狙い撃ちするコマンドも使える。

コマンド

最新のコマンド一覧は @Cursor help を実行。
CommandDescription
@Cursor [prompt]Background Agent を開始。既存のエージェントがいるスレッドではフォローアップ指示を追加
@Cursor settingsデフォルトとチャンネルのデフォルトリポジトリを設定
@Cursor [options] [prompt]高度なオプションを使用: branch, model, repo
@Cursor agent [prompt]スレッドで新しいエージェントを強制的に作成
@Cursor list my agents実行中のエージェントを表示

オプション

これらのオプションで Background Agent の挙動をカスタマイズ:
OptionDescriptionExample
branchベースブランチを指定branch=main
modelAI モデルを選択model=o3
repo対象リポジトリを指定repo=owner/repo
autopr自動 PR 作成の有効/無効autopr=false
構文フォーマット
オプションは次の方法で使える:
  1. ブラケット形式 @Cursor [branch=dev, model=o3, repo=owner/repo, autopr=false] Fix the login bug
  2. インライン形式 @Cursor branch=dev model=o3 repo=owner/repo autopr=false Fix the login bug
オプションの優先順位
オプションを組み合わせるとき:
  • 明示的な値がデフォルトを上書き
  • 重複した場合は後に書いた値が前を上書き
  • インライン指定は設定モーダルのデフォルトより優先
ボットはメッセージ内のどこに書いてあってもオプションを解析するので、自然な書き方でコマンドできる。

スレッドコンテキストの活用

Background Agents はスレッド内のやり取りからコンテキストを理解して活用する。チームで課題を議論して、その会話に基づいて実装まで任せたいときに便利。
S
Sarah2:30 PM
Hey team, we're getting reports that users can't log in after the latest deploy
M
Mike2:32 PM
I checked the logs - looks like the auth token validation is failing on line 247 of auth.js
A
Alex2:33 PM
Oh, I think it's because we changed the token format but didn't update the validation regex
S
Sarah2:35 PM
Yeah, the regex still expects the old format. We need to update it to handle both old and new formats for backwards compatibility
Y
You2:36 PM
@Cursor fix this
1
Background Agents は呼び出し時にスレッド全体を読み込み、 チームの議論に基づいて解決策を理解し実装する。

強制コマンドを使うとき

@Cursor agent が必要なのはいつ? 既存のエージェントがいるスレッドでは、@Cursor [prompt] はフォローアップ指示を追加(自分が所有するエージェントに限る)。別のエージェントを起動したい場合は @Cursor agent [prompt] を使おう。 Add follow-up(コンテキストメニュー)を使うのはいつ? エージェントの返信のコンテキストメニュー(⋯)からフォローアップ指示を送れる。スレッド内に複数のエージェントがいるとき、どれにフォローアップするか指定するのに便利。

ステータス更新とハンドオフ

Background Agent の実行が始まると、最初に Open in Cursor を開くオプションが届く。
Background Agent の処理が完了すると、Slack で通知が届いて、GitHub で作成された PR を表示できるよ。

エージェントの管理

実行中のエージェントを全部見るには、@Cursor list my agents を実行してね。 任意のエージェントメッセージの三点メニュー(⋯)をクリックして、コンテキストメニューから Background Agent を管理できるよ。
利用可能なオプション:
  • Add follow-up: 既存のエージェントに追加入力(指示)を送る
  • Delete: Background Agent を停止してアーカイブする
  • View request ID: トラブルシューティング用の一意のリクエスト ID を表示(サポートに連絡するときに添えてね)
  • Give feedback: エージェントの動作についてフィードバックを送る

設定

Dashboard → Background Agents からデフォルト設定とプライバシーオプションを管理しよう。

設定

デフォルトモデル

@Cursor [model=...] でモデルが明示されていない場合に使用。利用可能なオプションは settings を参照。

デフォルトリポジトリ

リポジトリが指定されていない場合に使用。以下の形式を使う:
  • https://github.com/org/repository
  • org/repository
存在しないリポジトリを参照すると、アクセス権がないように見えるよ。 Background Agent の起動に失敗したときのエラーメッセージにそう表示される。

ベースブランチ

Background Agent の開始ブランチ。空欄のままにすると、リポジトリのデフォルトブランチ(多くは main)を使う。

チャンネル設定

@Cursor settings を使ってチャンネル単位でデフォルト設定を構成しよう。この設定はチーム単位で、そのチャンネルにおける個人のデフォルトを上書きする。 こんなときに便利:
  • チャンネルごとに異なるリポジトリで作業している
  • チーム全員で設定を統一したい
  • 毎回コマンドでリポジトリを指定したくない
チャンネル設定の手順:
  1. 目的のチャンネルで @Cursor settings を実行
  2. そのチャンネルのデフォルトリポジトリを設定
  3. そのチャンネルで Background Agents を使うメンバー全員にこのデフォルトが適用される
チャンネル設定は個人のデフォルトより優先されるけど、 @Cursor [repo=...] [prompt] のような明示的なオプションで上書きできるよ。

プライバシー

Background Agents は Privacy Mode をサポートしているよ。 Privacy Mode の詳細を読むか、privacy settings を管理しよう。
旧 Privacy Mode はサポートしていないよ。Background Agents は実行中に一時的に コードを保存する必要がある。

エージェントサマリーの表示

エージェントのサマリーや差分画像を表示。ファイルパスやコードスニペットが含まれる場合がある。オン/オフ可能。

外部チャンネルでのエージェントサマリーの表示

他ワークスペースとの Slack Connect や、ゲストなど外部メンバーがいるチャンネルで、エージェントサマリーを表示するか選べる。

権限

Cursor は、ワークスペースで Background Agents が動作するように、次の Slack 権限をリクエストするよ:
権限説明
app_mentions:read@メンションを検出して Background Agents を起動し、リクエストに返答する
channels:history追加入力の文脈として、スレッド内の過去メッセージを読む
channels:join招待やリクエストに応じて自動的にパブリックチャンネルに参加する
channels:read返信や更新を投稿するために、チャンネルのメタデータ(ID・名前)にアクセスする
chat:writeエージェントの実行完了時にステータス更新、完了通知、PR リンクを送信する
files:read追加の文脈を得るため、共有ファイル(ログ、スクリーンショット、コードサンプル)をダウンロードする
files:write変更点のビジュアルサマリーをアップロードして、すばやくレビューできるようにする
groups:historyマルチターン会話の文脈として、プライベートチャンネル内の過去メッセージを読む
groups:read返信の投稿や会話の流れ維持のために、プライベートチャンネルのメタデータにアクセスする
im:history継続する会話の文脈として、ダイレクトメッセージの履歴にアクセスする
im:read参加者の特定や適切なスレッド運用のために、DM のメタデータを読む
im:writeプライベート通知や個別のやり取りのために、ダイレクトメッセージを開始する
mpim:history複数人の会話のために、グループ DM の履歴にアクセスする
mpim:read参加者の宛先指定と確実な配信のために、グループ DM のメタデータを読む
reactions:readユーザーのフィードバックやステータスのシグナルとして、絵文字リアクションを参照する
reactions:writeステータスを示す絵文字リアクションを追加する(実行中: ⏳、完了: ✅、失敗: ❌)
team:readワークスペースの詳細を特定して、インストールを分離し設定を適用する
users:readSlack ユーザーと Cursor アカウントを突き合わせて、権限と安全なアクセスを付与する