1. 任务
Hifox Docs
  • 欢迎使用 HiFox
  • 快速上手
  • 使用 Agent
    • Agent
    • Agent 如何执行任务
    • 连接代码库
    • 评论和回复
    • 收件箱
    • 与 Agent 对话
    • 机器
    • 小队
    • Skill
  • 工作空间
    • 空间
    • 任务
    • 成员
    • 项目
    • 迭代
    • 视图和任务列表
    • 自动化
  • 任务
    • 任务类型
    • 任务状态
    • 关注任务
    • 任务标签
    • 任务关联
  • 第三方集成
    • Jira 集成
    • 飞书集成
    • Slack 集成
  • CLI
    • HiFox CLI
    • 个人访问令牌
  • 服务与隐私协议
    • HiFox 服务协议
    • HiFox 隐私条款
  1. 任务

任务状态

任务状态用于表示一项任务当前处于哪个阶段,例如待处理、待办、进行中、已完成、已取消。
状态回答的是“这件事现在推进到哪里了”。团队可以通过状态看任务进展,也可以用状态驱动看板、筛选、收件箱提醒和 Agent 执行行为。

状态类别#

每个组织状态都属于一个固定类别。类别决定状态在系统里的语义。
状态类别含义
待处理还不准备开始,适合放 backlog。
待办已经准备好,可以开始。
进行中正在处理。
已完成已经完成,是终态。
已取消不再继续,是终态。
重复被其他任务覆盖,是终态。
你可以创建多个同类状态。例如“开发中”“测试中”都可以属于进行中类别;“已上线”“已关闭”都可以属于已完成类别。
类别比状态名称更重要。HiFox 会用类别判断任务是否完成、是否应该停止执行、看板如何展示,以及 Agent 是否应该开始工作。

默认状态#

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

组织状态库#

在组织的”任务状态“设置中,管理员可以维护组织状态库。
理解任务状态时,可以分成两层:
层级作用
组织状态库维护可复用的状态定义,例如“待办”“进行中”“待验证”“已完成”。
任务类型状态在某个空间的某个任务类型里,选择这类任务实际可用哪些状态、顺序是什么、默认状态是什么。
组织状态库像一组“可选状态材料”。任务类型状态则是从这些材料里挑出一组,组成某类任务的实际流转过程。
例如,组织状态库里可以同时有:
待办;
进行中;
待验证;
等待客户;
已完成;
已取消。
但不同任务类型可以只使用其中一部分:
Bug:待办 → 进行中 → 待验证 → 已完成;
客户请求:待办 → 等待客户 → 进行中 → 已完成;
内容任务:待办 → 进行中 → 已完成。
所以,用户在任务里能选到哪些状态,不是只看组织状态库,而是看当前任务所在空间中,这个任务类型配置了哪些状态。

配置某个任务类型的状态#

进入空间里的任务类型详情后,可以在“状态”页配置这个任务类型实际可用的状态。
常见操作包括:
从组织状态库中添加已有状态;
新建状态并加入当前任务类型;
移除当前任务类型不再使用的状态;
调整状态顺序;
设置这个任务类型的新任务默认状态。
如果某个状态已经有任务在使用,通常不能直接从任务类型中移除。需要先把这些任务移动到其他状态,再调整状态集合。

状态如何影响 Agent 执行#

任务状态会影响 Agent 是否自动开始执行。
通常规则是:
任务在待处理类别中时,即使已经分配给 Agent,也不会立即开始;
任务移到待办或进行中等可执行状态后,Agent 才会开始;
已完成、已取消、重复这类终态不会触发新的执行;
已取消和重复会停止任务继续执行。
需要注意:任务状态和 Agent 工作状态不是同一件事。
任务状态 表示任务生命周期,例如待办、进行中、已完成;
Agent 工作状态 表示 Agent 当前运行情况,例如工作中、等待人工回复、等待人工审阅、执行异常。
所以一个任务可以处于“进行中”,同时显示“等待人工回复”。这表示任务还在推进,但 Agent 需要人类补充信息。

在任务中切换状态#

你可以在任务详情、列表或看板中切换任务状态。
切换状态时,HiFox 会检查这个状态是否属于当前任务类型的可用状态。如果状态不在当前任务类型中,就不能直接切换。
看板按状态展示时,可以把任务拖到其他状态列,完成状态变更。跨空间或聚合视图中,如果多个空间或任务类型使用了不同状态,看板可能会按状态名称或状态类别聚合展示。

最佳实践#

状态名称要表达下一步#

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

不要创建太多状态#

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

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

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

把待处理当作整理区#

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

常见问题#

状态是按空间配置的吗?#

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

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

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

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

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

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

可以。评论触发 Agent 不完全受任务生命周期状态限制。即使任务已完成,如果你在评论中继续提问或 @ Agent,仍可能触发后续响应。
修改于 2026-06-30 09:32:36
上一页
任务类型
下一页
关注任务
Built with