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

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

이 기사에서

Introduction

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

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

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

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

팀에 적합한 검토 모델 선택

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

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

설정 단계는 AUTOTITLE 및 AUTOTITLE 을 참조 하세요.

Copilot 코드 검토 초안 끌어오기 요청 초기 사용

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

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

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

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

검토 품질 조정하기

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

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

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

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

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

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

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

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

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

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

자세한 사용자 지정 메커니즘 및 예제는 사용자 지정 지침을 사용하여 Copilot 코드 검토의 기능 잠금 해제을 참조하세요.

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

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

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

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

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

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

설치 세부 정보는 AUTOTITLE 및 AUTOTITLE 을 참조 하세요.

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

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

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

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

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

계획 및 설정 세부 정보는 GitHub Copilot 코드 검토를 위한 러너 구성을 참조하세요.

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

다음 단계