第43章 Linear 条目抽屉

Linear 条目抽屉 Linear 与托管评审提供商并列显示在任务抽屉中。你可以像关联 GitHub 问题一样，浏览、创建、更新 Linear 问题，并将其关联到工作树（worktree）。

配置

• 打开“设置”→“集成”→“Linear”。
• 粘贴来自 Linear → 设置 → API 的个人访问令牌。
• 选择你想要查看的团队。

使用 Linear

任务抽屉将 GitHub 和 Linear 问题合并为单一视图。在 Linear 任务视图中，使用“拥有工作区”模式可仅列出已关联到本地工作树或文件夹工作区的问题。带有已附加工作区的行会直接打开该工作区；如需第二个检出，你仍可从同一问题启动新的工作区。

从 Linear 问题创建工作树时，会打开交互式工作区配置器（与 GitHub 条目路径相同），因此问题命令自动化、SSH 和文件夹工作区均适用。Orca 会预填名称并附加问题 ID。当 Linear 为该问题提供分支名称时，Orca 会将其用作工作树分支（即 Linear 建议的命名），而不仅仅是标题的 slug。问题详情菜单中还包含“复制建议的分支名称”选项。

创建完成后，在工作区卡片上打开“编辑工作树详情”，使用带有 Linear 标签的问题字段（或直接粘贴 Linear 链接）来关联或更改问题，无需重新创建工作树。GitHub 和 Linear 共享该字段——保存新关联会替换之前提供商的链接。

打开问题详情视图可更新状态、负责人、优先级、标签和预估等字段。优先级使用 Linear 自身的图标渲染，确保抽屉中的显示与 Linear 内部一致。

当从 Linear 问题启动 Agent 时，Orca 会将嵌入在问题描述、评论和子问题中的内联图片和媒体包含在提示上下文中，让 Agent 能够直接查看设计稿或 bug 复现步骤，无需你手动粘贴截图。问题描述中的私有 Linear 图片也能在抽屉中正常加载，而不会显示为破损图标。

若你意外关闭“新建 Linear 问题”或“新建 Linear 项目”对话框（按 Escape、点击取消、点击外部或关闭），标题/描述（以及项目名称、摘要和简介）会被保留。在同一应用会话内重新打开对话框时，文本将恢复；创建成功后草稿会被清除，且应用重启后失效。团队/项目选择器仍使用其常规的默认值。

长列表通过“加载更多”操作实现分页——当项目的问题数量超出抽屉初始显示范围时，此功能非常有用。

布局选择会在重启后保留：列表或看板、分组方式、排序方式、可见列以及属性筛选器。属性筛选器按 Linear 工作区存储，因此切换工作区时不会应用另一个工作区的筛选面。

Orca 会为每个仓库记住你最近使用的任务来源（GitHub、Linear 或 Jira）。

Agent 和 CLI

Agent 可通过 orca linear（以及 orca-linear 技能）读取和写入 Linear。该功能表面包含 MCP 兼容的创建/更新操作和列表筛选器（save-issue, list-issues, 关联添加/移除），以及 --activity 和 --full 等问题上下文标志。详见 CLI 参考 → Linear。

后续步骤

• 托管评审、问题与 Actions — 在任务进行中时将代码评审状态关联到工作树。
• 从 Orca 提交并推送 — 无需离开 Orca 即可交付分支。