The workflow execution engine is governed by: {project-root}/_bmad/core/tasks/workflow.xml
You MUST have already loaded and processed: {installed_path}/workflow.yaml
Communicate all responses in {communication_language}
IMPORT ISSUE - GitHub 이슈를 BMAD 스토리로 변환
이 워크플로우는 외부 사용자가 작성한 GitHub 이슈를 BMAD 스토리 문서로 변환합니다.
Create Story와 달리 새 이슈를 생성하지 않고, 기존 이슈를 그대로 활용합니다.
Git 저장소 확인:
git rev-parse --git-dir
HALT
GitHub CLI 인증 확인:
gh auth status
HALT
가져올 GitHub 이슈 번호를 입력하세요:
- 단일 이슈: 42
- 복수 이슈: 42,43,45
입력값을 {{issue_numbers}}에 저장
이슈 번호 파싱:
- 쉼표로 분리하여 배열로 변환
- 각 번호에서 # 기호 제거 (있을 경우)
- 숫자만 추출하여 유효성 검증
각 이슈 존재 여부 확인:
for each issue_num in issue_numbers:
gh issue view {{issue_num}} --json number 2>/dev/null
if failed: 해당 이슈를 목록에서 제외하고 경고 출력
HALT
For each valid issue number:
이슈 상세 정보 조회:
gh issue view {{issue_num}} --json number,url,title,body,labels,assignees,milestone,state,createdAt,author
이슈 타입 결정 (story_type):
라벨 우선 분석:
- "bug", "fix" 라벨 포함 → fix
- "feature", "enhancement" 라벨 포함 → feat
- "refactor", "improvement", "performance" 라벨 포함 → refactor
- "documentation", "docs" 라벨 포함 → docs
- "test", "testing" 라벨 포함 → test
- "chore", "maintenance", "config" 라벨 포함 → chore
라벨 없을 경우 내용 분석:
- 제목/본문에 "버그", "오류", "error", "bug", "fix" 키워드 → fix
- 제목/본문에 "새 기능", "추가", "new", "feature", "add" 키워드 → feat
- 제목/본문에 "리팩토링", "개선", "refactor", "improve" 키워드 → refactor
- 기본값: feat
우선순위 제안:
- "critical", "urgent", "P0" 라벨 → P0 (긴급)
- "high", "P1" 라벨 → P1 (높음)
- "medium", "P2" 라벨 또는 기본 → P2 (보통)
- "low", "P3" 라벨 → P3 (낮음)
이슈 정보 품질 평가:
- body가 비어있거나 50자 미만 → 정보 부족
- Acceptance Criteria 형태의 체크리스트가 없음 → AC 보완 필요
추가 컨텍스트를 입력하세요 (또는 's'로 건너뛰기, 'c'로 현재 정보로 계속):
해당 이슈 건너뛰기
추가 컨텍스트를 이슈 정보에 병합:
{{additional_context}} 저장
에픽 파일에서 모든 에픽 정보 추출:
- {epics_artifacts}/*epic*.md 파일들 로드
- "## Epic N:" 또는 "# Epic N:" 패턴으로 에픽 찾기
- 각 에픽의 번호, 제목, 설명 추출
- 현재 스토리 개수 파악 (마지막 스토리 번호)
어떻게 진행할까요? (1: 새 에픽 생성, 2: 경로 지정, c: 취소):
각 이슈에 대해 에픽 매칭 수행:
- 이슈 제목과 본문에서 핵심 키워드 추출
- 각 에픽의 제목, 설명과 텍스트 유사도 분석
- 관련성 높은 상위 3개 에픽 선별 (또는 전체 에픽 수가 3개 미만이면 모두)
이슈 #{{issue_num}}을(를) 어떤 에픽에 추가할까요? (번호, N, 또는 E):
선택된 에픽 번호 저장: {{selected_epic}}
해당 에픽의 마지막 스토리 번호 확인
새 스토리 번호 계산: {{last_story_num}} + 1
새 에픽 제목을 입력하세요:
새 에픽 번호 계산: 마지막 에픽 번호 + 1
에픽 파일에 새 에픽 섹션 추가:
## Epic {{new_epic_num}}: {{new_epic_title}}
### Overview
{{issue_title}}을 해결하기 위한 에픽
### Stories
(스토리가 아래에서 추가됩니다)
스토리 번호: 1
에픽 번호를 입력하세요:
입력된 에픽 존재 여부 확인
스토리 키 생성:
- 제목을 kebab-case로 변환 (소문자, 공백→하이픈, 특수문자 제거)
- 형식: {{epic_num}}-{{story_num}}-{{title_kebab}}
- 예: 1-3-fix-login-error
스토리 파일 경로 결정:
{{story_file_path}} = {story_dir}/{{story_key}}.md
이슈 본문에서 스토리 요소 추출:
1. User Story 형식 탐지:
- "As a... I want... so that..." 패턴 검색
- 있으면 그대로 사용, 없으면 자동 생성
2. Acceptance Criteria 추출:
- "## Acceptance Criteria", "### AC", "- [ ]" 체크박스 패턴 검색
- 번호 목록 형태도 AC로 간주
3. 기술 요구사항 추출:
- 코드 블록, 파일 경로, 기술 용어 추출
이슈 정보에서 User Story 자동 생성:
As a [user/developer],
I want {{issue_title_action}},
so that {{benefit_from_body_or_default}}.
이슈 본문에서 AC 후보 추출 또는 기본 AC 생성
[y] 확인 / [e] 편집 / [a] 추가:
Acceptance Criteria를 입력하세요 (각 줄에 하나씩):
사용자 입력을 AC에 추가/대체
브랜치명 생성:
{{branch_name}} = {{story_type}}/{{story_key}}
예: fix/1-3-fix-login-error
template.md 기반 스토리 파일 생성:
template: {project-root}/_bmad/bmm/workflows/4-implementation/create-story/template.md
치환 변수:
- {{epic_num}} → 에픽 번호
- {{story_num}} → 스토리 번호
- {{story_title}} → 이슈 제목
- {{story_type}} → 스토리 타입 (feat/fix/refactor 등)
- {{role}} → User Story의 역할
- {{action}} → User Story의 행동
- {{benefit}} → User Story의 이점
GitHub Tracking 섹션 채우기:
| 항목 | 값 |
|------|-----|
| Issue | #{{issue_number}} |
| Issue URL | {{issue_url}} |
| Branch | {{branch_name}} |
| PR | |
| PR URL | |
※ 중요: Issue는 이미 존재하므로 새로 생성하지 않음
Dev Notes 섹션 채우기:
- 이슈 본문에서 추출한 기술 정보
- 관련 파일 경로 (언급된 경우)
- 재현 단계 (버그인 경우)
스토리 파일 저장: {{story_file_path}}
🔍 TECHNICAL VERIFICATION — Import된 이슈의 기술 스펙도 반드시 검증해야 함
GitHub 이슈 작성자가 기술한 CLI 명령어, API, 파일 경로가 정확하다고 가정하지 말 것
스토리 Dev Notes에서 외부 기술 스펙 목록 추출:
- CLI 명령어 및 옵션
- 외부 패키지 API 시그니처
- 파일 경로 및 디렉토리 구조
- 프로젝트 내부 코드 참조 (함수, 타입, 상수)
각 기술 스펙 검증:
1. CLI 명령어 → `--help` 실행으로 존재 여부 확인
2. 외부 API → 실제 타입 정의/문서에서 시그니처 확인
3. 파일 경로 → ls/read로 존재 여부 확인
4. 내부 코드 → grep/read로 존재 및 시그니처 확인
검증 결과 처리:
- 검증 성공 → [verified] 태그 부착
- 검증 실패 → 스토리 스펙을 실제에 맞게 수정, Dev Notes에 수정 사유 기록
- 검증 불가 → [unverified] 태그 부착, Dev Agent 검증 태스크 추가
sprint-status.yaml 파일 확인:
{implementation_artifacts}/sprint-status.yaml
sprint-status.yaml 로드
에픽 상태 확인 및 업데이트:
development_status:
epic-{{epic_num}}:
- 키가 없으면 추가 (status: backlog)
- 이미 있으면 유지
스토리 항목 추가:
{{story_key}}: ready-for-dev
sprint-status.yaml 저장 (기존 구조 유지)
코멘트 본문 생성:
## Linked to BMAD Story
This issue has been imported to BMAD workflow:
- **Story ID:** {{epic_num}}.{{story_num}}
- **Story Title:** {{story_title}}
- **Story File:** `{{story_file_path}}`
- **Story Type:** {{story_type}}
- **Branch:** `{{branch_name}}`
---
*Imported via BMAD Import Issue workflow*
코멘트 추가:
gh issue comment {{issue_number}} --body "{{comment_body}}"