任务状态

任务状态用于表示一项任务当前处于哪个阶段,例如待处理、待办、进行中、已完成、已取消。

状态回答的是“这件事现在推进到哪里了”。团队可以通过状态看任务进展,也可以用状态驱动看板、筛选、收件箱提醒和 Agent 执行行为。

状态类别

每个组织状态都属于一个固定类别。类别决定状态在系统里的语义。

状态类别含义
待处理还不准备开始,适合放 backlog。
待办已经准备好,可以开始。
进行中正在处理。
已完成已经完成,是终态。
已取消不再继续,是终态。
重复被其他任务覆盖,是终态。

你可以创建多个同类状态。例如“开发中”“测试中”都可以属于进行中类别;“已上线”“已关闭”都可以属于已完成类别。

类别比状态名称更重要。HiFox 会用类别判断任务是否完成、是否应该停止执行、看板如何展示,以及 Agent 是否应该开始工作。

默认状态

每个任务类型都有自己的默认状态。

新建任务时,如果没有手动选择状态,HiFox 会使用当前任务类型的默认状态。默认状态通常是“待办”,也可以是“待处理”。默认状态不能设置为已完成、已取消或重复这类终态。

这样可以避免新建任务一开始就进入完成或取消状态。

组织状态库

在组织的”任务状态“设置中,管理员可以维护组织状态库。

理解任务状态时,可以分成两层:

层级作用
组织状态库维护可复用的状态定义,例如“待办”“进行中”“待验证”“已完成”。
任务类型状态在某个空间的某个任务类型里,选择这类任务实际可用哪些状态、顺序是什么、默认状态是什么。

组织状态库像一组“可选状态材料”。任务类型状态则是从这些材料里挑出一组,组成某类任务的实际流转过程。

例如,组织状态库里可以同时有:

  • 待办;
  • 进行中;
  • 待验证;
  • 等待客户;
  • 已完成;
  • 已取消。

但不同任务类型可以只使用其中一部分:

  • Bug:待办 → 进行中 → 待验证 → 已完成;
  • 客户请求:待办 → 等待客户 → 进行中 → 已完成;
  • 内容任务:待办 → 进行中 → 已完成。

所以,用户在任务里能选到哪些状态,不是只看组织状态库,而是看当前任务所在空间中,这个任务类型配置了哪些状态

配置某个任务类型的状态

进入空间里的任务类型详情后,可以在“状态”页配置这个任务类型实际可用的状态。

常见操作包括:

  • 从组织状态库中添加已有状态;
  • 新建状态并加入当前任务类型;
  • 移除当前任务类型不再使用的状态;
  • 调整状态顺序;
  • 设置这个任务类型的新任务默认状态。

如果某个状态已经有任务在使用,通常不能直接从任务类型中移除。需要先把这些任务移动到其他状态,再调整状态集合。

删除状态

在组织的任务状态设置里可以删除状态。

仍被任务或任务类型工作流使用时,需要指定迁入的目标状态,才能删。不指定目标时,删除仍会被拒绝。迁入会一并处理该状态下的任务,以及工作流默认状态等从属关系。

仍不能删的情况包括:某类别里的最后一个状态、组织默认状态。具体限制以线上报错为准,例如「每个状态类别至少需要一个状态」或「删除此状态前,请先选择另一个默认状态」。

状态如何影响 Agent 执行

任务状态会影响 Agent 是否自动开始执行。

通常规则是:

  • 任务在待处理类别中时,即使已经分配给 Agent,也不会立即开始;
  • 任务移到待办或进行中等可执行状态后,Agent 才会开始;
  • 已完成、已取消、重复这类终态不会触发新的执行;
  • 已取消和重复会停止任务继续执行。

需要注意:任务状态和 Agent 工作状态不是同一件事。

  • 任务状态 表示任务生命周期,例如待办、进行中、已完成;
  • Agent 工作状态 表示 Agent 当前运行情况,例如工作中、等待人工回复、等待人工审阅、执行异常。

所以一个任务可以处于“进行中”,同时显示“等待人工回复”。这表示任务还在推进,但 Agent 需要人类补充信息。

在任务中切换状态

你可以在任务详情、列表或看板中切换任务状态。

切换状态时,HiFox 会检查这个状态是否属于当前任务类型的可用状态。如果状态不在当前任务类型中,就不能直接切换。

看板按状态展示时,可以把任务拖到其他状态列,完成状态变更。跨空间或聚合视图中,如果多个空间或任务类型使用了不同状态,看板可能会按状态名称或状态类别聚合展示。

最佳实践

状态名称要表达下一步

好的状态能让团队知道下一步该做什么。例如“待验证”比“处理中 2”更清楚。

不要创建太多状态

状态太多会让任务流转变慢,也会让看板难以阅读。只保留团队真正需要区分的阶段。

用状态类别保持系统语义正确

创建自定义状态时,要选对类别。例如“待发布”通常仍是进行中类别,“已上线”通常是已完成类别。

把待处理当作整理区

待处理适合放还没准备好的任务。把任务分配给 Agent 前,如果还需要补充需求,可以先放在待处理;准备执行时再移到待办。

常见问题

状态是按空间配置的吗?

状态本身是一组可复用定义。每个空间通过任务类型决定哪些状态可用;不同空间启用不同任务类型后,就可以形成不同的状态使用方式。

为什么我不能把任务切到某个状态?

通常是因为这个状态不在当前任务类型的可用状态里。需要切换任务类型,或让管理员调整该任务类型的状态设置。

为什么任务分配给 Agent 后没有开始?

先检查任务是否仍在待处理类别中。待处理中的任务不会立即触发 Agent,移动到待办或其他可执行状态后才会开始。

已完成状态可以继续评论触发 Agent 吗?

可以。评论触发 Agent 不完全受任务生命周期状态限制。即使任务已完成,如果你在评论中继续提问或 @ Agent,仍可能触发后续响应。