9차시. Issue, Label, Milestone

Day 2 · 11:00–11:45 (수업 45분) / 11:45–12:00 (휴식 15분)
저장소: portfolio-web
선수: 8차시 프로필과 기록

이 차시에서 하는 일

개발할 기능이나 고쳐야 할 버그를 머릿속으로만 생각하면 중요한 작업을 빠뜨리게 된다. GitHub Issue를 활용하면 할 일을 카드 형태로 만들고, 색상 라벨로 분류하며, 목표 마감일(Milestone)별로 진척도를 시각적으로 추적할 수 있다.

Issue: 작업 요청서 및 버그 리포트 티켓이다.
Label: 이슈의 종류(bug, enhancement, documentation)를 나타내는 색상 태그다.
Milestone: 목표 스프린트와 소속 이슈들의 해결률을 게이지 바로 표시한다.
GitHub CLI (gh): 터미널에서 gh issue list 등을 실행하는 공식 CLI 도구다. 설치와 인증은 선택 사항이다.
ChatGPT-GitHub 연동: 저장소 코드를 AI로 질의하는 기능이다. 권한과 보안을 먼저 확인한다.

GitHub 저장소 웹 페이지의 Issues 탭을 연다.
Milestones 메뉴로 들어가 v1.0 포트폴리오 완성 마일스톤을 만든다.
새 이슈 2건을 등록한다.
- 1건: [기능] 다크모드 토글 버튼 추가 (Label: enhancement, Milestone 할당)
- 1건: [문서] README에 라이선스 표기 보완 (Label: documentation, Milestone 할당)
Milestones 탭에서 0% 진척도 게이지를 확인한다.
강사 시연으로 gh issue list 명령을 관찰한다.
필요하면 ChatGPT-GitHub 연동의 역할과 보안 주의점을 이해한다.

bash

gh issue list --repo 계정이름/portfolio-web

text

Issue 초안 작성: 목적, 하지 않을 일, 완료 조건 3개 제안
Label과 Milestone 차이 설명

markdown

## 목적
다크모드 토글 버튼을 추가한다.

## 하지 않을 일
- 전체 테마 시스템 재작성
- 외부 라이브러리 도입

## 완료 조건
- [ ] 토글 버튼이 화면에 보인다.
- [ ] 클릭 시 배경색이 바뀐다.
- [ ] README에 사용법이 적혀 있다.

증상	원인	대응
`gh` 명령 실패	CLI 미설치 또는 인증 안 됨	브라우저로 동일 작업을 수행한다
Issue 권한 없음	저장소 권한 부족	개인 저장소에서 재시도한다
Milestone이 보이지 않음	메뉴 위치를 찾지 못함	저장소 `Issues` 탭의 `Milestones` 메뉴를 다시 확인한다
Label이 적용되지 않음	Label 미생성	`Labels` 메뉴에서 먼저 Label을 만든다