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