• 创建史诗
  • 开始和到期日期继承
• 编辑史诗
  • 重新排序史诗描述中的列表项
• 批量编辑史诗
  • 在抽屉（drawer）中打开史诗 (SELF-MANAGED ONLY)
• 指派人 (BETA)
  • 在史诗上更改指派人
  • 史诗颜色
  • 修改史诗颜色
• 删除史诗
• 关闭史诗
• 重新打开一个关闭史诗
• 从一个议题转到一个史诗
• 查看史诗列表
  • 谁可以查看史诗
  • 缓存史诗计数
• 过滤史诗列表
  • 使用 OR 运算符过滤
• 对史诗列表进行排序
• 改变排序顺序
• 使一个史诗保密
• 管理分配给史诗的议题
  • 查看分配给史诗的议题
  • 查看史诗中的议题数量
  • 查看史诗进度
  • 健康状态
    • 修改史诗的健康状态
  • 在史诗中添加一个新的议题
    • 添加现有的议题到史诗中
    • 从史诗中创建一个议题
  • 从史诗中删除议题
  • 重新排序分配给史诗的议题
  • 在史诗之间移动议题
• 多级子史诗
  • 添加父史诗到史诗
  • 来自其它群组的子史诗
  • 在路线图上查看子史诗
  • 在史诗中添加一个子史诗
    • 新史诗
    • 既有史诗
  • 在史诗之间移动子史诗
  • 重新排列分配给史诗的子史诗
  • 从父史诗中删除子史诗

管理史诗

本页收集了所有您能用史诗做的事情或与之有关的说明。

创建史诗

先决条件：

• 您必须至少具有史诗群组的报告者角色。

要在您所在的群组中创建一个史诗：

1. 进入新建史诗表单。
   • 进入您的群组，在左侧边栏选择 史诗。然后选择 新建史诗。
   • 从您的群组中的史诗，选择 ，然后选择 新建史诗。
   • 在任何地方，在顶部菜单中，选择 新建… () > 新建史诗。
   • 在一个空的路线图中，选择 新建史诗。
2. 输入一个标题。
3. 填写字段。
   • 输入描述。
   • 要使史诗保密，请选中保密下的复选框。
   • 选择标记。
   • 选择开始和截止日期，或继承它们。
   • 选择一个颜色。
   • 选择一个里程碑
   • 选择一个迭代
4. 选择创建史诗。

新创建的史诗就会打开。

开始和到期日期继承

如果您选择继承：

• 对于开始日期，系统会扫描所有分配给史诗的子议题和史诗，并将开始日期设置为与子史诗或分配给议题的里程碑中发现的最早开始日期相匹配。
• 对于到期日，系统会会扫描所有分配给史诗的子议题和史诗，并将到期日设置为与子史诗或分配给议题的里程碑中发现的最迟到期日相匹配。

这些是动态的日期，如果出现以下情况，会重新计算：

• 子史诗的日期改变。
• 里程碑被重新分配给一个议题。
• 一个里程碑的日期发生变化。
• 议题被添加到史诗中，或从史诗中删除。

因为史诗的日期可以继承其子史诗的日期，所以开始日期和到期日期会从下往上传播。如果最底层的子史诗的开始日期发生了变化，它就会成为其父史诗的最早可能的开始日期。父史诗的开始日期就会反映这一变化，并向上传播到顶层的史诗。

编辑史诗

创建史诗后，您可以编辑以下细节。

• 标题
• 描述
• 开始日期
• 到期日期
• 标识
• 颜色

要编辑史诗的标题或描述：

1. 选择编辑标题和描述 按钮。
2. 进行修改。
3. 选择保存更改。

要编辑史诗的开始日期、到期日期或标识/里程碑/迭代：

1. 选择史诗侧边栏中每个部分旁边的编辑。
2. 选择您的史诗的日期或标识。

重新排序史诗描述中的列表项

• 引入于 15.1 版本。

当您查看描述中包含列表的史诗时，您还可以对列表项重新排序。

