gihwan-dev/gitlab-issue-picker

GitLab Issue Picker

glab CLI로 GitLab 이슈를 수집하고 우선순위를 분석하여 지금 작업할 이슈를 추천한다.

성공 기준

이 스킬의 실행이 성공으로 간주되려면 다음을 모두 충족해야 한다:

• glab 인증과 GitLab 리모트 확인을 통과했다.
• 최소 1개 이상의 이슈를 수집하여 우선순위 카드를 출력했다.
• 각 카드에 IID, 제목, 우선순위 근거, 복잡도 추정이 포함되어 있다.
• "작업할 이슈 번호를 알려주세요"로 후속 안내를 완료했다.

위 조건 중 하나라도 실패하면 실패 원인을 한 줄로 보고하고 종료한다.

전제 조건

glab auth status
git remote -v

• glab auth status가 비정상 종료하면 glab auth login 안내 후 즉시 종료. 이후 단계를 진행하지 않는다.
• git remote -v 출력에 GitLab 호스트가 없으면 스킬 사용 불가, 사용자에게 알리고 즉시 종료.
• glab 명령이 unknown command, not found, 또는 HTTP 4xx/5xx 에러를 반환하면 원인을 한 줄로 설명하고 즉시 종료.

Workflow

1. 이슈 수집

두 명령을 병렬 실행하여 할당/미할당 이슈를 모두 수집한다.

glab issue list --assignee=@me -P 20 --output json 2>/dev/null
glab issue list --assignee=none -P 20 --output json 2>/dev/null

수집 실패 처리:

• 한쪽만 실패하면 성공한 쪽 결과만 사용한다.
• 둘 다 빈 결과([] 또는 null)면 glab issue list -P 20 --output json으로 전체 조회 폴백.
• 전체 조회도 빈 결과면 "열린 이슈가 없습니다"를 출력하고 즉시 종료.
• JSON 파싱 실패(glab이 HTML이나 에러 메시지를 반환한 경우) 시 원본 출력 첫 3줄을 인용하며 "glab 응답이 JSON이 아닙니다"를 보고하고 즉시 종료.

중복 이슈는 IID 기준으로 제거한다.

2. 우선순위 분석

수집된 JSON에서 다음 신호를 종합하여 이슈별 우선순위를 판단한다.

| 신호 | 감지 방법 | 중요도 | |------|----------|--------| | 우선순위 라벨 | labels[]에서 priority::1, priority::2, P1, P2, urgent, critical, high, medium, low 등 | 최상 | | 심각도 라벨 | labels[]에서 severity::1, severity::critical, S1, S2 등 | 상 | | 마감일 | due_date — 오늘에 가까울수록 높음, 초과(overdue)면 최우선 | 상 | | 가중치 | weight — 높을수록 중요 | 중 | | 마일스톤 마감 | milestone.due_date — 근접 시 우선 | 중 | | 생성일 | created_at — 오래된 이슈 약간 우선 | tiebreaker |

프로젝트에 우선순위/심각도 라벨이 없으면 마감일 → 가중치 → 생성일 순서로 판단한다.

라벨이 전혀 없고 마감일/가중치도 미설정인 이슈는 생성일 순으로 정렬하되, "우선순위 판단 근거 없음 — 라벨 또는 마감일 설정 권장"이라고 명시한다.

3. 추천 출력

카테고리별 Top 5를 카드 형태로 출력한다.

## 내게 할당된 이슈 (Top 5)

### 1. #142 — 로그인 페이지 비밀번호 재설정 버튼 미작동

| 항목 | 내용 |
|------|------|
| 요약 | 비밀번호 재설정 버튼 클릭 시 아무 동작 없는 버그 |
| 우선순위 근거 | priority::1, 마감 D-3 (2026-04-18) |
| 예상 복잡도 | 낮음 — 이벤트 핸들러 누락 가능성 |
| 라벨 | bug, priority::1, frontend |

---

### 2. #98 — ...

---

## 미할당 이슈 (Top 5)

### 1. #201 — ...

각 카드의 필드:

• 요약: 이슈 제목이 아닌, 본문을 읽고 쉬운 한국어 한 줄로 설명. 본문이 비어 있거나 접근 불가하면 제목을 그대로 사용하고 "(본문 없음)"을 덧붙인다.
• 우선순위 근거: 이 이슈가 왜 상위 랭크인지 (라벨, 마감일 등).
• 예상 복잡도: 아래 규칙으로 추정.
• 라벨: 이슈에 붙은 라벨 나열.

4. 복잡도 추정

| 신호 | 판단 | |------|------| | size::S, size::XS, weight ≤ 2 | 낮음 | | size::M, weight 3~5 | 중간 | | size::L, size::XL, weight ≥ 6 | 높음 | | 설명이 짧고 변경 범위가 좁음 | 낮음 | | 여러 파일/컴포넌트 언급 | 높음 | | 판단 근거 부족 | "판단 불가 — 이슈 상세 확인 필요" |

5. 후속 안내

추천 목록 출력 후:

작업할 이슈 번호를 알려주세요.
선택하면 바로 작업을 시작할 수 있습니다.

카테고리가 하나만 결과가 있으면 해당 카테고리만 표시한다. 이슈가 5개 미만이면 있는 만큼만 표시한다.