在 Linear 中直接使用 Background Agents：把問題指派給 Cursor，或在留言中提及 @Cursor。

​
開始使用

​
安裝

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

​
帳號連結

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

​
使用方式

把 issue 指派給 Cursor，或在留言中標註 @Cursor。Cursor 會分析 issue，並自動篩掉非開發相關的工作。

​
指派 issue

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

​
提及 Cursor

在留言中標註 @Cursor，可以指派新的代理或提供更多指示，例如：@Cursor 修復上面描述的 authentication bug。

​
工作流程

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

​
後續說明

你可以在 agent 的工作階段中回覆，訊息會作為後續內容傳送給 agent。只要在 Linear 的留言中提及 @Cursor，就能為正在執行的 Background Agent 提供更多指引。

​
設定

在 Dashboard → Background Agents 設定 Background Agent。
設定位置說明
Default RepositoryCursor Dashboard未設定專案儲存庫時使用的主要儲存庫
Default ModelCursor DashboardBackground Agents 使用的 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 設定儲存庫標籤