Day6 Prd Submit

# Day 6: PRD 작성 & PR 제출

PRD(Product Requirements Document) 초안을 템플릿 기반으로 작성하고, 필수 형식을 검증한 뒤, GitHub PR 제출 과정을 안내한다.

---

## 용어 정리

이 스킬에서 사용하는 핵심 용어:

| 용어 | 설명 |
|------|------|
| **PRD** | Product Requirements Document. "이 프로젝트가 뭘 해결하고, 뭘 만드는지" 정리한 문서 |
| **GitHub** | 코드와 문서를 함께 관리하고 공유하는 온라인 서비스. Google Docs의 코드 버전 |
| **GitHub ID** | GitHub 사이트에서 나를 식별하는 이름. 프로필 URL의 마지막 부분 (github.com/여기) |
| **Repository (Repo)** | 프로젝트 파일이 모여있는 폴더. Google Drive의 공유 폴더와 비슷 |
| **브랜치(Branch)** | 원본을 건드리지 않고 내 작업 공간을 따로 만드는 것. "사본으로 저장"과 비슷 |
| **커밋(Commit)** | 변경사항을 저장하는 것. Ctrl+S의 Git 버전 |
| **Push** | 내 컴퓨터에 저장한 것을 온라인(GitHub)에 올리는 것 |
| **PR (Pull Request)** | "내 작업을 확인해주세요"라고 운영진에게 보내는 검토 요청. 제출 버튼과 같다 |
| **gh CLI** | 터미널에서 GitHub을 조작할 수 있는 도구 |

---

## 사전 요구사항

이 스킬은 아래 환경이 갖춰져 있다고 가정한다. Step 0에서 자동 확인한다.

- `git`이 설치되어 있어야 한다
- `gh` CLI가 설치되고 인증되어 있어야 한다
- 대상 repo가 clone 되어 있어야 한다
- repo에 push 권한(collaborator)이 있어야 한다

---

## 소요 시간 가이드

| Step | 주제 | 예상 시간 |
|------|------|-----------|
| 0 | 환경 체크 | ~1분 |
| 1 | GitHub ID 확인 | ~1분 |
| 2 | PRD 작성 + 검증 | ~10분 |
| 3 | 제출 (git + PR) | ~3분 |
| **합계** | | **~15분** |

> 환경이 세팅되어 있으면 15분 내 완료 가능. 환경 문제 발생 시 +5~10분.

---

## PRD 템플릿

```markdown
# [프로젝트 제목]

## 문제
> 한 줄: 누구의, 어떤 불편을, 어떻게 해결하는가

- **현재 상태**: (구체적 수치 — 몇 건, 몇 분, 몇 명)
- **원하는 상태**: (1주 후 돌아가고 있을 모습)
- **성공 기준**: (숫자로 판단 가능한 것 1~2개)

## 스킬
| # | 스킬명 | 한 줄 설명 | 상태 |
|---|--------|-----------|------|
| 1 | `/my-skill-1` | 입력 → 출력 | ✅ 동작 / 🔨 진행중 |
| 2 | `/my-skill-2` | 입력 → 출력 | ✅ 동작 / 🔨 진행중 |

## 변화 기록
- **Day 1**: "처음 정의" →
- **Day 6**: "지금 정의" →
- **가장 크게 달라진 점**:
```

---

## 실행 흐름

```
Step 0           Step 1           Step 2          Step 3
환경 체크 →  GitHub ID 확인 → PRD 작성/검증 → 제출 (git + PR)
```

### Step 0: 환경 사전 체크

스킬 시작 시 **진행 전에** 아래를 자동으로 확인한다:

```bash
git --version
gh --version
gh auth status
git remote -v
```

결과를 참가자에게 보여준다:

```
=== 환경 체크 ===
✅ git: 설치됨
✅ gh CLI: 설치됨
✅ GitHub 로그인: 완료 (사용자: {detected-id})
✅ 프로젝트 폴더: 연결됨 ({repo-url})

환경 준비가 완료되었습니다!
```

