jira-complete

Files (1)

• SKILL.md

SKILL.md (first lines)

# jira-complete — 작업 완료 및 최종 검증

Jira 티켓 작업을 완료하고 최종 검증을 수행한 뒤 QA 상태로 전환합니다.
지라에 댓글이나 설명을 작성할 때에는 한글로 작성합니다.
Jira API에 보내는 텍스트에 리터럴 `\n` 문자열을 넣지 마라 — Jira가 줄바꿈으로 해석 못하고 텍스트가 깨진다. 실제 개행문자를 사용할 것.

## Usage

```
/jira-complete <ISSUE-KEY>                            # 기본
/jira-complete <ISSUE-KEY> --no-organize              # CLAUDE.md 위생 자동 organize 호출 스킵
/jira-complete <ISSUE-KEY> --subtasks                 # 부모 + 하위 일괄 QA 전이 (ADR-070)
/jira-complete <ISSUE-KEY> --subtasks --no-organize   # 두 플래그 동시 사용 가능
```

- `ISSUE-KEY`: Jira 이슈 키 (예: PROJ-20)
- `--no-organize`: §4.6 위생 체크는 수행하되 임계점 도달 시 organize-claude-md 자동 호출은 스킵하고 권고 메시지만 출력. 나중에 별도로 organize 를 돌리고 싶을 때.
- `--subtasks`: 부모 + 모든 하위 이슈 일괄 QA 전이. 자세한 정책은 `~/.claude/skills/_subtasks-convention.md`.

## Procedure

### 1. 스택 감지

작업 디렉토리에서 프로젝트 스택을 자동 감지합니다.

### 2. 최종 검증 체크리스트

스택에 맞는 품질 검증을 수행합니다:

#### 코드 품질 (스택별 자동 실행)

| 스택 | Lint | Test | Build |
|------|------|------|-------|
| Flutter | `flutter analyze` | `flutter test` | `flutter build` |
| Spring Boot | built-in | `./gradlew test` (Windows: `gradlew.bat test`) | `./gradlew build -x test` |
| Vue.js | `npm run lint` | `npm test` | `npm run build` |
| React | `npm run lint` | `npm test` | `npm run build` |
| Go | `go vet ./...` | `go test ./...` | `go build ./...` |
| Python | `ruff check .` 또는 `flake8` | `pytest` | — |

**CLAUDE.md에 커스텀 명령이 정의되어 있으면 해당 명령을 우선 사용합니다.**

#### Git 상태
- ✅ 모든 변경사항이 커밋됨
- ✅ 브랜치가 최신 main/master과 충돌 없음

### 3. Git Push

```bash
git push -u origin feature/<ISSUE-KEY>
```

### 4. Jira 상태 전환

- 이슈 상태를 **"In Review"** 또는 **QA 가능한 다음 상태**로 전환
  - `getTransitionsForJiraIssue`로 가용 전환 목록 조회
  - "In Review", "Review", "QA", "Done" 등 적절한 전환 선택
- 최종 코멘트 추가:

```
✅ 작업 완료

📊 작업 요약:
- 총 커밋 수: X개
- 변경된 파일: XX개
- 추가: +XXX줄
- 삭제: -XXX줄

✅ 검증 완료:
- Lint: 통과
- Test: 통과
- Build: 성공

🌿 브랜치: feature/<ISSUE-KEY>
🔧 스택: <감지된 스택>
```

### 4.4. Wiki Ingest 자동 Chain (closure 단계) — **MANDATORY**

> ⛔ **이 단계는 선택 사항 아님.** QA 전환이 막 끝났고 사용자가 명시적으로 `<ISSUE-KEY>` 를 전달했으므로, **wiki INDEX 의 해당 이슈 row 를 closed 로 전환할 유일한 정상 시점**이다. archive (§4.5) 보다 먼저 수행하는 이유: archive 가 runtime 산출물을 이동시키기 전에 INDEX/LOG 가 archive 경로를 참조할 수 있도록.
>
> 본 chain 누락 시 wiki 가 drift 한다: INDEX row 가 영구히 `planned` 또는 미존재 → wiki-lint L14 (Jira/INDEX 불일치) 가 다음 호출마다 위반 보고. 사용자에게 "ingest 할까요?" 라고 물어보지 않는다 (조용한 누락 방지 — 명시적 `--no-ingest` 플래그만 인정).

**왜 이 시점인가**: Jira QA 전환은 closure 의 정식 단언. archive 가 일어나기 전에 INDEX status 를 `planned → closed` 로 전환해야 wiki-lint L14 (Jira/INDEX 불일치) 가 다음 호출에서 정상 PASS.

**자기 점검 (skill 종료 직전 last-mile check)**:
1. `docs/INDEX-SCHEMA.md` 존재? → 존재하면 본 §4.4 chain 호출 흔적이 conversation 에 있어야 함
2. 호출 흔적 없으면 → **지금 즉시 호출** + 사용자에게 "§4.4 chain 누락 감지 → 사후 호출함" 1줄 보고
3. 그래도 호출 못 한 사유 (skill 부재 등) 가 있으면 사용자에게 명시 경고 (조용한 skip 금지)

> 💡 **harness-workflow 또는 직접 호출 무관** — `/jira-complete` 가 호출되는 모든 경로에서 본 chain 은 반드시 발화. harness-workflow Phase 7 이 jira-complete skill 호출 없이 직접 transition/push 만 수행하면 본 chain 이 통째로 누락된다 (2026-05-14 PROJ-208 사고). harness-workflow 도 반드시 `Skill('jira-complete', ...)` 로 진입해야 §4.4 + §4.7 둘 다 발화 보장.

#### 조건

```
실행 조건: docs/INDEX-SCHEMA.md 존재 AND 사용자가 --no-ingest 플래그 전달 안 함
```

조건 미충족 시 전체 §4.4 skip (wiki 미설정 프로젝트).

#### 절차

Skill tool 로 jira-ingest 호출:
```
Skill('jira-ingest', '<ISSUE-KEY> closure 모드로 ingest — Jira QA 전환 완료, INDEX status 갱신 + cross-ref 보강')
```

`--subtasks` 모드면 flag 자동 전파:
```
Skill('jira-ingest', '<ISSUE-KEY> closure --subtasks')
```

jira-ingest 가 수행:
- INDEX.md 의 row 갱신 (status=closed, closed=<today>)
- LOG.md append (CLOSURE + INGEST closure 2줄)
- `08-decision-log.md` 관련 ADR 의 ingest-managed 블록 갱신 (Referenced by 추가)
- sprint/weeks/w*.md 의 ingest-managed 블록 갱신 (closure 라인)
- sprint/tracks/*.md 동일

From bigbulgogiburger/claude_jira_harness, MIT.

More from bigbulgogiburger/claude_jira_harness