Release Notes

마일스톤의 배포 내역을 하나의 큐레이션 리스트로 정리해 2산출물로 변환: ① 요약 이슈(마일스톤 연결) ② 배포 공지 메시지(슬랙 등). 저장소는 gh repo view --json nameWithOwner 또는 사용자 지정.

전제: 마일스톤 이슈는 잡다(내부 작업·QA·SQL 포함). 공지·릴리스노트엔 사용자-대면 기능만 선별 → 완전 자동 불가, 큐레이션 단계 필수.

쉘 호환: for x in $var/< <(...) 금지(zsh 미분리·sh 미지원) → ... | while IFS= read -r 파이프 사용.

STEP 1 — 마일스톤 식별

REPO=$(gh repo view --json nameWithOwner --jq .nameWithOwner)
gh api "repos/$REPO/milestones?state=open" --jq '.[] | "\(.number)\t\(.title)\tdue:\(.due_on)\t(open:\(.open_issues) closed:\(.closed_issues))"'

• 버전·날짜가 제목에 있으면 제목에서 파싱(due_on이 비는 경우 대비). 예: v1.2.0 06/25 배포.
• 사용자가 미지정 시: 배포일(due_on 또는 제목 날짜)이 가장 가까운 마일스톤을 후보로 제시·확인.
• 공지 헤더용 요일 계산: date -j -f "%Y/%m/%d" "2026/06/25" +%u(mac) / date -d 2026-06-25 +%u(linux) → 1=월…7=일.

STEP 2 — 이슈 수집 + 큐레이션 (핵심)

gh issue list --repo "$REPO" --milestone "<마일스톤 제목>" --state all --limit 300 \
  --json number,title,labels,state,stateReason | cat

선별 원칙 (사용자-대면 기능만):

• 포함: 신규 기능·고도화·사용성/디자인 개선 — 사용자가 체감하는 변경.
• 제외: 순수 내부 작업(SQL·마이그레이션·리팩터링·테스트·CI), 비가시성 버그픽스, QA 재현·검증 전용.
• 부모(기능) 이슈 단위로 묶는다. 하위 Task는 부모 아래 들여쓰기 불렛으로.

분류 (3섹션): 신규 기능 추가 및 고도화 / 사용성 개선 / 버그 수정(없으면 생략).

큐레이션 드래프트를 사용자에게 제시하고 확인·수정 받는다(포함/제외, 그룹, 하위 bullet, 부모 이슈번호). 자동 분류는 초안.

STEP 3 — 요약 이슈 생성/갱신

기존 요약 이슈 있으면 갱신, 없으면 생성. 생성은 사용자 확인 후.

gh issue create --repo "$REPO" \
  --title "chore: <버전/마일스톤> 릴리스 내역 정리" \
  --milestone "<마일스톤 제목>" \
  --body-file <작성한 본문 파일>

STEP 4 — 배포 공지 메시지 생성

요약 이슈 본문(큐레이션 결과)을 공지 포맷으로 변환. 부모 기능 항목 뒤에 #이슈번호 표기. 출력은 복사용 코드블록으로 제시 — 자동 게시 안 함.

산출물 템플릿

배포 공지

:loudspeaker: MM/DD(요일) <프로젝트> <버전> 배포 예정입니다.
<배포 시각·변경 안내 한 줄>

[신규 기능 추가 및 고도화]

- <부모 기능명> #<부모 이슈번호>
  - <하위 기능> #<이슈번호>
  - <하위 기능> #<이슈번호>
- <단일 기능명> #<이슈번호>

[사용성 개선]

- <부모 개선명> #<부모 이슈번호>
  - <하위 항목> #<이슈번호>

[버그 수정]

- <수정 내용> #<이슈번호>

이상입니다.

포맷 규칙: 부모 기능은 최상위 불렛 + 이슈번호, 하위 기능은 각각 들여쓰기 불렛 + 이슈번호. 하위 없으면 부모 한 줄. 3섹션 모두 포함(비면 그 섹션 생략).

요약 이슈 본문

## 적용 대상 내역

### 신규 기능 추가 및 고도화
- <부모 기능명> #<부모 이슈번호>
  - <하위 기능> #<이슈번호>

### 사용성 개선
- <부모 개선명> #<부모 이슈번호>

### 버그 수정
- <있으면 기재, 없으면 `-`>

## See Also
- 마일스톤: <마일스톤 제목>

주의

• 이슈 생성·공지는 외부 노출 — 본문 확정 후 사용자 확인. 공지는 자동 게시 없이 텍스트만 출력.
• gh 계정이 올바른지 gh auth status로 먼저 확인.