기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# GitHub에서 Amazon Q Developer로 코드 검토
<a name="github-code-reviews"></a>

**참고**  
Amazon Q Developer for GitHub는 평가판 릴리스 중이며 변경될 수 있습니다.

Amazon Q Developer는 GitHub 내에서 자동 코드 검토를 활성화합니다. 새 풀 요청을 생성하거나 닫힌 풀 요청을 다시 열면 Amazon Q Developer는 코드 검토를 자동으로 수행하고 코드 품질, 잠재적 문제 및 심각도가 높은 결과에 대한 피드백을 제공합니다. 각 검토에는 스레드 조사 결과가 포함된 코드 검토 요약이 포함됩니다. 또한 Amazon Q Developer는 식별된 문제에 대한 수정 사항을 생성하며, 이를 검토하고 풀 요청에 커밋하도록 선택할 수 있습니다. 풀 요청 설명에 `/q` 명령을 사용하여 코드 검토 결과와 관련하여 질문하고 상호 작용할 수 있습니다. 자동 코드 검토는 기존 풀 요청 내에서 이루어진 후속 커밋에 의해 트리거되지 않습니다.

**참고**  
Amazon Q Developer 콘솔의 코드 검토 기능 설정은 풀 요청이 생성되거나 다시 열릴 때 실행되는 자동 코드 검토를 제어합니다. 풀 요청 설명에서 `/q review` 슬래시 명령을 사용하여 코드 검토를 시작하는 것은이 설정의 영향을 받지 않습니다.

