jira-setuplisted
Install: claude install-skill mzd-hseokkim/jira-claude-code-integration
# jira-setup: Interactive Jira Setup Wizard
**Language Rule**: 프로젝트 CLAUDE.md의 Conventions 섹션 참고 (한국어 출력).
## Overview
Jira MCP 서버(`atlassian`)를 Claude Code에 등록하는 대화형 설정 위자드.
## Step 1: Prerequisites Check
### 1-1. uv 설치 확인
```bash
uv --version
```
실패 시:
```
❌ uv가 설치되어 있지 않습니다.
설치 방법:
Windows (PowerShell): irm https://astral.sh/uv/install.ps1 | iex
macOS/Linux: curl -LsSf https://astral.sh/uv/install.sh | sh
설치 후 터미널을 재시작하고 /jira setup을 다시 실행하세요.
```
→ 중단
### 1-2. Python 3.10+ 확인
```bash
python --version 2>/dev/null || python3 --version 2>/dev/null
```
**Windows Store stub 회피**: `python --version`이 "Python 3.x.x"를 반환하지 않고 아무것도 출력하지 않거나 Microsoft Store를 열려고 하면 stub으로 간주. `uv python list`로 대체 확인.
Python 3.10 미만이거나 없으면:
```
❌ Python 3.10 이상이 필요합니다.
현재 버전: <버전 또는 "없음">
uv로 Python 설치:
uv python install 3.11
또는 python.org에서 직접 설치하세요.
```
→ 중단
사전 요건 통과 시: `✅ 사전 요건 확인 완료 (uv <버전>, Python <버전>)`
## Step 2: Check Existing Registration
`.claude/settings.local.json`과 `~/.claude/settings.json` 검사:
```bash
cat .claude/settings.local.json 2>/dev/null
cat ~/.claude/settings.json 2>/dev/null
```
`mcpServers` 키 아래 `atlassian` 항목이 존재하면 이미 등록된 것으로 판단.
**이미 등록된 경우**, 선택지를 안내:
```
ℹ️ Jira MCP 서버(atlassian)가 이미 등록되어 있습니다.
어떻게 하시겠습니까?
1. 연결 테스트만 실행
2. 자격증명 재설정 (기존 설정 덮어쓰기)
3. 취소
```
`AskUserQuestion` 도구로 사용자에게 선택 요청:
- "연결 테스트" 선택 → Step 5로 바로 이동
- "재설정" 선택 → Step 3부터 진행
- "취소" 선택 → 종료
## Step 3: Collect Credentials
`AskUserQuestion` 도구로 아래 정보를 수집한다.
**필수 항