name: github-issue description: GitHub 이슈를 자동으로 생성하는 스킬. 사용자가 "이슈 만들어줘", "이슈 생성", "GitHub 이슈", "버그 등록", "작업 등록", "태스크 추가", "이슈 올려줘" 등을 언급하면 반드시 이 스킬을 사용한다. 게임 개발(Unity 등) 환경을 기준으로 동작하며, Git 저장소가 있는 상태에서 이슈 관련 작업이 필요할 때 항상 트리거된다.
GitHub Issue Creator
현재 Git 저장소에 GitHub 이슈를 생성하는 스킬.
게임 개발(Unity) 환경을 기준으로 동작한다.
언어 규칙 (필수)
- 이슈 제목:
[태그] 한글 설명형식 - 이슈 본문: 반드시 한글로 작성
- 제목 예시:
[Bug] 카드 뒤집기 시 충돌 발생,[Feature] 인벤토리 정렬 기능 추가
전제 조건
ghCLI 설치 및 인증 완료 (gh auth status)- Git 저장소 초기화 완료 (원격 GitHub 저장소 연결)
워크플로우
1단계: 저장소 확인
# 현재 레포 확인
gh repo view --json nameWithOwner -q .nameWithOwner
# 현재 사용자 확인 (담당자 기본값용)
gh api user -q .login
2단계: 이슈 정보 수집
사용자의 요청에서 다음 정보를 추출한다. 불분명한 항목만 질문한다.
| 항목 | 기본값 | 설명 |
|---|---|---|
| 제목 | (필수) | [태그] 한글 설명 형식 |
| 본문 | (선택) | 아래 템플릿 참고 |
| 라벨 | 내용 기반 자동 결정 | 아래 라벨 규칙 참고 |
| 담당자 | 현재 로그인 사용자 | 명시하지 않으면 자신으로 설정 |
3단계: 이슈 제목 생성
제목 형식: [태그] 한글 설명
| 태그 | 사용 상황 |
|---|---|
Bug |
버그, 오류, 충돌, 예외 |
Feature |
새 기능, 시스템 추가 |
Improve |
기존 기능 개선, 최적화 |
Design |
UI/UX, 아트, 레이아웃 |
Docs |
문서, 주석, README |
Refactor |
코드 정리, 구조 개편 |
Test |
테스트 코드, QA |
Chore |
빌드, 설정, 의존성 |
4단계: 본문 작성
사용자가 본문을 제공하지 않으면 아래 템플릿을 기반으로 자동 작성한다.
Bug 이슈 템플릿:
## 버그 설명
<!-- 어떤 버그인지 간결하게 설명 -->
## 재현 방법
1.
2.
3.
## 예상 동작
<!-- 정상적으로 어떻게 동작해야 하는지 -->
## 실제 동작
<!-- 실제로 어떻게 동작하는지 -->
## 환경
- Unity 버전:
- 플랫폼: (PC / Mobile / Editor)
## 참고 사항
<!-- 스크린샷, 로그, 추가 정보 -->
Feature / Improve 이슈 템플릿:
## 개요
<!-- 무엇을 추가/개선하려는지 설명 -->
## 목적 및 배경
<!-- 왜 이 기능이 필요한지 -->
## 구현 내용
- [ ]
- [ ]
- [ ]
## 참고 사항
<!-- 관련 문서, 레퍼런스, 디자인 시안 등 -->
기타 이슈 템플릿 (Design / Refactor / Docs / Chore / Test):
## 개요
<!-- 작업 내용 설명 -->
## 작업 항목
- [ ]
- [ ]
## 참고 사항
<!-- 추가 정보 -->
5단계: 라벨 결정
요청 내용을 분석해 자동으로 라벨을 결정한다.
기본 라벨:
| 조건 | 라벨 |
|---|---|
| 버그, 오류, 크래시 | bug |
| 새 기능, 시스템 추가 | feature |
| 개선, 최적화 | enhancement |
| UI/UX, 아트 | design |
| 문서, 주석 | documentation |
| 코드 정리, 리팩토링 | refactor |
| 빌드, 설정 | chore |
| 테스트 | test |
Unity/게임 특화 라벨:
| 조건 | 라벨 |
|---|---|
| 씬(Scene) 관련 | scene |
| 셰이더, 렌더링 | graphics |
| 애니메이션 | animation |
| 사운드, 오디오 | audio |
| UI, HUD, 인벤토리 | ui |
| 카드, 덱, 패 관련 | card |
| 전투, 스킬, 데미지 | gameplay |
| 성능, 프로파일링 | performance |
| 네트워크, 멀티플레이 | network |
라벨은 여러 개 적용 가능. GitHub에 없는 라벨은 자동 생성하거나 사용자에게 안내.
6단계: 생성 전 확인
사용자에게 다음을 보여주고 확인받는다:
📋 이슈 생성 예정
제목: [Bug] 카드 뒤집기 시 NullReferenceException 발생
라벨: bug, card
담당자: @username
본문:
---
(본문 미리보기)
---
생성할까요? (y/n)
반드시 사용자 확인 후 이슈를 생성한다.
7단계: 이슈 생성
gh issue create \
--title "<이슈 제목>" \
--body "<이슈 본문>" \
--label "<label1>" \
--label "<label2>" \
--assignee "<username>"
라벨이 없을 때 자동 생성:
gh label create "<label-name>" --color "#0075ca" --description "<설명>"
8단계: 결과 보고
이슈 생성 후 다음을 사용자에게 알려준다:
- 이슈 번호 및 URL
- 적용된 라벨 목록
- 담당자
에러 처리
| 상황 | 대응 |
|---|---|
gh 인증 안 됨 |
gh auth login 실행 안내 |
| Git 저장소 아님 | 저장소 확인 요청 |
| 원격 저장소 없음 | GitHub 원격 연결 안내 |
| 라벨 없음 | 자동 생성 또는 사용자 선택 |
| 권한 부족 | 저장소 권한 확인 안내 |
참고
ghCLI 설치: https://cli.github.com- 이슈 확인:
gh issue list - 이슈 보기:
gh issue view <번호>