Bug Report Templates#
버그 리포트 이슈 생성 시 사용되는 템플릿 모음입니다.
Template A: 전체 버그 리포트#
이미지 분석 및 상세 정보가 포함된 전체 템플릿:
## 버그 설명
{버그에 대한 간단한 요약}
## 스크린샷/영상
{이미지 URL 또는 설명}
### 이미지 분석 결과
- **화면**: {화면명}
- **UI 상태**: {에러 다이얼로그 / 빈 화면 / 로딩 상태 등}
- **에러 메시지**: {추출된 에러 메시지}
## 재현 단계
1. {precondition - 사전 조건}
2. {step_1 - 첫 번째 단계}
3. {step_2 - 두 번째 단계}
4. {step_3 - 버그 발생 단계}
## 예상 결과
{정상적으로 동작할 때 기대되는 결과}
## 실제 결과
{현재 발생하는 문제}
## 환경 정보
| 항목 | 값 |
|------|-----|
| OS | {os_version} |
| 디바이스 | {device_model} |
| 앱 버전 | {app_version} |
| 네트워크 | {network_type} |
## 추가 정보
{로그, 스택트레이스, 추가 컨텍스트}
---
> Generated by `/bug-report`
Template B: 간단 버그 리포트#
최소 정보만 포함된 간단 템플릿:
## 버그 설명
{버그 요약}
## 재현 단계
1. {step_1}
2. {step_2}
3. {step_3}
## 예상 vs 실제
- **예상**: {expected}
- **실제**: {actual}
## 환경
- OS: {os}
- 앱 버전: {version}
---
> Generated by `/bug-report`
Template C: 크래시 리포트#
크래시/ANR 전용 템플릿:
## 크래시 요약
{크래시 상황 요약}
## 크래시 유형
- [ ] 앱 강제 종료 (Crash)
- [ ] 응답 없음 (ANR)
- [ ] 화면 멈춤 (Freeze)
## 재현 단계
1. {precondition}
2. {step_1}
3. {step_2}
4. **크래시 발생**
## 재현 확률
- [ ] 항상 재현 (100%)
- [ ] 자주 재현 (>50%)
- [ ] 가끔 재현 (<50%)
- [ ] 1회만 발생
## 환경 정보
| 항목 | 값 |
|------|-----|
| OS | {os_version} |
| 디바이스 | {device_model} |
| 앱 버전 | {app_version} |
| 메모리 상태 | {memory_status} |
## 스택트레이스
\`\`\`
{stack_trace}
\`\`\`
## 관련 로그
\`\`\`
{relevant_logs}
\`\`\`
---
> Generated by `/bug-report` - Crash Report
Template D: UI 버그 리포트#
UI/레이아웃 관련 버그 템플릿:
## UI 버그 요약
{UI 문제 요약}
## 버그 유형
- [ ] 레이아웃 깨짐
- [ ] 오버플로우
- [ ] 스타일 오류
- [ ] 애니메이션 문제
- [ ] 반응형 문제
## 스크린샷
{이미지 URL}
### 영향받는 컴포넌트
- 화면: {screen_name}
- 위젯: {widget_name}
- 영역: {affected_area}
## 재현 조건
- 화면 크기: {screen_size}
- 디바이스: {device}
- 방향: {orientation}
## 예상 UI vs 실제 UI
| 항목 | 예상 | 실제 |
|------|------|------|
| 정렬 | {expected_align} | {actual_align} |
| 크기 | {expected_size} | {actual_size} |
| 색상 | {expected_color} | {actual_color} |
## 관련 디자인
- Figma: {figma_link}
---
> Generated by `/bug-report` - UI Bug
이슈 제목 템플릿#
일반 버그#
[Bug] {화면명}: {버그 요약}
예시:
[Bug] 로그인: 소셜 로그인 버튼 미동작[Bug] 홈: 배너 이미지 로딩 실패
크래시#
[Crash] {화면명}: {크래시 상황}
예시:
[Crash] 프로필: 이미지 선택 시 크래시[Crash] 결제: 완료 화면 진입 시 ANR
UI 버그#
[UI] {화면명}: {UI 문제}
예시:
[UI] 목록: 긴 텍스트 오버플로우[UI] 상세: 하단 버튼 겹침
라벨 조합 예시#
Critical 크래시#
labels:
- bug
- severity:critical
- crash
- priority:urgent
- needs-investigation
High 기능 버그#
labels:
- bug
- severity:high
- area:backend
- priority:high
Medium UI 버그#
labels:
- bug
- severity:medium
- area:ui
Low 오타/정렬#
labels:
- bug
- severity:low
- area:ui
- good-first-issue
워크플로우 연계 출력#
이슈 생성 완료 메시지#
╔════════════════════════════════════════════════════════════════╗
║ Bug Report Created ║
╠════════════════════════════════════════════════════════════════╣
║ ║
║ 📋 Issue: #{issue_number} ║
║ 📝 Title: {issue_title} ║
║ ║
║ 🏷️ Labels: ║
║ - bug ║
║ - {severity_label} ║
║ - {area_label} ║
║ ║
║ 📊 Pipeline: {pipeline} ║
║ 📈 Estimate: {estimate} points ║
║ ║
║ 🔗 URL: {issue_url} ║
║ ║
║ 💡 Next Steps: ║
║ - /workflow:bug-cycle {issue_number} # 수정 사이클 시작 ║
║ - 수동으로 브랜치 생성 후 작업 ║
║ ║
╚════════════════════════════════════════════════════════════════╝
이미지 분석 결과 메시지#
╔════════════════════════════════════════════════════════════════╗
║ Image Analysis Result ║
╠════════════════════════════════════════════════════════════════╣
║ ║
║ 🖼️ Image: {image_path} ║
║ ║
║ 📍 Detected Issues: ║
║ 1. {issue_1} ║
║ 2. {issue_2} ║
║ ║
║ 🏷️ Suggested Classification: ║
║ - Type: {bug_type} ║
║ - Severity: {severity} ║
║ - Area: {area} ║
║ ║
║ 📝 Extracted Text: ║
║ "{extracted_error_message}" ║
║ ║
║ 🔍 Screen Context: ║
║ - Screen: {detected_screen} ║
║ - State: {ui_state} ║
║ ║
╚════════════════════════════════════════════════════════════════╝