Issue及びPull Requestのフィルタリングと検索

Tip

GitHub CLI を使用して Issue またはPull Requestをフィルタすることもできます。詳細については、GitHub CLI ドキュメントの「gh issue list」または「gh pr list」を参照してください。

Issue およびPull Requestをフィルタリングする

Issue およびPull Requestには、適用してリストを整理するためのデフォルトのフィルタが備わっています。

検索修飾子 review-requested:[USERNAME] または team-review-requested:[TEAMNAME] が使用された、自分または自分がメンバーであるチームが確認を求められているプルリクエストを探すことができます。詳しくは、「Issue およびプルリクエストを検索する」を参照してください。

Issue およびPull Requestをフィルタリングして、以下を探すことができます:

すべてのオープンな Issue およびPull Request
自分で作成した Issue およびPull Request
自分に割り当てられた Issue およびPull Request
@mentioned されていた現在の issue と pull request

Tip

GitHub で、リポジトリのメインページに移動します。
リポジトリ名の下で、 [イシュー] または [pull request] をクリックします。
一覧の上にある [フィルター] を選び、関心のあるフィルターの種類をクリックします。

Issue およびPull Requestをアサインされた人でフィルタリングする

issue または pull request を他のユーザーに割り当てると、作業しているユーザーに基づいて項目を見つけることができます。

GitHub で、リポジトリのメインページに移動します。
リポジトリ名の下で、 [イシュー] または [pull request] をクリックします。
issue または pull request の一覧の上にある [担当者] ドロップダウンメニューを選びます。
[Assignee] ドロップダウンメニューには、リポジトリへの書き込み権限のあるすべてのユーザがリストされます。確認したい割り当て済みの項目を持つユーザの名前をクリックするか、 Assigned to nobody をクリックして未割り当ての issue を表示します。

フィルターの選択を解除するには、 Clear current search query, filters, and sorts をクリックします。

Issue およびPull Requestをラベルでフィルタリングする

issue または pull request にラベルを適用すると、そのラベルに基づいて項目を見つけることができます。

GitHub で、リポジトリのメインページに移動します。
リポジトリ名の下で、 [イシュー] または [pull request] をクリックします。
issue または pull request の一覧の上にある Labels をクリックします。
ラベルの一覧でラベルをクリックします。

ヒント: フィルターの選択を解除するには、 Clear current search query, filters, and sorts をクリックします。

プルリクエストをレビューステータスでフィルタリングする

フィルタを使用して、レビューステータスでPull Requestをフィルタリングしたり、自分でレビューしたPull Requestや他のユーザにレビューするよう依頼されたPull Requestを検索したりできます。

Pull Requestのリポジトリのリストをフィルタリングして、次の検索を行えます:

まだレビューされていない pull request
マージできるようになる前にレビューを必要とする pull request
レビュー担当者が承認したPull Request
レビュー担当者が変更を求めているPull Request
自分がレビューした pull request
誰かから直接レビューを求められた pull request
他のユーザーから、またはメンバーであるチームからレビューするよう求められた pull request

GitHub で、リポジトリのメインページに移動します。
リポジトリ名の下にある [pull request] をクリックします。
右上隅の [レビュー] ドロップダウンメニューを選びます。
フィルタを選択してます。そのフィルタのステータスのPull Requestすべてが検索されます。

検索を使用して Issue およびプルリクエストをフィルタリングする

特定の条件を満たすIssueやPull Requestを検索するために、フィルターを使うことができます。

IssueやPull Requestの検索

Issue とPull Requestの検索バーを使用すると、独自のカスタムフィルターを定義し、さまざまな基準で並べ替えることができます。検索バーは、各リポジトリの [Issue] タブと [Pull requests] タブ、および [Issue] ダッシュボードと [Pull requests] ダッシュボードにあります。

ヒント: キーボードショートカットを使えば、Issueあるいはプルリクエストのリストの上にある検索バー上のカーソルに集中できます。詳しくは、「キーボードショートカット」を参照してください。

GitHub CLI の詳細については、「GitHub CLI について」を参照してください。

