#任务关联

任务关联用于表达两个任务之间的关系。它不会把任务合并，也不会自动改变任务状态，而是让团队在任务详情里清楚看到“这件事和哪些任务有关”。

关联任务适合用来说明：

• 一个任务被另一个任务阻塞；
• 两个任务重复或互为克隆；
• 两个任务有上下文关系，但不一定有先后顺序；
• Jira 导入或同步过来的任务保留了原来的 issue link；
• 一个复杂问题拆成多条任务后，需要保留它们之间的影响关系。

如果你只是想把大任务拆成可独立完成的步骤，用子任务。
如果你想表达两个独立任务之间的影响、重复或上下文关系，用任务关联。

#任务关联显示在哪里？

任务详情页会显示 关联任务 区域。

每条关联通常包含：

• 关系类型，例如“受阻于”“阻塞”“重复”“与……存在关联”；
• 关联任务的编号；
• 关联任务标题；
• 关联任务状态；
• 关联任务负责人头像。

点击关联任务行，可以打开对方任务。已完成、取消或重复等终态任务，会用更弱的视觉状态展示，方便你判断这个依赖是否已经结束。

如果当前任务还没有任何关联，关联区域通常不会显示。你可以从任务详情页的更多菜单中添加关联任务。

#如何添加关联任务？

在任务详情页中，打开更多菜单，选择 添加关联任务。

添加时需要完成两步：

1. 选择关系类型；
2. 搜索、选择或粘贴另一个任务链接。

搜索范围是当前组织内的任务，因此可以关联不同空间里的任务。比如“产品需求”空间里的需求，可以关联到“研发”空间里的 Bug 或实现任务。

你也可以直接粘贴当前组织内的任务链接。HiFox 会解析链接并显示对应任务。如果链接属于其他组织，或者任务不存在，就不能添加为任务关联。

如果粘贴的是普通外部链接，例如文档、日志或设计稿链接，应该使用 添加链接，而不是添加关联任务。

#内置关系类型

HiFox 默认提供几类类似 Jira issue link 的内置关系类型：

有方向的关系会在两边显示不同文案。例如：

• 在 A 任务上添加“阻塞 B”；
• 打开 B 任务时，会看到“受阻于 A”。

“与……存在关联”是对称关系，两边看到的关系相同。

#阻塞关系怎么用？

阻塞关系适合表达真实的执行顺序。

例如：

• API 返回分页字段 阻塞 前端列表接入分页；
• 补齐测试账号权限 阻塞 验证登录流程；
• 修复构建脚本 阻塞 发布桌面端版本。

使用阻塞关系后，团队成员和 Agent 可以更快理解为什么一个任务暂时无法推进。

注意：任务关联本身不会自动把任务状态改成 Blocked，也不会在被阻塞任务完成后自动切换状态。它主要用于表达关系和保留上下文。是否调整状态，仍然需要成员、Agent 或自动化根据团队流程处理。

看板卡片会分别展示两类阻塞提示：

• 阻塞数量：当前任务正在阻塞的任务数量；
• 阻塞进度：当前任务的阻塞项中已经完成的进度。

当关联任务的状态发生变化时，看板上的数量和进度提示会随之更新。这些提示只反映关联任务的数量和完成情况，不会代替任务工作流，也不会因为建立或解除关联而自动改变任务状态。

#重复关系怎么用？

当两个任务描述的是同一件事时，可以使用重复关系。

通常建议：

1. 保留信息更完整、讨论更多或更适合继续推进的任务；
2. 把另一个任务关联为“重复”；
3. 在被关闭的任务里补充说明，指向保留任务；
4. 根据团队流程把重复任务移动到“重复”或其他终态状态。

HiFox 的任务状态里可以有 duplicate 类别；如果你的空间工作流配置了类似“Duplicate / 重复”的状态，可以用它来关闭不再推进的重复任务。

#关联任务和子任务有什么区别？

例如：

• “完成新用户上手流程优化”下面可以拆多个子任务：改文案、补文档、加埋点、验证流程；
• “补文档”可能受阻于另一个任务“确认最终产品文案”；这时它们之间适合用阻塞关联。

简单判断方式：

