← ClaudeAtlas

jira-task-discoverlisted

Discover requirements from a free-form topic — searches codebase, asks clarifying questions, writes a structured requirements doc with issue-breakdown proposal. Triggers: discover, jira-task discover, requirements analysis; 요구사항 분석, 디스커버리, 요구사항 문서.
mzd-hseokkim/jira-claude-code-integration · ★ 8 · AI & Automation · score 74
Install: claude install-skill mzd-hseokkim/jira-claude-code-integration
# jira-task-discover: Requirements Discovery from a Topic **Language Rule**: 프로젝트 CLAUDE.md의 Conventions 섹션 참고 (한국어 출력, Jira 코멘트 제목은 영어). ## Overview `jira-task-discover`는 모호한 자연어 주제를 입력받아, 코드베이스 탐색과 사용자 질문을 거쳐 명시적인 요구사항 분석 문서를 만든다. 이 스킬의 산출물은 다음 단계인 `jira-task-create`(`--from-requirements`)의 입력이 된다. **입력 (3종):** - 위치 인자: 자연어 주제 (필수). 예: `"사용자 알림 시스템"` - `--lite`: 질문을 3건으로 줄이고, 출력 문서를 한 페이지 분량으로 축약 - `--from <파일경로>`: 기존 요구사항 ���서를 import해서 베이스로 사용 **출력 (1종):** - `docs/requirements/<TOPIC-SLUG>.requirements.md` — 요구사항 분석 문서 (말미에 이슈 분해 제안 섹션 포함) **비목표 (Non-goals):** - Jira 이슈/코멘트/첨부 생성 안 함 (로컬 문서 단계로 한정) - `.jira-context.json` 읽기/쓰기 안 함 - 인덱스 파일(`docs/requirements/INDEX.md` 등) 자동 관리 안 함 - `templates/requirements.template.md` 생성 안 함 (부재 시 에러로 종료) ## Input Model ``` $ARGUMENTS = <자연어 주제> [--lite] [--from <파일경로>] ``` **파싱 규칙:** - 첫 번째 위치 인자(따옴표로 묶인 문자열 또는 플래그가 아닌 토큰의 연결)를 **자연어 주제**로 간주 - `--lite`: 인자 어디에 와도 됨. 값 없음 (boolean 플래그) - `--from <파일경로>`: `--from` 다음 토큰을 파일경로로 사용. 절대/상대 경로 모두 허용 - 자연어 주제가 비어 있으면 Step 0에서 사용자에게 입력 요청 - `--lite`와 `--from`은 동시 사용 가능 (효과 합쳐짐: 질문 축소 + 기존 문서 import) ## Workflow ### Step 0: Parse Arguments 1. `$ARGUMENTS`를 토큰화한다. 2. `--lite` 토큰 존재 여부를 boolean `lite`에 저장. 3. `--from <path>` 패턴을 추출해 `fromPath`에 저장. `--from` 다음 토큰이 비었거나 다른 플래그면 에러. 4. 남은 토큰을 공백으로 합쳐 `topic`(자연어 주제)으로 사용. 5. `topic`이 비어 있으면: - `AskUserQuestion`으로 단답형 질문 1회: "어떤 주제로 요구사항을 만들까요? (한 문장으로 입력)" - 답변도 비어 있으면 종료 (에러 메시지 출력) 6. `fromPath`가 지정되었으면 파일 존재 검증: - 파일 부재: 에러