GitHub CLIを使ってIssueやPull Requestを検索できます。 --search 引数と検索クエリと共に gh issue list または gh pr list サブコマンドを使用します。

たとえば、担当者がいなくて、help wanted または bug ラベルを持つすべての issue を、作成された日付順に一覧表示できます。

gh issue list --search 'no:assignee label:"help wanted",bug sort:created-asc'

octo-org/octo-team チームにメンションするすべての pull request を一覧表示することもできます。

gh pr list --search "team:octo-org/octo-team"

検索語について

Issue およびPull Requestの検索用語により、次のことができます:

作成者ごとに issue と pull request をフィルター処理します: state:open type:issue author:octocat
特定のユーザーを含むが必ずしも @mention していない issue と pull request をフィルター処理します: state:open type:issue involves:octocat
担当者ごとに issue と pull request をフィルター処理します: state:open type:issue assignee:octocat
ラベルごとに issue と pull request をフィルター処理します: state:open type:issue label:"bug"
語句の前に - を使用して、検索語句を除外します: state:open type:issue -author:octocat

ヒント: 論理和あるいは論理積を使って、ラベルごとに issue と pull request をフィルター処理できます。

論理和を使用して issue をフィルター処理するには、コンマ構文を使用します: label:"bug","wip"。
論理積を使用して issue をフィルター処理するには、別のラベルフィルターを使用します: label:"bug" label:"wip"。

Issueについては、以下も検索に利用できます。

クローズしている参照ごとに、pull request にリンクされている issue をフィルター処理します (linked:pr)
クローズされた理由により issue をフィルタリングします: is:closed reason:completed または is:closed reason:"not planned"

Pull Requestについては、検索を利用して以下の操作もできます。

ドラフトの pull request をフィルター処理する: is:draft
まだレビューされていない pull request をフィルター処理する: state:open type:pr review:none
マージできるようになる前にレビューを必要とする pull request をフィルター処理する: state:open type:pr review:required
レビュー担当者が承認した pull request をフィルター処理する: state:open type:pr review:approved
レビュー担当者が変更を求めている pull request をフィルター処理する: state:open type:pr review:changes_requested
レビュー担当者ごとに pull request をフィルター処理する: state:open type:pr reviewed-by:octocat
レビューを要求した特定のユーザーで pull request をフィルター処理する: state:open type:pr review-requested:octocat
誰かから直接レビューするよう求められた pull request をフィルター処理する: state:open type:pr user-review-requested:@me
レビューを要求したチームで pull request をフィルター処理する: state:open type:pr team-review-requested:github/docs
pull request がクローズできる issue にリンクされている pull request をフィルター処理する: linked:issue
merging の状態でプルリクエストをフィルター処理する: is:merged または is:unmerged

Issue およびPull Requestをソートする

フィルターは、特定の期間の情報をよりよく提供するためにソートできます。

これらのフィルタービューでソートできます。

一番新しく作成された Issue またはPull Request
一番古くに作成された Issue またはPull Request
最もコメントされた Issue またはPull Request
最もコメントされていない Issue およびPull Request
一番新しく更新された Issue またはPull Request
一番古くに更新された Issue またはPull Request
最もリアクションがあったIssueまたはPull Request

GitHub で、リポジトリのメインページに移動します。
リポジトリ名の下で、 [イシュー] または [pull request] をクリックします。
issue または pull request の一覧の上にある [並べ替え] ドロップダウンメニューを選び、並べ替え方法をクリックします。

並べ替えの選択を解除するには、 [並べ替え] > [最新] をクリックします。

一定の Issue およびPull Requestをフィルタリングする場合、ブラウザの URL は、次の表示にマッチするように自動的に更新されます。

Issue が生成した URL は、どのユーザにも送れます。そして、あなたが見ているフィルタビューと同じフィルタで表示できます。

たとえば、Hubot にアサインされた Issue でフィルタリングし、最も古いオープン Issue でソートした場合、あなたの URL は、次のように更新されます:

/issues?q=state:open+type:issue+assignee:hubot+sort:created-asc

参考資料

「Issue およびプルリクエストを検索する」