先决条件：

• 您必须至少具有项目的报告者角色，是史诗的作者，或被指派到史诗。
• 史诗的描述必须有一个有序、无序或任务列表。

要重新排序列表项，在查看史诗时：

1. 将鼠标悬停在列表项行上，使工具图标 () 可见。
2. 选择并按住工具图标。
3. 将该行拖到列表中的新位置。
4. 释放工具图标。

批量编辑史诗

权限级别为报告者或更高权限的用户可以管理史诗。

当在一个组中批量编辑史诗时，您可以编辑他们的标识。

先觉条件：

• 您必须至少具有父史诗群组的报告者角色。

要同时更新多个史诗：

1. 在一个组中，进入 史诗 > 列表。
2. 点击 批量编辑。屏幕右侧的侧边栏会出现一个可编辑的字段。
3. 勾选您想编辑的每个史诗旁边的复选框。
4. 从侧边栏中选择适当的字段和它们的值。
5. 点击 更新所有。

在抽屉（drawer）中打开史诗 (SELF-MANAGED ONLY)

• 引入于极狐GitLab 17.4，使用名为 issues_list_drawer 的功能标志。默认禁用。
• 功能标志名在极狐GitLab 17.6 中更改为 epics_list_drawer。

当启用此功能时，当您从史诗列表或史诗看板中选择一个史诗时，它会在抽屉中打开。您可以在抽屉中编辑史诗或创建评论。

要在完整视图中打开史诗，或：

• 在新标签页中打开史诗。从史诗列表中，您可以:
  • 右键单击史诗并在新标签页中打开。
  • 按住 Cmd 或 Ctrl 并选择史诗。
• 从抽屉中，在左上角选择 在完整视图中打开。

指派人 (BETA)

• 引入于极狐GitLab 17.4，使用名为 work_items_beta 的功能标志。默认禁用。

如果您的管理员启用了新的史诗外观，可以讲一个史诗指派给一个或多个用户。

指派人可以根据需要进行更改。想法是指派人是对史诗负责的人。

如果用户不是群组的成员，如果其他的群组成员来进行指派，则史诗只能指派给它们。

在史诗上更改指派人

先决条件：

• 您的管理员必须启用新的查看。
• 您必须至少具有群组的报告者角色。

要在史诗上更改指派人：

1. 在左侧边栏中，选择 搜索或跳转到，然后找到您的群组。
2. 选择 计划 > 史诗，然后选择您的史诗以查看它。
3. 在右侧边栏中，在 指派人 区域中选择 编辑。
4. 从下拉列表中选择要添加为指派人的用户。
5. 选择任何不在下拉列表中的区域。

无需刷新页面，指派人就已经被更改。

史诗颜色

引入于 14.9 版本，功能标志为 epic_color_highlight。默认禁用。 - 在极狐GitLab 16.11 中，为私有化部署和 SaaS 启用。 - 自定义颜色引入于极狐GitLab 17.5。

您可以为史诗设置颜色来分类和对任务进行优先级处理。使用颜色来：

• 将史诗和团队或公司的创新计划关联起来。
• 指示史诗层次结构中的级别。
• 将相关的史诗组合在一起。

史诗颜色在 路线图 和 史诗看板 中可见。

在路线图中，时间线条匹配史诗的颜色：

在史诗看板上，颜色显示在卡片的边框上：

修改史诗颜色

先决条件：

• 您必须至少具有史诗群组的报告者角色。

要修改史诗颜色：

1. 在左侧边栏中，选择 搜索或转到，然后找到您的群组。
2. 选择 计划 > 史诗。
3. 选择 新建史诗或选择现有的史诗。
4. 在右侧边栏中，在 颜色 区域中选择 编辑。
5. 选择现有的颜色或输入 RGB 或十六进制值。
6. 选择任何不在对话框中的区域。

删除史诗

