# 풀 리퀘스트 수명 주기 전반에 걸쳐 GitHub Copilot 코드 검토를 사용하세요

초안 풀 리퀘스트부터 병합까지 Copilot code review용으로 반복 가능한 워크플로를 구축하세요.

## Introduction

Copilot code review 는 끌어오기 요청 워크플로의 일부로 사용할 때 가장 효과적입니다. 이 자습서에서는 수동 및 자동 검토 중에서 선택하고, 초안 끌어오기 요청 초기에 검토를 요청하고, 병합하기 전에 다시 검토를 트리거할 시기를 결정하는 방법을 보여 줍니다.

또한 사용자 지정, 스킬, MCP 서버 및 실행기 옵션을 언제 사용하여 Copilot의 검토를 필요에 맞게 조정할 수 있는지도 알아봅니다.

## 풀 리퀘스트 수명 주기 따라 작업하기

검토 모델을 선택하고 초안 및 활성 끌어오기 요청에 대한 초기 피드백을 설정합니다.

### 팀에 적합한 검토 모델 선택

Copilot code review 는 끌어오기 요청의 수명 주기에서 하나 이상의 지점에서 직접 또는 자동으로 트리거할 때 수동으로 실행할 수 있습니다. 수동 검토를 사용하면 Copilot code review가 정확히 언제 개입할지 제어할 수 있습니다. 자동 검토는 일관된 적용 범위를 보장하며, 오픈, 초안 또는 모든 새 푸시에서 트리거할지 여부를 선택할 수 있습니다.

| 모델 검토                                    | 적합한 대상                     | 이유                                       |
| ---------------------------------------- | -------------------------- | ---------------------------------------- |
| 수동 검토 요청                                 | 맥락 의존도가 높은 변경 또는 선택적 사용    | 다른 관점을 원하는 경우에만 트리거 Copilot 할 수 있습니다.    |
| 열려 있는 끌어오기 요청에 대한 자동 검토                  | 광범위하고 일관된 적용 범위를 원하는 팀     | 모든 끌어오기 요청은 개별 습관에 의존하지 않고 기준 피드백을 받습니다. |
| 초안 끌어오기 요청에 대한 자동 검토                     | 이전 피드백 루프를 원하는 팀           | 작성자는 사용자 검토가 시작되기 전에 문제를 해결할 수 있습니다.     |
| 새 푸시에 대한 자동 검토                           | 여러 차례 수정되는 빠르게 진행되는 풀 리퀘스트 |                                          |
| Copilot 풀 리퀘스트가 변경됨에 따라 주요 업데이트를 재평가합니다. |                            |                                          |

설정 단계는 [AUTOTITLE 및 AUTOTITLE](/ko/copilot/how-tos/use-copilot-agents/request-a-code-review/use-code-review) 을 참조 [하세요](/ko/copilot/how-tos/copilot-on-github/set-up-copilot/configure-automatic-review).

### Copilot code review 초안 끌어오기 요청 초기 사용

Copilot code review로 초안 풀 리퀘스트를 검토하면 팀에 검토를 요청하기 전에 코드를 초기에 신뢰성 있게 점검할 수 있습니다.

유용한 초안 워크플로는 다음과 같습니다.

1. 끌어오기 요청을 초안으로 엽니다.
2. Copilot code review 아래에서 \*\*\*\* 검토를 요청하거나 초안 끌어오기 요청에 대해 자동 검토를 사용하도록 설정합니다.
3. 정확성, 보안 및 명확한 유지 관리 가능성 문제와 같은 높은 신뢰도 피드백을 먼저 해결합니다.
4. 업데이트를 푸시하고 주요 주석이 해결되었는지 확인합니다.
5. 끌어오기 요청을 사용자 검토를 위한 준비로 표시합니다.

이 접근 방식은 팀이 이전에 발견되었을 수 있는 명백한 문제 대신 디자인 장단점 및 제품에 미치는 영향에 대해 더 많은 인적 검토 시간을 보내는 데 도움이 됩니다.

## 검토 품질 조정하기

다시 검토를 요청할 시기와 사용자 지정, 외부 컨텍스트 및 실행기에서 가치를 추가하는 위치를 결정하여 검토 품질을 개선합니다.

### 병합하기 전에 다시 검토 사용

상당한 변경 후 다시 검토하여 이전 피드백을 해결하는 동안 새로운 위험이 도입되었는지 확인합니다.

다음과 같은 경우 다시 검토 요청:

* 서비스 또는 패키지 경계를 넘어 여러 파일을 업데이트합니다.
* 보안에 민감하거나 데이터를 구분하는 동작을 변경합니다.
* 많은 제안된 변경 사항을 적용한 후 최종 검토를 원합니다.

활성 끌어오기 요청을 자주 업데이트하는 팀의 경우 새 푸시에 대한 자동 검토를 사용하면 피드백을 최신 상태로 유지하면서 수동 다시 검토 요청을 줄일 수 있습니다.

### 사용자 지정을 워크플로에 맞추세요

사용자 지정은 각 파일 형식이 워크플로에서 검토 결정 지점을 지원하는 경우에 가장 유용합니다.

