在 Linear 中把 issue 指派給 Cursor，或在留言中標註 @Cursor，就能直接使用 Background Agents。

​
開始使用

​
安裝

你必須是 Cursor 管理員才能連接 Linear 整合。其他團隊設定也開放給非管理員成員使用。
  1. 前往 Cursor 整合
  2. 在 Linear 旁邊點擊 Connect
  3. 連結你的 Linear 工作區並選擇團隊
  4. 點擊 Authorize
  5. 在 Cursor 完成剩餘的 Background Agent 設定：
    • 連結 GitHub 並選擇預設儲存庫
    • 啟用依用量計費
    • 確認隱私設定

​
帳號連結

首次使用會提示將 Cursor 與 Linear 的帳號連結。建立 PR 需要先連結 GitHub。

​
如何使用

把問題指派給 Cursor，或在留言中提到 @Cursor。Cursor 會自動分析問題並過濾非開發相關的工作。

​
指派問題

  1. 開啟 Linear 的問題
  2. 點擊指派人欄位
  3. 選擇「Cursor」
在 Linear 中將問題指派給 Cursor

​
提及 Cursor

在留言中提到 @Cursor 來指派新的代理或提供額外指示，例如：@Cursor 修復上面描述的驗證錯誤。

​
工作流程

Background Agents 會在 Linear 中顯示即時狀態，並在完成後自動建立 PR。到 Cursor 儀表板 追蹤進度。
Background Agents 在 Linear 中的狀態更新

​
後續指示

你可以在代理的工作階段中回覆，訊息會作為後續指令傳送給代理。只要在 Linear 的評論中提到 @Cursor，就能為正在執行的 Background Agent 提供額外指引。

​
設定

從 Dashboard → Background Agents 設定 Background Agent。
設定位置說明
Default RepositoryCursor Dashboard當未設定專案儲存庫時使用的預設儲存庫
Default ModelCursor Dashboard背景代理使用的 AI 模型
Base BranchCursor Dashboard建立 PR 的基準分支（通常是 main 或 develop）

​
設定選項

你可以用多種方式設定 Background Agent 的行為： Issue 描述或留言：使用 [key=value] 語法，例如：
  • @cursor please fix [repo=anysphere/everysphere]
  • @cursor implement feature [model=claude-3.5-sonnet] [branch=feature-branch]
Issue 標籤：使用父子標籤結構，父標籤為設定鍵，子標籤為值。 Project 標籤：與 issue 標籤相同的父子結構，套用在專案層級。 支援的設定鍵：
  • repo：指定目標儲存庫（例如 owner/repository）
  • branch：指定建立 PR 的基準分支
  • model：指定要使用的 AI 模型

​
儲存庫選擇

Cursor 會依照以下優先順序決定要處理哪個儲存庫：
  1. Issue 描述/留言：issue 文字或留言中的 [repo=owner/repository] 語法
  2. Issue 標籤：附加在特定 Linear issue 上的儲存庫標籤
  3. Project 標籤：附加在 Linear 專案上的儲存庫標籤
  4. Default repository：在 Cursor Dashboard 設定中的預設儲存庫

​
設定儲存庫標籤

在 Linear 中建立儲存庫標籤：
  1. 前往 Linear 工作區的 Settings
  2. 點擊 Labels
  3. 點擊 New group
  4. 將群組命名為「repo」（不分大小寫——必須正是「repo」，不是「Repository」或其他變體）
  5. 在該群組內，為每個儲存庫建立標籤，格式為 owner/repo
之後你可以把這些標籤指派給 issues 或 projects，指定 Background Agent 應該處理的儲存庫。
在 Linear 中設定儲存庫標籤