• 在极狐GitLab 16.11 中发生变化。在极狐GitLab 16.10 及早期版本，如果您删除了一个史诗，则其所有子史诗和它们的后代也会被删除。如果需要，您可以在删除前从父史诗中删除子史诗。

先决条件：

• 您必须至少具有史诗群组的所有者角色。

要删除史诗：

1. 选择 编辑史诗 ()，然后 删除史诗。
2. 选择 删除。在确认对话框中，选择 删除史诗。

删除一个史诗会将系统中所有已存在的与该史诗级问题相关联的议题从其关联关系中释放出来。

关闭史诗

先决条件：

• 您必须至少具有史诗群组的报告者角色。

要关闭史诗：

• 在右上角，选择 史诗操作 ()，然后选择 关闭史诗。

您还可以使用 /close 快捷操作。

重新打开一个关闭史诗

您可以重新打开一个关闭了的史诗。

先决条件：

• 您必须至少具有史诗群组的报告者角色。

要这么做，您可以：

• 在右上角，选择 史诗操作 ()，然后选择 重开史诗。
• 使用 /reopen 快捷操作。

您还可以通过提升一个议题来创建一个史诗。

从一个议题转到一个史诗

如果一个议题属于一个史诗，您可以通过议题侧边栏的链接导航到包含的史诗。

查看史诗列表

在一个群组中，左侧边栏显示开放的史诗总数。此数字表示与该群组及其子组关联的所有史诗，包括您可能无权查看的史诗。

先决条件：

• 您必须是某个成员：
  • 群组
  • 群组中的项目
  • 群组中子群组中的项目

要在群组中查看史诗：

1. 在左侧边栏中，选择 搜索或跳转到，然后找到您的群组。
2. 选择 计划 > 史诗。

谁可以查看史诗

您是否可以查看史诗取决于群组可见性级别和史诗的私密状态：

• 公共群组和非私密史诗：您不必成为该群组的成员。
• 私有群组和非私密史诗：您必须至少拥有群组的访客角色。
• 私密史诗（无论群组可见性如何）：您必须至少具有群组的报告者角色。

缓存史诗计数

如果高于 1000，则侧边栏中显示的打开史诗的总数将被缓存。缓存值四舍五入为数千或数百万，并每 24 小时更新一次。

过滤史诗列表

• 按群组过滤功能引入于 15.9 版本。

您可以通过以下方式过滤史诗列表：

• 标题或描述
• 作者姓名/用户名
• 标识
• 里程碑
• 机密性
• 反应表情符号
• 群组

过滤步骤：

1. 在左侧边栏中，选择 搜索或转到 并找到您的群组。
2. 选择 史诗。
3. 选择字段 搜索或过滤结果。
4. 从下拉菜单中选择范围或输入纯文本以按史诗标题或描述进行搜索。
5. 按键盘上的 Enter。该列表已过滤。

使用 OR 运算符过滤

• 对于标签和作者的 OR 过滤引入于极狐GitLab 15.9。使用名为 or_issuable_queries 的功能标志。默认禁用。
• 在极狐GitLab 15.9 中为私有化部署和 SaaS 启用。
• 在极狐GitLab 17.0 中 GA，功能标志 or_issuable_queries 已删除。

您可以使用 OR 操作符 (is one of: ||) 通过如下内容来过滤史诗列表：

• 作者
• 标签

是（is one of） 表示包容性 OR。例如，如果您在 标签是一个of：交付 和 标签是一个of：UX，则 GitLab 将显示包含 交付、UX 或两者的史诗。

对史诗列表进行排序

您可以通过以下方式对史诗列表进行排序：

• 开始日期
• 截止日期
• 标题

每个选项都包含一个按钮，可以在上升和下降之间切换顺序。排序选项和顺序会被保存并用于您浏览史诗的任何地方，包括路线图。

改变排序顺序

您可以调整默认顺序，并与顶部按最近项目排序的活动源进行交互。您的偏好会通过本地存储保存并自动应用于您查看的每个史诗和议题。

