바이브코딩으로 게임 만들기 #14 – Claude Code 스킬로 작업일지 자동화하기

개발 일지를 꾸준히 쓰고 싶었는데 매번 귀찮아서 안 썼다. 작업 끝나고 뭘 했는지 정리하는 게 코딩만큼 에너지가 들었다. Claude Code에 스킬이라는 기능이 있다는 걸 알고 나서, 커밋 전에 일지를 자동으로 뽑아주는 걸 만들어봤다.

스킬이 뭔가

Claude Code에서 /커밋 같은 슬래시 명령어를 직접 만들 수 있다. 내가 정의한 흐름대로 Claude가 작업을 대신 처리해주는 거다. 일반적인 대화처럼 매번 같은 말을 반복하지 않아도 된다.

내가 만든 커밋 스킬의 흐름은 이렇다. git diff로 변경 내용을 확인하고, 그걸 바탕으로 작업 일지를 먼저 작성한다. 일지가 마음에 들면 커밋하고 푸시까지 한 번에 처리한다. 커밋 메시지도 자동으로 뽑아준다.

실제로 어떻게 쓰나

작업이 끝나면 /커밋 하나만 입력한다. 그러면 Claude가 diff를 보고 “오늘 BTDynamicSelector로 교체해서 깃발 미반응 버그 수정했고, 3열 그리드 대형 슬롯 시스템 추가했습니다” 같은 식으로 작업 내용을 정리해준다. 그걸 보고 맞으면 커밋하면 된다.

블로그 이 시리즈가 만들어진 것도 사실 이 흐름이 있었기 때문이다. 커밋할 때마다 일지가 쌓이고, 그 일지를 모아서 글로 만들었다. 매번 뭘 했는지 기억해서 쓰는 게 아니라 이미 정리된 내용에서 글감을 가져왔다.

좋았던 점, 아쉬운 점

가장 좋은 건 작업하면서 문서화를 따로 신경 안 써도 된다는 거다. 코드에 집중하고, 끝나면 스킬 하나 돌리면 정리가 된다. 귀찮아서 미루다가 나중에 뭘 했는지 기억 못 하는 일이 줄었다.

아쉬운 건 가끔 diff가 너무 크면 요약이 뭉뚱그려진다는 거다. 작업 단위를 작게 유지하고 자주 커밋하면 일지 품질이 훨씬 좋아진다. 결국 좋은 커밋 습관이랑 같이 가는 도구다.

정리하자면

개발 일지 쓰는 게 귀찮다면 커밋 워크플로우에 끼워 넣는 방식이 잘 맞는다. Claude Code 스킬로 자동화하면 일지 작성의 진입 장벽이 거의 없어진다. 기록이 쌓이면 블로그 글감도 되고, 나중에 뭘 왜 만들었는지 돌아볼 수 있는 자산이 된다.