Slackにはアプリ用のコマンドを実行するスラッシュコマンドと呼ばれるものがあります。
SlackのGitHub公式アプリにも/githubというスラッシュコマンドがあるのですが、どのような機能を提供しているのか、まとまっている情報源が全然見当たりませんでした。
しばらく探したところ、連携機能のGitHubプロジェクトのドキュメントに記載があったので、こちらでもまとめようかと思います。
コマンド一覧
GitHubアプリの招待
/invite @github
GitHubアプリを利用する場合、slackチャンネルに招待する必要があります。これはその際に使います。
GitHubのスラッシュコマンドではないのですが、一応紹介します。
GitHub認証
/github signin
SlackにGitHubアプリを入れたあと、自分のGitHubアカウントの情報を利用するために認証する必要があり、その際に利用します。
連携リポジトリ設定
/github subscribe owner/repo
/github unsubscribe owner/repo
連携するリポジトリを選択します。
連携する場合はsubscribe、連携を解除する場合はunsubscribeを使います。
ownerとrepoには対象とするGitHubリポジトリのオーナー（オーガナイゼーション）名、リポジトリ名をそれぞれ指定してください。
/github subscribe list
現在連携しているリポジトリは上記コマンドで確認できます。
通知対象設定
/github subscribe owner/repo [feature]
/github unsubscribe owner/repo [feature]
[feature]にアクション名を指定することで通知するアクションの通知ON/OFFができます。
選択可能なアクションは下記のようになっています。
| feature | 説明 | 初期設定 |
|---|---|---|
| issues | イシューのオーブン＆クローズ | ON |
| pulls | プルリクエストの生成もしくはマージ | ON |
| statuses | プルリクエストのStatus | ON |
| commits | default branchに対する新しいコミット 初期設定ではmasterブランチ |
ON |
| deployments | deploymentsステータスの更新 | ON |
| public | リポジトリのpribateからpublicへの変更 | ON |
| releases | リリースの公開 | OFF |
| reviews | プルリクエストのレビュー | OFF |
| comments | プルリクエストとイシューに対するコメント | OFF |
| branches | ブランチの作成と削除 | OFF |
| commits:all | 全てのブランチに対する全コミット | OFF |
| +label:"your label" | イシュー、プルリクエスト、コメントへのラベル検索した結果 | OFF |
ちょいちょい意訳入ってます。
また、+labelの使い方もいろいろとTipsがありそうなので、詳細を確認したい方は原文を御覧ください。
また、複数同時に設定することも可能です。
/github subscribe owner/repo reviews comments
プルリクエスト / イシュー操作
/github open [owner/repo]
新しいイシューをオープンします。
/github open [pull request link]
/github close [issue link]
既存のプルリクエストもしくはイシューをオープン、クローズする場合は[issue link]を指定します。
参考