feedback

# 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** — 스킬 제작 가이드라인