> 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/screenshot/issue.md).

# 이슈 작성

주석을 마치고 **주석 완료**를 누르면 이슈 초안이 열립니다. 아래 순서대로 채워 가면 됩니다.

## 1. 제목

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

## 2. 재현 환경

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

![재현 환경](/files/4GUx7OE3BtQVZUYGb99A)

## 3. 미디어 — 주석 스크린샷

스크린샷 모드의 미디어는 **주석을 입힌 스크린샷**입니다. 화살표·박스로 표시한 그 이미지가 그대로 이슈에 첨부됩니다.

![주석 스크린샷 첨부](/files/Caik8Dn1ngzMv5Sq94UM)

## 4. 본문 섹션

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

![본문 작성](/files/vr2VbaNEfmqMiuKUiPtp)

## ✨ AI 초안 작성

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

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

스크린샷 모드에서는 **주석을 입힌 스크린샷 이미지**를 근거로 삼습니다. 한 줄 설명을 곁들이면 화면 속 문제를 더 정확히 읽어 초안에 반영합니다.

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

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

## 5. 로그 첨부

스크린샷 모드에서는 콘솔·네트워크 로그를 첨부할 수 있습니다. 두 토글 모두 **기본은 꺼짐**이니, 필요할 때만 켜서 담으시면 됩니다.

> 로그를 보고 다루는 방법은 [실시간 로그](/ko/logs/live.md)를 참고하세요.

## 6. 미리보기

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

![이슈 미리보기](/files/2EmxF2U9w0ZAiVWT7u0j)

## 7. 제출

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

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

***

🌐 [English](https://bugshot.gitbook.io/en/screenshot/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/screenshot/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.