jira-create

Files (3)

• SKILL.md
• bulk-document-flow.md · references/
• description-templates.md · references/

SKILL.md (first lines)

Codex 질문 도구: `request_user_input`은 제공되는 모드에서만 사용한다. 사용할 수 없으면 `request_user_input_async` 또는 간결한 평문 질문을 사용한다. 승인 요청은 현재 세션의 상위 지침을 따르고, 응답이 없다는 이유로 승인 처리하지 않는다.


# jira-create — Jira 이슈 등록

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

지라에 댓글이나 설명을 작성할 때 쓸 언어는 `.codex/harness.json` 의 `jira.comment_lang` 값을 따른다 (미설정 시 한국어).

## Usage

```
# 단일 모드 (자연어)
/jira-create 대시보드에 KPI 위젯 추가하는 이슈 만들어줘
/jira-create [ABC] 로그인 화면 자동완성 버그 등록

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

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

## 모드 자동 판별

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

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

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

## 단일 모드 절차

### 1. cloudId 확정

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

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

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

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

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

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

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

### 4. 스택 감지

감지 매핑 + 스택별 라벨 후보는 [references/stack-detection.md](references/stack-detection.md) 참조(프로젝트에 `.codex/harness.json` 이 있으면 `stacks` 가 우선).

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

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

`jira-harness 플러그인의 issue 스킬` 의 grill·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 위젯 추가"

From bigbulgogiburger/jira-harness, MIT.

More from bigbulgogiburger/jira-harness