跳转到主要内容
在 Linear 里直接用 Background Agents:把 issue 分配给 Cursor,或在评论里提及 @Cursor

入门

安装

只有 Cursor 管理员才能连接 Linear 集成。其他团队设置对非管理员成员也可用。
  1. 前往 Cursor 集成
  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 修复上面提到的身份验证 bug

工作流程

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

后续指令

你可以在 agent 会话中直接回复,消息会作为后续内容发送给 agent。只需在 Linear 的评论里 @Cursor,就能为正在运行的 Background Agent 提供更多指导。

配置

Dashboard → Background Agents 配置 Background Agent。
SettingLocationDescription
Default RepositoryCursor Dashboard未配置项目仓库时使用的默认仓库
Default ModelCursor DashboardBackground Agents 使用的 AI 模型
Base BranchCursor Dashboard用于创建 PR 的基础分支(通常是 maindevelop

配置选项

可以通过多种方式配置 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 格式创建标签
随后可以将这些标签分配给 issue 或项目,用于指定 Background Agent 应处理的仓库。
在 Linear 中配置仓库标签
I