Feedback — 버그/기능 요청 GitHub Issues 등록

moai-core | 피드백 수집 및 이슈 자동 등록

개요

사용자의 버그 리포트 또는 기능 요청을 구조화하여 GitHub Issues에 자동 등록합니다. 대상 레포지토리: modu-ai/cowork-plugins

트리거 키워드

버그 신고 피드백 기능 요청 feature request bug report 개선 요청 이슈 등록 문제 신고

워크플로우

1. [분류] 버그 vs 기능 요청 판별
2. [수집] 구조화 인터뷰로 필수 정보 수집
3. [확인] 이슈 미리보기 → 사용자 승인
4. [등록] gh issue create로 GitHub Issues 등록
5. [완료] 이슈 URL 전달

실행 규칙

1단계: 분류

사용자 메시지에서 유형을 판별한다:

유형	판별 기준	레이블
버그	"안 돼", "오류", "에러", "깨져", "문제", "bug"	bug
기능 요청	"추가해줘", "있으면 좋겠", "기능 요청", "feature"	enhancement
불명확	위 키워드 없음	AskUserQuestion으로 확인

2단계: 정보 수집

AskUserQuestion으로 필수 정보를 수집한다.

버그 리포트 수집 항목:

항목	필수	설명
관련 플러그인/스킬	O	어떤 플러그인에서 발생했는지
증상	O	무엇이 잘못되었는지
재현 절차	O	어떻게 하면 재현되는지
기대 동작	-	정상이라면 어떻게 되어야 하는지

기능 요청 수집 항목:

항목	필수	설명
관련 플러그인/스킬	O	어떤 플러그인에 추가할지
요청 내용	O	어떤 기능이 필요한지
사용 시나리오	-	어떤 상황에서 필요한지

자연어 메시지에 충분한 정보가 포함되어 있으면 인터뷰를 생략한다.

3단계: 이슈 미리보기

수집한 정보를 이슈 형식으로 구성하여 사용자에게 확인 요청:

버그 리포트 템플릿:

## 버그 설명
[증상 요약]

## 재현 절차
1. [절차]

## 기대 동작
[정상 동작 설명]

## 환경
- 플러그인: [플러그인명]
- 스킬: [스킬명]

기능 요청 템플릿:

## 기능 설명
[요청 내용]

## 사용 시나리오
[어떤 상황에서 필요한지]

## 관련 플러그인
- [플러그인명]

AskUserQuestion으로 "등록하시겠습니까?" 확인. 선택지: "등록" / "수정 후 등록" / "취소"

4단계: GitHub Issues 등록

gh CLI로 이슈를 생성한다:

gh issue create \
  --repo modu-ai/cowork-plugins \
  --title "[{레이블}] {제목}" \
  --body "{본문}" \
  --label "{레이블}"

레이블 매핑:

• 버그 → bug
• 기능 요청 → enhancement

플러그인명이 명확하면 추가 레이블: plugin:{플러그인명} (예: plugin:moai-office)

5단계: 완료 보고

이슈 생성 결과를 사용자에게 전달:

• 이슈 번호와 URL
• "감사합니다. 피드백이 등록되었습니다." 메시지

gh CLI 인증 실패 시

gh CLI가 없거나 인증되지 않은 환경에서는:

1. 이슈 본문을 마크다운으로 출력
2. GitHub Issues 페이지 직접 링크 제공: https://github.com/modu-ai/cowork-plugins/issues/new
3. "복사하여 직접 등록해 주세요" 안내

사용 예시

버그 신고: moai-office PPT 생성 시 한글 폰트가 깨져요

기능 요청: moai-marketing에 유튜브 쇼츠 대본 스킬 추가해주세요

/moai feedback 세금 계산 결과가 이상해요

이 스킬을 사용하지 말아야 할 때

• 플러그인 사용법 질문 → /moai catalog 또는 해당 플러그인 직접 호출
• 일반적인 불만이나 감상 → 별도 스킬 없이 직접 대화
• 긴급 보안 이슈 → email@mo.ai.kr 으로 직접 연락