次のサポートされているフィルターを使って、受信トレイ用のカスタム フィルターを作成できます。 カスタム フィルターの作成について詳しくは、「インボックスからの通知を管理する」をご覧ください。
カスタムフィルタの制限
カスタムフィルタは現在、以下をサポートしていません。
- インボックス内の全文検索では、プルリクエストやイシューのタイトルも検索できます。
is:issue、is:pr、およびis:pull-requestクエリ フィルターの区別。 これらのクエリは、Issue と pull request の両方を検索結果として表示します。- 15 個以上のカスタムフィルタの作成
- デフォルトのフィルタまたはその順序の変更
- 除外 検索を
NOTまたは-QUALIFIERを用いて行う
カスタムフィルタでサポートされているクエリ
使用できるフィルタの種類は次のとおりです。
- リポジトリによるフィルター (
repo:を使用) - ディスカッションの種類によるフィルター (
is:を使用) - 通知理由で絞り込む
reason: - 通知作成者によるフィルター (
author:を使用) - を使用して組織別にフィルター処理する
org:
サポートされている repo: クエリ
repo: フィルターを追加するには、リポジトリの所有者をクエリに含める必要があります: repo:owner/repository。 所有者は、通知をトリガーする GitHub 資産を所有する組織またはユーザーです。 たとえば、repo:octo-org/octo-repo は、octo-org 組織内の octo-repo リポジトリでトリガーされた通知を表示します。
サポートされている is: クエリ
GitHubの特定のアクティビティの通知をフィルター処理するには、is クエリを使用できます。 たとえば、リポジトリの招待の更新のみを表示するには、 is:repository-invitationを使用し、 Dependabot alertsのみを表示するには、 is:repository-vulnerability-alertを使用します。
is:check-suiteis:commitis:gistis:issue-or-pull-requestis:releaseis:repository-invitationis:repository-vulnerability-alertis:repository-advisoryis:discussion
Dependabot alertsの通知からのノイズを減らす方法については、Dependabot アラートの通知を構成する を参照してください。
is: クエリを使用して、通知がトリアージされた方法を記述することもできます。
is:savedis:doneis:unreadis:read
サポートされている reason: クエリ
更新を受信した理由で通知をフィルター処理するには、reason: クエリを使用します。 たとえば、自分 (または自分が所属する Team) が Pull Request のレビューを要求されたときに通知を表示するには、reason:review-requested を使用します。 詳しくは、「通知について」をご覧ください。
| クエリ | 説明 |
|---|---|
reason:assign | 割り当てられている Issue またはプルリクエストに更新があるとき。 |
reason:author | プルリクエストまたは Issue を開くと、更新または新しいコメントがあったとき。 |
reason:comment | Issue またはプル リクエストでコメントをした際。 |
reason:participating | issue や 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 更新があるとき。 |
サポートされている author: クエリ
ユーザーごとに通知をフィルター処理するには、author: クエリを使用します。 作成者は、通知を受け取るスレッド (例: issue、pull request、gist、ディスカッション) の元の作成者です。 たとえば、Octocat ユーザーによって作成されたスレッドの通知を表示するには、author:octocat を使用します。
サポートされている org: クエリ
Organization を指定して通知をフィルター処理するには、org クエリを使用できます。 クエリで指定する必要がある組織は、 GitHubに通知されるリポジトリの組織です。 このクエリは、複数の Organization に属していて、特定の Organization の通知を表示する場合に便利です。
たとえば、octo-org の Organization からの通知を表示するには、org:octo-org を使用します。
Dependabot カスタム フィルター
Dependabotを使用して依存関係を最新の状態に保つ場合は、次のカスタム フィルターを使用して保存できます。
is:repository_vulnerability_alertを選択すると、 Dependabot alertsの通知が表示されます。reason:security_alertDependabot alerts とセキュリティ更新プログラムのプル リクエストの通知を表示するには。author:app/dependabotを選択すると、 Dependabotによって生成された通知が表示されます。 これには、 Dependabot alerts、セキュリティ更新プログラムのプル要求、バージョン更新プログラムのプル要求が含まれます。
Dependabot の詳細については、「Dependabot alerts」を参照してください。