> For the complete documentation index, see [llms.txt](https://bugshot.gitbook.io/ko/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bugshot.gitbook.io/ko/video/issue.md).

# 이슈 작성

녹화가 끝나면 이슈 초안이 열립니다. 아래 순서대로 채워 가면 됩니다. 녹화 모드는 **영상과 함께 로그를 가장 풍부하게** 담을 수 있는 모드예요.

## 1. 제목

설정해 둔 제목 접두어(예 `[QA]` )가 미리 채워져 있습니다. 이어서 제목을 적으면 됩니다.

## 2. 재현 환경

OS·브라우저·페이지 URL·뷰포트 크기·캡처 시각이 **알아서 채워집니다**(읽기 전용). 더 알리고 싶은 정보가 있으면 변수 행을 직접 더하셔도 됩니다.

![재현 환경](/files/WnQikoGSlQwdz85hqacO)

## 3. 미디어 — 영상

녹화 모드의 미디어는 **영상**입니다. 방금 녹화한(또는 30초 리플레이로 가져온) 영상이 이슈에 첨부됩니다.

![영상 첨부](/files/JOnGLRPpSWrYX7iGLFge)

## 4. 본문 섹션

설정한 본문 구성대로 섹션이 나타납니다 — 발생 현상·재현 과정·기대 결과·비고(켜 둔 것만). 재현 과정은 번호 목록으로 입력합니다. 한 줄씩 직접 채워도 되고, 아래 AI 초안 작성으로 한 번에 채워도 됩니다.

![본문 작성](/files/2kJZKCpo8t5Oh25x2zwz)

## ✨ AI 초안 작성

한 줄 한 줄 직접 적기 번거로우셨다면, 이 기능이 큰 힘이 됩니다. AI를 연결해 두면 본문 섹션 아래에 보라색 **"AI로 초안을 작성해보세요"** 배너가 나타납니다.

오른쪽 **AI 초안 작성**을 누르면 작은 입력창이 열립니다. 버그를 한 줄로 간단히 적고 **초안 작성**을 누르면 AI가 **제목과 본문 섹션을 한 번에** 채워 줍니다. 채워지는 건 켜 둔 섹션뿐이고, 제목 접두어도 그대로 유지됩니다.

녹화 모드에서는 **콘솔·네트워크·액션 로그 요약**을 근거로 삼아, 녹화 중 실제로 무슨 일이 있었는지를 초안에 녹여 줍니다. 로그가 풍부한 모드인 만큼 초안의 정확도도 가장 높습니다.

> AI도 가끔 실수하니 생성된 초안은 한 번 확인해 주세요. 배너는 AI를 연결했을 때만 보입니다 — 연결 방법은 [AI LLM 연동](/ko/settings/ai.md)에 있습니다.

![AI 초안 작성 배너와 입력창](/files/rMGAd3gyFVSDo1xbIOZe)

## 5. 로그 첨부 — 녹화 모드 전용 정책

녹화 모드는 영상에 더해 세 종류의 로그를 함께 담습니다. **세 토글 모두 기본 켜짐**이라, 따로 손대지 않아도 풍부하게 담깁니다.

* **콘솔 로그** — 녹화 중 발생한 콘솔 출력·에러.
* **네트워크 로그** — 녹화 중 오간 네트워크 요청.
* **액션 로그** — 클릭·입력·페이지 이동 등 사용자 동작 기록. **액션 로그는 녹화 모드에서만 수집됩니다.**

영상 타임라인과 로그가 시간으로 연결되어, 받는 분이 [로그 뷰어](/ko/logs/viewer.md)에서 "이 순간에 무슨 일이 있었는지"를 차근차근 따라갈 수 있습니다.

![녹화 모드 로그 정책](/files/nxSPGlGBSL9I535Tz6oT)

## 6. 미리보기

제출 전 본문을 미리보기로 확인합니다. **마크다운 복사**로 본문을 그대로 복사해 다른 곳에 붙여 넣을 수도 있습니다.

## 7. 제출

연결한 플랫폼의 필드(프로젝트·담당자·라벨 등)를 채우고 **이슈 제출**을 누르면 됩니다. 등록이 끝나면 이슈 링크가 표시됩니다.

![이슈 제출 완료](/files/yac4oDRRuii1nYbXDZCH)

***

🌐 [English](https://bugshot.gitbook.io/en/video/issue)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://bugshot.gitbook.io/ko/video/issue.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.