이슈 백로그 Triage Skill

이슈 백로그 Triage

이 레포의 열린 GitHub 이슈를 전수 평가하고, 착수 추천과 close 후보를 근거와 함께 제안한다. close 실행은 항상 사용자 확인 뒤 승인된 이슈에만 수행한다.

현재 repo를 확인한다: gh repo view --json nameWithOwner -q .nameWithOwner.
기본 대상은 열린 이슈 전체다: gh issue list --state open --limit 200 --json number,title,labels,createdAt,updatedAt,url,body.
사용자가 범위를 좁히면 --label, --search, 제목/본문 키워드 검색을 조합하되 --state open을 유지한다.
결과가 limit에 걸릴 가능성이 있으면 limit를 늘리거나 검색 조건을 나누어 누락 가능성을 보고한다.
관련 PR은 필요할 때만 gh pr list --state all --search "<키워드>"로 보조 확인한다.

각 이슈마다 본문 주장을 먼저 요약한 뒤, 현재 코드와 변경 이력을 실측한다.

Freshness: 전제가 여전히 유효한지 확인한다. 관련 파일 rg -n, git log --oneline -- <path>, 관련 PR/이슈 상태로 이미 해결됐는지 본다.
False-positive: 주장한 문제가 실제로 재현되거나 코드상 존재하는지 확인한다. 없으면 왜 false-positive로 보는지 파일/라인 근거를 남긴다.
YAGNI/NGMI/over-engineering: 이 레포의 실제 사용 흐름, 기존 단순화 관습, 유지보수 비용 대비 필요한 복잡도인지 판단한다.
공수 대비 효용: 공수는 S/M/L로, 기대 효용은 high/medium/low로 표시한다. 공수 추정 근거를 한 줄로 남긴다.
선행관계: 다른 이슈, PR, 설정 반영, 외부 확인이 먼저 필요한지 확인한다.
병렬 가능성: 서로 다른 파일/서비스/스킬 영역이면 병렬 가능, 같은 모듈이나 같은 정책 문서면 충돌 가능으로 표시한다.

근거 파일은 가능하면 path:line 형식으로 적는다. 라인 번호가 불안정하면 파일 경로와 검색어, 관련 커밋 해시를 함께 적는다.

사용자에게 다음 세 가지를 한 번에 제시한다.

평가 표
- 열: 이슈, 판정, 근거, freshness, false-positive/YAGNI 여부, 공수, 효용, 병렬 가능성.
- 판정 값은 "착수 추천", "보류", "추가 확인", "close 후보" 중 하나를 우선 사용한다.
착수 추천 top N
- 효용/공수 비율, unblock 효과, 회귀 위험을 기준으로 정렬한다.
- 각 추천에는 첫 작업 파일이나 첫 확인 명령을 포함한다.
close 후보 목록
- 각 후보마다 close reason을 completed 또는 not planned로 제안한다.
- gh issue close에 넣을 사유 초안을 함께 작성한다.
- 사용자 이견 가능성이 있는 항목은 close 후보 대신 "추가 확인"으로 둔다.

close 후보가 있으면 질문 도구로 사용자에게 승인 범위를 묻는다. 질문에는 이슈 번호, 제목, reason, 사유 초안을 포함한다.

선택지는 기본적으로 다음 형태를 사용한다.

승인된 항목에 대해서만 다음 형식으로 실행한다.

gh issue close <n> --comment "<사유>" --reason <completed|not planned>

사유에 shell 특수 문자가 많으면 안전하게 한 줄 문자열로 정리한 뒤 전달한다. close 실행 후 성공/실패를 이슈별로 보고한다.