# Bug Report

> Creates ClickUp bug/issue subtasks with the team bug report template for Flower (PC web) and AdBuddy (PC web, mobile web, app). Use when the user says 이슈 티켓 만들어줘, 버그 리포트, 버그 티켓, or pastes a ClickUp parent link and asks to file an issue.

- Skill: `yol-mu/bug-report` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add yol-mu/bug-report`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yol-mu/bug-report/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: yol-mu (https://skillmd.com/u/yol-mu)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/yol-mu/bug-report

---


# Bug Report

사용자가 **「이슈 티켓 만들어줘」** 또는 **「버그 리포트」** 라고 하고
**ClickUp 부모 링크**를 주면 → 템플릿 본문으로 **하위 이슈**를 생성한다.

주 도메인: **Flower** · **AdBuddy**  
서버: **QA** 또는 **운영**

## 입력 패턴

```
이슈 티켓 만들어줘 / 버그 리포트
ClickUp: https://app.clickup.com/t/...  (또는 AM-xxxxx)
(현상 / 기대결과 / 이미지·Figma 등)
담당: BE · FE (있으면)
```

부모 링크가 없으면 먼저 요청한다. 있으면 바로 하위 이슈로 생성.

## 도메인 · 디바이스 매트릭스

| 도메인 | 가능 디바이스 | 비고 |
|--------|----------------|------|
| **Flower** | PC web 만 | 모바일 web/app 없음 |
| **AdBuddy** | PC web, mobile web, mobile app | 웹·앱 모두 가능 |

환경 정보에 디바이스·서버를 적는다. 제목에는 넣지 않는다.

- Flower + 모바일 언급 → Flower는 PC web만 가능하다고 짧게 알리고 PC web으로 작성할지 확인

## Workflow

1. **부모 ClickUp** 조회 → list_id  
2. **도메인** + **디바이스** + **서버** 확정  
3. **중분류** 확정 (화면/메뉴명, 예: `Ad requests`, `지역 선택`)  
4. 본문 작성 (공통 구조 + 디바이스별 환경 블록)  
5. 첨부(이미지/영상/Figma/로그) 반영  
6. ClickUp 하위 이슈 생성  
   - **Test Type = Report** (고정)  
   - 담당자: 사용자가 지정한 BE/FE (미지정이면 짧게 확인)  
   - 첨부 업로드 → 설명에 미디어 삽입  
7. 채팅에 **커스텀 ID + URL** 반환

예시·필드 상세: [templates.md](templates.md)

## 제목

형식 (고정):

```
[중분류]현상요약
```

- 중분류 = 화면/메뉴/기능 단위 (짧게)
- 현상요약 = 한 줄 요약
- 도메인·디바이스·경로 장황하게 넣지 않음

예:

- `[Ad requests]플랫폼 필터에 ALL 노출`
- `[Ad requests]CP 변경 시 Placement 미초기화`
- `[지역 선택]키보드가 화면을 밀어 올림`
- `[리소스>콘텐츠]Linear 콘텐츠 미노출`

## ClickUp Custom Fields

생성 시 설정:

| 필드 | 값 | 비고 |
|------|-----|------|
| **Test Type** | **Report** | **필수.** 이슈 라이징 티켓 고정. option UUID `7df3f8af-5ab4-4afb-8421-aa05a8fc3925` (field id `3e5c93d6-148d-484b-8969-c2e033b3c1e3`) |
| **Target** | Flower/Reds Web Site (Flower) / 해당 AdBuddy 옵션 | Flower PC web 기본값 |
| **Environment** | PC Web (Flower) / 해당 디바이스 | Flower는 PC Web만 |

- **Release Target**: 사용자가 지정한 경우에만 설정. 미지정이면 비워 둠.

담당자:

- 사용자가 **BE / FE** 를 주면 둘 다 assignees에 넣는다
- 예: BE 유순조 + FE 차진영 → 둘 다 지정
- 미지정 시 한 줄만 확인 후 생성

## 문체 (중요)

리포트 목적: **간결하게, 핵심만, 빠르게 읽히게.**

사람이 읽으므로 **가독성 우선**. 기계적 나열·수다스러운 해요체 모두 피한다.

| 원칙 | 내용 |
|------|------|
| 짧게 | 한 섹션 = 필요한 사실만. 군더더기 문장 삭제 |
| 핵심 먼저 | `[문제점]` 첫 1~2줄에 무엇/어디서/뭐가 잘못됐는지 |
| 스캔 가능 | 줄바꿈·불릿·짧은 단계. 긴 한 문단 금지 |
| 팩트만 | 수치·ID·실제 문구는 넣되, 해석·추정·개선안은 넣지 않음 |
| 톤 | 보고서체(음슴체/명사 종결). 해요체·채팅체 X |

피할 것:

- `~확인됨 / ~미포함 / A ≠ B (차이 N = …)` 같은 분석 메모 나열
- `~해요 / ~주세요` 등 구어체
- 같은 사실 반복, 장황한 배경 설명

권장 `[문제점]` 패턴:

```markdown
[문제점]
(조건)에서 (기대와 다른 실제 결과)
필요 시 실제 노출 문구·핵심 수치만 짧게
timeline: YYYY-MM-DD 확인
발생빈도(재현율): 항상 | 간헐 | 미확인
```

## 본문 공통 구조

섹션 이름·순서를 바꾸지 않는다.

```markdown
[문제점]
현상만 기재
timeline
발생빈도(재현율)

