创建和管理工单

本指南介绍如何创建和管理工单。

创建工单

通过 UI

在工作区侧边栏中点击工单。
点按新建工单。
填写：
- 标题 —— 简短摘要。这是唯一必填的字段。
- 描述 —— Markdown 格式，带有格式工具栏。
- 状态 —— 待办（默认）或待办池。已启动状态与终态都通过生命周期到达，而不是在创建时设定。
- 优先级 —— 无、紧急、高、中或低。
- 负责人 —— 你自己，或工作区中的任意智能体。
- 项目 —— 可选的分组。
点按创建，或先打开继续创建，让对话框保持打开以便连续录入。

对话框中没有任何提供方选择器。工单会创建到工作区当前生效的工单提供方上。

通过智能体

在空间中请智能体：

为慢速连接上的登录超时问题创建一张工单。

它会调用 create_ticket MCP 工具。该工具上的优先级是整数，而不是名称：

create_ticket(
  workspace_id: "...",
  title: "Fix login timeout on slow connections",
  description: "...",
  priority: 2
)

值	优先级
`0`	无
`1`	紧急
`2`	高
`3`	中
`4`	低

只有 workspace_id 和 title 是必填的；description、priority、 assignee（智能体 id）和 team_id 都是可选的。该工具被归类为厂商同步写入，运行前会请求你批准。

更新工单状态

工单遵循以下生命周期：

backlog → open → inProgress ⇄ blocked
                    ↓   ↑
                 inReview
                    ↓
              done / failed   (terminal)

done、failed 和 cancelled 是终态。cancelled 可以从任何非终态到达。 done 和 failed 可以从 inProgress 或 inReview 到达；open 也可以直接转到 blocked。UI 的状态选择器列出了除 failed 之外的每一个状态 —— 该状态由智能体通过 fail_ticket 设置。

要更改状态，可以使用以下任一方式：

工单属性栏中的状态行，
列表中工单右键菜单里的状态子菜单，
多选工单后浮动栏上的状态按钮。

状态变更会发出领域事件（TicketStatusChanged、TicketCompleted 等），可以触发流水线。参见设置流水线触发器。

分配工单

打开工单。
在属性栏中设置负责人 —— 你自己、另一位工作区成员，或一个智能体。

添加标签

标签是从工单列表中批量添加的，而不是在单张工单上 —— 属性栏里没有任何标签控件。

将鼠标悬停在工单列表中的某一行上并勾选它的复选框。按需要勾选任意多行；一旦有内容被选中，就会浮现一个浮动栏。
在该浮动栏中，打开标签按钮。
选择一个标签。它会被添加到每一张尚无该标签的选中工单上；已有标签绝不会被清除。清除标签会移除所有标签。该选择器列出的是工作区中已经出现在某张工单上的标签。智能体可以通过 update_ticket 或 tickets.patch 添加新名称。

关联工单

关联关系位于属性栏中工单的关联卡片上，或列表右键菜单的关联到之下。

打开工单，找到关联卡片。
点按其添加控件，选择关系：

关系	含义
子工单属于…	这张工单的父工单是另一张
父工单为…	另一张工单是这张的子工单
被阻塞于…	这张工单被另一张阻塞
阻塞…	这张工单阻塞另一张
关联到…	对称关系，不隐含方向
重复于…	这张工单是另一张的重复项

选择目标工单。

被重复会出现在卡片中，但不会出现在选择器里 —— 它是**重复于…**的逆向关系，要从另一张工单上设置。列出的每个关系都可以点击以打开被关联的工单，并可在悬停时移除。

父工单和子工单关系保存在工单自身，而不是作为关联行，因此删除一张父工单会级联到它的子工单（见下文），而阻塞和关联链接则不会。

添加协作者

协作者是工单上的一份名册 —— 记录谁参与其中、以什么身份参与。

打开工单。
点按添加协作者卡片上的人形加号控件。
选择一个智能体。

三种角色分别是 assignee、collaborator（默认）和 reviewer。 UI 中的选择器只列出工作区智能体，并且总是写入默认角色；人员可以作为行出现，但不会在该菜单中提供。MCP 的 add_ticket_collaborator 工具接受一个 role。

添加协作者会写入一行记录，但不会发布任何领域事件；它也不授予任何空间访问权限。要把智能体带进某段对话，请改从空间头部把它添加为参与者 —— 参见空间。

删除工单

使用属性栏底部的删除工单、右键菜单，或多选后浮动栏上的删除操作。