Enterprise Server 3.20 は、現在リリース候補として使用できます。

受信トレイフィルター

GitHub 受信トレイ内で通知をフィルタリングする方法について学びます。

この記事で

次のサポートされているフィルターを使って、受信トレイ用のカスタム フィルターを作成できます。 カスタム フィルターの作成について詳しくは、「インボックスからの通知を管理する」をご覧ください。

カスタムフィルタの制限

カスタムフィルタは現在、以下をサポートしていません。

  • インボックス内の全文検索では、プルリクエストやイシューのタイトルも検索できます。
  •         `is:issue`、`is:pr`、および `is:pull-request` クエリ フィルターの区別。 これらのクエリは、Issue と pull request の両方を検索結果として表示します。
  • 15 個以上のカスタムフィルタの作成
  • デフォルトのフィルタまたはその順序の変更
  •         [除外](/search-github/getting-started-with-searching-on-github/understanding-the-search-syntax#exclude-certain-results) 検索を `NOT` または `-QUALIFIER` を用いて行う

カスタムフィルタでサポートされているクエリ

使用できるフィルタの種類は次のとおりです。

  • リポジトリによるフィルター (repo: を使用)
  • ディスカッションの種類によるフィルター (is: を使用)
  • 通知理由によるフィルター (reason: を使用)

サポートされている repo: クエリ

          `repo:` フィルターを追加するには、リポジトリの所有者をクエリに含める必要があります: `repo:owner/repository`。 オーナーは、通知をトリガーする GitHub アセットを所有する Organization またはユーザです。 たとえば、`repo:octo-org/octo-repo` は、octo-org 組織内の octo-repo リポジトリでトリガーされた通知を表示します。

サポートされている is: クエリ

GitHub での特定のアクティビティに関する通知をフィルター処理するには、is クエリを使用できます。 たとえば、リポジトリ招待の更新のみを表示するには is:repository-invitation を使用します。Dependabot alerts のみを表示するには、is:repository-vulnerability-alert を使用します。

  • is:check-suite
  • is:commit
  • is:gist
  • is:issue-or-pull-request
  • is:release
  • is:repository-invitation
  •         `is:repository-vulnerability-alert`

Dependabot alerts の通知からノイズを減らす方法については、「Dependabot アラートの通知を構成する」を参照してください。

          `is:` クエリを使用して、通知がトリアージされた方法を記述することもできます。
  • is:saved
  • is:done
  • is:unread
  • is:read

サポートされている reason: クエリ

更新を受信した理由で通知をフィルター処理するには、reason: クエリを使用します。 たとえば、自分 (または自分が所属する Team) が Pull Request のレビューを要求されたときに通知を表示するには、reason:review-requested を使用します。 詳しくは、「通知について」をご覧ください。

クエリ説明
reason:assign割り当てられている Issue またはプルリクエストに更新があるとき。
reason:authorプルリクエストまたは Issue を開くと、更新または新しいコメントがあったとき。
reason:commentIssue またはプル リクエストでコメントをした際。
reason:participatingissue や pull request にコメントした場合、または @mentioned された場合。
reason:invitationチーム、組織、またはリポジトリに招待されたとき。
reason:manualまだサブスクライブしていない Issue または Pull Request で [サブスクライブ] をクリックしたとき。
reason:mention直接 @mentioned されたとき。
reason:review-requestedあなたまたはあなたが所属しているチームがプルリクエストのレビューを依頼されました。
reason:security-alertリポジトリに対してセキュリティアラートが発行されたとき。
reason:state-changeプルリクエストまたはイシューの状態が変更されたとき。 たとえば、Issue がクローズされたり、プルリクエストがマージされた場合です。
reason:team-mentionメンバーになっている Team が @mentioned されたとき。
reason:ci-activityリポジトリに、新しいワークフロー実行ステータスなどの CI 更新があるとき。

Dependabotカスタムフィルタ

Dependabot を使って依存関係を最新の状態に保つには、次のカスタム フィルターを使用および保存できます。 * is:repository_vulnerability_alert: Dependabot alertsの通知を表示します。 * reason:security_alert: Dependabot alertsとセキュリティ更新プログラムの Pull Request の通知を表示します。 * author:app/dependabot: Dependabot によって生成される通知を表示します。 これには、Dependabot alerts、セキュリティアップデートのプルリクエスト、およびバージョン更新のプルリクエストが含まれます。

Dependabot について詳しくは、「Dependabot アラートについて」を参照してください。