jira-create

Files (5)

• SKILL.md
• evals.json · evals/
• bulk-document-flow.md · references/
• description-templates.md · references/
• jira-best-practices.md · references/

SKILL.md (first lines)

# jira-create — Jira 이슈 등록

자연어 한 줄 혹은 문서(spec / 주차 계획 / RFC 등)를 받아 Jira 이슈로 만든다. 단일 이슈는 곧바로 등록하고, 문서 기반이면 에픽 → 이슈 → 하위이슈 계층으로 일괄 등록한다.

지라에 댓글이나 설명을 작성할 때에는 한글로 작성한다.

## Usage

```
# 단일 모드 (자연어)
/jira-create 대시보드에 KPI 위젯 추가하는 이슈 만들어줘
/jira-create [STD] 정산 화면 엑셀 다운로드 버그 등록

# 벌크 모드 (문서)
/jira-create docs/w1-w4.md 읽고 STD 프로젝트에 에픽→이슈→하위이슈로 등록
/jira-create plan.md 보고 이슈 만들어줘
```

옵션 인자:
- **prefix**: 대괄호(`[STD]`) 또는 명시적 단어("STD 프로젝트") 어느 쪽이든 인식. 미지정 시 후술 절차로 자동 감지.
- **mode 힌트**: "에픽", "하위이슈", "계층", "여러 이슈" 같은 단어가 있으면 벌크 모드로 가정.

## 모드 자동 판별

다음 중 하나라도 해당하면 **벌크 모드**, 그 외에는 **단일 모드**로 진행한다:

- 사용자 입력에 **파일 경로** 가 포함됨 (`*.md`, `*.txt`, `*.pdf`, `docs/...`)
- "에픽", "epic", "하위이슈", "subtask", "계층", "여러 이슈", "한 번에 등록" 같은 키워드
- 문서 안에 명백한 계층 구조(주차/Phase/모듈별 헤딩)가 있음

벌크 모드 절차는 `references/bulk-document-flow.md`를 따른다. 아래는 단일 모드 절차다.

## 단일 모드 절차

### 1. cloudId 확정

`mcp__atlassian__getAccessibleAtlassianResources` 로 cloudId를 확보한다. 사이트가 여러 개라면 가장 최근에 사용한 사이트(또는 사용자가 명시한 사이트)를 선택한다.

### 2. projectKey 확정 (prefix 감지)

다음 우선순위로 **첫 번째로 확정되는 값**을 사용한다:

1. **사용자 입력 명시** — `[STD]`, `STD 프로젝트`, `--prefix STD` 등
2. **현재 git 브랜치명** — `feature/PROJ-200-foo` → `PROJ`
3. **최근 브랜치 목록** — `git branch --all | grep -oE '[A-Z][A-Z0-9]+-[0-9]+' | sort -u | head` 결과의 다수 prefix
4. **최근 커밋 메시지** — `git log --oneline -50 | grep -oE '[A-Z][A-Z0-9]+-[0-9]+'`
5. **`mcp__atlassian__getVisibleJiraProjects`** — `action: "create"` 로 호출하여 사용 가능한 프로젝트 목록 조회. 1개뿐이면 그것 사용. 여러 개면 다음 6번으로.
6. **사용자에게 질문** — `AskUserQuestion`으로 후보 3-4개 제시. 절대 임의로 고르지 않는다.

> 한 번 확정되면 본 작업 동안에는 다시 묻지 않는다. 단, 사용자가 명시적으로 다른 프로젝트를 지목하면 즉시 교체한다.

### 3. 이슈 타입 메타데이터 조회

확정된 projectKey에 대해 `mcp__atlassian__getJiraProjectIssueTypesMetadata`를 호출하여 사용 가능한 issueTypeName 목록을 확인한다 (`Task`, `Story`, `Bug`, `Epic`, `Sub-task` 등). 프로젝트마다 다를 수 있으므로 **항상 메타에서 확인된 이름만 사용**한다.

### 4. 스택 감지