要改变活动的排序顺序，请点击最旧的优先下拉菜单，选择最先显示的最旧或最新的项目。

使一个史诗保密

如果您正在工作的项包含私有信息，您可以将史诗变为机密。

先决条件：

• 您必须至少具有史诗群组的报告者角色。

要将史诗变为机密：

• 当创建史诗时：在 机密性 下方的复选框中选择。
• 在现有史诗中：在右上角，选择 编辑史诗 ()，然后选择 机密性，然后选择 开启。

在 15.6 及更高版本中，您还可以使用 /confidential 快速操作。

管理分配给史诗的议题

本节收集了所有与史诗有关的议题的说明。

查看分配给史诗的议题

在 子议题和史诗 选项卡上，您可以查看史诗，以及分配给此史诗的议题。只有您可以访问的史诗和议题才会显示在列表中。

如果它们在群组的子项目中，您始终可以查看分配给史诗的议题，因为项目的可见性设置必须与其父组相同或限制更少。

查看史诗中的议题数量

在 子议题和史诗 选项卡上，会显示子史诗级议题和议题的数量，以及它们的总权重。

这个数字表示所有与项目有关的史诗，包括您可能没有权限的议题。

要查看打开和关闭的议题和史诗数量：

• 在每个史诗名称的标头部分，悬停在总数上

数量反映了所有与史诗关联的议题和史诗，包括您可能没有权限的议题和史诗。

如果您的管理员启用了新的史诗外观，则此部分命名为子项。您还可以看到任何继承来的史诗、议题以及任务。只有您可以访问展示在列表中的的史诗、议题和任务。

查看史诗进度

• 引入于极狐GitLab 17.1。

在 子议题和史诗 部分上，会显示史诗进度百分比。

要查看子议题的完整权重和进度:

• 在 section header 上，悬停在百分比上

权重和进度反映了所有与史诗关联的议题，包括您可能没有权限的议题和史诗。

如果您的管理员启用了新的史诗外观，则此部分命名为子项。任务没有包含在此计算中。

健康状态

• 引入极狐GitLab 17.5。

史诗上的用户健康状态能够快速获取项目进度。用户健康状态帮助您提前通知和管理潜在问题。

您可以在史诗视图上查看史诗的健康状态，并在 子项 和 关联项 选项卡中查看史诗的健康状态。

您可以将健康状态设置为：

• 在跟踪中（绿色）
• 需要注意（黄色）
• 风险（红色）

要处理风险并及时交付您计划的工作，将史诗健康状态集成到您的:

• 日常会议
• 项目状态报告
• 每周会议

修改史诗的健康状态

先决条件：

• 您的管理员必须启用新的史诗外观。
• 您必须至少具有史诗群组的报告者角色。

要更改史诗的健康状态：

1. 在左侧导航栏中，选择 搜索或转到 并找到您的群组。
2. 选择 计划 > 史诗。
3. 选择史诗。
4. 在右侧侧边栏中，在 健康状态 选项卡中，选择 编辑。
5. 从下拉列表中选择状态。

史诗的健康状态被更新。

您还可以通过使用 /health_status 和 /clear_health_status 快速操作来设置和清除健康状态。

在史诗中添加一个新的议题

• 子议题和史诗的最大数在极狐GitLab 17.1 中更改为 5000。

您可以将现有的议题添加到史诗中，或者创建一个新的议题，这会自动添加到史诗中。

子议题和史诗的最大数是 5000。

添加现有的议题到史诗中

您可以将现有议题添加到史诗中，包括来自不同的群组层级结构的项目中的议题。新添加的议题出现在子议题和史诗选项卡的议题列表的顶部。

一个史诗包含一个议题列表，一个议题最多可以与一个史诗关联。当您添加一个已经与史诗相关联的新议题时，该议题会自动从其当前的父辈中解除链接。

先决条件：

• 您必须至少拥有议题所在项目和史诗所在群组的访客角色。

要在史诗中添加新的议题：

