AI 비교 기반 자동 GitHub 릴리스 노트 생성 - n8n 워크플로우

• 소프트웨어 개발팀


• 릴리스 자동화를 모색하는 DevOps 엔지니어


• 자동화된 문서 초안이 필요한 기술 문서 작성자


• 맞춤형 n8n 워크플로 솔루션을 배포하는 사용자


• 정확하고 분류된 변경 로그를 신속하게 생성하려는 모든 사람.

이 정교한 n8n 워크플로는 소프트웨어 릴리스 후 정확한 변경 로그를 컴파일하는 중요하지만 종종 수동적인 문제를 해결합니다. GitHub API를 활용하고 고급 대규모 언어 모델(OpenRouter/LangChain n8n 노드를 통해)을 통합하여, 이 n8n 템플릿은 두 개의 게시된 Git 태그 간의 차이점을 자동으로 추적합니다. n8n 트리거가 새 릴리스 이벤트를 감지하면, 워크플로는 변경된 상세 커밋과 파일을 효율적으로 가져옵니다. 이 원시 데이터는 변경 사항을 기능(features), 버그 수정(bug fixes), 개선 사항(improvements)으로 분류하는 일련의 AI 에이전트에게 전달됩니다. 최종 결과물은 즉시 게시할 준비가 된 깔끔하고 SEO 친화적인 마크다운 형식의 릴리스 노트로, n8n에 의존하는 모든 개발팀의 문서화 파이프라인을 획기적으로 가속화합니다.

1. n8n 워크플로 트리거링: 자동화는 지정된 GitHub 리포지토리 내에서 새로운 release 이벤트를 구체적으로 감지하도록 설정된 Github Trigger n8n 트리거에서 시작됩니다.


2. 릴리스 세부 정보 식별: Code 및 Set n8n 노드 단계(Fetch the latest release body 및 Set Repo & Owner)의 조합을 통해 웹훅 페이로드에서 리포지토리 소유자, 이름 및 현재 태그를 추출하여 다운스트림 노드용 변수를 표준화합니다.


3. 비교 태그 가져오기: 후속 Get the last two releases GitHub n8n 노드가 최근 릴리스 내역을 가져옵니다. 그런 다음 Get the last two release tags Code n8n 노드가 핵심 로직을 실행하여 비교에 필요한 currentTag와 previousTag를 올바르게 식별합니다.


4. 차이점(Diff) 실행: HTTP Request n8n 노드는 핵심 GitHub 비교 API 엔드포인트(URL .../compare/{{previousTag}}...{{currentTag}} 사용)를 호출합니다. 이 API 요청은 커밋 메시지와 파일 패치를 포함하여 전체 상세 diff를 가져옵니다.


5. 데이터 사전 처리: Confirm diff Code n8n 노드는 이 복잡한 JSON diff 페이로드를 처리합니다. 커밋 및 파일 데이터를 단순화하고 실제 변경 사항이 발생했는지(hasChanges) 확인하며, 후속 AI 소비에 최적화된 깔끔한 JSON 구조를 생성합니다.


6. AI 요약 및 생성: 정리된 diff는 AI 단계로 전달됩니다.

1. n8n 템플릿 가져오기: 제공된 JSON을 복사하여 '새로 만들기(New)' -> 'JSON에서 가져오기(Import from JSON)' 기능을 사용하여 n8n 인스턴스로 가져옵니다.


2. GitHub 자격 증명 설정: GitHub OAuth2 자격 증명을 구성해야 합니다. 이 자격 증명은 리포지토리 릴리스에 대한 읽기 권한이 필요하며 Github Trigger, Get the last two releases GitHub n8n 노드 및 Fetch release details from last two releases HTTP Request n8n 노드에 연결되어야 합니다.


3. OpenRouter 자격 증명 설정: OpenRouter API 키 자격 증명을 구성하고 OpenRouter Chat Model 및 OpenRouter Chat Model1 n8n 노드 인스턴스에 연결하여 AI가 요청을 처리할 수 있도록 보장합니다.


4. 트리거 구성: Github Trigger n8n 트리거에서 자동화하려는 프로젝트에 대해 올바른 리포지토리 소유자 및 리포지토리 이름을 지정합니다.


5. 활성화 및 테스트: n8n 워크플로를 저장하고 활성화한 다음, 대상 GitHub 리포지토리에서 새 릴리스를 트리거하여 엔드투엔드 자동화를 테스트합니다.

Github Trigger (n8n trigger): 구성된 GitHub 리포지토리에서 새 release 이벤트가 게시될 때 n8n 워크플로를 시작하도록 웹훅을 설정합니다.
Get the last two releases (GitHub n8n node): release: getAll 작업을 실행하며, 가장 최근 릴리스 두 개로 제한되어 비교 기준 기간을 설정하는 데 필수적입니다.
Get the last two release tags (Code n8n node): 가져온 릴리스에서 currentTag와 previousTag를 안전하게 추출하고 검증하기 위한 사용자 지정 JavaScript 로직을 포함합니다.
Fetch release details from last two releases (HTTP Request n8n node): 동적 표현식을 사용하여 소유자, 리포 및 두 비교 태그를 포함시켜 GitHub의 비교 엔드포인트에 핵심 API 호출을 수행하고 전체 코드 diff를 가져옵니다.
Confirm diff (Code n8n node): 거대한 GitHub diff 페이로드를 정리하고 단순화하며, 커밋 및 파일 변경 데이터를 후속 AI LangChain n8n 노드가 최적으로 소비할 수 있는 형식으로 재구성합니다.
Summarize release differences (LangChain Agent n8n node): 강력한 프롬프트와 OpenRouter 연결을 사용하여 구조화된 diff 데이터를 분석하고 기술적 변경 사항을 사용자 친화적인 요약 섹션(예: 기능, 버그 수정)으로 그룹화합니다.

• Generate latest release notes (LangChain Agent n8n node): 최종 AI n8n 노드로, 분류된 요약과 특정 버전 태그를 사용하여 완전하고 적절하게 형식화된 마크다운 릴리스 노트를 생성할 책임이 있습니다.