pr-checklistlisted
Install: claude install-skill Swttch/swttch
> 이 문서는 한글로 작성되어 있으나, 사용자가 사용하는 언어에 맞게 읽고 번역하여 전달할 것.
> (This document is written in Korean; read it and translate to the user's language when relaying.)
# pr-checklist — PR 올리기 전 검토
기여 변경을 `main`에 PR로 올리기 전에 통과해야 할 항목을 순서대로 검증한다.
**규칙의 본문(왜/무엇)은 [CONTRIBUTING.md](../../../CONTRIBUTING.md)가 단일 소스**이며,
이 스킬은 그 규칙을 실제로 검증하는 **절차**다. 상세 근거는 [CLAUDE.md](../../../CLAUDE.md) 참조.
## 트리거
- 사용자가 "PR 올리기 전", "PR 전 검토", "기여 전 체크", "피알 검토", "PR 준비 됐어?" 등을 말할 때
- 브랜치 작업을 마치고 PR 생성/업데이트 직전
## 검증 절차
각 항목을 실제 명령으로 검증하고, 통과/실패를 근거와 함께 보고한다. 실패 항목은 고치도록 안내한다.
### 1. 최신 main 리베이스 (필수)
PR은 반드시 **main의 최신 커밋 위에 리베이스**된 상태여야 한다. 오래된 base에서 PR을 열지 않는다.
```bash
git fetch origin
git rebase origin/main
```
- 리베이스 후 충돌이 있으면 해결하고, 3레이어 빌드/테스트를 다시 돌린다.
- 이미 push한 브랜치라면 리베이스 후 force-push(`--force-with-lease`)가 필요함을 안내한다.
### 2. 기능 PR엔 기능 문서 (필수)
사용자 대면 기능은 `docs/features/NNN-feature_name/` 폴더에 언어별 문서(`en.md` / `ko.md` …)를
작성하고, `docs/features/CLAUDE.md` 색인에 한 줄 추가해야 한다. 포맷은 그 색인 문서를 따른다.
```bash
ls docs/features/ # 다음 번호(NNN) 확인
```
### 3. 마켓플레이스 금지 API 미사용 (필수)
JetBrains **Internal API**(`@ApiStatus.Internal`, `impl` 패키지 내 클래스)는 **사용 금지** —
Marketplace Plugin Verifier가 오류로 잡아 배포가 거부된다. **Deprecated API**도 지양(경고 발생).
네이티브 기능에 위험한 API가 필요하면 reflection 또는 public 대체 API로 우회한다.
```bash
# 정적 점검(로컬 스킬 precheck과 동일한 grep 계열)
grep -rn "@ApiStatus.Internal\|StartupManager\|PluginManagerConfigurable" src/main/kotlin --include="*.kt"
```
### 4. 3레이어 테���트 + lint + build 통과 (필수)
"테스트"는 별도 명