---
name: pr-rule
description: 사용자가 pull request 생성을 명시적으로 요청했을 때 적용합니다. draft PR을 만들고 대상 브랜치를 사용자에게 확인하며 제목과 본문 양식을 강제합니다.
---

# PR 규칙

## 출력 언어

사용자가 출력 언어를 명시적으로 지정하면 해당 언어를 사용합니다. 지정하지 않으면 이 스킬이 만드는 모든 사용자 대상 출력, 문서, 프롬프트, 보고서, 계획, 스펙 및 기타 산출물을 한국어로 작성합니다. 제목, 섹션, 레이블, 표, 체크리스트, 다이어그램, 템플릿에도 같은 언어를 사용합니다. 코드, 명령어, 파일 경로, 식별자, API 이름, 모델 ID, 프로토콜 이름과 필수 고유명사는 번역하지 않습니다.

## 작성 문서 첨부

요청된 모든 문서의 작성 또는 갱신을 마친 뒤 최종 응답에 각 문서를 `[문서 이름](절대 경로)` 형식의 Markdown 링크로 반드시 첨부합니다. 링크에는 독립된 디렉터리 세그먼트로 구성된 절대 경로를 사용하고, 디렉터리 구분자를 생략하거나 경로 세그먼트를 붙여 쓰지 않습니다. Windows 경로를 문자열로 표시할 때는 `C:\\Users\\WinUser\\Documents\\폴더\\문서.md`처럼 각 역슬래시를 두 번 씁니다.

## 필수 항목(필수 준수)

- PR 제목과 본문은 사용자가 언어를 명시적으로 지정하면 해당 언어를 사용하고, 지정하지 않으면 한국어를 사용해야 합니다.
- 반드시 draft PR로 설정한다.
- 임의로 머지 브랜치를 정하지 말고 반드시 유저에게 질의한다.
- PR 제목은 GitHub PR title 필드에만 작성하고, PR 본문에는 제목을 반복 작성하지 않는다.
- PR 본문은 아래 PR 양식의 마크다운 구조를 유지해서 작성해야 한다.
- `기대 결과`, `실제 결과`, `사실`, `추정`처럼 서로 비슷한 판단 섹션을 반복하지 않는다.
- 기대하는 동작은 `배경/맥락`이나 `검증 기준`에 흡수하고, 판단 근거는 필요한 경우 `관찰된 문제 또는 목표`에 포함한다.
- `수정 결과`처럼 diff와 중복되는 섹션은 기본 양식에 넣지 않는다.

## PR 양식

아래 내용은 반드시 출력 언어 규칙에 따른 언어로 기재하고, 마크다운 heading/list/code block 문법이 깨지지 않도록 작성한다.

```md
## 요약

## 배경/맥락

## 관찰된 문제 또는 목표

## 수정 방향

## 수정된 파일

## 검증 기준

## 테스트 목록

## 공식 문서 또는 참고 자료

## 관련 PR(옵션)
```

## 작성 규칙

- `배경/맥락`에는 왜 이 PR이 필요한지와 기대하는 동작을 짧게 함께 적는다.
- `관찰된 문제 또는 목표`에는 리뷰어가 판단해야 할 문제와 근거를 목록으로 적는다.
- `수정 방향`에는 구현 의도와 선택한 접근을 적는다.
- `검증 기준`에는 PR이 의도대로 동작한다고 판단할 수 있는 조건을 적는다.
- 이미 diff로 확인 가능한 세부 구현 결과를 별도 `수정 결과` 섹션으로 반복하지 않는다.

## PR 제목 규칙

PR 제목은 아래 형식으로 작성한다.

```text
브랜치 접두사: 제목
```

예시: `bug: PR 본문 제목 중복 방지`

### 브랜치 이름 규칙(필수 준수)

저장소가 별도로 정한 규칙이 없으면 아래 이름만 최상위 접두사로 사용한다.

- feat/…
- bug/…
- perf/…
- refactor/…
- misc/…

자잘한 변경점을 모은 브랜치는 `misc/…` 접두사를 사용한다. `codex/`, `agent/` 또는 도구 이름을 앞에 자동으로 추가하지 않는다. 예를 들어 `codex/bug/fix-title`이 아니라 `bug/fix-title`을 사용한다. 사용자가 이번 작업에서 다른 이름을 명시하면 그 이름을 우선한다.