* 대부분의 pull request에 적용되어야 하는 리포지토리 전반의 검토 기준에는 `.github/copilot-instructions.md`를 사용하세요.
* 코드베이스의 여러 부분에 서로 다른 표준이 있는 경우 에이전트별 및 경로별 지침에 사용합니다 `.github/instructions/**/*.instructions.md` .
* 의도적인 패턴, 아키텍처 경계 또는 우선 순위 검토와 같은 관련성을 향상시키는 리포지토리 컨텍스트를 제공하는 데 사용합니다 `AGENTS.md` .

이 파일들은 검토자가 풀 요청 중에 결정해야 할 사항에 집중되도록 하세요. 전체 엔지니어링 핸드북으로 전환하지 마십시오.

자세한 사용자 지정 메커니즘 및 예제는 [사용자 지정 지침을 사용하여 Copilot 코드 검토의 기능 잠금 해제](/ko/copilot/tutorials/customize-code-review)을 참조하세요.

### 특정 검토 목표를 위해 에이전트 기능과 MCP 서버 사용

에이전트 기술 및 MCP 서버는 팀이 조직별 컨텍스트에 따라 검토해야 하는 경우에 가장 유용합니다.

다시 사용할 수 있는 검토 루틴을 원하는 경우 에이전트 기술을 사용합니다. 예를 들면 다음과 같습니다.

* 마이그레이션 끌어오기 요청에 표준 검사 목록을 적용합니다.
* 모노레포에서 언어별 또는 프레임워크별 검토 패스 실행
* 권한 부여 또는 청구 논리와 같은 특정 위험 영역의 우선 순위를 지정합니다.

예를 들어 검토에서 끌어오기 요청 자체 외부의 컨텍스트를 참조해야 하는 경우 MCP 서버를 사용합니다.

* 끌어오기 요청 변경 내용을 문제, 인시던트 또는 서비스 소유권 데이터에 연결합니다.
* 내부 시스템에서 예상되는 롤아웃 또는 운영 컨텍스트를 확인합니다.
* 외부 설명서 원본에 대한 구현 세부 정보 유효성 검사

설치 세부 정보는 [AUTOTITLE 및 AUTOTITLE](/ko/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/add-skills) 을 참조 [하세요](/ko/copilot/how-tos/copilot-on-github/customize-copilot/configure-mcp-servers).

### 자체 호스팅 실행기가 필요한지 여부를 결정합니다

대부분의 경우 표준 GitHub호스팅 실행기만으로도 Copilot code review에 충분하며 별도의 설정이 필요하지 않습니다. 기본적으로 미리 구성되어 있습니다.

다음이 필요한 경우 자체 호스팅 러너 또는 더 큰 러너를 고려하세요:

* 더 무거운 검토 워크로드에 대한 성능 향상.
* 조직에서 요구하는 내부 시스템에 대한 네트워크 액세스.

Copilot code review가 더 심층적인 컨텍스트 수집 및 도구 호출과 같은 에이전트 작업에 GitHub Actions를 사용하기 때문에 러너가 필요합니다.
GitHub호스팅된 실행기를 사용할 수 없고 지원되는 자체 호스팅 옵션이 올바르게 구성되지 않은 경우, 리뷰는 더 제한적인 모드로 전환됩니다.

계획 및 설정 세부 정보는 [GitHub Copilot 코드 검토를 위한 러너 구성](/ko/copilot/how-tos/copilot-on-github/set-up-copilot/configure-runners)을 참조하세요.

## 시나리오별 권장 워크플로

| 팀 시나리오                 | 권장 워크플로                                                                                                                                             |
| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| 자주 끌어오기 요청이 있는 소규모 팀   | 모든 끌어오기 요청에 대해 자동 검토를 사용하도록 설정하고, 초기 피드백에 대한 초안을 검토하고, 변경 내용이 상당할 때 병합하기 전에 수동 다시 검토를 사용합니다.                                                        |
| 여러 기술 스택이 혼재된 대규모 모노레포 | 자동 검토를 사용하도록 설정하고 새 푸시를 검토하고, 각 주요 영역에 대한 경로별 지침을 추가하고, 반복되는 검토 패턴에 기술을 사용합니다.                                                                      |
| 보안에 민감하거나 규제된 코드베이스    | 초안 pull request 검토와 병합 전 필수 재검토를 사용하고, 리포지토리 전반의 보안 기준은 `.github/copilot-instructions.md`에 유지하며, GitHub 외부에 저장된 인시던트 또는 규정 준수 컨텍스트에는 MCP 서버를 사용하세요. |
| 내부 플랫폼 종속성이 있는 팀       | 자동 검토로 시작한 다음, 유용한 검토 피드백을 위해 내부 시스템 액세스가 필요한 경우에만 자체 호스팅 실행기 및 MCP 컨텍스트를 추가합니다.                                                                    |

## 다음 단계

* 검토 작업 및 에이전트 기능을 비롯한 광범위한 개념은 [GitHub Copilot 코드 검토 정보](/ko/copilot/concepts/agents/code-review)을 참조하세요.
* 특정 리포지토리에 대한 자동화된 검토 품질을 조정하려면 [를 사용하여 최적화된 검토 프로세스 빌드 Copilot](/ko/copilot/tutorials/optimize-code-reviews)을 참조하세요.
* 제외된 파일 형식 및 기타 제한은 [GitHub Copilot code review에서 제외된 파일](/ko/copilot/reference/review-excluded-files)을 참조하세요.