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

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

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

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

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

1. GitHub で、リポジトリのメイン ページに移動します。

2. リポジトリ名の下で、 [イシュー] または [pull request] をクリックします。

   

3. 一覧の上にある [フィルター] を選び、関心のあるフィルターの種類をクリックします。

   

label:"Bug fix" AND assignee:octocat

assignee:octocat OR assignee:hubot

(type:"Bug" AND assignee:octocat) OR (type:"Enhancement" AND assignee:hubot)

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

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

1. GitHub で、リポジトリのメイン ページに移動します。

2. リポジトリ名の下で、 [イシュー] または [pull request] をクリックします。

   

3. issue または pull request の一覧の上にある [担当者] ドロップダウン メニューを選びます。

   

4. [Assignee] ドロップダウンメニューには、リポジトリへの書き込み権限のあるすべてのユーザがリストされます。 確認したい割り当て済みの項目を持つユーザの名前をクリックするか、 Assigned to nobody をクリックして未割り当ての issue を表示します。

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

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

1. GitHub で、リポジトリのメイン ページに移動します。

2. リポジトリ名の下で、 [イシュー] または [pull request] をクリックします。

   

3. issue または pull request の一覧の上にある Labels をクリックします。

   

4. ラベルの一覧でラベルをクリックします。

issue の種類によるフィルター処理

組織で issue の種類を使用している場合は、特定の種類の issue をフィルター処理できます。 フィルターに直接 type: 修飾子を入力することもできます。

1. GitHub で、リポジトリのメイン ページに移動します。

2. リポジトリ名の下にある [イシュー] をクリックします。

   

3. issue の一覧の上にある [型] ドロップダウン メニューを選びます。

   

4. 種類の一覧で、issue の種類をクリックします。

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

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

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

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

1. GitHub で、リポジトリのメイン ページに移動します。

2. リポジトリ名の下にある [pull request] をクリックします。

   

3. 右上隅の [レビュー] ドロップダウンメニューを選びます。

   

4. フィルタを選択してます。そのフィルタのステータスのPull Requestすべてが検索されます。

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

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

IssueやPull Requestの検索

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

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 をフィルター処理します (linked:pr)
• クローズされた理由により issue をフィルタリングします: is:closed reason:completed または is:closed reason:"not planned"
• 特定のタイプの問題をフィルタリングします: is:open type:"Bug"

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

1. GitHub で、リポジトリのメイン ページに移動します。

2. リポジトリ名の下で、 [イシュー] または [pull request] をクリックします。

   

3. 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 およびプルリクエストを検索する