任务 - Hifox Docs

任务是 HiFox 里跟踪工作的基本单位。一个任务可以由成员处理，也可以委派给 Agent 执行。

你可以把任务理解成一件工作的完整上下文容器：要做什么、为什么做、谁负责、现在处于什么状态、有哪些讨论、Agent 做了什么、结果是否通过验收，都会沉淀在同一个任务里。

任务适合用来做什么？

任务适合承载任何需要被跟踪、分配和完成的工作，例如：

修复一个 Bug；

实现一个小需求；

补充一篇文档；

跟进一次客户反馈；

排查一次测试失败；

让 Agent 修改一处文案、补一条测试或分析一段日志。

如果一件事需要明确负责人、状态、上下文和结果，就适合创建为任务。

任务里包含什么？

一个任务通常包含这些信息：

标题：用一句话说明要做什么；

描述：补充背景、目标、范围和验收标准；

空间：任务属于哪个团队或项目范围；

任务类型：这是一项普通任务、Bug、需求、内容任务，还是其他自定义类型；

状态：任务当前处于哪个阶段；

负责人：可以是成员，也可以是 Agent 或小队；

优先级：帮助团队判断处理顺序；

标签：用于模块、风险、来源或临时分类；

项目：把任务归入一个更大的目标或交付；

评论和活动记录：保留讨论、补充信息、字段变化和 Agent 回复；

子任务和关联任务：把复杂工作拆开，或标记任务之间的关系。

任务不是一句待办事项。写得好的任务应该让接手的人或 Agent 能知道下一步该做什么，以及怎样判断完成。

创建任务

创建任务时，最重要的是把任务写清楚。

建议至少包含：

标题

标题应该具体、可行动。例如：

不推荐：按钮问题

推荐：把任务列表空状态按钮文案从“开始”改为“开始执行”

标题越明确，后续搜索、筛选和分配越容易。

描述

描述不需要一开始就写得非常完整。先把你已经知道的信息写进去，例如背景、目标、截图、链接、报错日志或相关讨论。

如果细节还没想清楚，可以直接在描述里说明“请先帮我调研并补全任务细节”。Agent 可以继续细化范围、补充验收标准、拆解子任务，并把结论写回任务详情。

任务类型

任务类型用于区分不同工作对象。

例如在产品与研发空间里，常见任务类型可能包括：

任务：一般工作项；

Bug：缺陷和回归问题；

需求：产品能力或用户故事；

问题：需要排查或跟进的事项。

不同任务类型可以有不同字段和工作流。比如 Bug 可能需要复现步骤、影响范围和修复版本；需求可能需要用户价值、验收标准和上线阶段。

选择正确的任务类型，可以让任务字段更贴近实际工作，也方便后续筛选、统计和自动化。

状态和工作流

状态表示任务当前处于哪个阶段。常见状态包括：

Backlog：还在收集或规划，暂不开始；

Todo：已经准备好，可以开始处理；

In Progress：正在处理；

In Review：等待评审或验收；

Done：已经完成；

Blocked：被信息、权限、依赖或环境阻塞；

Cancelled：不再继续处理。

不同空间和任务类型可以使用不同工作流。研发空间可能更关注开发和 review，运营空间可能更关注待处理、跟进中和已解决。

如果任务已经委派给 Agent，状态还会影响 Agent 是否开始工作。通常任务在 Backlog 时不会立即开始；进入 Todo 后，Agent 才会开始执行。

负责人：成员、Agent 和小队

任务负责人表示谁负责推进这件事。

负责人可以是：

成员：由人类成员判断、沟通或执行；

Agent：由一个配置好的 Agent 执行；

小队：由多个 Agent 或角色协同处理复杂任务。

如果任务目标明确、上下文充分，并且 Agent 所在机器已经准备好，就可以把任务委派给 Agent。

如果任务还需要产品判断、权限确认或跨团队沟通，建议先分配给成员，等信息补充完整后再交给 Agent。

