使用适用于 Slack 的 GitHub 集成,可以将 GitHub 帐户连接到 Slack 中的 GitHub 应用。 连接后,可以使用斜杠命令与 GitHub进行交互,接收有关存储库活动的通知,并在 Slack 中直接与团队协作。
将 GitHub 帐户连接到 Slack 中的 GitHub 应用
注意
在连接帐户之前,Slack 工作区的管理员必须已安装 GitHub 应用。 请参阅 将 GitHub 与 Slack 集成。
- 在 Slack 中,使用 GitHub 应用启动直接消息。
- 私信中将预先填充一条欢迎消息和一个连接你的 GitHub 帐户的链接。 按照 Slack 屏幕上的提示作,然后在浏览器中的 GitHub 中进行身份验证和授权连接。
GitHub 帐户连接后,Slack 将显示可用的命令和功能列表。
在 Slack 中使用斜杠命令与 GitHub 交互
要使用斜杠命令,请在任何 Slack 通道或直接消息的消息输入框中输入 /github,然后输入您要执行的命令,前提是该消息中有 GitHub 应用程序。 若要邀请应用加入频道,请在频道中键入 /invite @github 。
| Command | Description |
|---|---|
/github help | 显示基本命令及其说明的列表。 |
/github subscribe owner/repo | 订阅此渠道以接收指定存储库的通知。 |
/github unsubscribe owner/repo | 取消通道对指定存储库通知的订阅。 |
/github subscribe list | 列出频道订阅的所有存储库。 |
/github open owner/repo | 在指定的存储库中打开问题。 系统将提示你提供问题的标题和说明。 |
/github close [issue link] | 将指定的问题标记为已完成并关闭。 |
/github close [issue link] reason:"not planned" | 关闭指定的问题并给出原因。 将 "not planned" 替换为你的原因。 |
/github reopen [issue link] | 重新打开指定的问题。 |
注意
当你将渠道订阅到存储库时,该渠道将收到该存储库中有关拉取请求和问题的所有 open、close和reopen 事件的通知。 该通道还将直接接收任何 push 事件的通知,并将这些事件直接发送到存储库的默认分支。
在 Slack 中启动 Copilot 编码智能体 会话
GitHub 应用还将 Copilot 编码智能体 集成到 Slack 中。 你可以使用此功能在进行重要讨论的线程中召唤 Copilot 编码智能体,并要求它根据这些讨论的上下文进行更改。 请参阅: 将 Copilot 编码代理与 Slack 集成。
Slack 中的提及
在 Slack 中订阅存储库时,您将在涉及您的存储库事件通知中看到自己被提及。 例如,如果你被分配到某个问题,或在批注中提及,你将在 Slack 的通知中看到自己被提及。
提及功能要求你通过 Slack 中的 GitHub 应用登录你的 GitHub 帐户。 这使得 GitHub 能够将您的 Slack 身份映射到您的 GitHub 身份。 请参阅 在 Slack 中将 GitHub 帐户连接到 GitHub 应用。
注意
如果你有多个 Slack 工作区,并在其中使用 GitHub 应用,则提及功能将仅在你最近登录的 GitHub 应用工作区中起作用。 如果在不同的工作区中登录 GitHub 应用,则提及功能将在之前的工作区停止工作。
以下是会提到你的情境:
- 将为你分配一个任务。
- 请求你对拉取请求进行审查。
- 你在拉取请求、问题说明、评论或讨论中被提及。
- 请求你对一项部署进行评审。
- 你会收到一条关于拉取审查请求的定时提醒。
可以在 Slack 的“提及”视图中查看 GitHub 提及摘要。 有关详细信息,请参阅 Slack 文档中 “活动”选项卡中的“会审通知 ”。
线程会话
每个问题或拉取请求的通知都会在 Slack 中被分组到一个线程中。 父消息始终显示问题或拉取请求的最新状态,以及其他元数据,如标题、说明、分配者、审阅者、标签和检查。 线程处理有助于保持对话组织有序,从而更轻松地跟踪与特定问题或拉取请求相关的更新和讨论。 当问题或拉取请求的状态发生更改时,关联的答复将同时在线程和通道中发布,以便通道中的每个人都知道更新。
可以在各个渠道中为问题和拉取请求通知禁用线程功能。
- 在要禁用线程的 Slack 通道中,键入
/github settings。 - 在设置菜单中,在“禁用拉取请求和问题通知的线程处理”选项的右边,单击禁用。
你或通道的任何其他成员都可以按照相同的步骤并单击“设置”菜单中的“ 启用 ”,随时重新启用线程处理。
将评论和评价发布到 Slack 频道
默认情况下,注释和评论只会显示在其相关线程中。 如果希望渠道成员(而不仅仅是问题参与者)看到这些内容,可以使用以下命令选择进行广播:
-
对于评论广播,请使用
/github subscribe owner/repo comments:"channel" -
若要审查广播,请使用
/github subscribe owner/repo reviews:"channel"
在 Slack 中展开指向 GitHub 活动的链接
在 Slack 中共享指向 GitHub 活动的链接时,链接预览可提供其他上下文。 在 Slack 中,以下 GitHub 活动会显示链接预览:
- 拉取请求
- 问题
- 直接关联的注释
- 包含行号的代码 Blob
- 组织、存储库和用户
如果存在以下任一情况,则不会显示链接预览:
- 在 Slack 工作区中禁用链接预览。 请参阅 Slack 文档中的 “共享”链接并设置预览首选项 。
- 在过去 30 分钟内,频道中已共享同一链接。
- 在同一条消息中共享 3 个或多个链接。
- 存储库是专用的,共享链接的用户:
- 尚未将其 GitHub 帐户连接到 Slack 中的 GitHub 应用。
- 不要在出现提示时显示链接预览。
- GitHub 应用不在共享链接的通道中。 请参阅 使用斜杠命令在 Slack 中与 GitHub 交互。
安排拉取请求评审的提醒
可以在 Slack 中安排拉取请求评审的提醒。 提醒可以直接通过 GitHub 应用以私信形式发送给你,或者发送到 GitHub 应用所在的渠道。 例如,可以安排在每个工作日上午 10 点通过私信向你发送提醒,包括所有分配给你的未解决的问题。
可以为自己、团队或整个组织设置定时提醒。 有关详细信息,请参见:
-
[AUTOTITLE](/account-and-profile/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations/managing-your-scheduled-reminders) -
[AUTOTITLE](/organizations/organizing-members-into-teams/managing-scheduled-reminders-for-your-team) -
[AUTOTITLE](/organizations/managing-organization-settings/managing-scheduled-reminders-for-your-organization)
延伸阅读
-
[AUTOTITLE](/integrations/how-tos/slack/customize-notifications) - 了解如何在 Slack 中自定义 GitHub 通知以满足您的需求。 -
[AUTOTITLE](/integrations/tutorials/slack) - 通过示例和动手活动生成有关 GitHub Slack 集成的技能和知识。