GitHub Copilotによるコード レビューの構成

プル要求を確認するように Copilot を設定します。

この記事で

はじめに

プル要求を自動的に確認するように Copilot code review を構成し、 Copilot レビュー作業を設定できます。 概要については、「GitHub Copilotによるコードレビューについて」を参照してください。

自分の pull request に対する自動コード レビューの構成

Copilot code reviewを設定して、作成したプル要求を、Copilot code reviewが使用可能な任意のリポジトリで確認できます。

メモ

自動コード レビューの構成は、 Copilot Pro、 Copilot Pro+、および Copilot Max プラン、および Copilot Business または Copilot Enterprise ライセンスで使用できます。 マネージド ユーザー アカウントでは使用できません。

  1. GitHub の任意のページで、右上隅にある自分のプロフィール画像をクリックしてから、[ Copilot settings] をクリックします。
  2. サイドバーの [ Copilot] で、[ コード レビュー] をクリックします。
  3. 自動Copilot code review を有効にします。
  4. 必要に応じて、 Copilot が既に確認している pull request への新しいプッシュを確認するには、[ 新しいプッシュの確認] を有効にします。
  5. 必要に応じて、引き続き下書きとしてマークされている間に pull request を確認するには、 下書きプル要求のレビューを有効にします。

プル要求では、ユーザー設定、リポジトリ ルールセット、または組織のルールセットなど、複数の独立したソースからの自動レビューを受けることができます。 これらのソースは個別に評価されます。 複数のソースが適用される場合でも、 Copilot は 1 つのレビューを投稿します。 ユーザー設定では、ルールセットが有効にしたプッシュ レビューまたは下書きレビューを無効にすることはできません。 詳細については、「GitHub Copilotによるコードレビューについて」を参照してください。

Copilot レビュー作業の構成

要求するレビューにCopilot使用するCopilot code reviewレビューの作業量を選択できます。 選択内容は、自動レビューと、手動で要求したレビューに適用されます。 レベルの概要と、使用するレベル Copilot 決定する方法については、 GitHub Copilotによるコードレビューについて を参照してください。

  1. GitHub の任意のページで、右上隅にある自分のプロフィール画像をクリックしてから、[ Copilot settings] をクリックします。
  2. サイドバーの [ Copilot] で、[ コード レビュー] をクリックします。
  3. [レビュー工数レベル] の横で、依頼するレビューの Copilot レビュー工数を選択します。
    • Lite: 標準のレビュー。
    • バランス: 複雑なロジック、セキュリティに依存するコード、およびサービス間の変更のより詳細な分析。
    • Max: 最も詳細なレビュー。 このオプションは、[ 近日 公開] ラベルと共に表示され、まだ使用できません。