与 Agent 协作

要让 Agent 或小队来处理任务，最常见的方式是把任务负责人设置为某个 Agent 或小队。

如果任务已经在 Todo、In Progress 或其他可执行状态中，只要把负责人改成 Agent，HiFox 就会把任务委派给这个 Agent，自动开始执行。

如果任务还在 Backlog，Agent 会保持等待，不会立刻开始。你可以先把任务放在 Backlog 中整理需求，等准备开始时再移动到 Todo 或其他可执行状态。

如果你还没想清楚任务细节，也可以先把任务安排给 Agent 做调研和细化。比如让 Agent 阅读相关代码、整理影响范围、提出实现方案、拆解子任务、补充验收标准，然后把结论写回任务详情或评论里。

需要人类确认的状态

Agent 执行任务时，有些情况需要人类处理。常见状态包括：

等待人工回复：Agent 需要你补充信息、回答问题或确认下一步；

等待人工审阅：Agent 已经完成一轮工作，需要你 review 结果；

Agent 被阻塞：Agent 遇到权限、环境、依赖或信息缺失，无法继续；

任务失败：Agent 的运行失败，需要查看失败原因后决定重试、补充信息或改派给成员。

这些需要你关注的更新会进入收件箱。收件箱只保留需要你处理、判断或追踪的协作信息，例如 Agent 请求回复、任务完成、任务失败、Agent 被阻塞、有人提及你或请求审阅。

当收件箱里出现这类任务时，打开任务详情，在评论里回复、补充上下文、确认方案，或根据结果完成 review。Agent 会基于同一个任务上下文继续工作。

评论和活动记录

任务评论用于补充上下文和继续讨论。

你可以在评论里：

补充截图、链接或日志；

说明新的限制条件；

@ 成员或 Agent；

回复 Agent 提出的问题；

记录人工验收结果。

活动记录会保留任务字段变化，例如状态变更、负责人变更、标签变更、Agent 执行结果等。这样其他成员可以快速理解任务发生过什么。

子任务和关联任务

当一个任务太大，包含多个可独立完成的步骤时，可以拆成子任务。

父任务用于表达总体目标，子任务用于跟踪具体执行。例如：

父任务：完成新用户上手流程优化；

子任务：调整欢迎页文案；

子任务：补充快速上手文档；

子任务：增加关键路径埋点；

子任务：验证桌面端和网页端流程。

关联任务用于表示任务之间的关系，例如重复、阻塞、相关或依赖。

任务列表/看板

任务可以通过列表、看板、视图和筛选来整理。

常见筛选条件包括：

空间；

状态；

负责人；

创建人；

优先级；

任务类型；

标签；

项目；

是否委派给 Agent。

如果一组筛选条件经常使用，可以保存成视图。例如“本周待 review”“高优先级 Bug”“Agent 阻塞任务”“我的未完成任务”。

常见问题

任务应该放在哪个空间？

放到最接近实际负责团队或工作范围的空间。空间会影响任务 ID、成员可见性、工作流、视图和自动化。

什么时候应该拆子任务？

当一个任务包含多个可独立验收、可独立分配或可能并行推进的步骤时，就应该拆子任务。

什么时候交给 Agent？

当任务目标明确、上下文充分、执行环境可用，并且结果可以被 review 时，就适合交给 Agent。

Agent 没有开始怎么办？

先确认任务是否仍在 Backlog，再检查 Agent 是否可用、机器是否在线、代码库和密钥是否配置好，以及任务是否有明确下一步。

任务

任务适合用来做什么？#

任务里包含什么？#

创建任务#

标题#

描述#

任务类型#

状态和工作流#

负责人：成员、Agent 和小队#

与 Agent 协作#

需要人类确认的状态#

评论和活动记录#

子任务和关联任务#

任务列表/看板#

常见问题#

任务应该放在哪个空间？#

什么时候应该拆子任务？#

什么时候交给 Agent？#

Agent 没有开始怎么办？#