개요
코드 리뷰는 pull request, 코드 변경 사항, 리뷰에서 발견된 문제, 댓글, 검사 결과를 한곳에 모아 보여줍니다. 다른 사람의 변경 사항을 리뷰하거나, 자신의 pull request에 달린 피드백을 확인하거나, 답변하기 전에 Codex에 변경 사항을 설명해 달라고 요청할 수 있습니다.
코드 리뷰 플러그인은 데스크톱과 웹에서 리뷰를 지원합니다. GitLab 병합 요청 리뷰는 프리뷰로 제공됩니다. GitLab 클라우드 코드 리뷰는 제공되지 않습니다.
시작하기 전에
리뷰하려는 pull request에 접근할 수 있는 리포지터리 계정을 사용하세요. 읽거나 변경할 수 있는 범위는 리포지터리 권한에 따라 결정됩니다.
관리형 워크스페이스에서는 코드 리뷰 플러그인과 필요한 앱 연결을 사용할 수 있는 권한이 있어야 합니다. 플러그인을 설치해도 리포지터리 접근 권한이 부여되지는 않습니다.
플러그인 설정과 워크스페이스 관리 기능은 ChatGPT와 Codex의 플러그인을 참고하세요.
pull request 찾기
코드 리뷰를 열어 직접 작성했거나 리뷰를 요청받은 pull request를 찾으세요. 검색과 필터로 목록을 좁힌 다음 pull request를 선택하세요.
리포지터리, 제목, 작성자, 브랜치를 확인해 리뷰하려던 변경 사항이 맞는지 확인하세요. 설명에는 작성자의 목적이 담겨 있고, diff에는 변경된 코드가 표시됩니다.
변경 사항 리뷰하기
pull request의 설명과 요약을 읽어보세요.
diff에서 변경된 파일과 관련 코드 줄을 살펴보세요.
리뷰에서 발견된 문제와 기존 댓글을 검토하세요.
테스트 결과, 검사 결과, 해결되지 않은 병합 충돌을 확인하세요.
추가 확인이 필요한 사항은 Codex에 질문하세요.
자동으로 생성된 리뷰 결과를 신뢰하기 전에 관련 코드와 대조해 검토하세요.
Codex에 pull request에 관해 질문하기
pull request의 대화에서 변경 사항에 관해 질문하거나 리뷰에서 발견된 문제를 자세히 살펴보세요. 중점적으로 확인하려는 동작이나 리뷰 기준을 함께 알려주세요. 예시:
“Explain how this change affects sign-in.”
“Check whether the new error path releases the database connection.”
“Show me the code that supports this finding.”
“Compare this revision with the review feedback and identify anything still unresolved.”
Codex에 수정안을 준비해 달라고 요청할 수도 있습니다. 원하는 변경 사항과 변경 범위의 제한을 설명한 다음, 생성된 diff와 테스트 결과를 살펴보세요.
예시: “Address the error-handling finding. Keep the change limited to this function and add a test for the failing case.”
댓글을 제출하거나, 변경 사항을 커밋하거나, 병합하기 전에 결과를 검토하세요.
GitLab 병합 요청 리뷰하기
GitLab 프리뷰를 통해 코드 리뷰에서 병합 요청을 확인할 수 있습니다. 변경 사항을 살펴보고 Codex의 도움을 받아 리뷰 피드백을 이해하고 반영할 수 있습니다.
리뷰하려는 계정과 프로젝트에 맞는 GitLab 연결을 사용하세요. 연결 옵션과 리포지터리 권한은 ChatGPT와 Codex에 GitLab 연결하기를 참고하세요.
앱 내 프리뷰에는 GitLab 클라우드 코드 리뷰가 포함되지 않습니다. GitLab을 연결하거나 코드 리뷰에 병합 요청이 표시된다고 해서 해당 리포지터리의 자동 클라우드 리뷰가 활성화되는 것은 아닙니다.
자주 묻는 질문
pull request를 만들기 전에 로컬 변경 사항을 리뷰할 수 있나요?
네. Codex에 로컬 변경 사항을 리뷰해 달라고 요청할 수 있습니다. 로컬 리뷰 옵션은 코드 리뷰 가이드를 참고하세요.
이번 업데이트로 기존 클라우드 리뷰가 새 클라우드 환경으로 이전되나요?
아니요. 이번 업데이트는 기존 클라우드 코드 리뷰를 새 클라우드 환경으로 이전하지 않습니다.