GitHub 오픈소스 기여 도우미
내가 관리하지 않는 오픈소스 저장소에 '머지되는' PR을 보내기 위한 단계별 실전 플레이북.
개발·코딩중급★ 1,323⑂ 212AI 점수 9/10마지막 업데이트: 2026. 8. 8.
무엇을 해주나
남의 저장소에 PR을 올릴 때 필요한 전 과정을 5단계로 나눠 Claude가 대신 챙겨줍니다.
- Phase 1 사전 조사: CONTRIBUTING.md를 '스타일 조언'이 아닌 '머지 조건 계약서'로 읽고, AI 기여 조항·이슈 선행 규칙·테스트 명령어를 추출합니다.
gh pr list로 최근 머지된 PR의 diff 크기를 뽑아 내 PR이 과도하게 큰지 판정합니다. - Phase 2 구현: 업스트림 main에서 브랜치를 따고, 스코프 계약서를 세워 '온 김에 리팩터링' 같은 스코프 크립을 차단합니다. Conventional Commits와
--fixup+ autosquash 워크플로를 안내합니다. - Phase 3 품질 게이트: 프로젝트가 지정한 lint/test를 실제로 돌리고, GUI 앱은 데이터 디렉터리를 격리해 진짜 E2E를 실행합니다. "테스트했다"고 쓰기 전 증거가 있는지 자가 감사합니다.
- Phase 4 PR 설명: 요약/변경/동기/테스트 계획/호환성/스크린샷/AI 사용 고지까지 포함한 본문 뼈대와 테스트 커버리지 매트릭스 표를 만들어 줍니다.
- Phase 5 제출 후: CodeRabbit·Codex 같은 봇 리뷰에 라인 단위로 답글을 달고,
--force-with-lease리베이스로 리뷰 스레드를 보존합니다.
이런 분께 추천
- 오픈소스에 처음 기여하는데 어디서부터 잘못되는지 모르겠는 개발자
- AI로 코드를 작성해 PR을 올렸다가 "AI 덤프"로 닫힌 경험이 있는 분
- 사내 PR 문화는 익숙하지만 외부 메인테이너와의 커뮤니케이션이 어려운 분
- 리베이스 충돌·봇 리뷰 응답을 매번 검색해서 처리하는 분
활용 예시
- "vercel/next.js에 이 버그 수정 PR 올려줘" → CONTRIBUTING.md를 먼저 읽고, 최근 머지 PR 크기 분포를 뽑아 내 diff가 적정한지 알려준 뒤, 테스트 명령을 실행하고 증거가 담긴 PR 본문을 작성합니다.
- "봇 리뷰 코멘트 5개에 답변해줘" → 각 지적을 확률/비용/시나리오 기준으로 걸러내고,
gh api ... in_reply_to로 해당 라인에 커밋 해시와 함께 답글을 답니다. - "업스트림 main과 충돌났어, 리베이스해줘" → fetch→rebase→충돌 해결→
--force-with-lease푸시 순서로 진행하며, 충돌 해결 중 무관한 변경이 섞이지 않게 감시합니다.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 daymade/claude-code-skills 의 github-contributor 폴더를 내 ~/.claude/skills/github-contributor/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/daymade/claude-code-skills.git /tmp/claude-code-skills && mkdir -p ~/.claude/skills && cp -r /tmp/claude-code-skills/github-contributor ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 사전 준비: 터미널에서
git --version과gh --version을 확인합니다. GitHub CLI가 없다면brew install gh(macOS) 또는 cli.github.com에서 설치하세요. - GitHub 로그인:
gh auth login을 실행해 계정 인증을 마칩니다. 이 스킬의 대부분 명령이gh에 의존합니다. - 저장소 클론:
git clone https://github.com/daymade/claude-code-skills.git /tmp/claude-code-skills - 스킬 폴더 생성 및 복사:
mkdir -p ~/.claude/skills && cp -r /tmp/claude-code-skills/github-contributor ~/.claude/skills/ - 확인:
ls ~/.claude/skills/github-contributor에SKILL.md와references/폴더가 보이면 성공입니다. - 적용: Claude Code를 재시작한 뒤 "이 저장소에 PR 올려줘" 또는 "upstream main으로 리베이스해줘"라고 말하면 스킬이 자동으로 활성화됩니다.
- 프로젝트 단위로만 쓰려면 4단계의 경로를
~/.claude/skills대신 프로젝트 내.claude/skills로 바꾸면 됩니다.
GitHub에서 원본 보기 ↗라이선스: MIT