GitHub에서 Codex 코드 리뷰

Codex 코드 리뷰를 사용하면 GitHub pull request에 대해 신호가 강한 추가 리뷰를 받을 수 있습니다. Codex는 pull request diff를 검토하고, 저장소 지침을 따르며, 심각한 문제에 초점을 맞춘 표준 GitHub 코드 리뷰를 게시합니다.

시작하기 전에

다음을 준비합니다.

리뷰하려는 저장소에 Codex cloud가 설정되어 있어야 합니다.
Codex 코드 리뷰 설정에 접근할 수 있어야 합니다.
Codex가 저장소별 리뷰 지침을 따르도록 하려면 AGENTS.md 파일을 준비합니다.

Codex 코드 리뷰 설정

Codex cloud를 설정합니다.
Codex 설정으로 이동합니다.
저장소의 Code review를 켭니다.

Codex 리뷰 요청

pull request 댓글에서 @codex review를 멘션합니다.
Codex가 반응하고 리뷰를 게시할 때까지 기다립니다.

Codex는 팀원처럼 pull request에 리뷰를 게시합니다. GitHub에서 Codex는 P0과 P1 문제만 표시하므로 리뷰 댓글은 우선순위가 높은 위험에 집중됩니다.

자동 리뷰 활성화

Codex가 모든 pull request를 자동으로 리뷰하게 하려면 Codex 설정에서 Automatic reviews를 켭니다. 그러면 @codex review 댓글 없이도 누군가 리뷰용 새 PR을 열 때마다 Codex가 리뷰를 게시합니다.

Codex가 리뷰할 내용 사용자화

Codex는 저장소에서 AGENTS.md 파일을 찾고, 포함된 Review guidelines를 따릅니다.

저장소의 지침을 설정하려면 최상위 AGENTS.md에 다음과 같은 섹션을 추가하거나 업데이트합니다.

## Review guidelines

- Don't log PII.
- Verify that authentication middleware wraps every route.

Codex는 각 변경 파일에 가장 가까운 AGENTS.md의 지침을 적용합니다. 특정 패키지를 더 엄격하게 검토해야 한다면 더 깊은 트리에 구체적인 지침을 둘 수 있습니다.

일회성 초점을 지정하려면 pull request 댓글에 추가합니다.

@codex review for security regressions

Codex가 문서 오타를 표시하게 하려면 AGENTS.md에 지침을 추가합니다. 예: "문서 오타를 P1로 취급합니다."

리뷰 발견 항목 처리

Codex가 리뷰를 게시한 뒤 같은 pull request에 다른 댓글을 남겨 문제 수정을 요청할 수 있습니다.

@codex fix the P1 issue

Codex는 pull request를 컨텍스트로 클라우드 작업을 시작하고, 권한이 있으면 수정 사항을 브랜치에 다시 push할 수 있습니다.

Codex에 다른 작업 맡기기

댓글에서 review가 아닌 내용으로 @codex를 멘션하면 Codex는 pull request를 컨텍스트로 사용해 클라우드 작업을 시작합니다.

@codex fix the CI failures