Linear

在 Linear 中使用 Background Agents

在 Linear 里直接用 Background Agents：把问题委派给 Cursor，或在评论里 @Cursor。

入门

安装

你必须是 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”

提及 Cursor

在评论中 @@Cursor 来指派新的代理或提供额外指令，例如：@Cursor 修复上面描述的认证相关 bug。

工作流程

Background Agents 会在 Linear 中显示实时状态，并在完成后自动创建 PR。可在 Cursor 仪表盘 跟踪进度。

后续说明

你可以在 agent 会话中回复，消息会作为后续指令发送给 agent。只需在 Linear 的评论中 @Cursor，即可为正在运行的 Background Agent 提供更多指导。

配置

在 Dashboard → Background Agents 配置 Background Agent 设置。

Setting	Location	Description
Default Repository	Cursor Dashboard	当未配置项目仓库时使用的默认仓库
Default Model	Cursor Dashboard	Background Agents 使用的 AI 模型
Base Branch	Cursor 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. 默认仓库：在 Cursor Dashboard 设置中指定的仓库

配置仓库标签

在 Linear 中创建仓库标签：

1. 进入 Linear 工作区的 Settings
2. 点击 Labels
3. 点击 New group
4. 将分组命名为 “repo”（不区分大小写——必须严格为 “repo”，不是 “Repository” 或其他变体）
5. 在该分组内，为每个仓库创建标签，格式为 owner/repo

随后可以将这些标签分配给 issues 或 projects，用来指定 Background Agent 应该处理哪个仓库。