1. 在史诗的页面上，在 子议题和史诗 下，选择 添加 下拉按钮。
2. 选择 添加一个现有的议题。
3. 使用以下任何一种方法确定要添加的题材。
   • 粘贴议题的链接。
   • 通过输入该议题的部分标题来搜索所需的议题，然后选择所需的匹配。来自不同的群组层级结构的议题不会出现在搜索结果中。要添加此类议题，请输入其完整 URL。

   如果有多个议题需要添加，请按Space并重复此步骤。

4. 选择添加。

如果您的管理员启用了新的史诗外观，则此部分命名为子项。

从史诗中创建一个议题

• 在极狐GitLab 15.8 中，项目所需的最小角色从报告者改为访客。

从史诗中创建一个议题，可以让您在将工作分成小部分的同时保持对史诗大背景的关注。

您可以尽在史诗群组或其子群组的项目中创建一个新的议题。要在和史诗群组共享的项目中创建一个新议题，您首先要直接在项目中创建一个议题，然后添加现有议题到史诗。

先决条件：

• 您必须至少拥有议题所在项目和史诗所在群组的访客角色。

要从史诗中创建一个议题：

1. 在史诗的页面上，在 子议题和史诗 下，选择 添加 下拉按钮。
2. 选择 添加一个新的议题。
3. 在 标题，输入新题材的标题。
4. 从 项目 的下拉菜单中，选择要创建该题的项目。
5. 选择 创建议题。

如果您的管理员启用了新的史诗外观，则此部分命名为子项。

从史诗中删除议题

当您在史诗的详情页面时，您可以从史诗中删除议题。在您从史诗中删除议题后，该议题就不再与该史诗相关联。

先决条件：

• 您必须至少拥有议题所在项目和史诗所在群组的访客角色。

要从史诗中删除议题：

1. 选择您想删除的议题旁边的 删除 () 按钮。出现 删除议题 警告。
2. 选择 删除。

重新排序分配给史诗的议题

• 在极狐GitLab 15.8 中，项目所需的最小角色从报告者改为访客。

新的议题会出现在子议题和史诗标签中的列表顶部。您可以通过拖动它们来重新排列议题列表。

先决条件：

• 您必须至少拥有议题所在项目和史诗所在群组的访客角色。

要重新排列分配给史诗的议题：

1. 进入 子议题和史诗 标签。
2. 拖动议题到所需的顺序。

如果您的管理员启用了新的史诗外观，则此部分命名为子项。

在史诗之间移动议题

• 在极狐GitLab 15.8 中，项目所需的最小角色从报告者改为访客。

新的议题会出现在 子议题和史诗 选项卡中的列表顶部。您可以将议题从一个史诗移动到另一个。

先决条件：

• 您必须至少拥有议题所在项目和史诗所在群组的访客角色。

要把一个议题移到另一个史诗：

1. 转到 子议题和史诗 选项卡。
2. 拖动议题到所需的父史诗。

如果您的管理员启用了新的史诗外观，则此部分命名为子项。

多级子史诗

您可以添加任何属于父史诗的群组或子群组的史诗。新的子史诗会出现在 子议题和史诗 选项卡中的史诗列表顶部。如果您的管理员启用了新的史诗外观，则此部分命名为子项。

当您添加一个已经链接到父史诗的史诗时，它与当前父史诗的链接会被删除。

史诗可以包含多个嵌套的子史诗，最多可以有七个层次。

添加父史诗到史诗

• 引入于极狐GitLab 17.5。

要创建史诗层次结构，添加一个父史诗到现有的史诗。这有助于组织和跟踪多个史诗中的相关工作。

先决条件：

• 您的管理员必须启用新的史诗外观。
• 您必须至少拥有父史诗所在群组和子史诗所在群组的访客角色。

要添加父史诗：

1. 在左侧边栏中，选择 搜索或跳转到，然后找到您的群组。
2. 选择 计划 > 史诗。
3. 选择史诗。
4. 在右侧边栏，在 父史诗 部分，选择 编辑。
5. 在搜索框中输入父史诗的部分标题。您只能搜索同一群组层级结构中的史诗。
6. 从搜索结果中选择您要添加为父史诗的史诗。

