new

Files (4)

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

SKILL.md (first lines)

# new — 이슈 생성

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

이 스킬은 트래커를 고정하지 않는다. `.claude/harness.json` 의 `tracker` 값이 등록 경로를 가른다:

| tracker | 등록 경로 | 세부 절차 |
|---------|----------|----------|
| `local`(기본) | 스크립트가 그 자리에서 — `scripts/cases.mjs new` | 이 문서 § 6 |
| `jira` | 라우터가 Atlassian MCP 로 | [`trackers/jira/references/create.md`](../../trackers/jira/references/create.md) |
| 그 외(`github`·`beads`·`gitlab` …) | 어댑터가 direct 면 `cases.mjs`, 아니면 그 어댑터의 references | 어댑터 문서 |

`<P>` = 플러그인 루트 절대 경로. 이 스킬이 로드될 때 표시되는 `Base directory for this skill` 의 **두 단계 위**다(`skills/new` 의 부모의 부모). 아래 명령의 `<P>` 를 그 경로로 치환하고, 프로젝트 루트에서 실행한다.

## Usage

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

# 벌크 모드 (문서)
/caseworker:new docs/w1-w4.md 읽고 에픽→이슈→하위이슈로 등록
/caseworker:new plan.md 보고 이슈 만들어줘
```

옵션 인자:
- **prefix**: 대괄호(`[ABC]`) 또는 명시적 단어("ABC 프로젝트") 어느 쪽이든 인식. local 트래커에서는 `harness.json` 의 `issue_prefix` 가 곧 접두사이므로 보통 지정할 일이 없다.
- **mode 힌트**: "에픽", "하위이슈", "계층", "여러 이슈" 같은 단어가 있으면 벌크 모드로 가정.

## 0. 트래커 확인 (항상 먼저)

1. `.claude/harness.json` 을 `Read` 한다. 없으면 `/caseworker:setup` 으로 보낸다 — 이슈를 만들 대상이 없다.
2. `tracker` 값을 본다. 없으면 `local`. 단, `jira` 블록만 있고 `tracker` 가 없는 v3 설정은 `jira` 로 읽는다(설정 로더와 같은 규칙).
3. `issue_prefix` 를 확인한다 — 생성될 키의 접두사다.
   위 세 가지를 스크립트로 한 번에 확인할 수 있다: `node "<P>/scripts/cases.mjs" info --json` → `{tracker, direct, issue_prefix, key_pattern}`. 설정 로더와 같은 규칙으로 판정하므로 손으로 규칙을 복제하지 말고 이것을 정본으로 쓴다.

확인한 트래커를 사용자에게 한 줄로 알린 뒤 진행한다(예: `트래커: local · 접두사 HX`).

## 모드 자동 판별

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

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

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

## 단일 모드 절차

### 1. 스택 감지

감지 매핑 + 스택별 라벨 후보는 [`references/stack-detection.md`](references/stack-detection.md) 참조(`harness.json` 에 `stacks` 가 있으면 그것이 우선 — 감지보다 설정을 믿는다).

스택 감지는 라벨 자동 부여와 이슈 타입 추정에 쓴다.

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

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

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

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

### 3. 이슈 타입 / 라벨 결정

#### 이슈 타입 (코어 5종)

코어가 아는 타입은 `task · bug · story · epic · subtask` 다섯이다. 사용자 입력의 단어로 추정한다:

- "버그", "오류", "에러", "안 됨", "터짐" → `bug`
- "에픽", "epic", "이니셔티브" → `epic`
- "하위", "서브", "subtask" → `subtask` (부모 키 필요)
- "기능 추가", "구현", "만들어", "도입" → `story`
- 그 외 / 모호 → `task` (가장 중립적)

> 외부 트래커(jira 등)는 이 5종을 자기 이름(`Story`·`Sub-task`·`하위 작업` …)으로 사상한다. 그 사상은 어댑터 references 의 몫이고, **이름은 반드시 트래커 메타에서 확인된 것만** 쓴다 — 추측 금지.

#### 라벨 (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`)

> 라벨은 대개 case-sensitive 다. **항상 소문자 + kebab-case**로 통일한다. `Spring-Boot` 와 `spring-boot` 는 검색에서 분리된다. 공백·콜론·슬래시는 쓰지 않는다.

라벨/우선순위/기한/인수조건/제목 컨벤션 전문은 [`trackers/jira/references/best-practices.md`](../../trackers/jira/references/best-practices.md) 에 있다(Jira 필드를 예로 쓰지만 라벨·인수조건·제목 규칙 자체는 트래커 무관하다).

#### 우선순위 · 기한

- **명시 요청이 없으면 설정하지 않는다.**
- local 트래커의 case 스키마에는 우선순위·기한 필드가 **없다**(`schemas/case.schema.json`). 필요하면 본문(`body.md`)에 한 줄로 적거나 라벨(`priority-high`)로 표현한다. 없는 필드를 지어내지 않는다.

### 4. 드래프트 작성

#### 제목 작성 규칙

- **컴포넌트 prefix 권장** (`[Dashboard]`, `[Billing]`, `[API]`)
- **70자 이내**
- **버그면 증상 + 환경**: `[로그인] 자동완성 시 한글 입력 깨짐`

#### 본문 템플릿 (단일 이슈, 라이트 버전)

`/caseworker:issue` 의 grill·plan 단계가 이후에 디테일을 채울 것이므로 **여기서는 의도가 전달될 정도만** 작성한다. 과도한 추측은 피한다.

```markdown
## 배경
<왜 이 이슈가 필요한지 1-3줄. 사용자 입력에서 추출>

## 작업 범위
- <할 일 항목 1>
- <할 일 항목 2>

From bigbulgogiburger/caseworker, MIT.

More from bigbulgogiburger/caseworker