**하나라도 실패하면** 해당 항목의 해결 방법을 안내하고, 해결 후 다시 체크한다. 모든 항목이 통과할 때까지 다음 Step으로 진행하지 않는다.

| 실패 항목 | 안내 |
|----------|------|
| git 미설치 | "git이 설치되어있지 않습니다. 운영진에게 도움을 요청해주세요." |
| gh CLI 미설치 | "`brew install gh`를 터미널에 입력해주세요." (macOS 기준). 실패 시 운영진 호출 |
| gh 미인증 | "`gh auth login`을 입력하고 나오는 안내를 따라주세요. GitHub 계정으로 로그인하면 됩니다." |
| repo 연결 안 됨 | "프로젝트를 아직 내 컴퓨터에 다운로드하지 않았어요. 터미널에서 아래를 입력해주세요: `gh repo clone {owner/repo}`" |

### Step 1: GitHub ID 확인

Step 0에서 `gh auth status`로 감지된 GitHub ID를 보여주고 확인만 받는다:

```
AskUserQuestion: "GitHub 사용자명이 '{detected-id}'가 맞나요?"
- 네, 맞습니다
- 아니요, 다른 ID입니다 (직접 입력)
```

**ID 형식 검증**: 입력된 ID가 영문, 숫자, 하이픈(`-`)만 포함하는지 확인한다. 특수문자, 공백, 슬래시 등이 포함되면 안내 후 다시 입력받는다.

입력된 ID는 소문자로 정규화한다.

이 ID는 이후 파일 경로와 브랜치명에 사용된다:
- 파일: `{github-id}/PRD.md`
- 브랜치: `prd/{github-id}`

### Step 2: PRD 작성 또는 검증

AskUserQuestion으로 현재 상태를 묻는다:

| 선택지 | 동작 |
|--------|------|
| PRD 새로 작성하기 | Step 2-A: 템플릿 기반 작성 가이드 |
| 이미 작성한 PRD 검증하기 | Step 2-B: 기존 파일 검증 |

#### Step 2-A: PRD 작성 가이드

1. 위 PRD 템플릿을 보여준다
2. AskUserQuestion으로 프로젝트 주제를 묻는다:

```
"어떤 프로젝트의 PRD를 작성할까요?"
- 캠프에서 만든 스킬 기반 (이번 주에 만든 스킬을 프로젝트로 발전)
- 업무 자동화 아이디어 (실제 업무에서 자동화하고 싶은 것)
- 직접 입력
```

"캠프에서 만든 스킬 기반"을 선택하면, `.claude/skills/` 디렉토리를 스캔하여 참가자가 만든 스킬 목록을 보여주고 선택하게 한다.

3. 참가자의 답변을 바탕으로 PRD 초안을 생성한다

4. 초안을 터미널에 출력하고 AskUserQuestion:

| 선택지 | 동작 |
|--------|------|
| 이대로 진행 | `{github-id}/PRD.md`에 저장 후 Step 2-B로 |
| 수정하고 싶어요 | 어떤 부분을 수정할지 묻고 (문제 정의 / 스킬 목록 / 변화 기록) 반영 후 다시 출력 |

5. **중요**: PRD 내용은 참가자의 실제 경험과 프로젝트를 반영해야 한다. 일반적인 예시가 아닌 캠프에서 만든 스킬, 실제 업무 문제를 담도록 유도한다.

#### Step 2-B: PRD 형식 검증

`{github-id}/PRD.md` 파일을 읽고 아래 체크리스트로 검증한다.

### 검증 체크리스트

| # | 항목 | 검증 방법 | 필수 |
|---|------|----------|------|
| 1 | 프로젝트 제목 | `#`으로 시작하는 첫 번째 줄 (큰 제목)이 존재하는가 | 필수 |
| 2 | 문제 섹션 | `## 문제` 헤딩이 존재하는가 | 필수 |
| 3 | 현재 상태 | `현재 상태` 텍스트가 존재하고 10자 이상인가 | 필수 |
| 4 | 원하는 상태 | `원