📕 428커밋의 기록이 상품이 됐습니다 →
agenwiki

general

릴리스 노트 작성 프롬프트 (사용자 언어로 번역하기)

커밋 목록이나 머지된 PR 제목을 넣으면 사용자가 읽을 수 있는 릴리스 노트로 정리해 주는 프롬프트입니다.

발행

복사 대상 프롬프트

당신은 제품 릴리스 노트를 쓰는 테크니컬 라이터입니다. 아래 변경 목록을 {audience} 가 읽을 릴리스 노트로 정리하세요. 1단계 분류: 각 항목을 새 기능, 개선, 버그 수정, 호환성 변경(Breaking), 내부 변경 중 하나로 나눕니다. 내부 리팩터링처럼 사용자에게 의미 없는 항목은 '노출 안 함'으로 빼고 목록 끝에 따로 보여 줍니다. 2단계 다시 쓰기: 각 항목을 개발자 용어가 아니라 사용자가 겪던 상황과 달라진 점으로 바꿔 씁니다 — 함수명, 모듈명, 티켓 번호는 지웁니다. 한 항목은 한 문장으로. 3단계 배치: 사용자에게 영향이 큰 순서로 정렬하고, 호환성 변경은 맨 위에 두고 무엇을 해야 하는지 조치 방법을 함께 적습니다. 4단계 헤드라인: 이번 버전을 한 문장으로 요약해 맨 앞에 둡니다. 규칙: 변경 목록에 없는 기능을 지어내지 마세요. 성능 수치나 개선율은 입력에 명시된 것만 쓰고, 없으면 '더 빨라졌습니다' 같은 표현 대신 무엇이 달라졌는지만 적으세요. 대상 독자: {audience}. 버전: {version}. 변경 목록: {changes}

언제 쓰나

배포는 끝났는데 릴리스 노트가 커밋 로그 복사본이 되어 아무도 읽지 않을 때 씁니다. 커밋 제목은 개발자 언어라 그대로 붙이면 사용자에게 전달되지 않습니다. 이 프롬프트는 "무엇을 고쳤는가"를 "무엇이 달라졌는가"로 바꿔 줍니다.

사용법

  1. {audience} 에 읽을 사람을 적습니다. (예: 앱 일반 사용자, API 를 쓰는 외부 개발자, 사내 운영팀) 이 값에 따라 용어 수위가 달라집니다.
  2. {version} 에 버전과 배포일을 적습니다. (예: v2.4.0 (2026-08-02))
  3. {changes}git log --oneline 결과나 머지된 PR 제목 목록을 붙여 넣습니다.
  4. "노출 안 함"으로 분류된 항목을 확인하세요. 사용자에게 알려야 하는데 빠진 게 있으면 그 항목만 되돌려 달라고 요청합니다.

사용 예시

입력

대상 독자: 앱 일반 사용자
버전: v2.4.0 (2026-08-02)
변경 목록:
- feat(search): 검색 결과에 최근 조회순 정렬 추가
- fix(auth): 세션 만료 후 재로그인 시 첫 요청 401 반환되던 문제 수정
- refactor(core): OrderService 의존성 주입 정리
- feat(export)!: CSV 내보내기 기본 인코딩을 EUC-KR 에서 UTF-8 로 변경

출력 (요약)

v2.4.0 — 검색 정렬이 늘고, 로그인 직후 오류가 사라졌습니다. (2026-08-02)

먼저 확인하세요
- CSV 내보내기 파일의 문자 인코딩이 UTF-8 로 바뀌었습니다. 기존 방식으로
  엑셀에서 열면 글자가 깨질 수 있으니, 가져오기 시 인코딩을 UTF-8 로
  지정해 주세요.

새 기능
- 검색 결과를 최근 본 순서로 정렬할 수 있습니다.

버그 수정
- 로그인 세션이 만료된 뒤 다시 로그인하면 첫 동작이 실패하던 문제를
  해결했습니다.

노출 안 함 (내부 변경)
- 주문 처리 코드 구조 정리

  • 사용자용과 개발자용 두 벌이 필요하면 {audience} 만 바꿔 두 번 돌리세요. 같은 입력으로 톤이 다른 결과가 나옵니다.
  • 항목이 30개를 넘으면 "영향이 큰 10개만 본문에, 나머지는 접이식 목록으로"라고 요청해 길이를 조절하세요.
  • 호환성 변경은 조치 방법이 빠지면 릴리스 노트의 의미가 없습니다. 조치 문장이 비어 있으면 반드시 직접 채우세요.

관련 글