github-ops

name	github-ops
description	GitHub 저장소 운영, 자동화, 관리 스킬입니다. 이슈 triage, PR 관리, CI/CD 운영, 릴리스 관리, 보안 모니터링을 `gh` CLI로 처리합니다. 단순 git 명령을 넘는 GitHub 운영 작업에 사용합니다.
origin	ECC

GitHub Operations

커뮤니티 건강, CI 신뢰성, 기여자 경험을 중심으로 GitHub 저장소를 운영합니다.

활성화 시점

• 이슈 triage
• PR 관리
• CI/CD 실패 디버깅
• 릴리스 및 changelog 준비
• Dependabot과 보안 경고 모니터링
• 오픈소스 프로젝트의 기여자 경험 관리
• 사용자가 "check GitHub", "triage issues", "review PRs", "merge", "release", "CI is broken"이라고 할 때

도구 요구사항

• gh CLI: 모든 GitHub API 작업용
• gh auth login으로 저장소 접근 설정

이슈 triage

각 이슈를 유형과 우선순위로 분류합니다.

유형: bug, feature-request, question, documentation, enhancement, duplicate, invalid, good-first-issue

우선순위: critical, high, medium, low

Triage 워크플로

1. 이슈 제목, 본문, 코멘트 읽기
2. 기존 이슈와 중복인지 확인
3. gh issue edit --add-label로 적절한 라벨 부여
4. 질문이면 유용한 답변 작성
5. 추가 정보가 필요한 버그면 재현 절차 요청
6. 초보자 이슈면 good-first-issue 라벨 추가
7. 중복이면 원본 링크와 함께 코멘트 후 duplicate 라벨 추가

gh issue list --search "keyword" --state all --limit 20
gh issue edit <number> --add-label "bug,high-priority"
gh issue comment <number> --body "Thanks for reporting. Could you share reproduction steps?"

PR 관리

리뷰 체크리스트

1. CI 상태 확인: gh pr checks <number>
2. merge 가능 여부 확인: gh pr view <number> --json mergeable
3. 나이와 마지막 활동 확인
4. 5일 넘게 리뷰 없는 PR 표시
5. 커뮤니티 PR이면 테스트와 규약 준수 확인

Stale 정책

• 14일 이상 활동 없는 이슈: stale 라벨과 업데이트 요청 코멘트
• 7일 이상 활동 없는 PR: 계속 진행 중인지 확인 코멘트
• 30일 응답 없는 stale 이슈는 자동 종료

gh issue list --label "stale" --state open
gh pr list --json number,title,updatedAt --jq '.[] | select(.updatedAt < "2026-03-01")'

CI/CD 운영

CI가 실패하면:

1. gh run view <run-id> --log-failed로 워크플로 런 확인
2. 실패 단계 식별
3. flaky test인지 실제 실패인지 구분
4. 실제 실패면 근본 원인과 수정 제안
5. flaky면 패턴을 기록

gh run list --status failure --limit 10
gh run view <run-id> --log-failed
gh run rerun <run-id> --failed

릴리스 관리

릴리스 준비 시:

1. main의 CI가 모두 초록인지 확인
2. 미출시 변경 검토
3. PR 제목에서 changelog 생성
4. gh release create

gh pr list --state merged --base main --search "merged:>2026-03-01"
gh release create v1.2.0 --title "v1.2.0" --generate-notes
gh release create v1.3.0-rc1 --prerelease --title "v1.3.0 Release Candidate 1"

보안 모니터링

gh api repos/{owner}/{repo}/dependabot/alerts --jq '.[].security_advisory.summary'
gh api repos/{owner}/{repo}/secret-scanning/alerts --jq '.[].state'
gh pr list --label "dependencies" --json number,title

• 안전한 의존성 bump는 검토 후 자동 머지 검토
• critical/high 경고는 즉시 표시
• Dependabot 경고는 최소 주간 단위 점검

품질 게이트

GitHub 운영 작업을 마치기 전에:

• triage한 이슈에 적절한 라벨이 있다
• 7일 넘게 방치된 PR에는 리뷰나 코멘트가 있다
• CI 실패는 단순 재실행이 아니라 조사되었다
• 릴리스는 정확한 changelog를 포함한다
• 보안 경고는 인지되고 추적된다