Skip to main content

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

GitHub AE上のリポジトリに関する詳細情報を見つけるために、そのリポジトリに関連するIssueやPull Requestをフィルタリング、ソート、検索できます。

ヒント: 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] が使用された、自分または自分がメンバーであるチームが確認を求められているプルリクエストを探すことができます。 詳細については、「Searching issues and pull requests」 (問題とプルリクエストの検索) を参照してください。

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

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

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

  1. On your enterprise, navigate to the main page of the repository. 1. リポジトリ名の下で、 [issue] または [pull request] をクリックします。 issue と pull request のタブの選択
  2. [フィルター] をクリックして関心のあるフィルターの種類を選択します。 [フィルター] ドロップダウンの使用

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

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

  1. On your enterprise, navigate to the main page of the repository. 1. リポジトリ名の下で、 [issue] または [pull request] をクリックします。 issue と pull request のタブの選択
  2. 右上にある [Assignee] ドロップダウンメニューをクリックします。
  3. [Assignee] ドロップダウンメニューには、リポジトリへの書き込み権限のあるすべてのユーザがリストされます。 確認したい割り当て済みの項目を持つユーザの名前をクリックするか、 [Assigned to nobody](未割り当て) をクリックして未割り当ての issue を表示します。 [担当者] ドロップダウン タブの使用

フィルターの選択を解除するには、 [Clear current search query, filters, and sorts](現在の検索クエリ、フィルター、並べ替えをクリアする) をクリックします。

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

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

  1. On your enterprise, navigate to the main page of the repository. 1. リポジトリ名の下で、 [issue] または [pull request] をクリックします。 issue と pull request のタブの選択 1. issue または pull request の一覧の上にある [Labels](ラベル) をクリックします。 リポジトリの issue もしくは pull request ページの[Labels](ラベル) タブ
  2. ラベルのリストでラベルをクリックして、割り当てられた Issue とプルリクエストを表示します。 リポジトリのラベルの一覧

ヒント: フィルターの選択を解除するには、 [Clear current search query, filters, and sorts](現在の検索クエリ、フィルター、並べ替えをクリアする) をクリックします。

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

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

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

  1. On your enterprise, navigate to the main page of the repository. 1. リポジトリ名の下にある [pull request] をクリックします。 [pull request] タブの選択
  2. 右上にある [Reviews] ドロップダウンメニューをクリックします。 pull request の一覧の上にあるフィルター メニュー内の [レビュー] ドロップダウン メニュー
  3. フィルタを選択してます。そのフィルタのステータスのPull Requestすべてが検索されます。 [レビュー] ドロップダウン メニュー内のフィルターの一覧

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

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

IssueやPull Requestの検索

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

Issue およびプルリクエストの検索バー

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

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

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

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

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

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

  • 一番新しく作成された Issue またはPull Request
  • 一番古くに作成された Issue またはPull Request
  • 最もコメントされた Issue またはPull Request
  • 最もコメントされていない Issue およびPull Request
  • 一番新しく更新された Issue またはPull Request
  • 一番古くに更新された Issue またはPull Request
  • 最もリアクションがあったIssueまたはPull Request
  1. On your enterprise, navigate to the main page of the repository. 1. リポジトリ名の下で、 [issue] または [pull request] をクリックします。 issue と pull request のタブの選択
  2. 右上にあるソートドロップダウンメニューをクリックします。 [並べ替え] ドロップダウン タブの使用

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

フィルターを共有する

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

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

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

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

参考資料