issue-bug-report

name	issue-bug-report
description	에러 로그, 스택 트레이스, 시스템 장애 정보를 분석하여 구조화된 버그 리포트를 자동 생성.
triggers	["버그 리포트","에러 분석","장애 이슈","bug report","error analysis"]

Bug Report Generator

에러 로그, 스택 트레이스, 시스템 장애 정보를 분석하여 구조화된 버그 리포트를 자동 생성하는 스킬입니다.

실행 절차

1. 정보 수집

다음 정보를 사용자에게 대화형으로 수집합니다:

• 프로젝트명: 버그가 발생한 프로젝트 이름
• 에러 로그: 전체 에러 로그 또는 스택 트레이스
• 발생 위치: 어디에서 발생했는지 (서비스명, 화면, API 등)
• 발생 시각: 언제 발생했는지
• 심각도: Critical / High / Medium / Low

2. 로그 분석 및 원인 파악

수집된 정보를 기반으로:

1. 에러 타입 식별: 에러 메시지와 스택 트레이스에서 에러 타입 파악
2. 발생 위치 특정: 코드상에서 에러가 발생한 정확한 위치 추적
3. 근본 원인 분석: 왜 이 문제가 발생했는지 원인 도출

3. 해결 방안 및 조치 내용 정리

• 해결 방안: 문제를 해결하기 위한 방법 제시
• 조치 내용: 실제로 수행한 조치 사항 기록

4. 문서 생성 및 저장

분석 결과를 구조화된 마크다운 문서로 생성하고, Read 도구로 ~/.claude/policies/obsidian-document-policy.md를 읽어 vault 경로, 파일명 규칙, 태그 체계, frontmatter 구조를 확인한 후 Obsidian vault에 저장합니다.

작성 원칙:

• 비개발자도 이해할 수 있도록 간략하고 핵심만 정리합니다.
• 경어체를 사용합니다.
• 기술 용어는 최소화하고, 필요 시 괄호 안에 쉬운 설명을 병기합니다.

버그 리포트 템플릿

# Bug Report: {버그 제목}

## 요약

| 항목 | 내용 |
|------|------|
| **발생 위치** | {서비스명, 화면, API 등 문제가 발생한 위치} |
| **발생 시각** | {YYYY-MM-DD HH:mm:ss} |
| **현상** | {어떤 문제가 발생했는지 한 줄로 설명} |
| **영향도** | {사용자/서비스에 미치는 영향 범위와 심각도} |

## 이슈 원인

{왜 이 문제가 발생했는지 핵심 원인을 간략하게 설명합니다.}

## 에러 로그

{관련 에러 로그 또는 스택 트레이스의 핵심 부분}

## 해결 방안

{문제를 해결하기 위해 제안하는 방법을 설명합니다.}

## 조치 내용

{실제로 수행한 조치 사항을 기록합니다. 미조치 시 "조치 예정"으로 표기합니다.}

- {조치 사항 1}
- {조치 사항 2}

문서 저장

버그 리포트 작성 완료 후, Read 도구로 ~/.claude/policies/obsidian-document-policy.md를 읽어 저장 규칙을 확인하고 다음과 같이 저장합니다:

1. 프로젝트명 확인: 사용자에게 프로젝트명 재확인
2. Frontmatter 생성:
   • type: bug-report
   • severity: 사용자가 제공한 심각도
   • status: New
   • 태그: doctype/bug-report, status/new, project/{프로젝트명}, topic/{관련기술}
3. 파일명: bug-report-{YYYY-MM-DD_HH-mm}.md
4. 저장 경로: ~/OneDrive/my-obsidian-vault/002-PROJECTS/{프로젝트명}/

자세한 저장 규칙은 ~/.claude/policies/obsidian-document-policy.md 참조.

작성 시 주의사항

1. 간결하고 핵심만: 비개발자도 이해할 수 있도록 쉬운 표현을 사용합니다.
2. 경어체 사용: 모든 항목에서 경어체(~합니다, ~입니다)를 사용합니다.
3. 객관적 사실 기반: 추측보다는 로그와 코드에 기반한 분석을 합니다.
4. 기술 용어 최소화: 필요 시 괄호 안에 쉬운 설명을 병기합니다.

제목 작성 규칙

• 형식: "Bug Report: [버그의 핵심 문제를 명확히 설명]"
• 예시:
  • "Bug Report: NullPointerException in UserService.login()"
  • "Bug Report: 결제 완료 후 주문 상태 업데이트 실패"

실행 예시

User: 버그 리포트 만들어줘
Assistant:
1. [정보 수집] 프로젝트명, 에러 로그, 발생 위치/시각 등 질문
2. [분석] 에러 타입, 발생 위치, 원인 파악
3. [문서 생성] 요약 → 이슈 원인 → 에러 로그 → 해결 방안 → 조치 내용 순으로 작성
4. [저장] Read `~/.claude/policies/obsidian-document-policy.md` 후 Obsidian vault에 저장