# Pr Write

> 현재 변경 내역(diff)을 기반으로 PR 설명문과 리뷰 체크리스트를 생성한다.

- Skill: `gaebalai-claude-code-kit-ko/pr-write` (Agent Skill)
- Install (CLI): `npx skillmds@latest add gaebalai-claude-code-kit-ko/pr-write`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gaebalai-claude-code-kit-ko/pr-write/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: gaebalai (https://skillmd.com/u/gaebalai-claude-code-kit-ko)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/gaebalai-claude-code-kit-ko/pr-write

---


당신은 신중한 시니어 엔지니어다. $ARGUMENTS 를 대상으로 아래 작업을 수행하라.

## 목적

현재 브랜치의 변경 내역을 분석하고, 리뷰어가 빠르고 정확하게 이해할 수 있는 PR 설명문을 작성한다.  
변경 목적·내용·영향 범위를 구조화하고, 리뷰 체크리스트를 함께 제공한다.

## 입력

- 현재 git 브랜치의 변경 내역 (자동 수집)
- 선택: PR의 목적·배경·관련 Issue 번호
- 선택: 특히 집중해서 봐야 할 리뷰 포인트

## 절차

1. **변경 내역 수집 및 파악**
   - `git diff`로 스테이지/미스테이지 변경 내역 확인
   - `git log`로 베이스 브랜치 대비 커밋 이력 확인
   - `git status`로 변경 파일 목록 및 상태(신규/수정/삭제) 파악

2. **변경 내용 분류**
   - 변경 파일을 다음 기준으로 분류:
     - **기능 추가**: 신규 기능·엔드포인트 추가
     - **버그 수정**: 기존 오류 수정
     - **리팩터링**: 동작 변화 없는 코드 개선
     - **테스트**: 테스트 추가·수정
     - **설정/인프라**: 설정, CI/CD, 의존성 변경
     - **문서**: README, 주석 등 문서 변경

3. **PR 제목 및 요약 작성**
   - 변경의 핵심을 70자 이내 제목으로 작성
   - 변경 목적(Why)과 구현 방식(How)을 2~3문장으로 정리
   - 관련 Issue가 있으면 번호 포함

4. **리뷰 체크리스트 생성**
   - 변경 유형에 맞춰 다음 관점에서 체크리스트 작성:
     - **로직**: 분기 처리·예외 처리 적절성
     - **보안**: 입력 검증·인증/인가·비밀 정보 관리
     - **성능**: 불필요한 반복·N+1 문제
     - **호환성**: 기존 API와의 하위 호환성
     - **테스트**: 테스트 존재 여부 및 충분성

5. **영향 범위 및 테스트 정보 정리**
   - 영향 가능 기능·모듈 명시
   - 배포 시 유의사항이 있다면 포함

## 출력 형식

```markdown
## 제목

[PR 제목 (70자 이내)]

## 개요

[변경 목적과 구현 방법. 2~3문장]

관련 Issue: [#번호 또는 N/A]

## 변경 내용

### [카테고리명]

- [변경 요약] (`파일명`)

## 리뷰 체크리스트

- [ ] [로직 관련 구체적 확인 항목]
- [ ] [보안 관련 구체적 확인 항목]
- [ ] [성능 또는 설계 관련 확인 항목]

## 테스트 결과

- **추가/수정된 테스트**: [테스트 파일 및 건수]
- **테스트 실행 결과**: [Pass/Fail 및 건수]

## 영향 범위

- [영향 가능 기능·모듈]
- [배포 시 유의사항]
```

## 유의사항

- `git diff`, `git log`출력에 포함된 비밀 정보는 PR 설명에 포함하지 않는다.
- 커밋에 비밀 정보가 포함된 경우 경고를 표시하고 조치를 권장한다.
- git의 읽기 전용 명령만 사용한다. (push, reset, checkout 등 금지)

## 종료 조건

위 형식에 맞춘 PR 설명문을 출력하면 종료한다.
커밋·푸시는 사용자의 추가 지시를 기다린다.