> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Linear

> 将 Linear 工单指派给 Devin，并将其转成拉取请求（PR）

<Note>
  当你连接 Linear 集成后，Devin 会自动使用你为该集成配置的身份认证信息访问 Linear 的原生工具。你不需要在 [MCP Marketplace](/zh/work-with-devin/mcp) 中单独配置 Linear MCP。
</Note>

<div id="setting-up-the-integration">
  ## 设置集成
</div>

1. 在 app.devin.ai 登录你的 Devin 账户后，前往 [Settings > Connections > Linear](https://app.devin.ai/settings/connections/linear)，然后点击 “Connect”。
2. 你将被重定向到 Linear，以查看你授予 Devin 的权限和访问范围。你可以选择 Devin 在 Linear 中可以访问的团队。之后你也可以随时在 Linear 的 Apps 设置中直接更改 Devin 的访问权限。
3. 连接完成后，在设置页面配置你的 **已同步的 Playbook 标签**，并根据需要设置 **自动化触发器**。

<div id="how-to-trigger-devin-from-linear">
  ## 如何在 Linear 中触发 Devin
</div>

可以通过三种方式从 Linear 工单中启动 Devin 会话：

<div id="assign-devin-to-a-ticket">
  ### 将工单指派给 Devin
</div>

直接在 Linear 中将工单指派给 Devin。Devin 会使用你在 [Linear 集成设置](https://app.devin.ai/settings/connections/linear) 中配置的 **默认 playbook** 来开始处理该工单。

<div id="add-a-playbook-label">
  ### 添加 playbook 标签
</div>

在工单中添加一个 playbook 标签 (例如 `!plan`, `!implement`, `!triage`, `!review`) 。Devin 会根据该标签，使用对应的 playbook 启动一个会话。这些标签会从你在集成设置中配置的 **synced playbook labels** 自动同步。

<div id="mention-devin-in-a-comment">
  ### 在评论中 @ 提及 Devin
</div>

在工单评论中 @ 提及 Devin，并提供具体指令。Devin 会发起一个会话，将你的评论作为任务指令，而不使用任何 playbook。

<div id="configuring-the-integration">
  ## 配置集成
</div>

<div id="synced-playbook-labels">
  ### 已同步的 Playbook 标签
</div>

Playbook 标签使你能够控制哪些 Devin [playbooks](/zh/product-guides/using-playbooks) 可在 Linear 中直接作为标签使用。将某个 playbook 添加到同步列表后，其宏 (例如 `!plan`) 会作为 Linear 中 “Devin Playbooks” 标签组里的一个标签可用。

* **默认 playbook**：会有一个 playbook 被标记为默认。当工单在没有指定 playbook 标签的情况下被指派给 Devin 时，Devin 会使用该默认 playbook。对于新建的连接，`!plan` playbook 会被设置为默认。
* **添加 playbook**：点击 “Add playbook” 以同步更多 playbook。只有带有宏的 playbook 才能被同步。
* **移除 playbook**：移除一个 playbook 即可停止将它的标签同步到 Linear。

<div id="automation-triggers">
  ### 自动化触发器
</div>

自动化触发器让 Devin 在工单满足特定条件时自动开始处理，而无需手动分配或添加标签。你可以基于以下内容配置触发器：

* **Teams**：仅对特定 Linear 团队中的工单触发。
* **Labels**：仅在工单具有特定标签时触发。
* **Statuses**：仅在工单达到特定状态时触发 (例如“Todo”“In Progress”) 。
* **Playbook**：可选地指定 Devin 在本次触发会话中应使用的 playbook。

触发器使用\*\*边沿触发 (edge detection) \*\*机制，这意味着只有当工单从“不满足”变为“满足”触发条件时才会被触发 (例如添加了标签或状态发生变化) ，而不会对已经满足条件的工单触发。

<div id="enterprise-linear-team-mapping">
  ### Enterprise：Linear 团队映射
</div>

对于包含多个 Devin 组织的 Enterprise 部署，管理员可以将各 Linear 团队映射到指定的 Devin 组织。这样可以确保每个 Linear 团队的工单都会被路由到正确的 Devin 组织。在 Enterprise 环境中，要让 Linear 集成正常工作，必须先完成此映射。

<div id="interacting-with-devin-in-linear">
  ## 在 Linear 中与 Devin 交互
</div>

一旦 Devin 开始处理某个工单，它会使用 Linear 的 agent 会话界面进行沟通：

* **Activity feed**：Devin 会在其中实时发布工作进度更新，包括运行的命令、编辑的文件以及进度摘要。
* **Plan tracking**：Devin 的待办事项列表会同步到 Linear 的计划 UI，方便你一目了然地查看进度。
* **Follow-up messages**：在 agent 会话线程中发送消息，为 Devin 提供额外指示或提出问题。
* **Stop Devin**：在 Linear 中使用停止指令，让 Devin 停止当前任务。
* **PR links**：当 Devin 创建拉取请求 (pull request) 时，PR URL 会自动添加到 agent 会话中，便于访问。
* **Session link**：指向 Web 应用中 Devin 会话的直接链接会被添加到 agent 会话中，并附上所使用 playbook 的链接 (如果适用) 。

<div id="connecting-your-linear-user-account">
  ## 连接你的 Linear 用户账户
</div>

除了组织级集成之外，每个团队成员也可以将自己的 Linear 账户关联到 Devin 账户。这样 Devin 就可以识别是谁触发了工单，并将会话归属到正确的用户。

要连接你的用户账户，请前往 [Settings > Connections > Linear](https://app.devin.ai/settings/connections/linear)，然后在用户连接部分关联你的账户。