GitHub Feature Ticket Generator

이 스킬은 사용자가 간단히 설명한 기능을 바탕으로 구조화된 GitHub 기능 티켓을 자동으로 생성합니다.

목적

새로운 기능 개발 시 필요한 태스크를 체계적으로 정리하여 GitHub Issue로 생성함으로써, 팀의 작업 추적과 협업을 돕습니다.

사용 시점

사용자가 새로운 기능 개발에 대한 티켓 생성을 요청할 때 사용합니다:

• "기능 티켓 만들어줘"
• "[기능명] 이슈 생성해줘"
• "GitHub 기능 티켓 만들어줘"

사용하지 않는 경우:

• 버그 리포트
• 문의/질문
• 단순 개선 사항
• 문서 작업

티켓 형식

기본 구조

## 설명

[기능에 대한 상세 설명]

## 공통

- [ ] [공통 태스크]
  - 하위 태스크 설명

## 프론트엔드

- [ ] [프론트엔드 태스크]
  - 하위 태스크 설명

## 백엔드

- [ ] [백엔드 태스크]
  - 하위 태스크 설명

## 인프라 (필요 시)

- [ ] [인프라 태스크]
  - 하위 태스크 설명

섹션 설명

설명 (Description)

• 기능의 목적과 범위를 2-3문장으로 요약
• 사용자 관점에서 무엇을 할 수 있는지 명시
• 연동되는 외부 서비스가 있다면 언급

공통 (Common)

• 요구사항 정리, 기능 정의서 작성
• 시나리오 및 예외 처리 정의
• 개발 컨벤션 및 워크플로우 정리

프론트엔드 (Frontend)

• UI/UX 구현 태스크
• 화면별 기능 구현
• 외부 모듈/SDK 연동 (클라이언트 측)
• 상태 관리 및 API 연동

백엔드 (Backend)

• API 엔드포인트 구현
• 비즈니스 로직 처리
• 데이터베이스 설계 및 연동
• 외부 서비스 연동 (서버 측)

인프라 (Infrastructure) - 필요 시만 포함

• 새로운 서버/서비스 배포
• CI/CD 파이프라인 구성
• 클라우드 리소스 프로비저닝
• 모니터링 설정

태스크 작성 가이드

세분화 원칙

1. 하나의 체크박스 = 하나의 작업 단위
2. 하위 항목으로 세부 사항 명시 (들여쓰기)
3. 명확한 동사로 시작 (구현, 연동, 처리, 설계, 작성)

좋은 예시

- [ ] 상품 조회 화면 구현
  - 상품 목록 및 상세 정보 표시
  - 카테고리별 필터링 기능

섹션별 패턴

공통:

- [ ] [기능명] 관련 요구사항 정리 및 기능 정의서 작성
- [ ] [기능명] 시나리오 및 예외 처리 정의
- [ ] 개발 컨벤션 및 워크플로우 정리 (프론트/백엔드 공통)

프론트엔드:

- [ ] [화면명] 화면 구현
  - [세부 UI 요소]
- [ ] [외부 모듈] 연동
- [ ] [기능] 결과 처리
  - 성공/실패 알림 UI

백엔드:

- [ ] [데이터] 조회 API 구현
  - DB 또는 외부 서비스 연동
- [ ] [기능] 생성/처리 API 구현
- [ ] [외부 서비스] Webhook 처리

인프라 (필요 시):

- [ ] [서비스] 서버 환경 구성
- [ ] CI/CD 파이프라인 구성
- [ ] 모니터링 설정

티켓 생성 프로세스

1. 기능 분석

사용자 설명에서 다음을 파악:

• 기능의 핵심 목적
• 필요한 화면/API
• 연동 서비스
• 인프라 작업 필요 여부

2. 섹션 구성

기본: 설명 → 공통 → 프론트엔드 → 백엔드

인프라 섹션 추가 기준:

• 새로운 서버/서비스 배포 필요
• CI/CD 파이프라인 구성 필요
• 클라우드 리소스 프로비저닝 필요

3. 태스크 세분화

• 화면 단위, API 단위로 분리
• 하위 항목으로 세부 사항 명시

4. 사용자 확인

티켓 내용을 보여주고 확인 받기

5. GitHub Issue 생성

gh issue create --repo Mockly-Company/.github --title "[제목]" --body "$(cat <<'EOF'
[티켓 내용]
EOF
)" --project "Mockly" --타입 "기능" --Status "Backlog"

중요:

• 반드시 --repo Mockly-Company/.github 옵션 사용
• --project "Mockly" 옵션으로 프로젝트 연결
• --타입 "기능" 옵션으로 타입 설정
• --Status "Backlog" 옵션으로 상태 설정
• 영역은 선택하지 않음 (기능 티켓은 프론트/백엔드 모두 포함하므로)

예시

입력

결제 시스템 만들어줘. 아임포트로 구독 결제하고, 결제 내역 조회할 수 있어야 해.

출력

제목: 결제 시스템

내용:

## 설명

사용자가 상품을 조회하고, 구독 결제를 생성 및 완료하며, 결제 내역을 확인할 수 있는 결제 시스템을 구축합니다.
아임포트(Iamport)를 통한 결제 연동 및 결제 상태 관리까지 포함합니다.

## 공통

- [ ] 결제 관련 요구사항 정리 및 기능 정의서 작성
- [ ] 결제 시나리오 및 예외 처리 정의
- [ ] 개발 컨벤션 및 워크플로우 정리 (프론트/백엔드 공통)

## 프론트엔드

- [ ] 상품 조회 화면 구현
  - 상품 목록 및 상세 정보 표시
- [ ] 구독 결제 생성 UI 구현
  - 아임포트 결제 모듈 연동
  - 결제 옵션 선택 및 결제 버튼 구현
- [ ] 결제 완료 콜백 처리
  - 결제 성공/실패 알림 UI 처리
  - 결제 결과 서버 연동
- [ ] 결제 내역 조회 화면 구현 (마이페이지)
  - 사용자가 자신의 결제 기록 확인 가능
  - 페이징, 필터링 등 UX 개선

## 백엔드

- [ ] 상품 조회 API 구현
  - DB 또는 외부 서비스 연동
- [ ] 구독 결제 생성 API 구현
  - 아임포트 서버 연동
  - 결제 요청 정보 생성 및 반환
- [ ] 결제 완료 콜백 처리
  - 아임포트 Webhook 처리
  - 결제 상태 업데이트 및 알림 처리
- [ ] 결제 내역 조회 API 구현
  - 사용자별 결제 내역 제공
  - 페이징/필터링 기능 포함

Mockly 프로젝트 속성

기능 티켓 생성 시 다음 속성을 설정합니다:

주의사항

1. 레포지토리: 항상 Mockly-Company/.github 레포에 생성
2. 프로젝트: --project "Mockly" 옵션 필수
3. 타입: --타입 "기능" 옵션 필수
4. Status: --Status "Backlog" 옵션 필수
5. 영역: 선택하지 않음 (기능 티켓은 프론트/백엔드 모두 포함)
6. 제목: 기능명을 간결하게 표현
7. 태스크 누락 방지: 프론트/백엔드 양쪽 작업 포함
8. 사용자 확인: GitHub 생성 전 반드시 확인 받기