GitHub Copilot コードレビューについて

はじめに

Copilotコードレビューは、任意の言語で記述されたコードをレビューし、フィードバックを提供します。コードを複数の角度からレビューして問題を特定し、修正を提案します。 2 回のクリックで、推奨される変更を適用できます。

この記事では、Copilotコードレビューの概要について説明します。 Copilot からコードレビューを要求する方法については、 GitHub Copilot を使ったコードレビューを参照してください。

可用性

Copilotコードレビューは、以下でサポートされています。

GitHub.com
VS Code
Visual Studio
Xcode
JetBrains IDE

Copilotコードレビューは、以下のプランで利用可能なプレミアム機能です。

データ変数.copilot.copilot_pro_short %}
Copilot Pro+
Copilot 事業

Copilot Enterprise

        [Copilot プラン](https://github.com/features/copilot/plans?ref_product=copilot&ref_type=purchase&ref_style=text)を確認してください。

組織から Copilot を受け取った場合、組織は、Copilot ポリシー設定で、Copilotコードレビュー オプションを有効にする必要があります。これは、GitHub.com または GitHub Mobile のレビューに適用されます。「組織内の GitHub Copilot のポリシーと機能の管理」を参照してください。

Copilotコードレビューは Copilot ライセンスなしで使用することはできません。

          **Copilot のライセンスを持たない**組織メンバーは、Copilotコード レビュー をGitHub.comで使用できます。 エンタープライズ管理者または組織の所有者が有効にする必要があります。 この機能は、**Copilot 事業** および **Copilot Enterprise** プランに加入している組織が利用できます。

ライセンスのないユーザーのコードレビューを有効にする

Copilot ライセンスを持たない組織メンバーが Copilotコードレビューを使用できるようにするには、次の 2 つのポリシーを有効にする必要があります。

       **Premium リクエストの有料利用**。 最初にこのポリシーを有効にします。 これにより、エンタープライズまたは組織には、Copilotコード レビュー Premium 要求の使用量が課金されます。

       **Copilot ライセンスを持たないメンバーがCopilotコード レビュー を GitHub.com で使用できるようにします**。 このサブポリシーは、ライセンスのないユーザーに対して Copilotコード レビュー を有効にします。

2 番目のポリシーには、次の特性があります。

この機能は既定で無効になっています。
このポリシーをエンタープライズレベルで設定すると、表示されますが、組織レベルでは 編集できなくなります 。
ポリシーは 最も制限が厳しい。 Copilotコードレビューは、ポリシーを明示的に有効にしたリポジトリでのみ使用できます。

ライセンスを持たないユーザーに対する動作

両方のポリシーが有効になっている場合、Copilot ライセンスが付与されていないユーザーは、組織のリポジトリ内のプルリクエストの Copilotコードレビューからレビューを要求できます。

自動コードレビューが有効になっているリポジトリでは、Copilot はすべてのプル要求を自動的に確認します。これは、作成者が Copilot ライセンスを持っているかどうかにかかわらず発生します。

ライセンスがないユーザーに対しては、Copilotコードレビューを IDE で利用することはできません。

除外されたファイル

一部のファイルの種類はCopilotコードレビューから除外されます。

依存関係管理ファイル (package.json や Gemfile.lock など)
ログファイル
SVG ファイル

これらのファイルの種類をプル要求に含める場合、Copilotコードレビューはファイルを確認しません。

詳しくは、「GitHub Copilot コードレビューから除外されるファイル」をご覧ください。

Copilotコードレビューのエージェント機能

メモ

Copilotコードレビューには、パブリックプレビューに含まれる機能があり、変更される可能性があります。 GitHub プレリリースライセンス条項は、プレビュー機能の使用に適用されます。

Copilotコードレビューは、エージェント機能を利用してその機能を拡張します。

        **完全なプロジェクト コンテキストの収集**。 これにより、より具体的で正確で、コンテキストに応じたコード レビューが提供されます。 この機能は、リポジトリ全体を分析して、コード変更のコンテキストをより深く理解します。 完全なプロジェクト コンテキスト収集が一般提供されています。

        **Copilotコーディングエージェント に提案を渡す機能**。 これにより、推奨される修正が適用されたブランチに対する新しいプル要求の作成が自動化されます。 Copilotコーディングエージェント への提案の受け渡しはパブリック プレビュー段階であり、変更される可能性があります。

これらの機能は、Copilot ProプランまたはCopilot Pro+プランに対して自動的に有効になります。

GitHub Actions を使用できないまたは、Copilotコードレビューが使用する Actions ワークフローが失敗した場合でも、レビューは生成されます。ただし、エージェント機能によって提供される追加機能は含まれません。

コードレビューでのエージェント機能に対する GitHub Actions ランナーの使用

Copilotコードレビューは、GitHub Actions の無料の分を使用して、エージェント機能を実行します。これには、プロジェクト全体のコンテキスト収集および、パブリックプレビューの機能が含まれます。既定では、Copilotコードレビューは、GitHub でホストされるランナーを使用します。パフォーマンスを向上させるために、GitHub ホストランナーをより大きいものにアップグレードすることもできます。

メモ

GitHub ホストランナーの使用が大きくなると、1分あたりの課金が行われ、追加の GitHub Actions 料金が発生する可能性があります。

コードレビューでエージェント機能を使用するために、組織または企業で GitHub Actions を有効にする必要はありません。

組織が、GitHub でホストされるランナーを無効にした場合、エージェント機能は利用できません。この場合、コードレビューは、より限定的なレビューにフォールバックします。このような状況の組織では、セルフホステッドランナーを使用できます。

ランナーの構成の詳細については、 GitHub Copilot コードレビュー用のランナーの構成を参照してください。

コードレビューの月間クォータ

Copilot が IDE でプル要求を確認したり、コードをレビューしたりするたびに、Copilot Premium 要求の月間クォータが 1 つ減ります。

すべての新しい pull request に対して Copilot からコードレビューを自動的に要求するようにリポジトリが構成されている場合、Premium 要求の使用量は pull request 作成者のクォータに適用されます。レビューが別のユーザーによって手動で要求された場合、代わりにそのユーザーのクォータに使用状況が適用されます。

GitHub Actions またはボットが、プルリクエストを作成する場合、使用量は、次に適用されます。

ワークフローをトリガーしたユーザー (そのユーザーを識別できる場合)。
指定された請求管理者。

クォータに達するとどうなりますか

毎月のクォータに達すると、クォータがリセットされるまで、 Copilot からコードレビューを受け取ることができません。クォータがリセットされる前にコードレビューを引き続き使用するには、Copilotプランをアップグレードするか、追加のプレミアムリクエストを有効にする必要があります。

Copilot のライセンスまたは Copilotコードレビューを含むプランを持たないユーザー

Copilotコードレビューにアクセスできないユーザーには、毎月の Premium 要求クォータがありません。これには、Copilot ライセンスを持たないユーザーと、Copilot無料プランのユーザーが含まれます。Copilotコードレビューは含まれません。

このようなユーザーに対して Copilotコードレビューが有効な場合、生成されるすべての Premium 要求は、支払われた超過分の使用量として組織または企業に直接課金されます。これは、手動で要求されたレビューと自動コードレビューの両方に適用されます。

これらのユーザーによって生成された Premium 要求は、Copilot プランクォータに起因しません。課金レポートと Premium 要求分析では、超過分の使用量として表示されます。コードレビューを含むCopilotライセンスを持つユーザーは、割り当てられたプランのクォータからプレミアムリクエストを引き続き消費します。

モデルの使用法

Copilotコードレビューは、入念に調整されたモデル、プロンプト、システム動作の組み合わせを使って、さまざまなコードベースについての一貫した高品質のフィードバックを提供する、専用の製品です。モデルを変更すると、レビューコメントの信頼性、ユーザーエクスペリエンス、品質が損なわれる可能性があるため、モデルの切り替えはサポートされていません。

メモ

Copilotコードレビューは、organization の [Models] 設定ページで有効にされていないモデルを使う場合があります。 [モデル] 設定ページでは、Copilot チャットのみが制御されます。

Copilotコードレビューは一般公開されているため、すべてのモデルの使用は一般公開の条件に従います。「組織内の GitHub Copilot のポリシーと機能の管理」をご覧ください。

Copilot コードレビューを検証する

Copilot は、プルリクエスト内のすべての問題や課題を検出するとは限りません。時には間違いを犯すことがあります。 Copilotのフィードバックを慎重に検証してください。 Copilotのフィードバックは、人間のレビューで補完します。

詳しくは、「GitHub Copilot コードレビューの責任ある使用」をご覧ください。

Copilot のリポジトリに関する知識を強化する

Copilot がリポジトリ内のコード、使用するツール、およびコーディングの標準とプラクティスについて知れば知るほど、レビューの精度と有用性が高くなります。 Copilotのリポジトリに関する知識を強化するには、2 つの方法があります。

カスタム手順

これらは、リポジトリに 1 つ以上のファイルとして書き込んで格納する、短い自然言語ステートメントです。 GitHub の組織の所有者である場合は、組織の設定でカスタム指示を定義することもできます。詳しくは、「GitHub Copilotの応答をカスタマイズする方法」をご覧ください。

Copilot メモリ(パブリックプレビュー)

Copilot Pro または Copilot Pro+ プランがある場合は、Copilot メモリを有効にすることができます。これにより、 Copilot は、リポジトリについて学習した有用な詳細を格納できます。 Copilot は、そのリポジトリ内のプルリクエストを確認するときにこの情報を使用できます。詳しくは、「GitHub Copilotのエージェント記憶について」をご覧ください。

プルリクエストの自動レビューについて

既定では、Copilot は、プルリクエストに割り当てた場合にのみそのプルリクエストをレビューします。ただし、自動レビューは構成できます。

Copilot Pro または Copilot Pro+ プランの個々のユーザーは、 Copilot を構成して、作成したすべてのプル要求を自動的に確認できます。

        **Repository 所有者** は、 Copilot を構成して、Copilot にaccessを持つユーザーによって作成されたすべてのプル要求をリポジトリ内で自動的に確認できます。

        **組織の所有者** が、Copilot を構成すると、Copilot ユーザーによってプル リクエストが作成された組織内の一部またはすべてのリポジトリのプル リクエストを自動的にレビューすることができます。

プルリクエスト自動レビューをトリガーする

自動コードレビューのトリガーは、構成設定によって異なります。

基本設定:
- "Open" プルリクエストとしてプルリクエストを作成する場合。
- 初めて "Draft" pull request を "Open" に切り替えます。
新しいプッシュを確認します。
- 新しいコミットをプルリクエストにプッシュするたび。
下書きの pull request を確認します。
- "Open" に切り替える前に、プルリクエストは下書きの段階で自動的にレビューされます。

完全な手順については、 GitHub Copilot による自動コードレビューの構成を参照してください。

メモ

Copilot がプルリクエストへの各プッシュをレビューするように設定されていない限り、プルリクエストは1回だけレビューされます。 pull request が自動的にレビューされた後で変更を加え、あなたが Copilot による再レビューを希望する場合は、手動でこれを要求することができます。 [レビュー担当者] メニューの Copilot 名の横にある [] ボタンをクリックします。

リポジトリ全体の詳細なコード品質フィードバックの取得

GitHub Copilot コードレビューは pull request でコードをレビューし、フィードバックを提供します。リポジトリ全体の信頼性と保守容易性に関する実用的なフィードバックが必要な場合は、GitHub Code Quality を有効にします。「GitHubのコード品質について」を参照してください。

参考資料

        [AUTOTITLE](/copilot/how-tos/agents/copilot-code-review/using-copilot-code-review)

GitHub Copilot コード レビューについて

この記事で

GitHub Copilot コードレビューについて