GitHub 이슈·PR 기반의 월간 작업일지 자동 생성 Claude 스킬 만들기

요약: 매달 저장소별 작업일지를 손으로 쓰는 일을 gh CLI와 Claude 스킬로 자동화했다. 스크립트가 닫힌 이슈와 이슈 없는 PR을 KST 기준으로 모으고, 모델은 일자별 요약만 맡는다. 저장소명 대소문자, gh repo view의 엉뚱한 결과, 작업 중인 브랜치를 건드리지 않고 dev에 푸시하는 문제를 겪고 해결했다.

무엇을 만들었나

요구는 단순했다. 저장소 하나를 지정하면 그 달에 닫힌 이슈와, 이슈 없이 머지된 PR을 모아 일자별 작업일지로 정리하고 docs/workLog/YYYY-MM-저장소명-작업일지.md로 저장한다. 월마다 파일 1개, 안에서는 날짜별 요약이다.

스킬은 두 부분으로 나눴다.

• scripts/fetch.sh: gh로 데이터를 모아 JSON으로 출력한다. 결과가 매번 같아야 하는 부분이다.
• SKILL.md: JSON을 일자별 문서로 쓰고 커밋·푸시하는 절차. 요약처럼 판단이 필요한 부분이다.

데이터 수집에서 막힌 곳

1. 월 경계는 KST로 잘라야 한다

GitHub 검색의 closed: 날짜는 UTC 기준이다. 11월 1일 새벽(KST)에 닫은 이슈는 UTC로는 10월 31일이다. 그래서 조회는 월 경계 앞뒤 하루씩 여유를 두고 하고, 응답의 시각을 KST로 바꿔 날짜를 계산한 뒤 jq에서 정확히 필터링했다.

KST='(fromdateiso8601 + 32400 | strftime("%Y-%m-%d"))'
gh issue list -R "$NWO" --state closed --search "closed:$FROM..$TO" \
  --json number,title,closedAt,url | jq "[.[] | .day = (.closedAt | $KST)]"

2. 이슈 없는 PR 판정

closingIssuesReferences가 비어 있고, 제목·본문에 자기 번호가 아닌 #N 참조도 없는 PR만 "이슈 없는 PR"로 본다. dev 브랜치에서 올라온 PR은 배포 PR로 따로 분리해 그날 목록의 마지막에 적는다.

3. gh repo view가 다른 저장소를 알려줬다

저장소의 owner를 알아내려고 gh repo view --json nameWithOwner를 썼더니, AILign 디렉터리에서 aivance-kr/AICreo가 나왔다. 기본 저장소 설정이 따로 잡혀 있었던 것으로 보인다. 믿을 수 있는 값은 git remote get-url origin이라 URL에서 owner/repo를 뽑는 방식으로 바꿨다.

4. 저장소명 대소문자

/work-log aicura로 실행하니 AICura를 찾지 못했다. 비교를 소문자로 맞추고, 현재 디렉터리와 하위 디렉터리들의 origin을 훑도록 고쳤다. 저장소명을 생략하면 현재 디렉터리의 origin을 쓰고, 첫 인자가 YYYY-MM이나 all이면 월 인자로 해석한다.

커밋과 푸시: 작업 중인 브랜치를 건드리지 않기

작업일지는 문서만 바뀌므로 dev에 직접 푸시하는 예외 규칙을 적용했다. 문제는 실제로 돌려 보니 대상 저장소가 다른 feature 브랜치에 있고, 무관한 미커밋 변경이 잔뜩 있었다는 점이다. git checkout dev를 하면 변경이 섞이거나 충돌한다.

해결은 임시 워크트리다. origin/dev 기준으로 만들고, 작업일지 파일 하나만 복사해 커밋·푸시한 뒤 지운다.

git fetch origin dev -q
git worktree add -q --detach "$W" origin/dev
cp docs/workLog/2026-11-AICura-작업일지.md "$W/docs/workLog/"
git -C "$W" add docs/workLog/2026-11-AICura-작업일지.md
git -C "$W" commit -m "📝 docs: 2026-11 작업일지 추가"
git -C "$W" push origin HEAD:dev
git worktree remove --force "$W"

여기에 규칙도 스킬에 못 박았다. 커밋·푸시 대상은 스킬이 만든 작업일지 파일뿐이고, git add -A, git add ., git commit -a는 금지한다. 경로를 명시해서 add 한다. 스킬이 다른 변경까지 실수로 올리는 일을 막기 위해서다.

전체 기간 옵션

두 번째 인자로 all을 주면 이슈·PR이 있는 모든 달을 대상으로 달마다 파일을 하나씩 만든다. 스크립트는 기간 제한 없이 최대 1000건을 가져오고, 각 항목의 날짜 앞 7자리(YYYY-MM)로 달을 나눈다. 한 저장소에서 확인해 보니 이슈 61건, 이슈 없는 PR 39건, 배포 PR 19건이 6개월에 걸쳐 나왔다. 커밋은 파일들을 한 번에 묶는다.

배운 점

• 결과가 결정적이어야 하는 부분(수집, 날짜 변환, 분류)은 스크립트로, 요약처럼 판단이 필요한 부분만 모델에 맡기면 스킬이 안정적이다.
• 타임존과 gh의 기본 저장소 같은 환경 의존 값은 직접 확인한 값(origin URL, 명시적 KST 변환)으로 바꿔야 한다.
• 자동 커밋을 하는 스킬에는 "무엇을 커밋하지 않는가"를 명시해야 한다. 작업 중인 브랜치가 있는 저장소에서는 임시 워크트리가 안전하다.

결과물

https://github.com/aivance-kr/AICura/tree/dev/docs/workLog