감지 매핑 + 스택별 라벨 후보는 `~/.claude/skills/_stack-detection.md` §1 + §3 참조.

스택 감지는 라벨 자동 부여와 issueType 추정(예: 백엔드 프로젝트면 Story 대신 Task가 표준일 수 있음)에 사용한다.

### 5. 라이트 코드/문맥 분석

`/jira-clarify` 와 `/jira-plan` 이 이후 단계에서 깊이 파주므로 **여기서는 가볍게**만 본다. 목적은 "이 이슈가 말이 되는가, 어디쯤에 손이 갈 가능성이 있는가" 확인.

- `CLAUDE.md` 가 있으면 1회 읽어 도메인 용어 확인
- 사용자 입력의 명사구를 키워드로 `Grep` 1-2회 (예: "KPI 위젯" → `Kpi`, `kpi`, `dashboard`)
- 매치되는 파일이 있으면 1-2개만 짧게 확인하여 "관련 파일이 있다" 정도 파악
- 매치 없어도 진행 — 신규 기능일 수 있다

깊이 파지 않는다. 5분 이상 쓰지 않는다.

### 6. 이슈 타입 / 우선순위 / 라벨 결정

#### 이슈 타입

사용자 입력의 단어로 1차 추정 후 메타데이터에 존재하는 이름으로 매핑:

- "버그", "오류", "에러", "안 됨", "터짐" → **Bug** (없으면 Task)
- "에픽", "epic", "이니셔티브" → **Epic**
- "하위", "서브", "subtask" → **Sub-task** (parent 필요)
- "기능 추가", "구현", "만들어", "도입" → **Story** (없으면 Task)
- 그 외 / 모호 → **Task** (가장 중립적)

#### 우선순위

명시적 단어 없으면 설정하지 않는다 (프로젝트 기본값 사용). 명시되면 매핑:

- "긴급", "급함", "ASAP", "블로커" → `Highest` 또는 `High`
- "사소", "낮음", "나중에" → `Low`

#### 라벨 (kebab-case 권장)

자동 부여 후보 (해당하는 것만):
- 스택: `spring-boot` / `vue` / `react` / `flutter` / `python` / `go` / `rust`
- 영역: `backend` / `frontend` / `mobile` / `infra` / `docs`
- 종류: `feature` / `bug` / `tech-debt` / `refactor` / `docs` / `chore`
- 출처(벌크 모드): `from-doc-<basename>` (예: `from-doc-w1-w4`) — Jira 라벨은 영문/숫자/하이픈/언더스코어만 안전하므로 콜론 사용 금지

> 라벨은 case-sensitive다. **항상 소문자 + kebab-case**로 통일. `Spring-Boot`, `Spring_Boot`, `springBoot` 같이 변형하면 검색에서 분리된다.

자세한 라벨 컨벤션은 `references/jira-best-practices.md` 참고.

#### 날짜

- **Start date / Due date 는 기본적으로 설정하지 않는다.** 사용자가 명시적으로 일정을 언급한 경우에만 설정한다.
- 시스템 필드 `duedate` 만 백로그에 표시된다. 커스텀 시작일 필드는 프로젝트마다 키가 달라(`customfield_10015` 등) 충돌 위험이 있으니, 명시 요청 없이는 건드리지 않는다.

### 7. 드래프트 작성

`contentFormat: "markdown"` 으로 createJiraIssue를 호출한다 (ADF JSON 직접 작성보다 안전하고 가독성 좋음).

#### Summary 작성 규칙

- **동사로 시작하는 행동형**: "추가한다", "수정한다", "리팩터링한다" 보다는 명사구 + 명료한 행동 → "[Dashboard] KPI 위젯 추가"
- **컴포넌트 prefix 권장** (`[Dashboard]`, `[Settlement]`, `[API]`)
- **70자 이내**
- **버그면 증상 + 환경**: "[정산] 엑셀 다운로드 시 한글 파일명 깨짐"

From bigbulgogiburger/claude_jira_harness, MIT.

More from bigbulgogiburger/claude_jira_harness