极狐GitLab 快速操作

  • 引入于 13.8 版本:当您在描述或注释字段中输入 / 时,所有可用的快速操作都会显示在可滚动列表中。
  • Rebase 快速操作引入于 13.8 版本。

快速操作是常见操作(通常通过选择用户界面中的按钮或下拉菜单来完成)的基于文本的快捷方式。您可以在议题、史诗、合并请求和提交的描述或评论中输入这些命令。

许多快速操作需要满足某些条件。例如,要使用 /remove_due_date 删除议题到期日期,该议题必须设置到期日期。

请务必在单独的行上输入每个快速操作,以便正确检测和执行命令。

参数

许多快速操作需要一个参数。例如,/assign 快速操作需要用户名。极狐GitLab 提供可用值列表,使用自动完成字符和快速操作来帮助用户输入参数。

如果您手动输入参数,则必须将其括在双引号 (") 中,除非它仅包含以下字符:

  • ASCII 字母
  • 数字(0-9)
  • 下划线(_),连字符(-),问号(?),点(.), &符号(&)或 @

参数区分大小写。自动完成会自动处理此问题以及引号的插入。

议题、合并请求和史诗

以下快速操作适用于描述、讨论和主题。某些快速操作可能不适用于所有订阅级别。

命令 议题 合并请求 史诗 操作
/add_contacts [contact:email1@example.com] [contact:email2@example.com] Yes No No 添加一位或多位有效的 CRM 联系人 (引入于 14.6 版本)。
/approve No Yes No 核准合并请求。
/assign @user1 @user2 Yes Yes No 指派给多名用户。
/assign me Yes Yes No 指派给您自己
/assign_reviewer @user1 @user2/reviewer @user1 @user2/request_review @user1 @user2 No Yes No 指派多名用户作为审核者。
/assign_reviewer me/reviewer me/request_review me No Yes No 指派您自己作为审核者。
/award :emoji: Yes Yes Yes 切换表情符号。
/cc @user Yes Yes Yes 提及用户。在 15.0 及更高版本中,此命令不执行任何操作。您可以改为输入 CC @user 或仅输入 @user。在 14.9 及更早版本中,在行首提及用户会创建特定类型的待办事项通知。
/child_epic <epic> No No Yes 将子史诗添加到 <epic><epic> 值应该采用 &epicgroup&epic 或史诗 URL 的格式。
/clear_weight Yes No No 清除权重。
/clone <path/to/project> [--with_notes] Yes No No 将议题克隆到给定的项目,如果没有给出参数,则将议题克隆到当前的项目()。只要目标项目包含等效的标记、里程碑等,就可以复制尽可能多的数据。除非 --with_notes 作为参数提供,否则不复制注释或系统注释。
/close Yes Yes Yes 关闭。
/confidential Yes No Yes 将议题或史诗标记为私密。对史诗的支持引入于 15.6 版本。
/copy_metadata <!merge_request> Yes Yes No 从项目中的另一个合并请求复制标记和里程碑。
/copy_metadata <#issue> Yes Yes No 从项目中的另一个议题复制标记和里程碑。
/create_merge_request <branch name> Yes No No 从当前议题开始创建一个新的合并请求。
/done Yes Yes Yes 标记为完成。
/draft No Yes No 切换草稿状态。废弃于 15.4 版本。
/due <date> Yes No No 设定截止日期。有效的 <date> 示例包括 in 2 daysthis FridayDecember 31st
/duplicate <#issue> Yes No No 关闭此议题并将其标记为另一个议题的副本。 另外,将两者标记为相关。
/epic <epic> Yes No No 添加到史诗<epic><epic> 值应该采用 &epicgroup&epic 或史诗 URL 的格式。
/estimate <time>/estimate_time <time> Yes Yes No 设置时间估计。 例如,/estimate 1mo 2w 3d 4h 5m/estimate_time <time> 引入于 15.6 版本。
/invite_email email1 email2 Yes No No 添加最多六个电子邮件参与者。此操作位于功能标志 issue_email_participants 之后,议题模板尚不支持。
/iteration *iteration:"iteration name" Yes No No 设置迭代。例如,设置 Late in July 迭代:/iteration *iteration:"Late in July"
/label ~label1 ~label2/labels ~label1 ~label2 Yes Yes Yes 添加一个或多个标记。标记名称也可以不使用波浪号 (~) 开头,但不支持混合语法。
/lock Yes Yes No 锁定讨论。
/link Yes **{dotted-circle} No No 为事件中的关联资源添加链接和描述(引入于 15.5 版本)。
/merge No Yes No 合并更改。根据项目设置,可能是流水线成功时,或添加到合并队列时。
/milestone %milestone Yes Yes No 设置里程碑。
/move <path/to/project> Yes No No 将此议题移至另一个项目。将议题移至具有不同访问规则的项目时要小心。在移动议题之前,请确保它不包含敏感数据。
/parent_epic <epic> No No Yes 将父史诗设置为 <epic><epic> 值的格式应为 &epicgroup&epic 或指向史诗的 URL。
/promote Yes No No 将议题提升为史诗。
/promote_to_incident Yes No No 将议题提升为事件 (引入于 14.5)。在 15.8 及更高版本中,您还可以在创建新议题时使用快速操作。
/page <policy name> Yes No No 开始升级事件 (引入于 14.9)。
/publish Yes No No 将议题发布到关联的状态页面。
/ready No Yes No 设置就绪状态(引入于 15.1 版本)。
/reassign @user1 @user2 Yes Yes No 用指定的指派人替换当前的指派人。
/rebase No Yes No Rebase 源分支。系统安排一个后台任务,该任务尝试将源分支中的更改重新设定为目标分支的最新提交。如果使用 /rebase,则忽略 /merge 以避免出现竞争条件,即在重新定位之前合并或删除源分支。如果存在合并冲突,会显示无法安排 rebase 的消息。变基失败与合并请求状态一起显示。
/reassign_reviewer @user1 @user2 No Yes No 用指定的审核者替换当前的审核者。
/relabel ~label1 ~label2 Yes Yes Yes 用指定的标记替换当前的标记。
/relate #issue1 #issue2 Yes No No 将议题标记为相关。
/remove_child_epic <epic> No No Yes <epic> 中移除子史诗。<epic> 值的格式应为 &epicgroup&epic 或指向史诗的 URL。
/remove_contacts [contact:email1@example.com] [contact:email2@example.com] Yes No No 删除一个或多个 CRM 联系人 (引入于 14.6 版本)。
/remove_due_date Yes No No 移除截止日期。
/remove_epic Yes No No 从史诗移除。
/remove_estimate/remove_time_estimate Yes Yes No 移除时间估计。/remove_time_estimate 引入于 15.6 版本。
/remove_iteration Yes No No 移除迭代(于 13.1 版本引入)。
/remove_milestone Yes Yes No 移除里程碑。
/remove_parent_epic No No Yes 从史诗中删除父史诗。
/remove_time_spent Yes Yes No 移除时间花费。
/remove_zoom Yes No No 从此议题中删除 Zoom 会议。
/reopen Yes Yes Yes 重新开放。
/severity <severity> Yes No No 设置严重性。议题类型必须是 Incident<severity> 的选项包括 S1S4criticalhighmediumlowunknown。引入于 14.2 版本。
/shrug <comment> Yes Yes Yes 附加 ¯\_(ツ)_/¯ 到评论。
/spend <time> [<date>]/spend_time <time> [<date>] Yes Yes No 增加或减少花费的时间。(可选)指定花费时间的日期。例如,/spend 1mo 2w 3d 4h 5m 2018-08-26/spend -1h 30m/spend_time <time> [<date>] 引入于 15.6 版本。
/submit_review No Yes No 提交一个处理中的审核。
/subscribe Yes Yes Yes 订阅通知。
/tableflip <comment> Yes Yes Yes 附加 (╯°□°)╯︵ ┻━┻ 到评论。
/target_branch <local branch name> No Yes No 设置目标分支。
/title <new title> Yes Yes Yes 更改标题。
/timeline <timeline comment> \| <date(YYYY-MM-DD)> <time(HH:MM)> Yes No No 向此事件添加时间线事件。例如,/timeline DB load spiked \| 2022-09-07 09:30。引入于 15.4 版本。
/todo Yes Yes Yes 添加一个待办事项。
/unapprove No Yes No 取消批准合并请求(引入于 14.3 版本)。
/unassign @user1 @user2 Yes Yes No 移除指定的指派人。
/unassign No Yes No 移除所有指派人。
/unassign_reviewer @user1 @user2 or /remove_reviewer @user1 @user2 No Yes No 移除指定的审核者。
/unassign_reviewer me No Yes No 将自己从审核者中移除。
/unassign_reviewer or /remove_reviewer No Yes No 移除所有审核者
/unlabel ~label1 ~label2 or /remove_label ~label1 ~label2 Yes Yes Yes 移除指定的标记
/unlabel or /remove_label Yes Yes Yes 移除所有标记。
/unlock Yes Yes No 解锁讨论。
/unsubscribe Yes Yes Yes 取消订阅通知。
/weight <value> Yes No No 设定权重。<value> 的有效选项包括 012 等。
/zoom <Zoom URL> Yes No No 添加 Zoom 会议到此议题。
/blocks <issue1> <issue2> Yes No No 将议题标记为阻塞其他议题。<issue> 值的格式应为 #issuegroup/project#issue 或完整的议题 URL。(引入于 16.0 版本)
/blocked_by <issue1> <issue2> Yes No No 将议题标记为被其他议题阻塞。<issue> 值的格式应为 #issuegroup/project#issue 或完整的议题 URL。(引入于 16.0 版本)

工作项

在评论中执行快速操作的功能引入于 15.10 版本。

极狐GitLab 中的工作项包括任务OKR。 在编辑或评论工作项时,可以通过描述字段应用以下快速操作。

命令 任务 目标(O) 关键结果(KR) 操作
/title <new title> Yes Yes Yes 更改标题。
/close Yes Yes Yes 关闭。
/reopen Yes Yes Yes 重新打开。
/shrug <comment> Yes Yes Yes 使用 ¯\_(ツ)_/¯ 进行评论。
/tableflip <comment> Yes Yes Yes 使用 (╯°□°)╯︵ ┻━┻ 进行评论。
/cc @user Yes Yes Yes 提及一个用户。在 15.0 及更高版本,此命令无效。您可以使用 CC @user 或仅使用 @user。在 14.9 及更早版本中,在行首提及用户会创建特定类型的待办事项通知。
/assign @user1 @user2 Yes Yes Yes 指派一个或多个用户。
/assign me Yes Yes Yes 指派给您自己。
/unassign @user1 @user2 Yes Yes Yes 删除特定指派人。
/unassign No Yes Yes 删除所有指派人。
/reassign @user1 @user2 Yes Yes Yes 用指定的指派人替换当前的指派人。
/label ~label1 ~label2 or /labels ~label1 ~label2 Yes Yes Yes 添加一个或多个标记。标记名称也可以不以波浪号 (~) 开头,但不支持混合语法。
/relabel ~label1 ~label2 Yes Yes Yes 用指定的标记替换当前标记。
/unlabel ~label1 ~label2 or /remove_label ~label1 ~label2 Yes Yes Yes 删除指定的标记。
/unlabel or /remove_label Yes Yes Yes 删除所有标记。
/due <date> Yes No Yes 设置截止日期。有效的 <date> 示例包括 in 2 daysthis FridayDecember 31st
/remove_due_date Yes No Yes 删除截止日期
/health_status <value> Yes Yes Yes 设置健康状态<value> 的有效选项是 on_trackneeds_attentionat_risk
/clear_health_status Yes Yes Yes 清除健康状态
/weight <value> Yes No No 设置权重。<value> 的有效选项包括 012
/clear_weight Yes No No 清除权重。
/type Yes Yes Yes 将工作项转换为指定类型。<type> 的可用选项包括 IssueTaskObjectiveKey Result。引入于 16.0 版本,功能标志work_items_mvc_2。默认禁用。

提交消息

以下快速操作适用于提交消息:

命令 操作
/tag v1.2.3 <message> 使用可选消息标记提交。