#任务

任务是 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 或小队可以选择。

开启多人处理人后，一条任务可以有多名人员处理人。集合内人人等价，没有主负责人。你可以追加人员，也可以整组替换；具体点击方式以线上为准。

任务只有一个全局状态：任一处理人把任务标完成，对所有处理人都完成。

「我的任务」、按处理人筛选，按「集合里包含我」命中。看板按处理人分组时，多人任务会在每个处理人列里各出现一次；视图顶部总数按任务去重。

空间开关关闭后，站内不能再给新任务加多人；已经是多人的存量任务仍可编辑。从导入或外部同步进来的多人数据不会被截断。

Slack、飞书等外部卡片可以展示多人，但 Slack 面板里改处理人仍是单选，写入等于整组替换。

入口在空间设置，设置项名称当前是「允许多个处理人」，以线上设置为准。

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

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

#与 Agent 协作

要让 Agent 或小队来处理任务，最常见的方式是把执行槽设置为某个 Agent 或小队。人员处理人可以同时保留。

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

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

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

任务详情头部也可以用 快捷对话：自建「功能名 + 提示词 + 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 是否可用、电脑是否在线、代码库和密钥是否配置好，以及任务是否有明确下一步。