Linear 整合
基於 Cursor 官方 Linear integration 文件解釋 issue delegation、repo labels、triage rules 和 follow-up。
📖 本篇術語速查表
| 英文 / 縮寫 | 中文 | 一句話解釋 |
|---|---|---|
| Linear 整合 | integration | 把 issue 委派給 Cursor。 |
| 自動分派 | auto-assign | 按規則自動指派 issue。 |
| 資料隱私 | privacy | issue 資料的邊界。 |
不想讀完？把下面這段提示詞丟給 AI 幫你跑完——幫你配好 Cursor 和 Linear 的整合（委派、自動分派）。
你是 Cursor Linear 整合顧問。
【角色】
Cursor Linear 整合顧問，按最小夠用和安全優先的原則給可落地的方案。
【輸入】
- 我的 Linear 使用情況：___
- 想委派什麼型別 issue：___
- 是否自動分派：___
- 隱私顧慮：___
【工作流程】
1. 給整合設定步驟
2. 設計委派和自動分派規則
3. 標出資料隱私注意點
4. 給排障建議
【輸出規範】
▌一、設定步驟
▌二、委派 / 自動分派規則
▌三、隱私與許可權
▌四、排障
【硬約束】
- 只委派範圍明確、適合 Agent 的 issue
- 自動分派要有規則和兜底，不無差別派
- 注意 issue 資料隱私邊界
- 不要替我臆測情況或編造不存在的能力，資訊不全先問清
- 不確定的設定或介面一律以官方文件為準，禁止照搬過時寫法
- 給的每條結論都要落到具體可照做的步驟或示例，不停留在「建議」「考慮一下」這類沒法直接執行的空泛表述Linear 整合讓團隊可以把 issue 直接委派給 Cursor，或在 Linear 評論裡 mention @Cursor 啟動 Cloud Agent。
閱讀目標：讀完本章，你應該能把 Linear issue、repo 選擇、branch/model 引數和 Cloud Agent status 串成一條可覆盤的開發工作流。
1. 什麼時候用
| 場景 | Linear 整合價值 |
|---|---|
| PM / support 已經在 Linear 寫清需求 | 直接從 issue 啟動 agent |
| issue 有上下文、驗收標準、截圖 | agent 能讀取 issue 資訊作為任務輸入 |
| 團隊按 project / label 路由 repo | 用 Linear labels 統一 repo routing |
| 需要看到執行狀態 | Cloud Agent status 回寫 Linear activity |
不適合把所有 issue 都自動丟給 Cursor。官方也說明 Cursor 會分析 issue 並過濾非開發工作，但商業團隊仍應保留 triage 標準。
2. 安裝和賬號關聯
安裝要求：
- 連線 Linear integration 需要 Cursor admin。
- 其他 team settings 可由非 admin members 設定。
- PR 建立需要 GitHub connection。
流程：
- 開啟 Cursor integrations。
- 點選 Linear 旁的 Connect。
- 連線 Linear workspace 並選擇 team。
- 點選 Authorize。
- 回到 Cursor 完成 Cloud Agent setup：連線 GitHub、選擇 default repository、開啟 usage-based pricing、確認 privacy settings。
第一次使用會觸發 Cursor 與 Linear 的 account linking。先把賬號關聯做好，再驗證真實 issue。
3. 兩種啟動方式
| 方式 | 操作 | 適合 |
|---|---|---|
| Delegate issue | 開啟 issue，點選 assignee field，選擇 Cursor | issue 已經足夠清楚 |
Mention @Cursor | 在評論寫 @Cursor fix the authentication bug described above | 需要補充具體指令或追加 follow-up |
Cloud Agents 會在 Linear 中顯示即時狀態，完成後自動建立 PR。詳細進度也能在 Cursor dashboard 的 Cloud Agents 區檢視。
4. Follow-up instructions
執行中的 agent 可以繼續接收 Linear 評論中的 @Cursor 指令。適合：
- 補充復現步驟。
- 修改實現方向。
- 要求增加測試。
- 讓 agent 解釋目前卡點。
但 follow-up 仍然會影響正在執行的 agent。高敏專案不要讓任意成員在 issue 裡隨意改任務方向，尤其是涉及 secrets、許可權、生產資料或付款邏輯時。
5. 設定項
基礎設定在 Dashboard -> Cloud Agents：
| Setting | Location | 用途 |
|---|---|---|
| Default Repository | Cursor Dashboard | issue 未指定 repo 時的 fallback |
| Default Model | Cursor Dashboard | Cloud Agents 預設模型 |
| Base Branch | Cursor Dashboard | PR 建立時的起始 branch |
Linear 中也可以透過 issue description、comments、issue labels 和 project labels 設定行為。
6. [key=value] 和 labels
Issue 描述或評論可以用 [key=value]：
| Key | 示例 | 用途 |
|---|---|---|
repo | [repo=anysphere/everysphere] | 指定目標 repository |
branch | [branch=feature-branch] | 指定 base branch |
model | [model=claude-3.5-sonnet] | 指定模型 |
Issue labels 和 project labels 使用 parent-child 結構：parent label 是設定 key，child label 是值。
repo label 建立要求：
- Linear workspace -> Settings -> Labels。
- 新建 group，名稱必須是
repo，大小寫不敏感，但不能寫成 Repository 等變體。 - group 內建立
owner/repo格式的 labels。 - 把 label 加到 issue 或 project。
7. Repository selection
Cursor 按這個優先順序選擇 repo：
- Issue description / comments 中的
[repo=owner/repository]。 - 目前 issue labels。
- Linear project labels。
- Cursor dashboard default repository。
商業團隊建議：project labels 做預設路由，issue comment 只用於臨時覆蓋。這樣既少重複，也能保留清晰的例外記錄。
8. Advanced: triage rules
Linear triage rules 可以自動給 issue 加 labels、assign to Cursor，並按條件觸發 Cloud Agents。
注意官方限制：目前 Linear triage rules 需要 human assignee 才會 fire，這個限制未來可能變化。
先不要把 triage rules 直接開到全專案。推薦：
- 先在一個專案裡設定 repo label。
- 再用一類低風險 bug 自動 assign Cursor。
- 最後看 PR 質量、誤觸發率和成本。
商業級驗收
上線前至少完成：
- 測試 issue 透過 assignee 委派 Cursor。
- 測試評論
@Cursor追加 follow-up。 [repo=]、issue label、project label、default repo 四層優先順序可解釋。- GitHub connection 能讓 agent 建立 PR。
- usage-based pricing 和 Privacy Mode 已確認。
- request ID / agent activity 排障路徑寫入 SOP。
- triage rules 僅在低風險範圍啟用。
官方來源
- Cursor Linear Integration —— 官方安裝、delegation、comments、repository selection、labels、triage rules 和 support。
- Cursor Cloud Agents —— Linear 觸發的 Cloud Agent 背景。
- Cursor Automations —— 事件觸發和後臺 agent run 背景。