표시되는 변경 내용

Source URL: https://developers.openai.com/codex/app/review

리뷰

리뷰 창은 Codex가 변경한 내용을 파악하고, 구체적인 피드백을 주며, 유지할 항목을 결정하는 데 도움을 줍니다.

이 기능은 Git 리포지토리 안에 있는 프로젝트에서만 작동합니다. 아직 Git 리포지토리가 아니라면 리뷰 창이 리포지토리를 생성하라고 안내합니다.

표시되는 변경 내용

리뷰 창은 Codex가 편집한 내용뿐만 아니라 Git 리포지토리의 상태를 반영합니다. 즉 다음을 보여줍니다:

• Codex가 만든 변경 사항
• 사용자가 직접 만든 변경 사항
• 리포지토리 내 다른 모든 커밋되지 않은 변경 사항

기본적으로 리뷰 창은 커밋되지 않은 변경 사항에 초점을 맞춥니다. 범위를 다음으로 전환할 수도 있습니다:

• 모든 브랜치 변경 사항 (기준 브랜치와의 diff)
• 마지막 턴 변경 사항 (가장 최근 어시스턴트 턴만)

로컬에서 작업 중이라면 스테이징되지 않은 변경 사항과 스테이징된 변경 사항 사이를 전환할 수도 있습니다.

리뷰 창 탐색

• 파일 이름을 클릭하면 일반적으로 선택한 편집기에서 해당 파일이 열립니다. 기본 편집기는 설정에서 선택할 수 있습니다.
• 파일 이름 배경을 클릭하면 diff가 확장되거나 축소됩니다.
• Cmd를 누른 상태에서 한 줄을 클릭하면 그 줄이 선택한 편집기에서 열립니다.
• 변경 내용이 만족스럽다면 변경 사항을 스테이지하거나 원치 않는 변경을 되돌릴 수 있습니다.

피드백을 위한 인라인 댓글

인라인 댓글은 diff의 특정 줄에 직접 피드백을 달 수 있게 해줍니다. 이는 Codex가 정확한 수정을 하도록 안내하는 가장 빠른 방법인 경우가 많습니다.

인라인 댓글을 남기려면:

1. 리뷰 창을 엽니다.
2. 댓글을 달고 싶은 줄에 마우스를 가져갑니다.
3. 나타나는 + 버튼을 클릭합니다.
4. 피드백을 작성하고 제출합니다.
5. 모든 피드백을 마친 뒤에는 스레드에 메시지를 다시 보냅니다.

댓글이 줄에 고정되므로 Codex는 일반적인 지시보다 더 정확하게 응답할 수 있습니다.

인라인 댓글은 리뷰 안내로 취급됩니다. 댓글을 남긴 뒤에는 “인라인 댓글을 처리하고 범위를 최소화해 주세요”처럼 의도를 명확히 하는 후속 메시지를 보내세요.

코드 리뷰 결과

/review를 사용해 코드 리뷰를 실행하면, 댓글이 리뷰 창에 바로 인라인으로 표시됩니다.

파일 스테이징 및 되돌리기

리뷰 창에는 커밋 전에 diff를 조정할 수 있도록 Git 작업이 포함되어 있습니다.

다음 단위로 변경 사항을 스테이지하거나 언스테이지하거나 되돌릴 수 있습니다:

• 전체 diff: 리뷰 헤더의 작업 버튼(예: “모두 스테이지” 또는 “모두 되돌리기”) 사용
• 파일별: 개별 파일을 스테이지, 언스테이지 또는 되돌리기
• 허크별: 단일 허크를 스테이지, 언스테이지 또는 되돌리기

작업의 일부만 수용하고 싶을 때는 스테이징을, 버리고 싶을 때는 되돌리기를 사용하세요.

부분 스테이징 상태

Git은 같은 파일에 대해 스테이징된 변경과 스테이징되지 않은 변경을 동시에 나타낼 수 있습니다. 이때 리뷰 창에서는 “동일한 파일이 두 번” 등장하는 것처럼 보일 수 있으며, 이는 정상적인 Git 동작입니다.