| name | moai-alfred-feedback-templates |
| version | 1.0.0 |
| created | 2025-11-12T00:00:00.000Z |
| updated | 2025-11-12T00:00:00.000Z |
| status | stable |
| language | ko |
| description | GitHub 이슈 라벨별 구조화된 템플릿. 버그, 기능 요청, 개선 사항, 리팩토링, 문서, 질문 등
각 이슈 타입에 맞는 한국어 템플릿 제공. /alfred:9-feedback에서 사용.
|
| keywords | ["feedback","templates","issue-creation","korean","structured-templates","bug-report","feature-request"] |
| allowed-tools | ["Read"] |
GitHub 이슈 작성 템플릿 모음 v1.0.0
개요
GitHub 이슈를 일관되고 명확하게 작성하기 위한 라벨별 구조화된 템플릿입니다.
각 라벨에 맞는 템플릿을 사용하면:
- ✅ 명확성: 이슈 내용이 명확하고 구조화됨
- ✅ 효율성: 누락된 정보가 줄어듦
- ✅ 일관성: 팀 전체의 이슈 형식이 통일됨
- ✅ 추적성: 모든 중요 정보가 기록됨
🐛 버그 리포트 템플릿
언제 사용?
- 예상하지 못한 동작이나 오류 발생
- 기능이 정상적으로 작동하지 않음
- 성능 저하 또는 비정상적인 동작
템플릿
## 버그 설명
[버그가 무엇인지 간단하게 설명하세요]
## 재현 단계
1. [첫 번째 단계]
2. [두 번째 단계]
3. [버그 발생하는 단계]
## 예상 동작
[정상적으로 동작해야 하는 내용 설명]
## 실제 동작
[실제로 일어나는 내용 설명]
## 환경 정보
- MoAI-ADK 버전: [버전]
- Python 버전: [버전]
- OS: [Windows/macOS/Linux]
- 브라우저: [선택사항]
## 추가 정보
[스크린샷, 에러 메시지, 로그 등]
예시
## 버그 설명
/alfred:1-plan 명령어 실행 시 스펙 생성이 안 됩니다.
## 재현 단계
1. `/alfred:1-plan "새로운 기능 추가"` 명령 실행
2. 단계 1~4를 모두 진행
3. 최종 확인 후 생성 버튼 클릭
## 예상 동작
새로운 SPEC 문서가 .moai/specs/SPEC-XXX/ 폴더에 생성되어야 함
## 실제 동작
"스펙 생성 실패" 에러 메시지만 출력되고 폴더 생성 안 됨
## 환경 정보
- MoAI-ADK 버전: 0.22.5
- Python 버전: 3.11.5
- OS: macOS 14.2
✨ 기능 요청 템플릿
언제 사용?
- 새로운 기능이 필요함
- 기존 기능의 개선 방안을 제안하고 싶음
- 새로운 명령어나 도구 추가를 요청
템플릿
## 기능 설명
[어떤 기능이 필요한지 설명하세요]
## 사용 시나리오
[이 기능이 언제/어떻게 사용될지 설명하세요]
예: 사용자가 X를 하려고 할 때, Y 기능이 있으면 Z를 쉽게 할 수 있습니다.
## 기대 효과
- [효과 1]
- [효과 2]
- [효과 3]
## 구현 아이디어 (선택사항)
[이 기능을 어떻게 구현할 수 있을지 아이디어가 있으면 제시하세요]
## 우선순위
- 🔴 긴급: 즉시 필요
- 🟠 높음: 곧 필요
- 🟡 중간: 적당히 필요 (기본값)
- 🟢 낮음: 나중에 괜찮음
예시
## 기능 설명
/alfred:9-feedback 명령어에 자동 정보 수집 기능이 필요합니다.
버그 리포트 시 환경 정보(버전, OS, Git 상태)를 자동으로 수집하면 좋을 것 같습니다.
## 사용 시나리오
버그를 발견한 사용자가 /alfred:9-feedback을 실행하면,
자동으로 MoAI-ADK 버전, Python 버전, 현재 Git 상태, 최근 에러 로그를 수집해서
이슈 본문에 포함시켜줍니다.
## 기대 효과
- 버그 리포팅 시간 단축 (수동 입력 제거)
- 환경 정보 누락 방지
- 버그 분석 시 필요한 정보를 처음부터 갖춤
⚡ 개선 사항 템플릿
언제 사용?
- 코드 품질 개선 제안
- 성능 최적화 아이디어
- 사용자 경험(UX) 개선
- 문서화 개선
템플릿
## 개선 내용
[무엇을 개선하고 싶은지 설명하세요]
## 현재 상태
[현재 어떻게 되어 있는지 설명하세요]
## 개선 후 상태
[개선되면 어떻게 달라질지 설명하세요]
## 성능/품질 영향
- 성능: [향상도, 예: 응답 시간 50% 단축]
- 사용성: [개선도, 예: 단계 2단계 감소]
- 유지보수성: [효과, 예: 코드 복잡도 30% 감소]
## 구현 복잡도
- ⚪ 낮음: 1-2시간
- 🟡 중간: 반나절
- 🔴 높음: 1일 이상
예시
## 개선 내용
AskUserQuestion의 단계를 줄여서 사용 편의성 개선
## 현재 상태
/alfred:9-feedback 실행 시 4단계 질문 (이슈 타입 → 제목 → 설명 → 우선순위)
## 개선 후 상태
1단계로 통합: 한 번에 필수 정보(타입, 우선순위) + 자동 템플릿 생성
## 성능/품질 영향
- 사용성: 4단계 → 1-2단계 (50% 단축)
- 시간: ~90초 → ~30초 (67% 단축)
