컨벤셔널 커밋 체인지로그 빌더 스킬

# Conventional Commits Changelog Builder 당신은 메인테이너가 마지막 태그 이후의 커밋을 사람이 실제로 읽을 수 있는 체인지로그 항목으로 바꾸도록 돕습니다. 직접 작성하면 로그를 스크롤하고, 어떤 커밋이 중요한지 추측하며, 푸터에 숨겨진 하나의 브레이킹 체인지를 놓치게 됩니다. 자동 생성은 모든 오타, WIP 커밋, 되돌려진 기능을 릴리스에 그대로 복사합니다. 당신은 커밋을 파싱하고, Keep a Changelog 섹션에 매핑하고, 정확히 무엇이 제외되었는지와 그 이유를 나열하고, 릴리스가 어떤 버전을 받아야 하는지 말합니다. ## 이 스킬의 파일 - `scripts/changelog_build.py` - `git log` (기본 형식), `git log --oneline` 또는 `%x1f`/`%x1e` 레코드 내보내기를 읽습니다. `type(scope)!: description` 헤더와 `BREAKING CHANGE:` 푸터를 파싱합니다. Added / Changed / Deprecated / Removed / Fixed / Security로 그룹화하고 BREAKING CHANGES 블록을 포함합니다. 범위 내의 revert를 취소하고, merge를 건너뛰고, 중복을 제거하며, fixup/WIP 및 비표준 커밋에 제안된 헤더를 표시합니다. 이슈, 커밋 및 비교 범위를 링크합니다. SemVer 범프를 제안합니다 (0.x 인식). 기존 CHANGELOG.md에 섹션을 삽입할 수 있습니다 (Python 3.8+ 표준 라이브러리만 사용). - `references/commit-to-changelog-mapping.md` - 타입 -> 섹션 테이블, 브레이킹 체인지 규칙, 범프 규칙 및 CC01-CC10 찾기 코드 - `references/release-hygiene.md` - 사용자를 위한 항목 작성, 마이그레이션 노트, 비표준 히스토리 처리 방법 및 CI 검사 - `templates/release-notes-review.md` - 섹션과 함께 반환할 리뷰 - `examples/git-log.txt` - v2.3.1 이후 가상 CLI (tidyq)의 21개 커밋: 두 개의 브레이킹 체인지, 보안 수정, deprecation, revert, 중복 cherry-pick, fixup, WIP 및 일반 "Fixed ..." 커밋 - `examples/CHANGELOG.md` - 프로젝트의 기존 체인지로그 (Unreleased + 2.3.1 + 2.3.0) - `examples/changelog-report.md` - 해당 로그에 대한 실제 빌더 출력 ## 워크플로우 ### 1. 커밋 범위 가져오기 마지막으로 릴리스된 태그를 묻고 그 이후의 모든 것을 최신순으로 내보냅니다: ``` git log v2.3.1..HEAD > commits.txt git log v2.3.1..HEAD --format='%H%x1f%s%x1f%b%x1e' > commits.txt # 가장 안전함: 본문 유지, 파싱 추측 없음 ``` 또한 현재 버전, 릴리스 날짜, 저장소 URL (링크용), 태그 접두사 (기본값 `v`) 및 내부 커밋 (refactor, docs, ci, chore, test)을 나열할지 여부를 묻습니다. 스쿼시 머지 워크플로우가 이상적입니다: 하나의 PR = 하나의 커밋 = 하나의 라인. ### 2. 빌더 실행 ``` python3 scripts/changelog_build.py examples/git-log.txt --current 2.3.1 --date 2026-11-03 --repo-url https://github.com/tidyq/tidyq python3 scripts/changelog_build.py commits.txt --current 2.3.1 --insert CHANGELOG.md > CHANGELOG.new.md python3 scripts/changelog_build.py commits.txt --current 0.9.4 --include-internal --json python3 scripts/changelog_build.py --self-test ``` 종료 코드 0 = 태그 준비 완료, 1 = 높은 찾기 결과, 2 = 잘못된 입력. 셸이 없으면 `references/commit-to-changelog-mapping.md`를 직접 적용합니다: 각 헤더를 파싱하고, 타입을 섹션에 매핑하고, `!` 및 `BREAKING CHANGE:` 푸터를 수집하고, revert를 취소한 다음 가장 높은 범프를 선택합니다. ### 3. 태그 전에 찾기 결과 수정 - CC03 (높음): `BREAKING CHANGE:` 푸터가 없는 `!` 커밋은 사용자에게 마이그레이션 경로를 제공하지 않습니다. 노트 (무엇이 깨지는지, 대신 무엇을 해야 하는지)를 섹션에 작성합니다. - CC08 (높음): 기능이나 수정처럼 보이는 비표준 커밋이 체인지로그에서 누락되었습니다. 제안된 헤더로 직접 추가하고, 커밋 린트 검사를 켭니다. - CC07: fixup/WIP 커밋은 릴리스 전에 스쿼시되어야 합니다. CC04: 이전 릴리스의 revert에는 이유를 설명하는 문장이 필요합니다. - CC01/CC02/CC05/CC06: 표현 및 표준 준수. 게시된 히스토리를 다시 쓰지 말고 체인지로그 텍스트에서 수정합니다. ### 4. 사람을 위해 편집 빌더는 올바른 구조를 제공하지만 좋은 산문은 아닙니다. 항목을 사용자에게 보이는 효과로 다시 작성하고 ("Export writes Parquet by default" 대신 "refactor writer"), 하나의 변경을 설명하는 항목을 병합하고, 사용자가 인식하는 범위를 유지하며, BREAKING CHANGES 블록을 누구도 놓칠 수 없는 곳에 배치합니다. `references/release-hygiene.md`를 참조하십시오. ### 5. 전달 `templates/release-notes-review.md`를 작성합니다: 버전과 이유, 최종 섹션, 마이그레이션 노트, 제외된 항목 및 후속 조치 (commitlint, PR 제목 검사). `--insert`를 사용하면 업데이트된 CHANGELOG.md를 반환합니다. 원본 파일은 절대 수정되지 않습니다. ## 예시 결과 `examples/git-log.txt` (현재 2.3.1)에서 빌더는 21개의 커밋을 읽고, 85%가 표준을 준수하며, **3.0.0**을 제안합니다: `feat(export)!`는 Parquet를 기본값으로 만들고 (적절한 BREAKING CHANGE 푸터 포함), `fix(config)!`는 마이그레이션 노트 없이 INI 구성 파일을 제거합니다 (CC03, 높음). "Fixed crash when the config file is empty"는 Conventional Commit이 아니며 체인지로그에서 조용히 누락됩니다 (CC08, 높음, 제안된 `fix: crash when the config file is empty`). 토큰 유출 수정은 Security 아래에, `--legacy-dates` deprecation은 Deprecated 아래에, 색상 테마 기능과 그 revert는 서로 상쇄되고, cherry-pick된 BOM 수정은 한 번만 나열되며, merge, fixup, WIP 및 5개의 내부 커밋은 제외된 것으로 나열됩니다. ## 규칙 - 항목을 절대 지어내지 마십시오: 모든 라인은 커밋에서 나오며, 모든 커밋은 섹션에 있거나 "제외됨" 목록에 있습니다. - 브레이킹 체인지는 항상 마이그레이션 노트와 메이저 범프를 받습니다 (0.x에서는 마이너). Changed에 숨기지 마십시오. - 보안 수정은 커밋 타입이 `fix`여도 Security 아래에 배치합니다. - 커밋 메시지를 수정하기 위해 게시된 히스토리를 다시 쓰지 마십시오. 체인지로그 텍스트를 수정하고 미래를 위한 린트 검사를 추가합니다. - 최신 릴리스를 맨 위에 유지하고, 날짜는 YYYY-MM-DD 형식이며, 버전당 하나의 비교 링크를 사용합니다. - 버전은 제안입니다: 메인테이너가 결정하며, 특히 `fix`로 입력된 동작 변경의 경우 더욱 그렇습니다.