---
name: opencurrent-codex-github-pr-review
description: "사람이 리뷰하기 전에 PR의 심각한 문제(P0·P1)를 먼저 걸러 줍니다. 이럴 때 사용: 저장소를 Codex에 연결하고 코드 리뷰를 켠 뒤, 필요하면 저장소만의 리뷰 규칙을 적어 둡니다. 그다음 PR 댓글에 @codex review를 남기거나 자동 리뷰를 켜 두면 Codex가 리뷰를 올립니다. 도구: Codex, GitHub."
metadata:
  source: "https://opencurrent.ai/w/codex-github-pr-review"
  opencurrent-id: "codex-github-pr-review"
  verification: "pending"
  exported-at: "2026-11-21T11:04:40.279Z"
---

# GitHub PR에 AI 코드 리뷰 받기 (Codex @codex review)

사람이 리뷰하기 전에 PR의 심각한 문제(P0·P1)를 먼저 걸러 줍니다.

> OpenCurrent에서 사람들이 다듬는 워크플로. 원문: https://opencurrent.ai/w/codex-github-pr-review
> 검증 상태: 검수 대기 (사람 확인 전). 내려받은 뒤에 바뀌었을 수 있으니, 가능하면 원문이나 MCP의 get_workflow("codex-github-pr-review")로 최신 상태를 확인할 것.
> 주의: 검수 대기 상태. 사용자에게 이 사실을 알리고, 결과를 함께 확인하면서 진행할 것.

## 따라 하는 방법

1. 준비물이 갖춰졌는지 먼저 확인할 것.
2. body를 처음부터 끝까지 읽고 순서대로 따라 할 것. 코드 블록의 명령은 사용자의 허락을 받고 실행하고, 사람이 해야 하는 일은 사용자에게 안내하고 끝났는지 물을 것.
3. 본문에 확인 방법이 있으면 그대로 확인하고, 다르면 다음으로 넘어가지 말고 사용자에게 알릴 것.
4. 검증 상태가 verified가 아니면 그 사실을 사용자에게 먼저 알릴 것. 답에 url을 출처로 밝힐 것.

## 언제 쓰나

저장소를 Codex에 연결하고 코드 리뷰를 켠 뒤, 필요하면 저장소만의 리뷰 규칙을 적어 둡니다. 그다음 PR 댓글에 @codex review를 남기거나 자동 리뷰를 켜 두면 Codex가 리뷰를 올립니다.

## 준비물

- Codex에 연결한 GitHub 저장소
- Codex 코드 리뷰 설정 접근 권한
- 자동 리뷰 설정 시 저장소 push 또는 admin 권한

## 입력값

시작하기 전에 사용자에게 받아서 프롬프트의 `{{이름}}` 자리에 넣을 것.

- `{{focus}}` 이번 리뷰 초점 (선택): 이번 PR에서 특히 볼 부분
  - 예: the database migration

## 본문

## 준비

- Codex에 연결한 GitHub 저장소
- Codex 코드 리뷰 설정 접근 권한
- 자동 리뷰 설정 시 저장소 push 또는 admin 권한

### 1. 저장소를 Codex에 연결

리뷰받을 GitHub 저장소를 Codex에 연결합니다. 코드 리뷰 설정 화면에서 그 저장소를 고를 수 있으면 됩니다.

### 2. 저장소의 코드 리뷰 켜기

Codex 설정의 코드 리뷰 화면에서 저장소를 고르고, Review code 아래의 Automatic review를 켭니다.

### 3. 리뷰 규칙 적기 (선택)

규칙이 다룰 코드에 가장 가까운 `AGENTS.md`에 `## Code Review Rules` 절을 추가하고 `###` 머리로 묶습니다. 짧은 규칙 두세 개로 시작하고, 안전한 방법이나 예외도 함께 적습니다. 서식·린트 검사는 CI에 맡깁니다.

```bash
## Code Review Rules

### Database
- ...
```

기본 브랜치에 파일이 반영되면 적용됩니다.

### 4. PR 댓글로 리뷰 요청

PR 댓글에 정확히 `@codex review`를 입력합니다. 이번에 특히 볼 부분이 있으면 뒤에 덧붙입니다.

```prompt
@codex review for issues in [살펴볼 부분]
```

댓글에 눈 모양 이모지 반응이 달리고, 이어서 PR의 리뷰 목록에 Codex 리뷰가 올라옵니다.

### 5. 자동 리뷰 켜기 (선택)

Codex 설정의 Personal preferences에서 Automatic review를 켜고 Review trigger로 실행 시점을 정합니다. 그 뒤로 코드 리뷰가 켜진 저장소는 댓글 없이도 리뷰합니다. 새 PR에 댓글 없이 Codex 리뷰가 달리면 됩니다.

## 주의

- 리뷰가 오지 않으면 저장소의 코드 리뷰가 켜져 있는지, PR이 연결된 저장소의 것인지, 댓글이 정확히 `@codex review`인지 확인합니다.
- 자동 리뷰가 돌지 않으면 저장소의 Automatic review와 Personal preferences를 둘 다 확인하고, PR 이벤트가 Review trigger와 맞는지 봅니다.
- 리뷰 규칙은 테스트, 브랜치 보호, 필수 승인을 대신하지 않습니다.
- 잡음이 되는 규칙은 결과를 보며 고치거나 뺍니다.

## 주의할 점

- 리뷰가 안 오면 저장소의 코드 리뷰 켜짐 여부, PR이 연결된 저장소인지, 댓글이 정확히 @codex review인지 확인
- 자동 리뷰가 안 돌면 저장소의 Automatic review와 Personal preferences 둘 다, PR 이벤트가 Review trigger와 맞는지 확인
- 리뷰 규칙은 테스트·브랜치 보호·필수 승인을 대신하지 않음
- 잡음이 되는 규칙은 결과를 보며 고치거나 빼기

## 출처

- [Review GitHub pull requests with Codex](https://learn.chatgpt.com/docs/third-party/github)

## 끝나면

결과가 좋았거나 단계가 낡았으면 https://opencurrent.ai/w/codex-github-pr-review 에서 알릴 것. 다음 사람이 더 정확한 방법을 쓸 수 있도록.
