Linear 事项抽屉
在任务抽屉中,Linear 与托管评审提供方并列。你可以浏览、创建、更新 Linear issue,并把它们关联到 worktree,方式与关联 GitHub issue 完全一致。
设置
- 打开 设置 → 集成 → Linear。
- 从 Linear → 设置 → API 粘贴一个个人 API token。
- 选择你想查看的团队。
使用 Linear
- 任务抽屉在一个合并视图中同时显示 GitHub 和 Linear 的 issue。
- 在 Linear 任务视图中使用 Has Workspace 模式,只列出已关联到本地 worktree 或文件夹工作区的 issue。带有已挂载工作区的行会打开那个工作区;当你需要第二个检出时,仍可从同一 issue 新开一个工作区。
- 从 Linear issue 创建 worktree 会打开交互式工作区编排器(与 GitHub 事项路径相同),因此 issue-command 自动化、SSH 和文件夹工作区都适用。DevAgent 会预填名称并附上 issue ID。当 Linear 为该 issue 提供了分支名时,DevAgent 会用它作为 worktree 分支(与 Linear 建议的命名一致),而不仅仅是标题的 slug。issue 详情菜单中可 Copy suggested branch name(复制建议的分支名)。
- 创建之后,在工作区卡片上打开 Edit Worktree Details,使用带 Linear 标签的 Issue 字段(或粘贴一个 Linear URL)来关联或更换 issue,无需重新创建 worktree。GitHub 与 Linear 共用这同一个字段 —— 保存一个新关联会替换掉之前的提供方关联。
- 打开某个 issue 的详情视图,可更新状态、指派人、优先级、标签、估点等字段。优先级会用 Linear 自己的优先级图标渲染,使抽屉与你在 Linear 中看到的保持一致。
- 当你从某个 Linear issue 启动 agent 时,DevAgent 会把该 issue 描述、评论及子 issue 中内嵌的行内图片和媒体一并纳入 prompt 上下文,这样 agent 就能看到设计稿或 bug 复现,而不必你手动粘贴截图。
- 如果你不小心关闭了 New Linear issue 或 New Linear project 对话框(Escape、Cancel、点击外部或关闭),标题/描述(以及项目名称、摘要和简介)会保留。在同一次应用会话中重新打开对话框时会恢复这些文本;成功创建后草稿清空,且不会在应用重启后保留。团队/项目选择器仍使用它们通常的打开时默认值。
- 长列表通过 Load more 操作分页 —— 当某个项目的 issue 数量超过抽屉初始容量时很有用。
- 布局选择会在重启后保留:列表还是看板、分组方式、排序方式、可见列以及属性筛选。属性筛选按 Linear workspace 分别存储,因此切换 workspace 不会套用另一个 workspace 的分面筛选。
- DevAgent 会按仓库记住你上次使用的任务来源(GitHub、Linear 或 Jira)。
Linear 状态同步(创建 worktree 时把 issue 移到 "In Progress")需按团队逐一选择启用。
Agent 与 CLI
Agent 可通过 devagent linear(以及 orca-linear skill)读写 Linear。该接口包含兼容 MCP 的创建/更新与列表筛选(save-issue、list-issues、关系的增删),以及诸如 --activity 和 --full 之类的 issue 上下文标志。参见 CLI 参考 → Linear。
后续步骤
- 托管评审、issue 与 Actions —— 任务进入处理中后,把代码评审状态与 worktree 关联起来。
- 在 DevAgent 中提交与推送 —— 无需离开 DevAgent 即可发布分支。