Repository navigation
copilot code review settings_ja
リポジトリの Copilot 設定 API を使い、レビューの深さ、リポジトリのカスタム指示と MCP の使用、コメントの重大度フィルターを settings.copilotCodeReview で宣言的に管理します。レビューの自動依頼、push ごとの再レビュー、ドラフト PR のレビューは、既存の copilot_code_review ruleset で設定します。
| 種別 | Issue |
|---|---|
| 機能 | Issue #53 |
GitHub は Copilot code review 設定を管理する REST API と GraphQL API を追加しました。リポジトリ用 REST API では、レビューの深さ、リポジトリのカスタム指示と MCP server をレビューで使用するか、重大度フィルターを設定できます。このリポジトリ設定 API はレビューを調整するものであり、Copilot code review 自体を有効にするものではありません。レビューの自動依頼は ruleset で設定し、copilot_code_review ルールは review_on_push と review_draft_pull_requests を受け付けます。GitHub の告知と API リファレンスにも、利用できる設定とトークン要件が記載されています(changelog、API リファレンス、rules API リファレンス)。
クライアントが既に固定している REST API バージョンは 2026-03-10 です。このリポジトリでは、認証済み GitHub CLI トークンによる GET が 200 を返すことと、既存の planner が copilot_code_review ruleset を認識することを確認しました。実環境での PATCH と ruleset の適用は未実施です。
settings:
copilotCodeReview:
reviewEffort: balanced
customInstructionsEnabled: true
mcpEnabled: false
severityFilter: low-
設定形式。 任意の
settings.copilotCodeReviewにreviewEffort、customInstructionsEnabled、mcpEnabled、severityFilterを追加します。省略項目は管理対象外とし、boolean ポインターで明示的なfalseを保持します。reviewEffortは対象リポジトリのavailable_review_effortsに含まれる値、または継承を表すinheritを受け付けます。重大度の値はno_filter、low、low_and_mediumです。schemaVersionは1のままです。 -
API と収束。
/repos/{owner}/{repo}/copilot/code-review/settings用の型付き GET / PATCH を追加します。planは宣言項目と保存済みの設定値を比較します。取得に失敗した場合や要求したレビュー深度が利用できない場合はblockedにします。既存リポジトリへのapplyは設定を再取得し、宣言済みで差分がある項目だけを一つの PATCH にまとめます。差分がなければ PATCH を送りません。新規作成では宣言された設定を作成後に適用する計画を示し、既存の repository settings ステージで適用します。GitHub は PATCH 全体を検証してから反映します。権限エラーや値の検証エラーは呼び出し元に返して表示します。 -
レビュー深度の継承。 GET は
review_effort.configuredとeffectiveを返します。configured: nullは継承中、または保存値が現在利用できない状態を表します。inheritは観測可能な範囲で null と同じ状態として扱い、effectiveを固定値としてインポートしません。importは継承中または表現できないレビュー深度を省略し、診断を出します。import --intoは取得した設定値が null の場合、既存の宣言を維持します。 -
インポートエラー。 読み取れる値を
settings.copilotCodeReviewに変換します。レート制限以外の HTTP 403 または HTTP 404 の場合、新規importでは該当セクションを省略して診断を出します。認証失敗、レート制限、通信エラーでは import を失敗させます。成功した GET で得られるavailable_review_effortsを使い、明示された深さを更新計画の前に検証します。重大度フィルターが各リポジトリで設定可能かどうかは、GitHub の応答を判定の基準とします。 -
認証と README。 ローカルの
gh auth loginで使う OAuth トークンまたは classic PAT にはrepoスコープが必要で、ログインユーザーはリポジトリ管理者である必要があります。GitHub App と fine-grained PAT は GET にリポジトリのAdministration: read、PATCH にAdministration: writeが必要です。GitHub Actions の組み込みGITHUB_TOKENには workflow のpermissionsで必要なAdministration権限を付与できません。CI では読み取り用と適用用の権限を区別し、必要な権限を持つ GitHub App トークンまたは PAT を使います。英語版と日本語版の README にローカル CLI と CI の利用方法および権限要件を追記します。 - 対象範囲。 リポジトリ単位のレビュー設定と、リポジトリ ruleset による自動レビュー設定を対象にします。Enterprise・組織ポリシー、課金、最大レビュー深度、承認ポリシーは今回の repository settings 実装に含めません。Copilot code review の機能自体はこの設定 API では有効化されません。
- 設定型、意味検証、JSON Schema を追加し、REST のリクエスト・レスポンス型とクライアント操作を追加します。
- repository settings ステージに plan 比較と apply を追加し、import と宣言済み項目だけを更新する YAML / JSON refresh に接続します。
- 英語・日本語の設計書と README、関連する設定例を更新し、API クライアント、planner、importer、refresh のテストを追加します。
自動テストでは、API のパス、メソッド、バージョンヘッダー、PATCH body、設定済みと継承状態のレビュー深度、動的な選択肢の検証、明示的な false、項目ごとの差分、権限とサービスのエラー、apply 後の収束、import の診断、YAML・JSON の --into 更新を確認します。YAML と JSON の両方で設定を検証し、README の両言語にローカル gh と CI のトークン要件が書かれていることも確認します。自動テスト後、テスト用リポジトリで plan、apply、再 import、再 plan を実行し、GET で値を確認したうえで、2回目の plan にドリフトがないことを確認します。確認後は元の設定値に戻します。実機の書き込み検証は未実施です。