• 如果一个任务是另一个任务的一部分，用子任务；
• 如果两个任务都可以独立存在，只是互相影响或相关，用任务关联。

#修改或移除关联

在任务详情页的 关联任务 区域，可以打开某条关联的更多菜单。

常见操作包括：

• 修改关系类型：把“相关”改成“受阻于”，或把“重复”改成“与……存在关联”；
• 移除关联：删除两个任务之间的这条关系。

任务关联是双向可见的。从任意一边移除关联，另一边也会消失。移除关联不会删除任何任务，也不会删除评论、活动记录或外部链接。

HiFox 会避免为同一对任务重复添加完全相同的关系，也会避免添加互相矛盾的反向关系。例如两个任务之间已经存在“受阻于”，就不应该再添加相反方向的“阻塞”形成互相阻塞。

#自定义关联类型

除了内置类型，组织还可以管理自定义任务关联类型。

自定义关联类型适合表达团队自己的关系，例如：

• 导致 / 由……导致；
• 验证 / 由……验证；
• 拆分自 / 拆分为；
• 客户反馈来源 / 对应处理任务。

每个关联类型包含：

• 名称：用于管理和识别这类关系；
• 链出描述：从发起关联的一侧读出的文案；
• 链入描述：从被关联的一侧读出的文案。

内置关联类型是固定的，不能编辑或删除。组织 owner / admin 可以新增、编辑和删除自定义关联类型。已经被现有任务关联使用的自定义类型不能直接删除，避免历史任务失去关系含义。

#与 Jira 的关系

HiFox 的任务关联与 Jira issue link 的模型接近。连接 Jira 后，Jira 中的 issue links 可能会同步为 HiFox 的任务关联。

常见对应关系包括：

• blocks / is blocked by；
• clones / is cloned by；
• duplicates / is duplicated by；
• relates to。

从 Jira 迁移或同步来的任务，建议检查关联关系是否准确，尤其是重复任务和阻塞任务。必要时可以在 HiFox 中调整关系类型，让团队和 Agent 都能读到正确上下文。

#最佳实践

#只在关系会影响理解或执行时添加

不要为了“可能有点关系”给任务加太多关联。过多弱关联会降低可读性。

如果关联能解释阻塞原因、重复来源、验收依赖或上下文来源，就值得添加。

#阻塞关系要配合任务状态和评论

关联能说明“被谁阻塞”，但不能替代状态和说明。重要阻塞建议同时：

• 把任务状态改成 Blocked 或团队约定的阻塞状态；
• 在评论里写清楚缺什么、谁能解除阻塞、预计下一步是什么。

#重复任务要明确保留哪一个

添加重复关系后，最好在评论或描述里说明保留任务是哪一个。这样成员和 Agent 打开重复任务时，不需要猜应该继续看哪条。

#给 Agent 留清楚上下文

Agent 会从任务标题、描述、评论、状态、标签和关联任务中理解上下文。添加关联任务时，尽量选择准确的关系类型；如果关系比较复杂，再用评论补一句原因。

#常见问题

#任务关联会自动改变状态吗？

不会。任务关联只表达任务之间的关系，不会自动把任务改成 Blocked、Done 或 Duplicate。

#可以关联不同空间的任务吗？

可以。只要任务属于同一个组织，就可以跨空间关联。

#可以关联其他组织的任务吗？

不可以。任务关联只能发生在同一个组织内。其他组织的任务链接无法作为关联任务添加。

#任务关联和外部链接有什么区别？

任务关联连接的是 HiFox 内的另一个任务，会显示对方任务编号、标题、状态和负责人。外部链接连接的是文档、网页、设计稿、日志、Jira issue 等资源。

#删除关联会删除任务吗？

不会。删除关联只移除两个任务之间的关系，两个任务本身都会保留。

#为什么某个任务不能再次添加为关联？

常见原因包括：它就是当前任务、已经用相同关系关联过、已经存在相反方向的冲突关系，或者链接属于其他组织。

#下一步

• 了解 任务 的基本结构。
• 了解 任务状态 如何表达 Blocked、Duplicate 等阶段。
• 了解 关注任务 如何追踪关联任务的后续动态。