GitHub 코필로트 코드 검토 정보

Copilot에서 풀 요청을 검토하는 방법을 알아봅니다.

이 기사에서

서문

Copilot 코드 검토는 모든 언어로 작성된 코드를 검토하고 피드백을 제공합니다. 여러 각도에서 코드를 검토하여 문제를 식별하고 수정 사항을 제안합니다. 몇 번의 클릭으로 제안된 변경 내용을 적용할 수 있습니다.

본 문서에서는 Copilot 코드 검토의 개요를 제공합니다. Copilot에서 코드 검토를 요청하는 방법을 알아보려면 GitHub Copilot 코드 검토 사용을 참조하세요.

가용성

Copilot 코드 검토는 다음 환경에서 지원합니다.

  • GitHub.com
  • GitHub Mobile
  • VS Code
  • 자료 변수.product.prodname_vs %}
  • Xcode
  • JetBrains IDE

Copilot 코드 검토는 다음 플랜에서 사용할 수 있는 프리미엄 기능입니다.

  • Copilot Pro
  • Copilot Pro+
  • 코파일럿 사업
  • Copilot Enterprise

Copilot 플랜을 확인하세요.

조직에서 Copilot를 수신하는 경우, 조직은 Copilot 정책 설정 내에서 Copilot 코드 검토 옵션을 활성화해야 합니다. GitHub.com 또는 GitHub Mobile에 관한 검토에 적용됩니다. 조직에서 GitHub Copilot에 대한 정책 및 기능 관리을(를) 참조하세요.

Copilot 라이선스 미포함 Copilot 코드 검토

          **Copilot 라이선스가 없는** 조직 구성원은 GitHub.com에 Copilot 코드 검토를 사용할 수 있습니다. 엔터프라이즈 관리자 또는 조직 소유자가 사용하도록 설정해야 합니다. 이 기능은 **코파일럿 사업** 및 **Copilot Enterprise** 플랜을 사용하는 조직에서 사용할 수 있습니다.

라이선스가 없는 사용자를 위한 코드 검토 활성화

Copilot 라이선스가 없는 조직 구성원이 Copilot 코드 검토를 사용하도록 허용하기 위해서는 다음 두 가지 정책을 활성화해야 합니다.

  1.        **프리미엄 요청의 유료 사용량**입니다. 먼저 이 정책을 사용하도록 설정합니다. 이를 통해 엔터프라이즈 또는 조직에서 Copilot 코드 검토 프리미엄 요청 사용량에 대한 요금이 부과됩니다.

  2.        **Copilot 라이선스가 없는 구성원이 GitHub.com에서 Copilot 코드 검토를 사용하도록 허용합니다**. 이러한 하위정책은 라이선스가 없는 사용자를 위해 Copilot 코드 검토를 활성화합니다.

두 번째 정책에는 다음과 같은 특징이 있습니다.

  • 기본적으로 사용하지 않도록 설정되어 있습니다.
  • 이 정책이 엔터프라이즈 수준에서 설정되면 표시되지만 조직 수준에서는 편집할 수 없게 됩니다.
  • 정책이 가장 제한적입니다. Copilot 코드 검토는 정책을 명시적으로 활성화한 리포지토리에서만 사용할 수 있습니다.

라이선스가 없는 사용자에 대해 작동하는 방식

두 정책을 모두 활성화하면 Copilot 라이선스가 없는 사용자는 조직 리포지토리의 풀 요청에 대해 Copilot 코드 검토로부터 검토를 요청할 수 있습니다.

자동 코드 검토를 사용하는 리포지토리에서 Copilot은(는) 모든 끌어오기 요청을 자동으로 검토합니다. 작성자에게 Copilot 라이선스가 있는지 여부에 관계없이 이 현상은 발생합니다.

라이선스가 없는 사용자는 Copilot 코드 검토을(를) IDE에서 사용할 수 없습니다.

제외된 파일

일부 파일 유형은 Copilot 코드 검토에서 제외됩니다.

  • package.json 및 Gemfile.lock과 같은 종속성 관리 파일
  • 로그 파일
  • SVG 파일

이러한 파일 형식을 풀 요청에 포함하면 Copilot 코드 검토가 파일을 검토하지 않습니다.

자세한 내용은 GitHub Copilot 코드 검토에서 제외된 파일을(를) 참조하세요.

Copilot 코드 검토의 도구

참고

          [AUTOTITLE](/free-pro-team@latest/site-policy/github-terms/github-pre-release-license-terms) 미리 보기 기능 사용에 적용됩니다.
  • Copilot 코드 검토에는 몇 가지 새로운 도구가 공개 미리 보기에 포함되어 있으며, 이는 변경될 수 있습니다.

