极狐GitLab 快速操作
快速操作是常见操作的基于文本的快捷方式，通常通过选择极狐GitLab 用户界面中的按钮或下拉菜单来完成。您可以在议题、史诗、合并请求和提交的描述或评论中输入这些命令。快速操作可以在编辑新的和现有的评论和描述时执行。
许多快速操作基于上下文，需要满足某些条件。例如，要使用 /remove_due_date 删除议题到期日期，该议题必须设置到期日期。
请务必在单独的行上输入每个快速操作，以便正确检测和执行命令。
参数
许多快速操作需要一个参数。例如，/assign 快速操作需要用户名。极狐GitLab 提供可用值列表，使用自动完成字符和快速操作来帮助用户输入参数。
如果您手动输入参数，则必须将其括在双引号 (") 中，除非它仅包含以下字符：
- ASCII 字母
- 数字（0-9）
- 下划线（
_）、连字符（-）、问号（?）、点（.）、＆符号（&）或@
参数区分大小写。自动完成会自动处理此问题以及引号的插入。
议题、合并请求和史诗
以下快速操作适用于描述、讨论和主题。某些快速操作可能不适用于所有订阅级别。
| 命令 | 议题 | 合并请求 | 史诗 | 操作 |
|---|---|---|---|---|
/add_contacts [contact:email1@example.com] [contact:email2@example.com]
| 是 | 否 | 否 | 添加一位或多位有效的 CRM 联系人 (引入于 14.6 版本)。 |
/approve
| 否 | 是 | 否 | 核准合并请求。 |
/assign @user1 @user2
| 是 | 是 | 否 | 指派给多名用户。 |
/assign me
| 是 | 是 | 否 | 指派给您自己 |
/assign_reviewer @user1 @user2 或 /reviewer @user1 @user2 或 /request_review @user1 @user2
| 否 | 是 | 否 | 指派多名用户作为审核者。 |
/assign_reviewer me 或 /reviewer me 或 /request_review me
| 否 | 是 | 否 | 指派您自己作为审核者。 |
/award :emoji:
| 是 | 是 | 是 | 切换表情符号。 |
/blocked_by <issue1> <issue2>
| 是 | 否 | 否 | 表明该议题被其他议题阻塞。<issue> 的格式应该为 #issue、group/project#issue 或完整的议题 URL。引入于 16.0 版本。
|
/blocks <issue1> <issue2>
| 是 | 否 | 否 | 表明该议题阻塞了其他议题。<issue> 的格式应该为 #issue、group/project#issue 或完整的议题 URL。引入于 16.0 版本。
|
/cc @user
| 是 | 是 | 是 | 提及用户。在 15.0 及更高版本中，此命令不执行任何操作。您可以改为输入 CC @user 或仅输入 @user。在 14.9 及更早版本中，在行首提及用户会创建特定类型的待办事项通知。
|
/child_epic <epic>
| 否 | 否 | 是 | 将子史诗添加到 <epic>。 <epic> 值应该采用 &epic、group&epic 或史诗 URL 的格式。
|
/clear_health_status
| 是 | 否 | 否 | 清除健康状态。引入于 14.7。 |
/clear_weight
| 是 | 否 | 否 | 清除权重。 |
/clone <path/to/project> [--with_notes]
| 是 | 否 | 否 | 将议题克隆到给定的项目，如果没有给出参数，则将议题克隆到当前的项目（）。只要目标项目包含等效的标记、里程碑等，就可以复制尽可能多的数据。除非 --with_notes 作为参数提供，否则不复制注释或系统注释。
|
/close
| 是 | 是 | 是 | 关闭。 |
/confidential
| 是 | 否 | 是 | 将议题或史诗标记为私密。对史诗的支持引入于 15.6 版本。 |
/copy_metadata <!merge_request>
| 是 | 是 | 否 | 从项目中的另一个合并请求复制标记和里程碑。 |
/copy_metadata <#issue>
| 是 | 是 | 否 | 从项目中的另一个议题复制标记和里程碑。 |
/create_merge_request <branch name>
| 是 | 否 | 否 | 从当前议题开始创建一个新的合并请求。 |
/done
| 是 | 是 | 是 | 标记为完成。 |
/draft
| 否 | 是 | 否 | 切换草稿状态。废弃于 15.4 版本。 |
/due <date>
| 是 | 否 | 否 | 设定截止日期。有效的 <date> 示例包括 in 2 days、this Friday 和 December 31st。
|
/duplicate <#issue>
| 是 | 否 | 否 | 关闭此议题并将其标记为另一个议题的副本。 另外，将两者标记为相关。 |
/epic <epic>
| 是 | 否 | 否 | 添加到史诗<epic>。<epic> 值应该采用 &epic、group&epic 或史诗 URL 的格式。
|
/estimate <time> 或 /estimate_time <time>
| 是 | 是 | 否 | 设置时间估计。 例如，/estimate 1mo 2w 3d 4h 5m。/estimate_time <time> 引入于 15.6 版本。
|
/health_status <value>
| 是 | 否 | 否 | 设置健康状态。<value> 的有效值为 on_track、needs_attention 和 at_risk。引入于 14.7 版本。
|
/invite_email email1 email2
| 是 | 否 | 否 | 添加最多六个电子邮件参与者。此操作位于功能标志 issue_email_participants 之后，议题模板尚不支持。
|
/iteration *iteration:"iteration name"
| 是 | 否 | 否 | 设置迭代。例如，设置 Late in July 迭代：/iteration *iteration:"Late in July"。
|
/label ~label1 ~label2 或 /labels ~label1 ~label2
| 是 | 是 | 是 | 添加一个或多个标记。标记名称也可以不使用波浪号 (~) 开头，但不支持混合语法。
|
/lock
| 是 | 是 | 否 | 锁定讨论。 |
/link
| 是 | **{dotted-circle} 否 | 否 | 为事件中的关联资源添加链接和描述（引入于 15.5 版本）。 |
/merge
| 否 | 是 | 否 | 合并更改。根据项目设置，可能是流水线成功时，或添加到合并队列时。 |
/milestone %milestone
| 是 | 是 | 否 | 设置里程碑。 |
/move <path/to/project>
| 是 | 否 | 否 | 将此议题移至另一个项目。将议题移至具有不同访问规则的项目时要小心。在移动议题之前，请确保它不包含敏感数据。 |
/parent_epic <epic>
| 否 | 否 | 是 | 将父史诗设置为 <epic>。<epic> 值的格式应为 &epic、group&epic 或指向史诗的 URL。
|
/promote
| 是 | 否 | 否 | 将议题提升为史诗。 |
/promote_to_incident
| 是 | 否 | 否 | 将议题提升为事件 (引入于 14.5)。在 15.8 及更高版本中，您还可以在创建新议题时使用快速操作。 |
/page <policy name>
| 是 | 否 | 否 | 开始升级事件 (引入于 14.9)。 |
/publish
| 是 | 否 | 否 | 将议题发布到关联的状态页面。 |
/ready
| 否 | 是 | 否 | 设置就绪状态（引入于 15.1 版本）。 |
/reassign @user1 @user2
| 是 | 是 | 否 | 用指定的指派人替换当前的指派人。 |
/rebase
| 否 | 是 | 否 | Rebase 源分支。系统安排一个后台任务，该任务尝试将源分支中的更改重新设定为目标分支的最新提交。如果使用 /rebase，则忽略 /merge 以避免出现竞争条件，即在重新定位之前合并或删除源分支。如果存在合并冲突，会显示无法安排 rebase 的消息。变基失败与合并请求状态一起显示。
|
/reassign_reviewer @user1 @user2
| 否 | 是 | 否 | 用指定的审核者替换当前的审核者。 |
/relabel ~label1 ~label2
| 是 | 是 | 是 | 用指定的标记替换当前的标记。 |
/relate #issue1 #issue2
| 是 | 否 | 否 | 将议题标记为相关。 |
/remove_child_epic <epic>
| 否 | 否 | 是 | 从 <epic> 中移除子史诗。<epic> 值的格式应为 &epic、group&epic 或指向史诗的 URL。
|
/remove_contacts [contact:email1@example.com] [contact:email2@example.com]
| 是 | 否 | 否 | 删除一个或多个 CRM 联系人 (引入于 14.6 版本)。 |
/remove_due_date
| 是 | 否 | 否 | 移除截止日期。 |
/remove_epic
| 是 | 否 | 否 | 从史诗移除。 |
/remove_estimate 或 /remove_time_estimate
| 是 | 是 | 否 | 移除时间估计。/remove_time_estimate 引入于 15.6 版本。
|
/remove_iteration
| 是 | 否 | 否 | 移除迭代（于 13.1 版本引入）。 |
/remove_milestone
| 是 | 是 | 否 | 移除里程碑。 |
/remove_parent_epic
| 否 | 否 | 是 | 从史诗中删除父史诗。 |
/remove_time_spent
| 是 | 是 | 否 | 移除时间花费。 |
/remove_zoom
| 是 | 否 | 否 | 从此议题中删除 Zoom 会议。 |
/reopen
| 是 | 是 | 是 | 重新开放。 |
/severity <severity>
| 是 | 否 | 否 | 设置严重性。议题类型必须是 Incident。<severity> 的选项包括 S1 … S4、critical、high、medium、low、unknown。引入于 14.2 版本。
|
/shrug <comment>
| 是 | 是 | 是 | 附加 ¯\＿(ツ)＿/¯ 到评论。
|
/spend <time> [<date>] 或 /spend_time <time> [<date>]
| 是 | 是 | 否 | 增加或减少花费的时间。（可选）指定花费时间的日期。例如，/spend 1mo 2w 3d 4h 5m 2018-08-26 或 /spend -1h 30m。/spend_time <time> [<date>] 引入于 15.6 版本。
|
/submit_review
| 否 | 是 | 否 | 提交一个处理中的审核。 |
/subscribe
| 是 | 是 | 是 | 订阅通知。 |
/tableflip <comment>
| 是 | 是 | 是 | 附加 (╯°□°)╯︵ ┻━┻ 到评论。
|
/target_branch <local branch name>
| 否 | 是 | 否 | 设置目标分支。 |
/title <new title>
| 是 | 是 | 是 | 更改标题。 |
/timeline <timeline comment> \| <date(YYYY-MM-DD)> <time(HH:MM)>
| 是 | 否 | 否 | 向此事件添加时间线事件。例如，/timeline DB load spiked \| 2022-09-07 09:30。引入于 15.4 版本。
|
/todo
| 是 | 是 | 是 | 添加一个待办事项。 |
/unapprove
| 否 | 是 | 否 | 取消批准合并请求（引入于 14.3 版本）。 |
/unassign @user1 @user2
| 是 | 是 | 否 | 移除指定的指派人。 |
/unassign
| 否 | 是 | 否 | 移除所有指派人。 |
/unassign_reviewer @user1 @user2 or /remove_reviewer @user1 @user2
| 否 | 是 | 否 | 移除指定的审核者。 |
/unassign_reviewer me
| 否 | 是 | 否 | 将自己从审核者中移除。 |
/unassign_reviewer or /remove_reviewer
| 否 | 是 | 否 | 移除所有审核者 |
/unlabel ~label1 ~label2 or /remove_label ~label1 ~label2
| 是 | 是 | 是 | 移除指定的标记 |
/unlabel or /remove_label
| 是 | 是 | 是 | 移除所有标记。 |
/unlink <issue>
| 是 | 否 | 否 | 删除与所提供议题的链接。<issue> 格式应为 #issue、group/project#issue 或完整的议题 URL。引入于 16.1 版本。
|
/unlock
| 是 | 是 | 否 | 解锁讨论。 |
/unsubscribe
| 是 | 是 | 是 | 取消订阅通知。 |
/weight <value>
| 是 | 否 | 否 | 设定权重。<value> 的有效选项包括 0、1、2 等。
|
/zoom <Zoom URL>
| 是 | 否 | 否 | 添加 Zoom 会议到此议题。 |
工作项
在评论中执行快速操作的功能引入于 15.10 版本。
极狐GitLab 中的工作项包括任务和 OKR。 在编辑或评论工作项时，可以通过描述字段应用以下快速操作。
| 命令 | 任务 | 目标（O） | 关键结果（KR） | 操作 |
|---|---|---|---|---|
/title <new title>
| 是 | 是 | 是 | 更改标题。 |
/close
| 是 | 是 | 是 | 关闭。 |
/reopen
| 是 | 是 | 是 | 重新打开。 |
/shrug <comment>
| 是 | 是 | 是 | 使用 ¯\＿(ツ)＿/¯ 进行评论。
|
/tableflip <comment>
| 是 | 是 | 是 | 使用 (╯°□°)╯︵ ┻━┻ 进行评论。
|
/checkin_reminder <cadence>
| 否 | 是 | 否 | 计划 check-in 提醒。选项为 weekly、twice-monthly、monthly 或 never（默认）。引入于 16.4 版本，功能标志为 okrs_mvc 和 okr_checkin_reminders。
|
/confidential
| 是 | 是 | 是 | 将工作项标记为私密。引入于 16.4 版本。 |
/cc @user
| 是 | 是 | 是 | 提及一个用户。在 15.0 及更高版本，此命令无效。您可以使用 CC @user 或仅使用 @user。在 14.9 及更早版本中，在行首提及用户会创建特定类型的待办事项通知。
|
/assign @user1 @user2
| 是 | 是 | 是 | 指派一个或多个用户。 |
/assign me
| 是 | 是 | 是 | 指派给您自己。 |
/add_child <work_item>
| 否 | 是 | 否 | 向 <work_item> 添加子工作项。<work_item> 格式应为 #iid、group/project#iid 或工作项 URL。可以将多个工作项作为子工作项同时添加。引入于 16.5 版本。
|
/award :emoji:
| 是 | 是 | 是 | 切换表情符号。引入于 16.5 版本。 |
/unassign @user1 @user2
| 是 | 是 | 是 | 删除特定指派人。 |
/unassign
| 否 | 是 | 是 | 删除所有指派人。 |
/reassign @user1 @user2
| 是 | 是 | 是 | 用指定的指派人替换当前的指派人。 |
/label ~label1 ~label2 or /labels ~label1 ~label2
| 是 | 是 | 是 | 添加一个或多个标记。标记名称也可以不以波浪号 (~) 开头，但不支持混合语法。
|
/relabel ~label1 ~label2
| 是 | 是 | 是 | 用指定的标记替换当前标记。 |
/unlabel ~label1 ~label2 or /remove_label ~label1 ~label2
| 是 | 是 | 是 | 删除指定的标记。 |
/unlabel or /remove_label
| 是 | 是 | 是 | 删除所有标记。 |
/done
| 是 | 是 | 是 | 将待办事项标记为已完成。引入于 16.2 版本。 |
/due <date>
| 是 | 否 | 是 | 设置截止日期。有效的 <date> 示例包括 in 2 days、this Friday 和 December 31st。
|
/remove_due_date
| 是 | 否 | 是 | 删除截止日期 |
/health_status <value>
| 是 | 是 | 是 | 设置健康状态。<value> 的有效选项是 on_track、needs_attention 和 at_risk。
|
/clear_health_status
| 是 | 是 | 是 | 清除健康状态。 |
/weight <value>
| 是 | 否 | 否 | 设置权重。<value> 的有效选项包括 0、1 和 2。
|
/clear_weight
| 是 | 否 | 否 | 清除权重。 |
/type
| 是 | 是 | 是 | 将工作项转换为指定类型。<type> 的可用选项包括 Issue、Task、Objective 和 Key Result。引入于 16.0 版本，功能标志为 work_items_mvc_2。默认禁用。
|
/promote_to <type>
| Yes | 否 | 是 | 将工作项提升为特定类型。<type> 可用选项为 issue（提升为任务）、objective （提升为关键结果）。引入于 16.1 版本。
|
/set_parent <work_item>
| Yes | 否 | 是 | 将父工作项设置为 <work_item>。<work_item> 格式应为 #iid、group/project#iid 或工作项 URL。引入于 16.5 版本。
|
/subscribe
| Yes | 是 | 是 | 订阅通知。引入于 16.4 版本。 |
/todo
| Yes | 是 | 是 | 添加待办事项。引入于 16.2 版本。 |
/unsubscribe
| Yes | 是 | 是 | 退订通知。引入于 16.4 版本。 |
提交消息
以下快速操作适用于提交消息：
| 命令 | 操作 |
|---|---|
/tag v1.2.3 <message>
| 使用可选消息标记提交。 |
故障排除
快速操作未执行
如果您运行快速操作，但没有任何反应，请检查快速操作在您键入时是否出现在自动完成框中。 如果没有，则可能是：
- 根据您的订阅级别或群组或项目中的用户角色，您无法使用与快速操作相关的功能。
- 不满足快速操作所需的条件。
例如，您在没有任何标签的议题上运行
/unlabel。