任务状态
任务状态用于表示一项任务当前处于哪个阶段,例如待处理、待办、进行中、已完成、已取消。
状态回答的是“这件事现在推进到哪里了”。团队可以通过状态看任务进展,也可以用状态驱动看板、筛选、收件箱提醒和 Agent 执行行为。
状态类别
每个组织状态都属于一个固定类别。类别决定状态在系统里的语义。
你可以创建多个同类状态。例如“开发中”“测试中”都可以属于进行中类别;“已上线”“已关闭”都可以属于已完成类别。
类别比状态名称更重要。HiFox 会用类别判断任务是否完成、是否应该停止执行、看板如何展示,以及 Agent 是否应该开始工作。
默认状态
每个任务类型都有自己的默认状态。
新建任务时,如果没有手动选择状态,HiFox 会使用当前任务类型的默认状态。默认状态通常是“待办”,也可以是“待处理”。默认状态不能设置为已完成、已取消或重复这类终态。
这样可以避免新建任务一开始就进入完成或取消状态。
组织状态库
在组织的”任务状态“设置中,管理员可以维护组织状态库。
理解任务状态时,可以分成两层:
组织状态库像一组“可选状态材料”。任务类型状态则是从这些材料里挑出一组,组成某类任务的实际流转过程。
例如,组织状态库里可以同时有:
- 待办;
- 进行中;
- 待验证;
- 等待客户;
- 已完成;
- 已取消。
但不同任务类型可以只使用其中一部分:
- Bug:待办 → 进行中 → 待验证 → 已完成;
- 客户请求:待办 → 等待客户 → 进行中 → 已完成;
- 内容任务:待办 → 进行中 → 已完成。
所以,用户在任务里能选到哪些状态,不是只看组织状态库,而是看当前任务所在空间中,这个任务类型配置了哪些状态。
配置某个任务类型的状态
进入空间里的任务类型详情后,可以在“状态”页配置这个任务类型实际可用的状态。
常见操作包括:
- 从组织状态库中添加已有状态;
- 新建状态并加入当前任务类型;
- 移除当前任务类型不再使用的状态;
- 调整状态顺序;
- 设置这个任务类型的新任务默认状态。
如果某个状态已经有任务在使用,通常不能直接从任务类型中移除。需要先把这些任务移动到其他状态,再调整状态集合。
删除状态
在组织的任务状态设置里可以删除状态。
仍被任务或任务类型工作流使用时,需要指定迁入的目标状态,才能删。不指定目标时,删除仍会被拒绝。迁入会一并处理该状态下的任务,以及工作流默认状态等从属关系。
仍不能删的情况包括:某类别里的最后一个状态、组织默认状态。具体限制以线上报错为准,例如「每个状态类别至少需要一个状态」或「删除此状态前,请先选择另一个默认状态」。
状态如何影响 Agent 执行
任务状态会影响 Agent 是否自动开始执行。
通常规则是:
- 任务在待处理类别中时,即使已经分配给 Agent,也不会立即开始;
- 任务移到待办或进行中等可执行状态后,Agent 才会开始;
- 已完成、已取消、重复这类终态不会触发新的执行;
- 已取消和重复会停止任务继续执行。
需要注意:任务状态和 Agent 工作状态不是同一件事。
- 任务状态 表示任务生命周期,例如待办、进行中、已完成;
- Agent 工作状态 表示 Agent 当前运行情况,例如工作中、等待人工回复、等待人工审阅、执行异常。
所以一个任务可以处于“进行中”,同时显示“等待人工回复”。这表示任务还在推进,但 Agent 需要人类补充信息。
在任务中切换状态
你可以在任务详情、列表或看板中切换任务状态。
切换状态时,HiFox 会检查这个状态是否属于当前任务类型的可用状态。如果状态不在当前任务类型中,就不能直接切换。
看板按状态展示时,可以把任务拖到其他状态列,完成状态变更。跨空间或聚合视图中,如果多个空间或任务类型使用了不同状态,看板可能会按状态名称或状态类别聚合展示。
最佳实践
状态名称要表达下一步
好的状态能让团队知道下一步该做什么。例如“待验证”比“处理中 2”更清楚。
不要创建太多状态
状态太多会让任务流转变慢,也会让看板难以阅读。只保留团队真正需要区分的阶段。
用状态类别保持系统语义正确
创建自定义状态时,要选对类别。例如“待发布”通常仍是进行中类别,“已上线”通常是已完成类别。
把待处理当作整理区
待处理适合放还没准备好的任务。把任务分配给 Agent 前,如果还需要补充需求,可以先放在待处理;准备执行时再移到待办。
常见问题
状态是按空间配置的吗?
状态本身是一组可复用定义。每个空间通过任务类型决定哪些状态可用;不同空间启用不同任务类型后,就可以形成不同的状态使用方式。
为什么我不能把任务切到某个状态?
通常是因为这个状态不在当前任务类型的可用状态里。需要切换任务类型,或让管理员调整该任务类型的状态设置。
为什么任务分配给 Agent 后没有开始?
先检查任务是否仍在待处理类别中。待处理中的任务不会立即触发 Agent,移动到待办或其他可执行状态后才会开始。
已完成状态可以继续评论触发 Agent 吗?
可以。评论触发 Agent 不完全受任务生命周期状态限制。即使任务已完成,如果你在评论中继续提问或 @ Agent,仍可能触发后续响应。