#任务标签

任务标签是给任务添加的彩色标记，用来补充说明任务的主题、来源、模块或临时分类。

标签适合表达“这个任务和什么有关”，例如：

• 前端；
• 客户反馈；
• 高风险；
• Migrated；
• 移动端；
• 支付。

标签不会改变任务的流程，也不会决定任务有哪些字段。它更像轻量分类，适合筛选、分组、搜索和批量处理。

#标签和任务类型的区别

如果一类工作需要固定字段和状态，用 任务类型。如果只是想给任务打一个可组合的标记，用标签。

#组织标签和空间标签

HiFox 支持两层标签：

• 组织标签：整个组织都可以使用，适合跨空间通用的分类；
• 空间标签：只属于某个空间，适合这个团队自己的分类。

在某个空间的任务里，通常可以使用组织标签和这个空间自己的标签。

例如：

• 组织标签：客户反馈、高风险、Migrated；
• 研发空间标签：前端、后端、性能；
• 内容空间标签：官网、公众号、素材。

如果任务从一个空间移动到另一个空间，不属于目标空间的空间标签可能会被移除；组织标签通常会保留。

#创建和管理标签

在标签设置中，可以创建和维护标签。

一个标签通常包含：

• 名称：标签显示名称；
• 描述：说明这个标签适合什么任务；
• 颜色：用于在列表、看板和任务详情中快速识别；
• 标签组：可选，用来把一组互斥标签放在一起；
• 作用范围：组织标签或空间标签。

在任务标签选择器中，如果输入了不存在的标签名，也可以快速创建标签。系统会自动为新标签选择一个颜色。

#标签组

标签组用于管理一组互斥标签。同一个任务在同一个标签组里最多只能选择一个标签。

例如你可以创建一个“规模”标签组：

• S；
• M；
• L。

一个任务不能同时是 S 和 L。当你在同一标签组中选择新标签时，会替换掉原来的标签。

标签组适合表达“只能选一个”的分类，例如规模、来源、客户等级、风险等级。

#给任务添加标签

你可以在任务详情或任务列表中打开标签选择器，为任务添加或移除标签。

常见操作包括：

• 搜索标签；
• 添加标签；
• 移除标签；
• 在标签组中选择一个标签；
• 快速创建新标签。

标签可以同时添加多个。分组标签遵循同组只能选一个的规则。

#批量处理标签

在任务列表中选择多个任务后，可以批量处理标签。

常见批量操作包括：

• 添加标签；
• 移除标签；
• 替换标签；
• 清除某个标签组下的标签。

批量操作适合整理一批任务，例如把导入任务统一标记为 Migrated，或者给某个模块的任务统一添加 前端 标签。

#归档、删除和合并

不再使用的标签可以归档。归档后，这个标签不会再作为新标签被添加到任务上，但已有任务上的历史标签会保留。

如果确认不再需要，也可以删除标签。

当两个标签含义重复时，可以合并标签。合并后，源标签上的任务会迁移到目标标签，源标签会被移除。

建议先归档，再观察一段时间，确认没有人继续依赖后再删除或合并。

#筛选和视图

标签常用于任务列表筛选。

你可以用标签来：

• 只看某个模块的任务；
• 只看客户反馈任务；
• 查找迁移导入的任务；
• 创建某个活动或专项的任务视图；
• 在看板或列表中识别任务来源和主题。

选择多个标签筛选时，通常表示任务需要同时包含这些标签。

如果某组标签筛选经常使用，建议保存成 视图。

#与 Jira 导入和同步

从 Jira 导入任务时，Jira labels 通常会导入为 HiFox 标签。

常见行为包括：

• Jira labels 会变成任务标签；
• Jira components 也可能被折叠为标签；
• 导入任务可以自动添加 Migrated 标签；
• 标签变化可以同步回 Jira labels。

如果团队依赖 Jira labels 做分类，建议导入后先检查标签是否需要合并、重命名或归档。

#权限

通常规则是：

• 组织 owner / admin 可以管理组织标签和组织标签组；
• 空间成员可以管理自己空间里的空间标签；
• 组织标签在空间设置中通常只能使用，不能直接编辑；
• 普通成员可以在有权限的任务上添加或移除可用标签。

具体可见和可管理范围取决于组织角色、空间权限和标签作用范围。

#最佳实践

#标签用于补充分类，不要替代任务类型

如果标签开始承载固定字段或固定流程，说明它可能应该升级成任务类型。

#标签名称要短

标签会出现在任务卡片、列表和筛选器里。名称越短，越容易扫描。

#定期合并重复标签

例如 frontend、前端、FE 如果表达同一件事，建议合并成一个标准标签。

#用标签组管理互斥分类

如果一组标签只能选一个，例如风险等级、任务规模、客户等级，建议放入标签组。

#常见问题

#标签会影响 Agent 执行吗？

标签本身不会直接触发 Agent，但会进入任务上下文，帮助成员和 Agent 理解任务分类、来源或风险。

#标签和自定义字段有什么区别？

标签适合轻量分类，可以一个任务添加多个；自定义字段适合结构化信息，例如日期、成员、数字、下拉选项。

#归档标签后，已有任务上的标签会消失吗？

不会。归档主要影响后续是否还能新添加这个标签，已有任务上的历史标签会保留。

#为什么我在某个空间里看不到某个标签？

可能是这个标签是其他空间的空间标签，或者已被归档。组织标签通常在所有空间可用。

#同一个标签组为什么只能选一个？

标签组用于互斥分类。选择同组的新标签时，会替换掉原来同组标签，避免一个任务同时出现互相冲突的分类。

#下一步

• 了解 任务类型 何时比标签更合适。
• 了解 视图和任务列表 如何保存标签筛选。
• 了解 任务 的基本结构。