---
title: "Linear 集成"
description: "基于 Cursor 官方 Linear integration 文档解释 issue delegation、repo labels、triage rules 和 follow-up。"
verifiedAt: "2026-05-09"
---

Linear 集成让团队可以把 issue 直接委派给 Cursor，或在 Linear 评论里 mention `@Cursor` 启动 Cloud Agent。

> [!NOTE]
> **阅读目标**：读完本章，你应该能把 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。

流程：

1. 打开 Cursor integrations。
2. 点击 Linear 旁的 Connect。
3. 连接 Linear workspace 并选择 team。
4. 点击 Authorize。
5. 回到 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 创建要求：

1. Linear workspace -> Settings -> Labels。
2. 新建 group，名称必须是 `repo`，大小写不敏感，但不能写成 Repository 等变体。
3. group 内创建 `owner/repo` 格式的 labels。
4. 把 label 加到 issue 或 project。

## 7. Repository selection

Cursor 按这个优先级选择 repo：

1. Issue description / comments 中的 `[repo=owner/repository]`。
2. 当前 issue labels。
3. Linear project labels。
4. 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](https://cursor.com/docs/integrations/linear.md) —— 官方安装、delegation、comments、repository selection、labels、triage rules 和 support。
- [Cursor Cloud Agents](https://cursor.com/docs/cloud-agent.md) —— Linear 触发的 Cloud Agent 背景。
- [Cursor Automations](https://cursor.com/docs/cloud-agent/automations.md) —— 事件触发和后台 agent run 背景。

## 接下来去哪

<Cards>
  <Card title="JetBrains 集成" description="继续学习通过 ACP 在 JetBrains IDE 中使用 Cursor agent。" href="/docs/cursor/official/05-integrations-sdk/74-jetbrains" />
  <Card title="Slack 集成" description="回看消息线程触发 Cloud Agent 的路由规则。" href="/docs/cursor/official/05-integrations-sdk/72-slack" />
</Cards>
