Slack でのGitHubの使用

Slack の GitHub 統合を使用すると、GitHub アカウントを Slack の GitHub アプリに接続できます。接続したら、スラッシュコマンドを使用して GitHub と対話し、リポジトリアクティビティに関する通知を受け取り、Slack 内でチームと直接共同作業を行うことができます。

Slack の GitHub アカウントを GitHub アプリに接続する

メモ

アカウントを接続するには、Slack ワークスペースの管理者が GitHub アプリをインストールしておく必要があります。「GitHubと Slack の統合」を参照してください。

Slack で、GitHub アプリで直接メッセージを開始します。
直接メッセージには、GitHub アカウントに接続するためのウェルカムメッセージとリンクが事前に設定されます。 Slack の画面の指示に従い、ブラウザーの GitHub で接続を認証および承認します。

GitHub アカウントが接続されると、使用可能なコマンドと機能の一覧が Slack に表示されます。

スラッシュコマンドを使用して Slack で GitHub と対話する

スラッシュコマンドを使用するには、 /github 入力し、次に実行するコマンドを Slack チャネルのメッセージ入力フィールドに入力するか、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"`を自分の理由に置き換えます。|

メモ

チャネルをリポジトリにサブスクライブすると、チャネルは、そのリポジトリ内のプル要求と問題に関するすべての open、 close、および reopen イベントに関する通知を受信します。チャネルは、push イベントの通知をリポジトリの既定のブランチに直接受信します。

Slack でのメンション

Slack でリポジトリをサブスクライブすると、参照されているリポジトリイベントの通知に自分が記載されていることがわかります。たとえば、問題に割り当てられている場合、またはコメントに記載されている場合は、Slack の通知に自分自身が表示されます。

メンションでは、Slack の GitHub アプリを使用してGitHub アカウントにログインする必要があります。これにより、GitHub があなたのSlackのIDをGitHubのIDに関連付けることが可能です。 Slack の GitHub アプリへの GitHub アカウントの接続を参照してください。

メモ

GitHub アプリを使用する複数の Slack ワークスペースがある場合、メンションは、 GitHub アプリに最近ログインしたワークスペースでのみ機能します。 GitHub アプリに別のワークスペースにログインすると、メンションは前のワークスペースで動作しなくなります。

次のシナリオであなたが言及されます。

あなたが問題に割り当てられています。
レビューは pull request で要求されます。
プルリクエスト、課題の説明、コメント、またはディスカッションで言及されています。
デプロイメントについてレビューを依頼されています。
pull request のレビューに関するスケジュール済みリマインダーを受け取ります。

Slack の [メンション] ビューで、GitHub メンションの概要を確認できます。詳細については、Slack ドキュメントのアクティビティタブのトリアージ通知を参照してください。

各問題またはプル要求の通知は、Slack のスレッドにグループ化されます。親メッセージには常に、問題または pull request の最新の状態と、タイトル、説明、担当者、レビュー担当者、ラベル、チェックなどの他のメタデータが表示されます。スレッド処理を使用すると、会話を整理し続け、特定の問題や pull request に関連する更新プログラムやディスカッションに簡単に従うことができます。問題またはプル要求の状態が変更されると、関連する応答がスレッドとチャネルの両方に投稿され、チャネル内のすべてのユーザーが更新を認識するようになります。

個々のチャネルで問題のスレッド処理と pull request 通知を無効にすることができます。

スレッド処理を無効にする Slack チャネルで、「 /github settings」と入力します。
[設定] メニューの [プル要求と問題の通知のスレッドを無効にする] の右側にある [ 無効にする] をクリックします。

ユーザーまたはチャネルの他のメンバーは、同じ手順に従い、[設定] メニューの [ 有効] をクリックすることで、いつでもスレッドを再び有効にすることができます。

Slack チャネルへのコメントとレビューのブロードキャスト

既定では、コメントとレビューは関連するスレッドにのみ表示されます。問題の参加者だけでなく、チャネルメンバーに表示させる場合は、次のコマンドを使用してブロードキャストをオプトインできます。

コメントブロードキャストの場合は、 /github subscribe owner/repo comments:"channel"
レビュー放送には、/github subscribe owner/repo reviews:"channel"を使用してください。

Slack での GitHub アクティビティへのリンクの展開

リンクプレビューでは、Slack で GitHub アクティビティへのリンクを共有するときに、追加のコンテキストが提供されます。リンクプレビューは、次の GitHub アクティビティの Slack に表示されます。

Pull Request
問題
直接リンクされたコメント
行番号付きのコードブロック
組織、リポジトリ、およびユーザー

次のいずれかが該当する場合、リンクのプレビューは表示されません。

Slack ワークスペースではリンクプレビューは無効になっています。 Slack ドキュメントの「リンクを共有し、プレビュー設定を設定する」を参照してください。
過去 30 分間に同じリンクがチャネルで既に共有されています。
3 つ以上のリンクが同じメッセージで共有されます。
リポジトリはプライベートであり、リンクを共有したユーザーは次のとおりです。
- GitHub アカウントを Slack の GitHub アプリに接続していません。
- メッセージが表示されたら、リンクプレビューを表示しないように求められます。
- GitHub アプリは、リンクが共有されているチャネルにありません。「スラッシュコマンドを使用して Slack でGitHubを操作するを参照してください。

詳細については、次を参照してください。

        [AUTOTITLE](/integrations/how-tos/slack/customize-notifications) - ニーズに合わせて Slack で GitHub 通知をカスタマイズする方法について説明します。

        [AUTOTITLE](/integrations/tutorials/slack) - 例と実践的なアクティビティを通じて、 GitHub Slack 統合に関するスキルと知識を構築します。

この記事で