Feedback — 피드백 수집 및 GitHub Issues 등록

개요

사용자의 버그 리포트 또는 기능 요청을 구조화된 인터뷰를 통해 수집하고, GitHub Issues에 자동 등록합니다. cowork-plugins 저장소(modu-ai/cowork-plugins)의 이슈를 관리하며, 명확한 문제 정의와 재현 가능한 정보를 수집하는 데 중점을 둡니다.

트리거 키워드

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

워크플로우

1단계: 분류 — 버그 vs 기능 요청 판별
2단계: 수집 — AskUserQuestion으로 필수 정보 수집
3단계: 확인 — 이슈 미리보기 → 사용자 승인
4단계: 등록 — gh issue create로 GitHub Issues 등록
5단계: 완료 — 이슈 URL 전달

1단계: 분류

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

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

2단계: 정보 수집

AskUserQuestion으로 필수 정보를 수집합니다. 자연어 메시지에 충분한 정보가 포함되어 있으면 인터뷰를 생략합니다.

버그 리포트 수집 항목:

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

기능 요청 수집 항목:

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

3단계: 이슈 미리보기

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

버그 리포트 템플릿:

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

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

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

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

기능 요청 템플릿:

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

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

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

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

4단계: GitHub Issues 등록

gh CLI로 이슈를 생성합니다:

bash
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에 유튜브 쇼츠 대본 스킬 추가해주세요

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

이슈 등록: moai-content 블로그 스킬에서 이미지 업로드가 안 돼요

출력 형식

성공 시:

✅ 피드백이 등록되었습니다.

이슈 #123: [bug] moai-office 한글 폰트 깨짐
https://github.com/modu-ai/cowork-plugins/issues/123

감사합니다. 빠른 시일 내에 검토하겠습니다.

gh CLI 미설치 시:

⚠️ GitHub CLI가 설치되지 않았습니다.

아래 내용을 복사하여 직접 등록해 주세요:
[이슈 본문 마크다운]

GitHub Issues: https://github.com/modu-ai/cowork-plugins/issues/new

주의사항

• 단순 불만 표출에는 사용하지 마세요: 구체적인 문제 설명이 없는 "별로예요", "안 좋아요" 같은 메시지는 이 스킬이 아닌 일반 대화로 처리하세요.
• 플러그인 사용법 질문은 별도 스킬로: 사용법이나 설정 방법 질문은 /project catalog로 확인하거나 해당 플러그인을 직접 호출하세요.
• 긴급 보안 이슈는 직접 연락: 보안 취약점은 이슈 트래커가 아닌 email@mo.ai.kr 로 직접 알려주세요.
• 중복 이슈 확인: 유사한 문제가 이미 보고되었는지 검색한 후 등록하세요.

관련 스킬

• moai:project — 프로젝트 문서 생성 및 카탈로그 관리
• moai-core:ai-slop-reviewer — 텍스트 산출물 품질 검수
• moai-foundation-cc — 스킬 제작 가이드라인