Claude Code로 Issues & Projects 관리하기
Claude Code에서 GitHub Issues와 Projects를 효율적으로 관리하는 실전 프롬프트 모음입니다. 복사해서 바로 사용하세요.
사전 준비
gh auth login완료 (GitHub CLI 설치 가이드)- Claude Code에서 GitHub 저장소 디렉토리를 열고 있는 상태
Issue 관리
이슈 생성
"회원가입 시 이메일 인증 메일이 발송되지 않음" 이슈 만들어줘.
라벨은 bug, 담당자는 나로 지정해줘.
상세한 이슈를 만들고 싶을 때:
아래 내용으로 이슈 만들어줘:
제목: 로그인 페이지 로딩 속도 개선
라벨: enhancement, performance
담당자: @swjeong
마일스톤: v1.2
본문:
- 현재 로그인 페이지 초기 로딩이 3초 이상 걸림
- 번들 사이즈 분석 후 코드 스플리팅 적용 필요
- 목표: 1.5초 이내로 개선
이슈 조회
# 전체 목록
열려있는 이슈 목록 보여줘
# 필터링
bug 라벨이 붙은 이슈만 보여줘
# 내가 담당하는 것만
나한테 할당된 이슈만 보여줘
# 특정 이슈 상세
42번 이슈 내용 자세히 보여줘
이슈에 태스크 리스트 추가
42번 이슈에 아래 태스크 목록을 추가해줘:
- [ ] DB 스키마 설계
- [ ] API 엔드포인트 구현
- [ ] 프론트엔드 폼 작성
- [ ] 단위 테스트
- [ ] E2E 테스트
이슈 수정·닫기
42번 이슈에 priority:high 라벨 추가해줘
35번 이슈에 "원인 파악 완료, PR #51에서 수정 중" 코멘트 달아줘
42번 이슈 닫아줘
이슈 기반으로 코드 수정
42번 이슈 읽고, 해당 버그 수정해줘. 수정 끝나면 커밋하고 PR도 만들어줘.
PR 본문에 "Closes #42" 포함해서.
Project(보드) 관리
프로젝트 현황 파악
우리 GitHub 프로젝트 목록 보여줘
1번 프로젝트의 전체 아이템 보여줘
1번 프로젝트에서 In Progress 상태인 것만 보여줘
이슈를 프로젝트에 추가
42번 이슈를 1번 프로젝트에 추가해줘
최근에 만든 bug 라벨 이슈들 전부 1번 프로젝트에 추가해줘
상태 변경
42번 이슈를 프로젝트에서 "In Progress"로 옮겨줘
완료된 이슈들 상태를 "Done"으로 변경해줘
스프린트·계획 관련
스프린트 계획 세우기
이번 주 스프린트에 넣을 이슈를 추천해줘.
열려있는 이슈 중 priority:high 라벨이 붙은 것 위주로.
스프린트 회고
이번 스프린트(마일스톤 v1.2)의 진행 상황을 정리해줘.
완료된 이슈, 미완료 이슈, 새로 추가된 이슈를 구분해서 보여줘.
마일스톤 관리
"v1.3 릴리스" 마일스톤 만들어줘. 마감일은 5월 30일로.
43, 44, 45번 이슈를 v1.3 마일스톤에 연결해줘
한 번에 여러 이슈 일괄 생성
아래 내용으로 이슈를 각각 만들어줘. 라벨은 전부 enhancement으로:
1. 제목: 다크모드 지원 / 본문: CSS 변수 기반 테마 전환 구현
2. 제목: 검색 성능 개선 / 본문: 인덱스 최적화 및 debounce 적용
3. 제목: 모바일 반응형 개선 / 본문: 768px 이하 레이아웃 수정
4. 제목: API 에러 핸들링 통일 / 본문: 공통 에러 응답 포맷 정의
이슈 템플릿 생성
.github/ISSUE_TEMPLATE/ 에 버그 리포트 템플릿 만들어줘.
재현 절차, 기대 동작, 실제 동작, 환경 정보, 스크린샷 섹션 포함해서.
보고·요약 요청
주간 리포트
이번 주(월~금) 동안 닫힌 이슈와 새로 열린 이슈를 정리해줘.
라벨별로 그룹핑해서 보여줘.
특정 담당자 현황
@swjeong 에게 할당된 열려있는 이슈를 우선순위 라벨별로 정리해줘
릴리스 노트 초안
v1.2 마일스톤에 포함된 이슈들로 릴리스 노트 초안 작성해줘.
Features, Bug Fixes, Improvements 카테고리로 나눠서.
프롬프트 작성 팁
좋은 프롬프트의 패턴
| 요소 | 예시 |
|---|---|
| 대상 명시 | "42번 이슈", "bug 라벨 이슈들", "1번 프로젝트" |
| 행동 명시 | "만들어줘", "보여줘", "추가해줘", "옮겨줘" |
| 조건 추가 | "priority:high만", "이번 주 것만", "나한테 할당된 것" |
| 후속 작업 연결 | "수정하고 커밋하고 PR도 만들어줘" |
피해야 할 패턴
# 모호함 — 어떤 프로젝트? 어떤 이슈?
❌ "이슈 좀 정리해줘"
# 구체적으로
✅ "1번 프로젝트에서 Done 상태인데 아직 이슈가 안 닫힌 것들 닫아줘"
# 한 번에 너무 많은 것
❌ "프로젝트 전체 재구성하고 이슈 다 정리하고 릴리스도 만들어줘"
# 단계별로
✅ "먼저 열려있는 이슈 목록 보여줘"
✅ "이 중에서 완료된 건 닫아줘"
✅ "남은 이슈로 v1.3 마일스톤 만들어줘"