Copilot 코드 검토는 프로젝트 전체의 컨텍스트를 파악하여 더욱 정확하고 맥락에 부합하는 구체적인 코드 검토를 제공합니다. 이 기능은 전체 리포지토리를 분석하여 코드 변경의 컨텍스트를 더 잘 이해합니다. 전체 프로젝트 컨텍스트 수집 기능은 Copilot Pro 또는 Copilot Pro+ 플랜에서 일반적으로 제공되며 자동으로 활성화됩니다.

Copilot 코드 검토에는 공개 미리 보기 단계에 있는 새로운 도구들이 추가로 포함되어 있습니다.

  •         **CodeQL, ESLint 및 PMD와 같은 정적 분석 도구 지원하기** 이렇게 하면 보안 및 품질에 대한 더 높은 신호와 일관된 결과를 제공합니다.

  •         **Copilot 코딩 도우미에 제안을 전달하는 기능**. 이렇게 하면 제안된 수정 사항이 적용된 분기에 대한 새 끌어오기 요청 생성이 자동화됩니다.

Copilot Pro 또는 Copilot Pro+ 플랜을 사용하면 이러한 도구가 자동으로 활성화됩니다.

조직에서 Copilot 구독을 받는 경우, 귀하의 조직 또는 엔터프라이즈 소유자가 미리보기 기능을 이용해 활성화한 경우에 한하여 GitHub 웹사이트에서 공개 미리 보기에 참여할 수 있습니다. 조직에서 GitHub Copilot에 대한 정책 및 기능 관리 및 기업에서 GitHub Copilot에 대한 정책 및 기능 관리 참조하세요.

Copilot 코드 검토의 도구를 사용하기 위해 조직이나 기업에서 code scanning 및 GitHub Actions를 활성화할 필요가 없습니다.

GitHub Actions을 사용할 수 없거나 Copilot 코드 검토에서 사용하는 작업 워크플로우가 실패하더라도 여전히 검토가 생성됩니다. 그러나 Copilot 코드 검토의 도구에서 제공하는 추가 기능은 포함되어 있지 않습니다.

참고

공개 미리 보기는 새로운 Copilot 코드 검토의 도구에 대한 무료 이용 시간을 포함합니다.

코드 검토 과정에서 GitHub Actions 실행기를 도구로 활용하기

Copilot 코드 검토는 GitHub Actions을 이용하여 Copilot 코드 검토의 도구를 실행하며, 전체 프로젝트 컨텍스트 수집 및 공개 미리 보기의 추가 도구도 포함합니다. 기본 설정으로 Copilot 코드 검토는 GitHub에서 호스팅된 실행기를 사용합니다.

조직에서 GitHub호스티드 실행기가 비활성화된 경우, 새 Copilot 코드 검토의 도구을(를) 사용할 수 없습니다. 이 경우 코드 검토는 더 제한된 검토로 대체됩니다.

이 상황에서 조직은 자체 호스팅 실행기를 사용할 수 있습니다. 자세한 내용은 GitHub Copilot 코드 검토를 위해 자체 호스팅 러너 구성을(를) 참조하세요.

코드 검토 월별 할당량

Copilot가 풀 요청을 검토하거나 IDE에서 코드를 검토할 때마다 Copilot 프리미엄 요청의 월별 할당량이 1씩 감소합니다.

모든 새 끌어오기 요청에 대해 Copilot에서 코드 검토를 자동으로 요청하도록 리포지토리가 구성된 경우 프리미엄 요청 사용량이 끌어오기 요청 작성자의 할당량에 적용됩니다.

GitHub Actions 또는 봇이 풀 요청을 생성하는 경우, 사용 정책이 다음에 적용됩니다.

  • 해당 사용자를 식별할 수 있는 경우 워크플로를 트리거한 사용자입니다.
  • 지정된 청구서 소유자입니다.

할당량에 도달하면 어떻게 되나요?

월별 할당량에 도달하면 할당량이 재설정될 때까지 Copilot에서 코드 검토를 받을 수 없습니다. 할당량이 리셋되기 전에 계속 코드 검토를 사용하려면 Copilot 플랜을 업그레이드하거나 추가 프리미엄 요청을 활성화해야 합니다.

Copilot 라이선스가 없는 사용자에 대한 할당량

Copilot 라이선스가 없는 사용자는 월별 프리미엄 요청 할당량이 없습니다. 이러한 사용자에 대해 Copilot 코드 검토을(를) 사용하도록 설정하면 생성하는 프리미엄 요청은 유료 초과분 사용량으로 조직 또는 기업에 직접 청구됩니다. 이는 수동으로 요청된 검토 및 자동 코드 검토 모두에 적용됩니다.

라이선스가 없는 사용자가 생성한 프리미엄 요청은 Copilot 계획 할당량에 기인하지 않습니다. 청구 보고서 및 프리미엄 요청 분석에서 초과분 사용량으로 표시됩니다. Copilot 라이선스가 있는 사용자는 할당된 플랜 할당량에서 프리미엄 요청을 계속 사용합니다.