`/q review` 슬래시 명령을 사용하여 풀 요청 내에서 코드 검토를 시작할 수도 있습니다. 슬래시 명령을 새 풀 요청 주석에 추가할 수 있습니다. 그러면 주석 및 새 커밋을 포함하여 현재 상태에서 풀 요청에 대한 새 코드 검토가 시작됩니다. 자세한 내용은 [GitHub 풀 요청 내에서 코드 검토 시작](#github-code-reviews-in-pr) 단원을 참조하십시오.

Amazon Q Developer가 매월 제한된 수의 줄에 대해 코드 검토를 수행하도록 할 수 있습니다. AWS 계정에 Amazon Q Developer 앱 설치를 등록하여 언제든지 무료 사용량을 늘릴 수 있습니다. 자세한 내용은 [Amazon Q Developer 콘솔에서 사용 한도 증가 및 세부 정보 구성](github-register-app-install.md) 단원을 참조하십시오.

**참고**  
코드 검토 기능이 이전에 비활성화된 경우 [Amazon Q Developer 콘솔](https://us-east-1.console.aws.amazon.com/amazonq/developer/home#/github)에서 활성화해야 GitHub에서 레이블을 적용할 수 있습니다. 자세한 내용은 [GitHub에서 Amazon Q Developer의 기능 편집](github-configuration.md#github-edit-features) 단원을 참조하십시오.

## 사전 조건
<a name="github-code-reviews-prerequisites"></a>

Amazon Q Developer에서 코드 검토를 시작하려면 먼저 대상 GitHub 리포지토리에 대한 적절한 권한이 필요합니다. 지원되는 리포지토리 역할은 쓰기, 유지 관리 또는 관리자입니다. 읽기 또는 분류 역할이 있는 사용자와 역할이 없는 구성원은 Amazon Q Developer에서 코드 검토를 시작할 수 없습니다.

분류 역할이 있는 GitHub 사용자는 여전히 리포지토리에서 풀 요청을 검토할 수 있습니다. 역할에 관계없이 모든 사용자는 퍼블릭 리포지토리에서 풀 요청을 검토할 수 있습니다.

자세한 내용은 조직의 *GitHub 설명서*의 [리포지토리 역할](https://docs.github.com/en/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/repository-roles-for-an-organization#repository-roles-for-organizations) 및 [사전 정의된 조직 역할 정보](https://docs.github.com/en/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization#about-pre-defined-organization-roles)를 참조하세요.

## GitHub 풀 요청에 대한 코드 검토 시작
<a name="github-new-code-reviews-pr"></a>

새 풀 요청을 열거나 이전에 닫은 풀 요청을 다시 열면 Amazon Q Developer는 코드 검토를 자동으로 실행하고 코드 품질, 가능한 문제 및 중요한 결과에 대한 피드백을 제공합니다.

**코드 검토에 Amazon Q Developer를 사용하고 수정 사항을 적용하려면**

검토를 시작하기 전에 `project-root/.amazonq/rules` 디렉터리의 간단한 마크다운 파일에 사용자 지정 코딩 표준을 정의하여 코드 품질 검토를 사용자 지정할 수 있습니다. Amazon Q는 지침에 따라 전체 프로젝트에서 일관된 코드 품질을 보장합니다. 자세한 내용은 [서드 파티 플랫폼에서 Amazon Q Developer에 대한 프로젝트 규칙 생성](third-party-context-project-rules.md) 단원을 참조하십시오.

1. 필요한 경우 GitHub 자격 증명을 사용하여 [https://github.com/](https://github.com/) 계정에 로그인합니다.

1. GitHub 조직으로 이동한 다음 Amazon Q Developer에서 코드 검토를 수행할 리포지토리로 이동합니다.

1. 소스 코드 변경 사항에 대한 풀 요청을 새로 생성합니다. 자세한 내용은 *GitHub 설명서*의 [풀 요청 생성](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request)을 참조하세요.

   새 풀 요청을 생성하면 Amazon Q Developer는 코드 검토를 자동으로 시작하여 잠재적 문제를 찾습니다. Amazon Q Developer는 검토를 완료하면 코드 검토 요약을 제공합니다. 각 조사 결과는 풀 요청에 커밋할 수 있는 제안된 수정 사항과 함께 요약 아래에 스레드 주석으로 표시됩니다.

1. 에이전트에게 변경 사항을 구현하고 풀 요청의 소스 브랜치에서 직접 커밋을 생성하도록 요청합니다. 에이전트가 변경할 수 있도록 `/q`로 시작하고 그 다음에 자연어로 요청을 게시하여이 작업을 수행할 수 있습니다.

1. (선택 사항) 특정 조사 결과에 대해 질문합니다. 풀 요청 내에서 **설명 추가**로 이동하고 설명 텍스트 입력 필드에 `/q` 뒤에 질문(예: "`/q explain the importance of this finding`")을 입력합니다.

1. Amazon Q Developer에서 제안된 코드 변경 사항을 검토하고 **제안 커밋**을 선택한 다음 **변경 커밋**을 선택하여 풀 요청을 업데이트합니다.

1. 제안된 코드 수정 사항에 만족하는 경우 풀 요청을 병합하여 Amazon Q Developer에서 제안한 코드 변경 사항을 적용할 수 있습니다. 자세한 내용은 *GitHub 설명서*의 [풀 요청 병합](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/merging-a-pull-request)을 참조하세요.

## GitHub 풀 요청 내에서 코드 검토 시작
<a name="github-code-reviews-in-pr"></a>

Amazon Q Developer에서 새 풀 요청 또는 다시 열린 GitHub 풀 요청에 대해 자동 코드 검토를 수행한 후 `/q review` 슬래시 명령을 사용하여 추가 코드 검토를 시작하여 코드를 반복할 수 있습니다. 코드 검토는 전체 풀 요청의 차이에 대해 수행됩니다.

**참고**  
새 주석을 사용하여 풀 요청 내에서만 코드 검토를 시작할 수 있습니다. `/q review` 슬래시 명령은 기존 주석 스레드에서 작동하지 않습니다. `/q review` 슬래시 명령을 사용하여 코드 검토를 시작하는 것은 Amazon Q Developer 콘솔의 코드 검토 기능 설정의 영향을 받지 않습니다.

**풀 요청에서 코드 검토 시작을 사용하려면**

1. 필요한 경우 GitHub 자격 증명을 사용하여 [https://github.com/](https://github.com/) 계정에 로그인합니다.

1. GitHub 조직으로 이동한 다음 Amazon Q Developer에서 코드 검토를 수행할 풀 요청으로 이동합니다. 자세한 내용은 [풀 요청 정보](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests)를 참조하세요.

1. 풀 요청 내에서 **설명 추가**로 이동하고 설명 텍스트 입력 필드에 `/q review`를 입력합니다.

1. **설명**을 선택하여 코드 검토를 시작합니다.

   Amazon Q Developer가 풀 요청 코드 분석을 완료하는 데 몇 분 정도 걸릴 수 있습니다. Amazon Q Developer는 분석을 완료한 후 코드 검토 요약을 제공합니다. 각 조사 결과는 요약 아래에 스레드 주석으로 표시되며 풀 요청을 커밋하고 업데이트하도록 선택할 수 있는 제안된 변경 사항도 함께 표시됩니다.

1. (선택 사항) 특정 조사 결과에 대해 질문합니다. 풀 요청 내에서 **설명 추가**로 이동하고 설명 텍스트 입력 필드에 `/q` 뒤에 질문(예: "`/q explain the importance of this finding`")을 입력합니다.

1. 제안된 코드 수정 사항에 만족하는 경우 풀 요청을 병합하여 Amazon Q Developer에서 제안한 코드 변경 사항을 적용할 수 있습니다. 자세한 내용은 *GitHub 설명서*의 [풀 요청 병합](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/merging-a-pull-request)을 참조하세요.