文档 / 审查 / Linear 事项抽屉

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

设置¶

1. 打开 设置 → 集成 → Linear。
2. 从 Linear → 设置 → API 粘贴个人 API token。
3. 选择要查看的团队。

使用 Linear¶

• 任务抽屉会在一个合并视图中显示 GitHub 和 Linear 议题。
• 在 Linear 任务视图中使用 有工作区 模式，仅列出已关联到本地工作树或文件夹工作区的议题。带有已附加工作区的行会打开该工作区；当需要第二个检出时，你仍可以从同一议题开始创建新的工作区。
• 从 Linear 议题创建工作树时，会打开交互式工作区创建器（与 GitHub 条目相同的路径），因此议题命令自动化、SSH 和文件夹工作区均可应用。Orca 会预填名称并附加议题 ID。当 Linear 为议题提供分支名称时，Orca 会将其用作工作树分支（与 Linear 建议的命名相同），而不仅仅是标题的 slug。议题详情菜单可以 复制建议的分支名称。
• 创建后，在工作区卡片上打开 编辑工作树详情，并使用带有 Linear 标签的 议题 字段（或粘贴 Linear URL）来关联或更改议题，而无需重新创建工作树。GitHub 和 Linear 共享该字段——保存新关联会替换之前的提供商关联。
• 打开议题详情视图，可更新状态、负责人、优先级、标签和估算等字段。优先级会使用 Linear 自身的优先级图标渲染，使抽屉与你在 Linear 中看到的保持一致。
• 当你从 Linear 议题启动代理时，Orca 会将嵌入在议题描述、评论和子议题中的任何内联图像和媒体包含在 prompt 上下文中，这样代理就能看到设计稿或 bug 复现，而无需你手动粘贴截图。
• 新建 Linear 议题 和 新建 Linear 项目 会在你意外关闭对话框时保留标题/描述（以及项目名称、摘要和简介）——按 Escape、取消、点击外部或关闭。在同一应用会话中重新打开对话框时，文本会恢复；成功创建后草稿会清除，并且不会在应用重启后保留。团队/项目选择器仍会使用其通常的打开时默认值。
• 长列表通过 加载更多 操作分页——当项目中的议题数量超出初始抽屉可显示的范围时，这很有用。
• 布局选择会在重启后保留：列表与看板、分组依据、排序依据、可见列和属性筛选器。属性筛选器按 Linear 工作区 存储，因此切换工作区不会应用其他工作区的筛选维度。
• Orca 会按仓库记住你上次使用的任务来源（GitHub、Linear 或 Jira）。

Linear 状态同步（创建工作树时将议题移动到“进行中”）按团队选择启用。

代理与 CLI¶

代理可以通过 orca linear（以及 orca-linear 技能）读取和写入 Linear。该接口包括 MCP 兼容的创建/更新和列表筛选器（save-issue、list-issues、关系添加/移除），以及议题上下文标志，例如 --activity 和 --full。参见 CLI 参考 → Linear。

后续步骤¶

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