父史诗被添加。

来自其它群组的子史诗

• 引入于 15.6 版本，功能标志为 child_epics_from_different_hierarchies。默认禁用。
• 在极狐GitLab 15.7 中，群组所需最小角色从报告者更改为访客。
• 跨群组子史诗功能引入于 15.9 版本。默认启用。
• 删除功能标志 child_epics_from_different_hierarchies 于 15.10 版本。

您可以添加不属于父史诗所在群组的子史诗。

先决条件：

• 您必须至少拥有子史诗所在群组和父史诗所在群组的访客角色。
• 多级子史诗必须在子史诗所在群组和父史诗所在群组中可用。

要添加来自另一个群组的子史诗，请在添加现有史诗时，粘贴史诗的 URL。

在路线图上查看子史诗

对于史诗，可以在路线图上查看他的子史诗和相关里程碑。

先决条件：

• 您必须至少具有父史诗所在群组的访客角色。

要从父级查看子史诗：

• 在史诗中，在 子议题和史诗 部分，选择 路线图视图。

如果您的管理员启用了新的史诗外观，则此部分命名为子项。

在史诗中添加一个子史诗

• 在极狐GitLab 15.7 中，群组所需的最小角色从报告者更改为访客。

先决条件：

• 您必须至少具有父史诗所在群组的访客角色。

新史诗

添加新史诗作为子史诗：

1. 在史诗中，在 子议题和史诗 部分，选择 添加 > 添加新史诗。
2. 从下拉列表中选择一个群组。 默认选择史诗所在的群组。
3. 输入新史诗的标题。
4. 选择 创建史诗。

如果您的管理员启用了新的史诗外观，则此部分命名为子项。

既有史诗

将现有史诗添加为子史诗：

1. 在史诗中，在 子议题和史诗 部分，选择 添加 > 添加现有史诗。
2. 使用以下任一方法确定要添加的史诗：
   • 粘贴该史诗的链接。
   • 通过输入史诗的部分标题来搜索所需的议题，然后选择所需的匹配。此搜索仅适用于同一群组的各层级结构中的史诗。

   如果有多个史诗需要添加，请按 Space 并重复此步骤。

3. 选择添加。

如果您的管理员启用了新的史诗外观，则此部分命名为子项。

在史诗之间移动子史诗

• 在极狐GitLab 15.7 中，群组所需的最小角色从报告者更改为访客。

新的子史诗会出现在 子议题和史诗 标签中的列表顶部。您可以将子史诗从一个史诗移动到另一个。当您添加一个已经链接到父史诗的新建史诗时，它与当前父史诗的链接会被删除。议题和子史诗不能混在一起。

先决条件：

• 您必须至少具有父史诗群组的访客角色。

要把子史诗移到另一个史诗。

1. 转到 子议题和史诗 标签。
2. 将史诗拖入所需的父史诗。

如果您的管理员启用了新的史诗外观，则此部分命名为子项。

重新排列分配给史诗的子史诗

• 在极狐GitLab 15.7 中，群组所需的最小角色从报告者更改为访客。

新的子史诗会出现在 子议题和史诗 选项卡中的列表顶部。您可以对子史诗的列表重新排序。

先决条件：

• 您必须至少具有父史诗群组的访客角色。

要重新排列分配给某个史诗的子史诗：

1. 转到 子议题和史诗 标签。
2. 拖动史诗到所需的顺序。

如果您的管理员启用了新的史诗外观，则此部分命名为子项。

从父史诗中删除子史诗

• 在极狐GitLab 15.7 中，群组所需的最小角色从报告者更改为访客。

先决条件：

• 您必须至少具有父史诗群组的访客角色。

要从父史诗中删除子史诗：

1. 在父史诗的史诗列表中选择 删除 ()。删除史诗 警告出现。
2. 选择 删除。