GitHub 커밋 내역을 매일 아침 4컷 만화로 바꿔주는 봇 개발기

실용적 조언

GitHub Actions의 cron 기능을 활용하면 별도의 서버 비용 없이 정기적인 AI 자동화 작업을 수행할 수 있다.
이미지 생성 모델의 결과물을 합성할 때는 파이썬의 Pillow 라이브러리를 사용해 레이아웃을 제어하는 것이 효과적이다.
Gemini API 키를 GitHub Secrets에 저장하여 보안을 유지하면서 자동화 워크플로를 안전하게 운영할 수 있다.

섹션별 상세

GitHub 커밋 내역을 4컷 만화로 변환하는 자동화 시스템을 구축했다. GitHub Actions의 cron 기능을 통해 매일 정해진 시간에 실행되며, Gemini API를 호출하여 커밋 메시지 기반의 스크립트 작성과 이미지 생성을 수행한다. 생성된 결과물은 Telegram이나 GitHub Issues를 통해 사용자에게 전달되어 매일 아침 자신의 성과를 시각적으로 확인할 수 있게 한다.

Update CHANGELOG.md 커밋을 기반으로 생성된 4컷 만화 예시 이미지이다. — Screenshot단순한 문서 수정 커밋이 중세 마을의 역사적인 사건으로 묘사되는 과정을 보여준다. Gemini가 생성한 이미지의 일관된 스타일과 4컷 레이아웃 구성을 확인할 수 있는 실질적인 결과물이다.

전체 프로젝트 개발에 Claude Code를 활용하여 생산성을 극대화했다. Claude Code가 GitHub Actions 파이프라인 구성, Gemini API 연동 로직, Telegram 전송 모듈, 그리고 Pillow 라이브러리를 이용한 이미지 합성 코드를 단일 주말 내에 완성했다. 이는 AI 코딩 에이전트가 복잡한 인프라 설정과 라이브러리 활용 능력을 갖추었음을 입증한다.

Gemini를 활용한 이미지 생성 과정에서 일관된 스타일을 유지하기 위한 프롬프트 엔지니어링이 핵심 과제였다. 4컷 만화의 레이아웃을 유지하고 중세 기사 테마의 톤을 고정하기 위해 여러 차례의 반복적인 프롬프트 수정 작업이 진행됐다. 텍스트 추론은 Claude가 담당하고 이미지 생성은 Gemini가 수행하는 모델 간 협업 구조를 채택했다.

단순한 로그 기록을 서사적인 만화로 변환하는 것이 개발자에게 강력한 심리적 보상을 제공한다. 자신의 사소한 코드 수정이 마을 사람들의 환호를 받는 기사의 업적으로 묘사되는 경험이 더 많은 코드를 배포하고 싶게 만드는 동기 부여 요소로 작용한다. 이는 기술적 자동화가 사용자 경험과 생산성 심리에 미치는 긍정적인 영향을 보여준다.

용어 해설

깃허브 액션(GitHub Actions): — GitHub 저장소에서 직접 소프트웨어 개발 워크플로를 자동화, 사용자 지정 및 실행할 수 있는 CI/CD 플랫폼이다. 코드 변경 시 빌드, 테스트, 배포를 자동으로 수행하며 이 프로젝트에서는 매일 정해진 시간에 만화를 생성하는 스케줄러 역할을 담당한다.
프롬프트 엔지니어링(Prompt Engineering): — LLM으로부터 원하는 결과물을 얻기 위해 입력값(프롬프트)을 설계하고 최적화하는 기술이다. 이 프로젝트에서는 Gemini가 일관된 4컷 만화 레이아웃과 특정 톤을 유지하며 이미지를 생성하도록 지시문을 조정하는 과정에 활용됐다.
크론 잡(Cron Job): — 리눅스 계열 운영체제에서 특정 시간에 특정 작업을 주기적으로 실행하도록 설정하는 시간 기반 잡 스케줄러이다. GitHub Actions의 schedule 이벤트를 통해 매일 아침 자동으로 봇을 실행하여 어제의 커밋 내역을 처리하는 데 사용된다.
필로우(Pillow): — 파이썬에서 이미지 파일을 열고, 조작하고, 저장하는 기능을 제공하는 강력한 이미지 처리 라이브러리이다. Gemini가 생성한 개별 이미지 패널들을 하나의 4컷 만화 스트립으로 이어 붙이는 스티칭 작업에 사용됐다.

언급된 도구

Claude Code추천

전체 시스템 코드 작성 및 GitHub Actions 파이프라인 구축

Gemini추천

만화 스크립트 생성 및 이미지 생성

GitHub Actions추천

워크플로 자동화 및 스케줄링

Pillow추천

이미지 스티칭 및 합성

언급된 리소스

GitHubgithub-comic-bot