GitHub Issue 템플릿 생성기

GitHub Issue 템플릿 생성기 사용 가이드

이슈를 받다 보면 재현 방법이나 환경 정보가 빠진 신고가 많습니다. 이슈 템플릿을 두면 새 이슈를 열 때 정해진 항목이 미리 채워져 필요한 정보를 받기 쉬워집니다. 이 생성기는 Markdown 이슈 템플릿 파일을 만들어 줍니다.

맨 위에는 GitHub가 읽는 머리말(name, about, title, labels, assignees)이 들어가고, '입력 항목'에 쉼표나 줄바꿈으로 적은 항목마다 '## 항목'과 '<!-- 항목 내용을 적어 주세요 -->' 안내 주석이 생깁니다. 라벨은 쉼표로 여러 개 적을 수 있고, 새 이슈 제목은 '[템플릿 이름]: '으로 시작합니다.

드롭다운이나 필수 입력이 필요한 정교한 양식은 GitHub Issue Form YAML 생성기를 쓰세요.

사용 방법

1. 1'템플릿 이름 (예: 버그 신고)'과 '라벨 (쉼표로 구분)'을 적습니다.
2. 2'입력 항목 (쉼표나 줄바꿈으로 구분)' 칸에 문제 설명, 재현 단계처럼 받을 항목을 적습니다.
3. 3'실행' 후 결과를 '다운로드'해 저장소의 .github/ISSUE_TEMPLATE/bug_report.md 같은 이름으로 저장합니다.

템플릿 이름: 버그 신고
라벨: bug
입력 항목: 문제 설명, 재현 단계, 기대 결과, 사용 환경

---
name: "버그 신고"
about: "버그 신고 내용을 정리해 알려 주세요."
title: "[버그 신고]: "
labels: ["bug"]
assignees: ''
---

## 문제 설명

<!-- 문제 설명 내용을 적어 주세요 -->

## 재현 단계

<!-- 재현 단계 내용을 적어 주세요 -->

## 기대 결과

<!-- 기대 결과 내용을 적어 주세요 -->

## 사용 환경

<!-- 사용 환경 내용을 적어 주세요 -->

이럴 때 쓰면 좋아요

• 버그 신고에 재현 정보가 빠지는 일을 줄일 때
• 기능 제안·질문용 템플릿을 따로 만들 때
• 사내 저장소의 이슈 작성 형식을 통일할 때
• 오픈소스 공개 전 기본 이슈 템플릿을 준비할 때

문제가 생겼을 때

활용 팁

• 템플릿을 여러 개 두면 새 이슈를 열 때 고르는 화면이 나옵니다. 버그·기능 제안·질문 세 가지가 흔한 구성입니다.
• 항목은 다섯 개 안팎이 적당합니다. 너무 많으면 신고자가 템플릿을 지우고 쓰는 경우가 늘어납니다.

자주 묻는 질문