사람과 AI 에이전트가 제각각 커밋을 남기면 변경 이유와 결과를 한 번에 파악하기 어려웠습니다.
대표 사례 03 · 사내 AX 패치노트 자동화
커밋을 남기면,
패치노트가 만들어집니다.
Agent 기반 Skill로 커밋 메시지를 구조화하고 Git Hook과 CI/CD 파이프라인을 통해 이를 검증 후 패치노트 작성을 자동화합니다.
문제 상황
짧은 커밋 메시지만으로는
패치노트에 필요한 정보가 부족했습니다.
패치노트를 만들 때마다 변경이 어느 실행 환경과 구성요소에 해당하는지 다시 확인해야 했습니다.
커밋에 필요한 정보가 빠져도 태그를 만들기 전까지 알아채기 어려웠습니다.
자동화 구조
검증된 커밋을 하나의 패치노트로
변경 파일과 저장소 설정을 읽어 제목, 변경 이유, 주요 변경, 기대 결과를 같은 형식으로 작성합니다.
Skill에서 작성한 필수 태그가 실제로 있는지 검증합니다.
코드 병합 과정에서 릴리즈 대상 커밋의 형식과 필수 태그를 다시 검사합니다.
하나의 패치노트로 정리합니다.
Tag 1
Commit 1
Commit 2
Commit 3
Tag 2
자동 생성
통합 패치노트
- 기능 추가API 응답 필드 추가
- 오류 수정실행 환경 설정 오류 해결
- 성능 개선요청 처리 성능 개선
릴리즈 태그가 만들어지면 이전 태그 이후의 여러 커밋을 모아 변경 유형과 적용 대상별로 정리하고, 하나의 Markdown 패치노트로 생성합니다.
Skill 상세 설명
커밋 작성 Skill의 규칙
커밋할 변경 내용과 저장소 설정을 읽고 작업 영역, 배포 대상, 구성요소를 판단합니다.
제목에는 변경 유형과 작업 영역을, 본문에는 영향 파일·수정 이유·주요 변경·기대 결과만 작성합니다.
제품 변경에는 네 개의 Release 태그를 기록하고, 제외 대상에는 건너뛰는 이유를 남깁니다.
실제 Skill 형식을 적용한 구조화 커밋
예시
perf(server): 요청 처리 성능 개선
영향 파일:
- `src/request_handler.cpp`: 반복 조회 구간 개선
수정 이유:
- 동일한 데이터를 반복 조회해 요청 처리 지연 발생
주요 변경:
- 요청 처리 중 조회한 결과를 재사용하도록 변경
기대 결과:
- 평균 요청 처리량 25% 상승
Release-Note: 반복 조회를 줄여 요청 처리 성능을 개선했습니다.
Release-Type: performance
Release-Targets: customer-environment
Release-Components: server
결과
커밋에서 패치노트까지 자동
업무
기존
개선
작성 방식
작성자마다 제목과 본문 형식이 달랐습니다.
Skill이 같은 구조와 필수 태그로 작성합니다.
검증 시점
패치노트를 정리하며 누락을 뒤늦게 확인했습니다.
Git Hook과 CI가 커밋·병합 단계에서 검증합니다.
패치노트 생성
커밋을 다시 읽으며 배포 대상과 변경 유형을 분류했습니다.
필수 태그를 기준으로 패치노트를 자동 생성합니다.
AI 작업 통제
AI에게 맡긴 것이 아니라, AI가 지켜야 할 규칙을 코드로 강제했습니다.
Skill은 정해진 형식으로 작성하고, Git Hook은 규칙을 어긴 커밋을 막으며 CI는 병합 전에 다시 검증합니다.