在 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”
在 Linear 中将问题委派给 Cursor

​
提及 Cursor

在评论中提到 @Cursor 以指派一个新的智能体，或补充指令，例如：@Cursor 修复上面描述的认证相关 bug。

​
工作流程

Background Agents 会在 Linear 中显示实时状态，并在完成后自动创建 PR。你可以在 Cursor dashboard 跟踪进度。
Linear 中的 Background Agent 状态更新

​
后续指引

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

​
配置

在 Dashboard → Background Agents 配置 Background Agent 的设置。
SettingLocationDescription
Default RepositoryCursor Dashboard当未配置项目仓库时使用的默认仓库
Default ModelCursor Dashboard用于 Background 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. 默认仓库：在 Cursor Dashboard 设置中指定的仓库

​
设置仓库标签

在 Linear 中创建仓库标签：
  1. 进入 Linear 工作区的 Settings
  2. 点击 Labels
  3. 点击 New group
  4. 将分组命名为 “repo”（不区分大小写——必须严格为 “repo”，而不是 “Repository” 或其他变体）
  5. 在该分组下为每个仓库创建标签，格式为 owner/repo
然后把这些标签分配给 Issues 或 Projects，以指定 Background Agent 应该处理的仓库。
在 Linear 中配置仓库标签