組み込みの既定値に戻すには、メニューの上部にある [既定 ] オプションを選択します。 特定のレベルを選択するまでは、コントロールに適用される組み込みの既定値 (Default (Lite) または Default (Balanced) が表示されます。

Copilotレビュー作業は、自動Copilot code review とは無関係です。 自動レビューをオフにしても、 Copilot レビュー作業がクリアされたり、手動で要求したレビューへの適用が停止されたりすることはありません。

リポジトリの自動コード レビューの構成

リポジトリの自動コード レビューを有効にし、コード レビューの実行方法をカスタマイズできます。

自動レビューを有効にする

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

  2. リポジトリ名の下にある [Settings] をクリックします。 [設定] タブが表示されない場合は、 [] ドロップダウン メニューを選び、 [設定] をクリックします。

    タブを示すリポジトリ ヘッダーのスクリーンショット。 [設定] タブが濃いオレンジ色の枠線で強調表示されています。

  3. 左側のサイドバーの [コードと自動化] で、[ ルールセット] をクリックし、[ ルールセット] をクリックします。

  4. 「新しいルールセット」をクリックします。

  5. [新しいブランチ ルールセット] をクリックします。

  6. [ルールセット名] に、ルールセットの名前を入力します。

  7. ルールセットをアクティブにするには、[Enforcement Status] で [Active] を選びます。

  8. [Target branches] で [Add target] をクリックし、オプションのいずれかを選びます。たとえば、[Include default branch] または [Include all branches] などです。

  9. 「Target branches」で、Add target をクリックし、ターゲット オプションから 1 つを選択します。

  10. 「分岐ルール」で、自動的にCopilot code reviewをリクエストする を選択します。

  11. 必要に応じて、Copilot に pull request への以降のすべてのプッシュを確認させるには、新しいプッシュの確認 を選択します。

    このオプションが選択されていない場合、 Copilot は pull request を 1 回だけ確認します。

  12. 必要に応じて、引き続き下書きである間に pull request をレビュー Copilot する場合は、[ 下書きプル要求のレビュー] を選択します。

    これは、人によるレビューを依頼する前に、エラーを早期に検出するのに役立つオプションです。

  13. ページの下部にある [Create] をクリックします。

カスタマイズ Copilot code review

リポジトリ Copilot code review コード レビューを完了する方法を構成できます。

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

  2. リポジトリ名の下にある [Settings] をクリックします。 [設定] タブが表示されない場合は、 [] ドロップダウン メニューを選び、 [設定] をクリックします。

    タブを示すリポジトリ ヘッダーのスクリーンショット。 [設定] タブが濃いオレンジ色の枠線で強調表示されています。

  3. サイドバーの [Code, planning, and automation](コード、計画、自動化) の下で、 [ Copilot]、[ コード レビュー] の順にクリックします。

  4. Copilotコード レビューの深さを選択するには、[Review effort level](レビューの作業量レベル) の横で、このリポジトリの自動レビューの作業レベルを選択します。

    • Lite: 標準のレビュー。
    • バランス: 複雑なロジック、セキュリティに依存するコード、およびサービス間の変更のより詳細な分析。

    バランスの取れたレビューでは、AI credits をより多く使用し、GitHub Actions 分ほど余分にかかる場合があります。 「GitHub Copilotによるコードレビューについて」を参照してください。

  5. リポジトリ Copilot プル要求を承認できるかどうかを選択するには、[自動承認] で設定を構成します。

    • Copilot がプルリクエストを承認できるようにする: オンにすると、Copilot が承認レビューを送信できるようになります。

    • Copilot承認がマージ要件にカウントされるようにする: Copilot承認がプル要求の承認要件を満たすことができるようにオンに切り替えます。

    • ファイルパス: 必要に応じて、マージ要件の対象となるプルリクエストを制限します。 変更されたすべてのファイルが glob の 1 つに一致するプル要求でのみ承認をカウントするには、行ごとに 1 つのファイル glob を入力します。 すべてのファイルの承認をカウントするには、空白のままにします。 最大 15 個の glob がサポートされています。

    メモ

    Copilot 承認はパブリック プレビューの段階にあり、変更される可能性があります。

Organization のリポジトリについて自動コード レビューを構成する

組織内のリポジトリの自動コード レビューを有効にし、コード レビューの実行方法をカスタマイズできます。

自動レビューを有効にする

  1. GitHub の右上隅にあるプロフィール画像をクリックしてから、[ Your organizations] をクリックします。

  2. 組織をクリックして選択します。

  3. Organization 名の下で、[ Settings] をクリックします。 [設定] タブが表示されない場合は、 [] ドロップダウン メニューを選び、 [設定] をクリックします。

    組織のプロファイルのタブのスクリーンショット。 [設定] タブが濃いオレンジ色の枠線で囲まれています。

  4. サイドバーの [Code, planning, and automation](コード、計画、自動化) の下で、[リポジトリ クリックし、[ルールセット] をクリックします。

  5. 「新しいルールセット」をクリックします。

  6. [新しいブランチ ルールセット] をクリックします。

  7. [ルールセット名] に、ルールセットの名前を入力します。

  8. ルールセットをアクティブにするには、[Enforcement Status] で [Active] を選びます。

  9. [Target repositories] で、[Add target] をクリックし、[Include by pattern] または [Exclude by pattern] を選びます。

  10. ターゲットにするリポジトリ名と一致するパターンを入力します。たとえば、名前が *feature で終わるすべてのリポジトリと一致するようにfeatureします。

    パターン マッチング構文については、 組織内のリポジトリのルールセットを作成する を参照してください。

  11. [ 包含パターンの追加] または [除外パターンの追加] をクリックします。

  12. 追加のパターンの場合は繰り返します。

    メモ

    複数のターゲット条件を同じルールセットに追加できます。 除外パターンは包含パターンの後に適用されます。 たとえば、パターン *cat* に一致するリポジトリを含め、パターン not-a-cat に一致するリポジトリを明示的に除外できます。

  13. 「Target branches」で、Add target をクリックし、ターゲット オプションから 1 つを選択します。

  14. 「分岐ルール」で、自動的にCopilot code reviewをリクエストする を選択します。

  15. 必要に応じて、Copilot に pull request への以降のすべてのプッシュを確認させるには、新しいプッシュの確認 を選択します。

    このオプションが選択されていない場合、 Copilot は pull request を 1 回だけ確認します。

  16. 必要に応じて、引き続き下書きである間に pull request をレビュー Copilot する場合は、[ 下書きプル要求のレビュー] を選択します。

    これは、人によるレビューを依頼する前に、エラーを早期に検出するのに役立つオプションです。

  17. ページの下部にある [Create] をクリックします。

カスタマイズ Copilot code review

組織内のリポジトリ Copilot code review コード レビューを完了する方法を構成できます。

  1. GitHub の右上隅にあるプロフィール画像をクリックしてから、[ Your organizations] をクリックします。

  2. 組織をクリックして選択します。

  3. Organization 名の下で、[ Settings] をクリックします。 [設定] タブが表示されない場合は、 [] ドロップダウン メニューを選び、 [設定] をクリックします。

    組織のプロファイルのタブのスクリーンショット。 [設定] タブが濃いオレンジ色の枠線で囲まれています。

  4. サイドバーの [Code, planning, and automation](コード、計画、自動化) の下で、 [ Copilot]、[ コード レビュー] の順にクリックします。

  5. Copilotコード レビューの深さを選択するには、[Review effort level](レビューの作業量レベル) の横にある組織内のリポジトリの自動レビューの既定の作業レベルを選択します。

    • Lite: 標準のレビュー。
    • バランス: 複雑なロジック、セキュリティに依存するコード、およびサービス間の変更のより詳細な分析。

    バランスの取れたレビューでは、AI credits をより多く使用し、GitHub Actions 分ほど余分にかかる場合があります。 「GitHub Copilotによるコードレビューについて」を参照してください。

  6. リポジトリ Copilot プル要求を承認できるかどうかを選択するには、[マージ要件に合わせて Copilot 承認をカウントする] の横にある [承認] でオプションを選択します。

    • あらゆる場所で有効: Copilot 承認は、組織内のすべてのリポジトリのマージ要件にカウントできます。

    • リポジトリが決定できるようにする: リポジトリ管理者は、リポジトリの設定でこれを決定できます。

    • 選択したリポジトリに対して有効にする: Copilot 承認は、選択したリポジトリ内でのみマージ要件にカウントできます。 このオプションを選択した場合は、これを有効にするリポジトリも割り当てます。

    • すべての場所で無効: Copilot 承認は、組織内のどのリポジトリのマージ要件にもカウントできません。

    メモ

    Copilot 承認はパブリック プレビューの段階にあり、変更される可能性があります。

企業の自動コード レビューの構成

エンタープライズの自動コード レビューを有効にし、コード レビューの実行方法をカスタマイズできます。

自動レビューを有効にする

  1. エンタープライズ レベルのブランチ ルールセットを作成します。 「Enterprise でルールセットを使ってコード ガバナンスを適用する」を参照してください。
  2. Copilot code reviewが自動的に実行される組織とリポジトリを対象とします。
  3. ** Copilot code review を自動的に要求する** ポリシーを有効にします。
  4. 必要に応じて、ドラフトのプル リクエストに対する自動レビューと、プル リクエストへのプッシュのたびに行われる自動レビューを有効にします。
  5. Create をクリックしてください。

カスタマイズ Copilot code review

Copilot code review が企業向けにコードレビューを完了する方法を設定できます。

  1. 企業ページに移動してください。 たとえば、GitHub.com の [Enterprise] ページから。
  2. ページの上部にある AI コントロールをクリックします。
  3. [使用可能なエージェント] まで下にスクロールし、[ Copilot code review] をクリックします。
  4. [Copilot code review] の横にあるポリシーを選択します。
  5. 次に、企業で有効にする Copilot code review 機能を選択します。
  6. 組織で Copilot が pull request を承認できるようにするかどうかを選択するには、[Copilot による pull request の承認を許可する] の横にあるポリシーを選択します。

    • 組織が決定できるようにする: 組織の所有者は、 Copilot 承認を有効にするかどうかを選択できます。

    • 選択した組織に対して有効にする: Copilot 承認は、選択した組織に対してのみ有効になります。

    • すべての場所で無効: 組織は Copilot 承認を有効にできません。 これが既定値です。

    メモ

    Copilot 承認はパブリック プレビューの段階にあり、変更される可能性があります。