[기대 결과]
정상적으로 동작해야하는 기준 기재

[재현 절차]
동일 현상을 재현할 수 있도록 최소 단계로 작성

[상세 환경 정보]
(디바이스 템플릿 + 서버)

[첨부 자료]
스크린샷, 영상, 로그, 기획서(figma) 등 참고 자료 첨부
```

### 작성 규칙

- `[문제점]`: 현상만 (원인·개선안 X). **2~4줄 이내** 권장
- `[기대 결과]`: 정상 기준만. 가능하면 기대 문구/동작을 **한 줄~짧은 불릿**
- `[재현 절차]`: 최소 단계 번호 목록. 단계당 한 행동
- 모르는 값: `미확인` 또는 `-` (섹션 삭제 금지)
- 사용자 원문 의도 유지, 템플릿 칸에 배치
- **`[첨부 자료]`에 TC(테스트케이스) 문구/시트 링크는 넣지 않음** — 스크린샷·영상·로그·Figma만

## [상세 환경 정보] — 디바이스별

모든 경우에 **서버: QA | 운영** 을 넣는다.

Flower QA 웹 캡처 기본 계정(알려준 경우): `QA_Automation` / Theme **QA** (비밀번호는 티켓에 적지 않음)

### PC web (Flower / AdBuddy)

```markdown
[상세 환경 정보]
URL:
OS: mac or window
브라우저:
서버: QA | 운영
테스트 계정 정보
```

### Mobile web (AdBuddy만)

```markdown
[상세 환경 정보]
URL:
OS/OS Version:
브라우저:
서버: QA | 운영
테스트 계정 정보
```

### Mobile app (AdBuddy만)

```markdown
[상세 환경 정보]
OS/OS Version
App Version
Device Model
서버: QA | 운영
테스트 계정 정보
```

STB/OTT 등 예외 Target이 필요하면 [templates.md](templates.md)의 확장 템플릿 사용.

## 스크린샷 / 첨부

- 사용자가 준 이미지·Figma·로그·영상은 반드시 첨부
- 웹이고 캡처가 필요하면 Playwright로 해당 화면 캡처 후 첨부
- 동영상 요청 시 재현 영상 첨부
- **TC 시트/케이스명 문구는 `[첨부 자료]`에 넣지 않음**
- 로그인 필요 시 계정 요청 (추측 로그인 금지)
- ClickUp: `request_attachment_upload` → 업로드 → 본문에 링크/`![](url)` 삽입

## ClickUp 체크

- [ ] 부모 하위 이슈로 생성
- [ ] 제목 `[중분류]현상요약`
- [ ] **Test Type = Report**
- [ ] 담당자 BE/FE 반영
- [ ] 본문 5섹션 + 서버(QA/운영)
- [ ] 첨부 + 본문 미디어
- [ ] 커스텀 ID + URL 전달

## 출력 (채팅)

1. 티켓 제목 + 링크 (커스텀 ID)
2. 담당자 / Test Type
3. 첨부 여부