jira-task-reviewlisted
Install: claude install-skill mzd-hseokkim/jira-claude-code-integration
# jira-task-review: Code Review + Gap Analysis with Jira Reporting
**Language Rule**: 프로젝트 CLAUDE.md의 Conventions 섹션 참고 (한국어 출력, Jira 코멘트 제목은 영어).
## Reviewer Independence Rule (필수)
Mode A/B 분기 규칙과 Mode A subagent prompt 전문은 `Read skills/jira-task-review/refs/reviewer-mode.md`로 참조.
요약: `[review-self-mode]` 마커가 없으면 Mode A(Agent 위임, opus 강제), 있으면 Mode B(wrapper agent가 직접 수행). self-praise / 사각지대 누락 차단이 목적.
## Workflow
### Context Optimization
이 스킬에서 `mcp__atlassian__jira_get_issue`를 호출해야 하면 먼저 `.jira-context.json`의 `cachedIssue`를 확인한다 (CLAUDE.md "Issue Cache" 참고). hit이면 호출 생략. miss이면 다음 파라미터로 호출 후 cache 갱신:
- `fields="summary,status,description,issuetype"`
- `comment_limit=0`
### Step 1: Prepare Context (main 세션)
**Level 판정**: `.jira-context.json.breakdownLevel` → 없으면 `cachedIssue.issuetype` 폴백 (approach Step 0 동일 규칙: Subtask/Task/Bug→L1, Story→L2, Epic→L3, 그 외→L1). 판정 결과를 이후 단계에서 사용.
| Level | 동작 |
|-------|------|
| L1 | 경량 리뷰 — 핵심 findings만 (gap-analysis 경량, report 인라인/파일 생략 허용) |
| L2 | 현행 유지 — 전체 gap-analysis + 리뷰 report 파일 생성 |
| L3 | child Story별 책임 — 본 스킬이 L3 Epic에서 호출되면 "child Story 단위로 실행할 것" 안내 후 조기 종료 |
리뷰 컨텍스트를 준비한다 — main 세션이 한다.
```bash
git log --oneline <base-branch>..feature/<TASK-ID>
git diff --name-only <base-branch>..feature/<TASK-ID>
```
설계 문서 존재 여부 확인:
- `docs/design/<TASK-ID>.design.md` ��재? (Gap Analysis 가능 여부)
- `docs/plan/<TASK-ID>.plan.md` 존재? (Acceptance Criteria 참조)
### Step 2: Perform Review (Mode A: delegate / Mode B: self)
호출 prompt