jira-task-epiclisted
Install: claude install-skill mzd-hseokkim/jira-claude-code-integration
# jira-task-epic: Project Epic Scope
**Language Rule**: 프로젝트 CLAUDE.md의 Conventions 섹션 참고 (한국어 출력). 이슈 키·필드명·JSON 키는 영어 유지.
## Overview
"이번 작업은 epic v1.0이야" 한 마디를 `.jira-epic.json`에 고정해 두고, 이후 `/jira-task create`가 그 Epic 아래에 이슈를 만들도록 한다. 스코프가 없으면 create는 지금과 동일하게 Epic 없이 생성한다.
**필수**: `Read skills/_shared/epic-scope.md` — 파일 위치 결정, 스키마, `.gitignore` 등록 블록의 단일 출처.
## Prerequisites
- Jira MCP 서버 (`atlassian`) 연결됨 — `set`에서만 필요. `show`/`clear`는 파일만 다루므로 연결 없이 동작한다.
- git 레포 안에서 실행. 아니면 "git 레포 안에서 실행해 주세요" 안내 후 종료.
## Workflow
### Step 0: Parse Argument
`$ARGUMENTS`에서 서브액션을 결정한다.
| 입력 | 서브액션 |
|---|---|
| `show`, `status`, 빈 인자 | **show** |
| `clear`, `unset`, `해제`, `없음` | **clear** |
| `set <값>` 또는 그 외 자연어(`v1.0`, `MAE-100`, `이번 작업은 epic v1.0이야`) | **set** (값 = 서브액션 토큰을 제외한 나머지) |
자연어에서 값을 뽑을 때 `epic`/`에픽`/`이번 작업은`/`이야`/`으로` 같은 조사·군더더기는 떼어낸다. 남은 것이 없으면 `AskUserQuestion`으로 Epic 키나 이름을 묻는다.
### Step 1: Resolve File Path
`skills/_shared/epic-scope.md`의 경로 결정 블록을 실행해 `EPIC_FILE`을 얻는다. `NOT_A_GIT_REPO`면 종료.
### Step 2: show
파일이 없으면:
```
📌 Epic 스코프: 설정되지 않음
`/jira-task epic set <에픽 키 또는 이름>`으로 지정하면 이후 create가 그 Epic 아래에 이슈를 만듭니다.
```
있으면 키/요약/설정 시각을 출력한다. 이때 `jira_get_issue`로 현재 상태를 1회 확인해 `status`가 `Done`이면 아래 줄을 덧붙인다:
```
⚠️ 이 Epic은 이미 Done 상태입니다. 새 작업은 다른 Epic이 맞는지 확인하세요.
```
### Step 3: clear
파일이 없으면 "설정된 Epic 스코프가 없습니다" 출력 후 종료. 있으면 삭제하고 어떤 Epic이 해제됐는지 알린다.
```bash
rm -f "$EPIC_FILE"
```
### Step 4: set — Epic 해석
입력값이 **이슈 키 형태**(`[A-Z][A-Z0-9]+-\d+`)인