모델 사용

Copilot 코드 검토는 다양한 codebases에서 일관되고 고품질의 피드백을 제공하기 위해 신중하게 조정된 모델, 프롬프트, 시스템 동작을 조합하여 설계된 특수 목적의 제품입니다. 모델 전환은 지원되지 않습니다. 모델을 변경하면 신뢰성, 사용자 환경, 검토 메모의 품질이 저하될 수 있습니다.

데이터 재사용 가능.코파일럿.ccr-모델-설정 %}

Copilot 코드 검토 유효성 검사

Copilot은 풀 요청에서 모든 문제 또는 문제 항목을 발견하도록 보장되지 않습니다. 때로는 실수를 할 것입니다. 항상 Copilot의 피드백을 신중하게 유효성 검사하세요. 사용자 검토를 통해 Copilot의 피드백을 보완합니다.

자세한 내용은 GitHub Copilot 코드 리뷰의 책임 있는 사용 참조하세요.

Copilot의 리포지토리 지식 향상시키기

Copilot에서 리포지토리의 코드, 사용하는 도구 및 코딩 표준과 관행에 대해 많이 알수록 검토가 정확하고 유용해집니다. 리포지토리에 대한 Copilot의 지식을 향상시키는 방법은 두 가지가 있습니다.

사용자 지정 지침

이러한 문은 리포지토리에 하나 이상의 파일로 작성하고 저장하는 간단한 자연어 문입니다. GitHub에서 조직의 소유자인 경우 조직의 설정에서 사용자 지정 지침을 정의할 수도 있습니다. 자세한 내용은 GitHub Copilot 응답을 사용자 지정하는 방법에 대한 정보을(를) 참조하세요.

Copilot 메모리 (공개 미리 보기)

Copilot Pro 또는 Copilot Pro+ 플랜이 있다면, Copilot 메모리를 사용하도록 설정할 수 있습니다. 이 기능을 통해 Copilot가 리포지토리에 대해 학습한 유용한 세부 정보를 저장할 수 있습니다. Copilot는 해당 리포지토리에서 풀 요청을 검토 시 이 정보를 사용할 수 있습니다. 자세한 내용은 GitHub Copilot의 주체적 기억에 관한 정보을(를) 참조하세요.

자동 풀 요청 검토에 대한 정보

기본적으로 풀 요청에 할당하는 경우에만 Copilot는 풀 요청을 검토합니다. 그러나 자동 검토를 구성할 수 있습니다.

  •           Copilot Pro 또는 Copilot Pro+ 플랜을 사용 중인 **개인 사용자**는 그들이 생성한 모든 풀 요청을 자동으로 검토하도록 Copilot를 구성할 수 있습니다.

  •           **리포지토리 소유자**는 Copilot에 액세스를 가진 사용자가 리포지토리에 생성한 모든 풀 요청을 자동으로 검토하도록 Copilot를 구성할 수 있습니다.

  •         **조직 소유자는** Copilot 사용자가 풀 요청을 생성한 조직 내 모든 리포지토리에서 모든 풀 요청을 자동으로 검토하도록 Copilot를 구성할 수 있습니다.

자동 풀 요청 검토 트리거하기

자동 코드 검토를 위한 트리거는 구성 설정에 따라 달라집니다.

  • 기본 설정:
    • 풀 요청을 "Open" 풀 요청으로 생성할 때.
    • "초안" 끌어오기 요청을 처음으로 "열기"로 전환합니다.
  • 새로 푸시된 내용을 검토합니다.
    • 끌어오기 요청에 새 커밋을 푸시할 때마다
  • 초안 끌어오기 요청 검토:
    • 끌어오기 요청은 아직 초안 상태일 때 자동으로 검토되며, "Open" 상태로 전환하기 전에 이루어집니다.

전체 지침은 GitHub Copilot에서 자동 코드 검토 구성을 참조하세요.

참고

Copilot이(가) 끌어오기 요청에 대한 각 푸시를 검토하도록 구성되지 않은 경우 끌어오기 요청은 한 번만 검토합니다. 풀 요청이 자동으로 검토되고 풀 요청을 변경하고, Copilot에서 그것을 재검토하도록 원하는 경우, 수동으로 요청할 수 있습니다. 검토자 메뉴의 Copilot 이름 옆에 버튼을 클릭합니다.

전체 리포지토리에 대한 자세한 코드 품질 피드백 가져오기

GitHub Copilot 코드 검토 끌어오기 요청에서 코드를 검토하고 피드백을 제공합니다. 전체 리포지토리의 안정성 및 유지 관리에 대한 실행 가능한 피드백을 원하는 경우 GitHub Code Quality를 사용하도록 설정합니다. GitHub 코드 품질 정보을(를) 참조하세요.

추가 참고 자료

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