プルリクエストで提案された変更をレビューする

pull request の目的を理解する

pull request の背後にある動機を明確に理解すると、レビューに通知できるため、ターゲットを絞って意味のある状態に保ち、pull request 作成者の意図とプロジェクトの目標に沿ったフィードバックを提供できます。

提案された変更のコンテキストと根拠をより深く理解するために、いくつかのオプションを使用できます。

コンテキストに対する pull request サイドバーの使用

pull request サイドバーには、次のような重要なコンテキストがあります。

• リンクされた 問題 または ディスカッション: プル要求が対処することを目的とする問題や目標を理解したり、背景、設計上の決定、現在の議論などに関する情報を収集したりするには、これらを確認します。
• リンクされた プロジェクト または マイルストーン: この pull request が大規模なプロジェクトまたは今後のリリースにどのように適合するかを確認します。

この情報を使用して、レビューのフレームを作成し、pull request の目標が元の意図と一致しているかどうかを確認します。

          コパイロットチャットを使用して根拠を理解する

pull request の意図の理解や変更の一部の明確化については、 コパイロットチャット に問い合わせてください。

1. pull request ページの右上にある検索バーの横にある ボタンをクリックします。

          コパイロットチャット が表示され、プロンプト ウィンドウにコンテキストとしてプル要求がアタッチされます。
   

2. プロンプト ボックスに質問を入力して Enter キーを押します。 たとえば、次のように入力できます。

   • What problem does this pull request solve?

   • Why were these changes needed?

   • Summarize the goals of this PR based on the linked issue.

   • How does this PR relate to issue ISSUE-URL?

          コパイロットチャット は、行レベルのレビューに進む前に、全体像を明確にするのに役立ちます。
     

レビューを開始する

1. リポジトリ名の下にある [Pull requests] をクリックします。

   

2. プルリクエストのリストで、レビューしたいプルリクエストをクリックします。

3. Pull request で、[ Files changed] をクリックします。

   
   このタブで差分ビューの形式を変更するには、 をクリックし、統合ビューまたは分割ビューを選択します。 他の pull request の差分を表示する場合も、この選択が適用されます。
   

   空白の違いを非表示にすることもできます。 この選択は、この pull request にのみ適用され、次回このページにアクセスするときに記録されます。

4. 必要に応じて、ファイルをフィルター処理して、確認するファイルのみを表示します。または、ファイル ツリーを使って特定のファイルに移動します。 詳しくは、「プルリクエスト内のファイルをフィルタリングする」をご覧ください。

5. コメントを追加するコード行にカーソルを合わせ、青いコメント アイコンをクリックします。

   

6. 必要に応じて、複数行にコメントを追加できます。 行の範囲を選択するには、コメントする最初の行の行番号をクリックし、最後の行までドラッグするか、 Shift キー を押しながら最後の行番号をクリックします。 その後、コメントする最後の行の青いコメント アイコンをクリックできます。 または、コメントする最初の行の横にある青いコメント アイコンをクリックし、コメントする最後の行まで下にドラッグします。

7. コメントフィールドにコメントを入力してください。

8. 必要に応じて、1 つまたは複数の行に固有の変更を提案するには、 をクリックした後、提案ブロック内のテキストを編集します。

   

9. ファイルに直接コメントするには、ファイルの右側にある をクリックしてコメントを入力します。

   

10. 終了したら [レビューの開始] をクリックします。 レビューを既に開始していた場合は、 [レビューコメントを追加] をクリックします。

レビューを提出する前は、行のコメントは 保留中 になっており、ご自分にしか見えません。 レビューを提出する前ならばいつでも、保留中のコメントを編集できます。 保留中のすべてのコメントを含め、保留中のレビューを取り消すには、変更されたコードの上にある [変更の確認] をクリックし、 [レビューの破棄] をクリックします。

          ![レビューのコメント フィールドのスクリーンショット。 [レビューの破棄] ボタンは濃いオレンジで囲まれます。](/assets/images/help/pull_requests/abandon-review-button.png)

          [
          GitHub Codespaces
          ](/codespaces/quickstart)を使用して、プル要求をテスト、実行、および確認できます。

プルリクエストの変更点を理解する

          GitHub Copilot は、特定のコミットのコンテキストと説明を提供することで、プル要求の変更をすばやく理解するのに役立ちます。 特定の変更の目的がわからない場合や、より広範なコードベースにどのように適合するかについて詳細が必要な場合は、個々のコミットについて Copilot 質問することができます。

1. GitHubのコミットに移動します。

1. GitHub の任意のページの右上で、検索バーの横にある アイコンをクリックします。

   ギットハブ コパイロット チャット パネルが表示されます。 パネルのサイズ変更を行うには、上端または左端をクリックしてドラッグします。

2. パネルに Copilot との以前の会話が含まれている場合は、Copilot パネルの右上にある プラス記号アイコンをクリックして、新しい会話を開始します。

3.        Copilotチャット パネルの下部にある [Ask Copilot] ボックスに質問を入力し、<kbd>Enter キー</kbd>を押します。 たとえば、次のように入力できます。
   

   • Summarize the changes in this commit

   • Who committed these changes?

   • When was this commit made?

   ヒント

   コミットの SHA がわかっている場合は、コミットに移動する代わりに、メッセージに SHA を含めることで、Copilot上のリポジトリ内の任意のページからコミットについてGitHubを確認できます。 たとえば、What changed in commit a778e0eab? のように指定します。

4. 必要に応じて、質問を送信した後、テキスト ボックス内の をクリックして回答を停止できます。

依存関係の変更をレビューする

プルリクエストに依存関係への変更が含まれている場合は、マニフェストまたはロックファイルの依存関係のレビューを使用して、何が変更されたかを確認し、変更によるセキュリティの脆弱性の発生の有無を確認できます。 詳しくは、「プルリクエスト内の依存関係の変更をレビューする」をご覧ください。

1. Pull request で、[ Files changed] をクリックします。

   

2. マニフェストまたはロック ファイルのヘッダーの右側で、 リッチ差分ボタンをクリックして依存関係の確認を表示します。

   

3. 依存関係を変化させないような変更がマニフェストあるいはロックファイルに行われているかもしれず、あるいはGitHubがパースできず、その結果として依存関係レビューに現れてこない依存関係があるかもしれないので、ソースdiffをレビューしたいこともあるでしょう。

   ソース差分ビューに戻るには、 ボタンをクリックします。

   

ファイルをレビュー済みとしてマークする

ファイルのレビュー後は、そのファイルをレビュー済みとしてマークできます。マークしたファイルは折りたたまれます。 ファイルを表示した後にファイルが変更された場合、「閲覧済み」マークが解除されます。

1. Pull request で、[ Files changed] をクリックします。

   

2. レビューを完了したファイルの、ヘッダーの右側にある [表示済み] を選びます。

   

レビューを提出する

プルリクエスト内でレビューしたいファイルをすべてレビューし終えたら、レビューをサブミットします。

1. Pull request で、[ Files changed] をクリックします。

   

2. 変更されたコードの上にある [変更の確認] をクリックします。

   

3. 提案された変更についてのフィードバックをまとめたコメントを入力してください。

4. 残しておくレビューの種類を選択します。

   • 変更を明示的に承認したり、追加の変更を要求したりせずに、一般的なフィードバックを残すには、 [コメント] を選びます。
   • フィードバックを提出して、pull request で提案された変更をマージすることを承認するには、 [承認] を選びます。
   • pull request をマージする前に対処する必要があるフィードバックを送信するには、 [変更の要求] を選びます。

5. [レビューをサブミット] をクリックします。