{"meta":{"title":"GitHub Copilotによるコードレビューについて","intro":"Copilot では、プル要求を確認し、問題を特定し、数回のクリックで適用できる修正プログラムを提案します。","product":"GitHub Copilot","breadcrumbs":[{"href":"/ja/copilot","title":"GitHub Copilot"},{"href":"/ja/copilot/concepts","title":"概念"},{"href":"/ja/copilot/concepts/agents","title":"展開"},{"href":"/ja/copilot/concepts/agents/code-review","title":"コード レビュー"}],"documentType":"article"},"body":"# GitHub Copilotによるコードレビューについて\n\nCopilot では、プル要求を確認し、問題を特定し、数回のクリックで適用できる修正プログラムを提案します。\n\n## はじめに\n\nCopilot code review は、任意の言語で記述されたコードをレビューし、フィードバックを提供します。 コードを複数の角度からレビューして問題を特定し、修正を提案します。 2 回のクリックで、推奨される変更を適用できます。\n\nこの記事では、 Copilot code reviewの概要について説明します。\nCopilotからコード レビューを要求する方法については、[GitHub Copilot を使ったコードレビュー](/ja/copilot/how-tos/use-copilot-agents/request-a-code-review/use-code-review) を参照してください。\n\n## 可用性\n\nCopilot code review は以下でサポートされています。\n\n* GitHub.com\n* GitHub CLI\n* GitHub Mobile\n* VS Code\n* Visual Studio\n* Xcode\n* JetBrains IDE\n* Azure DevOps (パブリック プレビュー)\n\n> \\[!NOTE]\n> 組織からCopilotを受け取った場合、組織はCopilot code reviewポリシー設定で\\*\\*\\*\\* オプションを有効にする必要があります。 これは、 GitHub.com または GitHub Mobileのレビューに適用されます。 「[組織内のGitHub Copilotのポリシーと機能の管理](/ja/copilot/how-tos/administer-copilot/manage-for-organization/manage-policies)」を参照してください。\n\n## Copilot code reviewCopilot ライセンスなし\n\n\\*\\*\nCopilot ライセンスを持たない\\*\\*組織のメンバーは、Copilot code reviewでGitHub.comを使用できます。 エンタープライズ管理者または組織の所有者が有効にする必要があります。 この機能は、 **Copilot Business** および **Copilot Enterprise** プランで組織が利用できます。\n\n### ライセンスのないユーザーのコード レビューを有効にする\n\nCopilot ライセンスを持たない組織メンバーがCopilot code reviewを使用できるようにするには、次の 2 つのポリシーを有効にする必要があります。\n\n1. \\*\\*\n AI credits有料使用量\\*\\*。 最初にこのポリシーを有効にします。 これにより、企業または組織は、 Copilot code reviewAI credits の使用に対して料金が発生します。\n2. \\*\\*\n Copilotライセンスを持たないメンバーがCopilot code reviewでGitHub.comを使用できるようにします\\*\\*。 このサブポリシーでは、ライセンスのないユーザーに対して Copilot code review を有効にします。\n\n2 番目のポリシーには、次の特性があります。\n\n* この機能は既定で無効になっています。\n* このポリシーがエンタープライズ レベルで設定されると、 **表示されますが、** 組織レベルでは編集できなくなります。\n* ポリシーは **最も制限が厳しい**。\n Copilot code review は、ポリシーを明示的に有効にした組織のリポジトリでのみ使用できます。\n\n### ライセンスを持たないユーザーに対する動作\n\n両方のポリシーが有効になっている場合、 Copilot ライセンスを持たないユーザーは、組織のリポジトリ内のプル要求に対して Copilot code review にレビューを要求できます。\n\n自動コード レビューが有効になっているリポジトリでは、 Copilot はすべてのプル要求を自動的に確認します。 これは、作成者が Copilot ライセンスを持っているかどうかにかかわらず発生します。 自動コード レビューを構成する方法の詳細については、 [Configuring code review by GitHub Copilot](/ja/copilot/how-tos/copilot-on-github/set-up-copilot/configure-automatic-review) を参照してください。\n\nCopilot code review ライセンスを持たないユーザーの場合は IDE では使用できません。\n\n## 除外されたファイル\n\n一部のファイルの種類は、 Copilot code reviewから除外されます。\n\n* 依存関係管理ファイル (package.json や Gemfile.lock など)\n* ログ ファイル\n* SVG ファイル\n\nこれらのファイルの種類をプル要求に含める場合、 Copilot code review はファイルを確認しません。\n\n詳しくは、「[GitHub Copilot code review から除外されたファイル](/ja/copilot/reference/review-excluded-files)」をご覧ください。\n\n## Copilot code review のエージェント機能\n\nCopilot code review はエージェント機能を利用して機能を拡張します。\n\n* **完全なプロジェクト コンテキストの収集**。 これにより、より具体的で正確で、コンテキストに応じたコード レビューが提供されます。 この機能は、リポジトリ全体を分析して、コード変更のコンテキストをより深く理解します。\n* **提案をCopilot cloud agentに渡す機能**。 これにより、推奨される修正が適用されたブランチに対する新しいプル要求の作成が自動化されます。\n Copilot cloud agentへの提案の受け渡しはパブリック プレビュー段階であり、変更される可能性があります。\n\nこれらの機能は、 Copilot code reviewを含むすべてのプランに対して自動的に有効になります。 ライト分析レベルとバランス分析レベルの選択については、この記事の後半の「 [作業レベルを確認](#review-effort-level) する」を参照してください。\n\nGitHub Actionsが使用できない場合、またはCopilot code reviewによって使用されるアクション ワークフローが失敗した場合でも、レビューが生成されます。 ただし、エージェント機能によって提供される追加機能は含まれません。\n\n### コード レビューでのエージェント機能のための GitHub Actions ランナーの使用\n\nCopilot code review では、 GitHub Actions を使用して、完全なプロジェクト コンテキストの収集や Copilot cloud agentへの提案の受け渡しなど、エージェント機能を実行します。 既定では、 Copilot code review は標準の GitHubホストランナーを使用します。 パフォーマンスを向上させるために、より大きな GitHubホストランナーにアップグレードしたり、セルフホステッド ランナーを使用したりすることもできます。\n\n> \\[!NOTE]\n> より大きな GitHubホストランナーの使用量は、分単位でより高いレートで課金されます。 セルフホステッド ランナーは、 GitHub Actions 分を消費しません。\n\nコード レビューでエージェント機能を使用するために、組織または企業で GitHub Actions を有効にする必要はありません。\n\n組織が GitHubホストランナーを無効にしている場合、エージェント機能は使用できません。 この場合、コード レビューは、より限定的なレビューにフォールバックします。 このような状況の組織では、セルフホステッド ランナーを使用できます。\n\nランナーの構成の詳細については、 [GitHub Copilot コード レビュー用のランナーの構成](/ja/copilot/how-tos/copilot-on-github/set-up-copilot/configure-runners) を参照してください。\n\nGitHub Actions の実行に関連する Copilot code review の記録を確認できます。 詳細については、[コードレビューに関するGitHub Actions議事録を](/ja/copilot/reference/copilot-billing/models-and-pricing#pricing-and-usage-cost-considerations-for-copilot-code-review)ご覧ください。\n\n## 作業レベルを確認する\n\nCopilot code review では、複数のレビュー作業レベルがサポートされているため、コードの重要度に一致する徹底度のレベルを選択できます。\n\n* **Lite**: 標準のレビュー。 バグ、セキュリティの脆弱性、スタイルの不整合 (既定) など、一般的な問題に関する迅速でターゲットを絞ったフィードバックを提供します。\n* **バランス**: 複雑なロジック、セキュリティに依存するコード、およびサービス間の変更のより長い分析のために、より高い推論モデルにプル要求をルーティングします。 バランスの取れたレビューは、より多くの AI creditsを使用し、ライトレビューよりもわずかに多くの GitHub Actions 分を消費する可能性があります。\n\nセキュリティに依存するコード、マルチサービスのプル要求、または厳密な品質基準を持つリポジトリには、Balanced を使用します。 完全な分析よりも高速なフィードバックが重要な日常的な変更には Lite を使用します。\n\nプル リクエストでレビューを依頼する際、Copilot がレビュー担当者として表示される **Reviewers** セクションで、レビューの作業レベルを選択できます。 組織の所有者は、組織内の自動コード レビューの既定のレビュー作業レベルを設定できます。 リポジトリ管理者は、特定のリポジトリの組織の既定値をオーバーライドできます。\n\nCopilot code review がプルリクエストをレビューすると、プルリクエストの概要コメントに各レビュー実行で使用された工数レベルが表示されます。\n\n### 消費予測\n\nレビューには通常、\"Lite\" effortで AI credits が約 0.05～1 米ドル相当、\"Balanced\" effortで AI credits が約 0.25～5 米ドル相当消費されます。\n\n一般に、プル要求のサイズとリポジトリのカスタム命令によって使用量が増加し、モデルの進化に合わせて範囲が変化する可能性があります。 これらの推定値には、GitHub Actions 分は含まれていません。\n\nリポジトリと組織の管理者は、自動コード レビューの既定のレビュー作業レベルを設定できます。 構成手順については、 [Configuring code review by GitHub Copilot](/ja/copilot/how-tos/copilot-on-github/set-up-copilot/configure-automatic-review#configuring-review-effort-level-for-an-organization) を参照してください。\n\n## コード レビューの使用状況\n\nCopilotが IDE でプル要求を確認したり、コードをレビューしたりするたびに、対話によってAI creditsが消費されます。 量は、使用されるモデルと処理されるトークンの数によって異なります。\n\nコード レビューには、モデルの相互作用の AI credits (レビュー自体) とエージェント機能 (コンテキストの収集とツールの使用) の GitHub Actions 分という 2 つのコスト コンポーネントがあります。\nGitHub Actionsの使用方法の詳細については、[コード レビューのエージェント機能のGitHub Actions ランナーの使用を](#usage-of-github-actions-runners-for-agentic-capabilities-in-code-review)参照してください。\n\nすべての新しいプル要求に対して Copilot からコード レビューを自動的に要求するようにリポジトリが構成されている場合、 AI credits の消費量は pull request 作成者に起因します。 レビューが別のユーザーによって手動でリクエストされた場合、その使用量は代わりにそのユーザーに計上されます。\n\nプル要求が GitHub Actions またはボットによって作成された場合、使用法は次に適用されます。\n\n* ワークフローをトリガーしたユーザー (そのユーザーを識別できる場合)。\n* 指定された請求管理者。\n\n### 予算に達するとどうなりますか\n\nCopilot BusinessとCopilot Enterpriseの場合、コード レビュー アクセスは予算コントロールによって管理されます。 ユーザーがユーザー レベルの予算に達した場合、またはエンタープライズまたはコスト センターの使用制限が使い果たされた場合、コード レビューは他の AI credits消費機能と共にブロックされます。 「[使用量ベースの課金の予算](/ja/copilot/concepts/billing/budgets-for-usage-based-billing#what-happens-when-a-user-is-blocked)」を参照してください。\n\n### Copilot を含む Copilot code review ライセンスやプランを持たないユーザー\n\nCopilot code reviewにアクセスできないユーザーには、AI creditsの毎月の許容量はありません。 これには、 Copilot ライセンスを持たないユーザーと、 Copilot Free プランのユーザー ( Copilot code reviewを含まない) が含まれます。\n\nこれらのユーザーに対して Copilot code review が有効になっている場合、使用するすべての AI credits は、有料の追加使用量として組織または企業に直接課金されます。 これは、手動で要求されたレビューと自動コード レビューの両方に適用されます。\n\nAI credits これらのユーザーが使用するリソースは、個々のユーザーの予算に起因しません。 課金レポートでは、追加の使用状況として表示されます。 コード レビューを含む Copilot ライセンスを持つユーザーは、管理者によって構成されたユーザー レベルの予算に従って、共有プールからの AI credits を使用します。\n\n## モデルの使用法\n\nCopilot code reviewは、入念に調整されたモデル、プロンプト、システム動作の組み合わせを使って、さまざまなコードベースについての一貫した高品質のフィードバックを提供する、専用の製品です。 モデルを変更すると、レビュー コメントの信頼性、ユーザー エクスペリエンス、品質が損なわれる可能性があるため、モデルの切り替えはサポートされていません。\n\n> \\[!NOTE]\n> Copilot code reviewは、organization の \\[Models] 設定ページで有効にされていないモデルを使う場合があります。 \\[モデル] 設定ページでは、Copilot Chat のみが制御されます。\n>\n> Copilot code review は一般公開されているため、すべてのモデルの使用は一般公開の条件に従います。 「[組織内のGitHub Copilotのポリシーと機能の管理](/ja/copilot/how-tos/administer-copilot/manage-for-organization/manage-policies)」をご覧ください。\n\n## コード レビューのための MCP サーバーとエージェント のスキル\n\nCopilot code review では、レビューに関連するリポジトリ レベルのエージェント スキルと MCP サーバーを使用できます。\n\nCopilot code review は、リポジトリまたは pull request が明確なシグナルを提供する場合にスキルと MCP コンテキストを使用する可能性が高くなります。これには、レビューに重点を置いたスキル ディレクトリ名、MCP コンテキストを参照するカスタム命令、問題キーやインシデント ID などの構成済みの MCP サーバーを参照する識別子を含むプル要求の説明が含まれます。\n\n### エージェントのスキル\n\nリポジトリにエージェント スキルが含まれている場合、 Copilot code review はプル要求を確認するときに関連するスキルを自動的に使用でき、組み込みの分析を超えて Copilot を拡張できます。\n\nプル要求を確認するときに、 Copilot は、ベース ブランチではなく、ヘッド ブランチ (変更したブランチ) からリポジトリのカスタム命令、エージェント命令、およびエージェント スキルを読み取ります。 たとえば、 `my-feature-branch` を `main`にマージする場合、 Copilot は `my-feature-branch`の命令とスキルを使用するため、同じプル要求で変更を最初にマージせずにテストできます。\n\nセットアップの詳細については、 [GitHub Copilot のスキルを追加する](/ja/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/add-skills) を参照してください。\n\n### MCP サーバー\n\nCopilot code review では、MCP サーバーを使用して、チームが使用するサードパーティのプラットフォームや内部システム (問題の追跡、ドキュメント、サービス カタログ、インシデント ツールなど) から直接レビューにコンテキストをプルできます。\n\nGitHub MCP サーバーと Playwright MCP サーバーは、既定で有効になっています。\n\nリポジトリ設定で MCP サーバーを構成できます。\nGitHubのリポジトリ MCP 構成は、Copilot cloud agentとCopilot code reviewの両方に適用されます。 リポジトリの MCP 設定に加えた変更は、両方の機能に影響します。 セットアップの詳細については、 [リポジトリの MCP サーバーを構成する](/ja/copilot/how-tos/copilot-on-github/customize-copilot/configure-mcp-servers) を参照してください。\n\nリポジトリの設定では、**プル リクエストのレビュー時に Copilot に MCP ツールの使用を許可する** が既定で有効になっています。\nCopilot cloud agentではなく、Copilot code reviewでのみ MCP サーバーを使用できるようにする場合は、この設定を無効にします。 詳細な手順については、 [リポジトリの MCP サーバーを構成する](/ja/copilot/how-tos/copilot-on-github/customize-copilot/configure-mcp-servers#disabling-mcp-tools-for-code-review) を参照してください。\n\n## Copilot コードレビューの検証\n\nCopilot は、プル要求内のすべての問題を検出する保証はありません。 時には間違いを犯すことがあります。\nCopilotのフィードバックは常に慎重に検証してください。 人間のレビューで Copilotのフィードバックを補足します。\n\n詳しくは、「[アプリケーション カード: GitHub Copilot エージェント](/ja/copilot/responsible-use/agents)」をご覧ください。\n\n## リポジトリに関する Copilotの知識を強化する\n\nリポジトリ内のコード、使用するツール、コーディングの標準とプラクティスについて知っている Copilot が多いほど、レビューの精度と有用性が高くなります。 リポジトリに関する Copilotの知識を 2 つの方法で強化できます。\n\n### カスタム手順\n\nこれらは、リポジトリに 1 つ以上のファイルとして書き込んで格納する、短い自然言語ステートメントです。\nGitHubの組織の所有者である場合は、組織の設定でカスタム手順を定義することもできます。 詳しくは、「[GitHub Copilotの応答をカスタマイズする方法](/ja/copilot/concepts/prompting/response-customization?tool=webui#about-repository-custom-instructions)」をご覧ください。\n\n### カスタム命令、AGENTS.md、スキルの選択\n\nCopilot code review では、複数のカスタマイズ方法を利用でき、それぞれ目的が異なります。\n`.github/copilot-instructions.md`に固有のリポジトリ全体のルールにはCopilotを使用し、特定のファイルまたはディレクトリにのみ適用されるルールには`*.instructions.md`のパス固有の`.github/instructions/` ファイルを使用し、AI ツールとエージェント間で共有する永続的なルールには`AGENTS.md`を使用し、必要に応じて実行Copilotタスク固有のワークフローのスキルを使用します。 次の表は、それぞれを使用するタイミングとルールを提供する方法をまとめたものです。\n\n| Use | `copilot-instructions.md` | パス固有の `*.instructions.md` | `AGENTS.md` | Skills |\n| ------------------------------------------------- | -------------------------------------- | ------------------------------------------- | ----------------------- | -------------------------------------------------- |\n| 最適な用途 | | | | |\n| Copilot のリポジトリ全体に適用される常時有効ルール | 特定のパス、ファイルの種類、またはディレクトリの Always On ルール | AI エージェント間で共有される常時有効ルール | タスク固有のレビュー ワークフロー | |\n| 格納先 | `.github/copilot-instructions.md` | `.github/instructions/**/*.instructions.md` | リポジトリ ルート (`AGENTS.md`) | `.github/skills/...` |\n| 例 | コーディング標準、アーキテクチャの既定値、テストの期待 | | | |\n| `content/**` 書き込み規則、 `src/**` コーディング規則、言語固有のガイダンス | それ以降に適用する必要がある共有リポジトリ規則 Copilot | レビュー、リリース、移行、分析 | | |\n| アクティベーション | 自動 | 変更されたファイルが命令スコープと一致する場合の自動 | 自動 (リポジトリ ルートからの読み取り) | 該当する場合（例：`code-review` などのレビュー重視のスキル）は自動、または必要に応じて |\n| Scope | リポジトリ全体および Copilot固有 | リポジトリのサブパスとCopilot固有 | ツール横断 / エージェントに依存しない | タスクごとに呼び出される |\n| ルール | | | | |\n| Copilot、このリポジトリについては、これを常に把握しておく | | | | |\n| Copilot、これらのパスで作業する際は、この点を常に理解しておいてください | \"任意のエージェント、常にこれを知っている\" | \"必要なときにこれを行う\" | | |\n\n詳細については、「[GitHub Copilot のスキルを追加する](/ja/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/add-skills)」および「[GitHub Copilot用のリポジトリカスタム命令の追加](/ja/copilot/how-tos/copilot-on-github/customize-copilot/add-custom-instructions/add-repository-instructions)」を参照してください。\n\n### Copilot Memory (パブリック プレビュー)\n\nCopilot Pro、Copilot Pro+、またはCopilot Maxプランがある場合は、Copilot Memoryを有効にすることができます。 これにより、 Copilot はリポジトリについて学習した有用な詳細を格納できます。\nCopilot は、そのリポジトリ内のプル要求を確認するときに、この情報を使用できます。 詳しくは、「[GitHub Copilot Memory について](/ja/copilot/concepts/agents/copilot-memory)」をご覧ください。\n\n## プル リクエストの自動レビューについて\n\n既定では、 Copilot は pull request に割り当てた場合にのみ pull request を確認します。 ただし、自動レビューは構成できます。\n\n* \\*\\*\\*\\*またはCopilot ProプランのCopilot Pro+は、作成したすべてのプル要求を自動的に確認するようにCopilotを構成できます。\n* **リポジトリ所有者**は、Copilotへのアクセス権を持つユーザーによって作成されたリポジトリ内のすべてのプル要求を自動的に確認するようにCopilotを構成できます。\n* **組織の所有者**は、プル要求がCopilotユーザーによって作成された組織内のリポジトリの一部または全部のすべてのプル要求を自動的に確認するようにCopilotを構成できます。\n\n組織がCopilotライセンスなしでCopilot code reviewを有効にしている場合は、ライセンスのない組織メンバーによって作成された pull request にも自動レビューが適用されます。 これは、自動レビューが有効になっているポリシーの対象となるリポジトリに適用されます。 詳細については、[Copilot ライセンスなしでの Copilot code review](#copilot-code-review-without-a-copilot-license)を参照してください。\n\n### プル リクエスト自動レビューをトリガーする\n\n自動コード レビューのトリガーは、構成設定によって異なります。\n\n* 基本設定:\n * \"Open\" プル リクエストとしてプル リクエストを作成する場合。\n * 初めて \"Draft\" pull request を \"Open\" に切り替えます。\n* 新しいプッシュを確認します。\n * 新しいコミットをプル リクエストにプッシュするたび。\n* 下書きの pull request を確認します。\n * \"Open\" に切り替える前に、プルリクエストは下書きの段階で自動的にレビューされます。\n\n完全な手順については、 [Configuring code review by GitHub Copilot](/ja/copilot/how-tos/copilot-on-github/set-up-copilot/configure-automatic-review) を参照してください。\n\n> \\[!NOTE]\n> プル要求への各プッシュを確認するように Copilot が構成されていない限り、pull request は 1 回だけ確認されます。 自動的にレビューされたプルリクエストに変更を加えた後で、Copilot に再レビューを依頼したい場合は、手動で要求できます。 \\[] メニューのCopilotの名前の横にある \\[\\*\\*\\*\\*] ボタンをクリックします。\n\n## リポジトリ全体でコード品質に関する詳細なフィードバックを取得する\n\nGitHub Copilot code review では、プル要求の変更を確認し、修正を提案します。 コードの信頼性と保守容易性に関する体系的なフィードバックを追加するには、pull request と既定のブランチ全体で、 GitHub Code Qualityを有効にします。\n\nGitHub Code Quality は、次を追加して Copilot code review を補完します。\n\n* プル リクエストと既定のブランチ上での**ルールベースのCodeQL分析**。\n* プル要求**のテスト カバレッジ メトリック**。そのため、変更によってカバレッジが維持または縮小されるかどうかを確認できます。\n* **ワンクリックで行えるCopilotを活用した修正**。これには、修正対応をCopilot cloud agentに委任することも含まれます。\n* **オプションのマージ ゲーティング**をルールセットで使用すると、未解決のルールベースの検出結果があるプル リクエストや、カバレッジしきい値を満たしていないプル リクエストがマージされないようにできます。\n\n詳しくは、「[GitHub のコード品質](/ja/code-security/concepts/code-quality/code-quality)」をご覧ください。\n\n## 参考資料\n\n* [GitHub Copilot を使ったコードレビュー](/ja/copilot/how-tos/use-copilot-agents/request-a-code-review/use-code-review)"}