Day 6: PRD 작성 & PR 제출

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

용어 정리

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

사전 요구사항

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

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

소요 시간 가이드

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

PRD 템플릿

# [프로젝트 제목]

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

- **현재 상태**: (구체적 수치 — 몇 건, 몇 분, 몇 명)
- **원하는 상태**: (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: 환경 사전 체크

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

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

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

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

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

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

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으로 현재 상태를 묻는다:

Step 2-A: PRD 작성 가이드

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

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

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

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

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

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

Step 2-B: PRD 형식 검증

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

검증 체크리스트

검증 결과 출력

=== PRD 형식 검증 결과 ===

[PASS] 또는 [보완 필요]

✅ 프로젝트 제목: 있음
✅ 문제 섹션: 있음
✅ 현재 상태: 있음
✅ 원하는 상태: 있음
✅ 성공 기준: 있음
✅ 스킬 섹션: 있음
✅ 스킬 2개 이상: 있음 (N개)
✅ 변화 기록: 있음

결과: 8/8 통과 → PASS

보완 필요인 경우 누락된 항목을 구체적으로 안내한다:

❌ 성공 기준: 내용이 너무 짧습니다. 구체적인 숫자를 포함해주세요.
   예) "주 3회 사용, 건당 처리 시간 30분 → 5분"

Step 3: 제출 (git + PR)

검증 PASS 후, AskUserQuestion:

"PRD 검증을 통과했습니다! GitHub에 제출할까요?"
- 네, 제출해주세요 (권장)
- 나중에 할게요

“나중에 할게요” 선택 시: “준비되면 다시 이 스킬을 실행해주세요.” 안내 후 종료.

“네, 제출해주세요” 선택 시 아래를 실행한다. 각 단계마다 한글 진행 상태를 출력한다:

[1/5] 최신 상태로 동기화하는 중...

git checkout main && git pull origin main

[2/5] 제출용 공간을 만드는 중...

git checkout -b prd/{github-id}

브랜치가 이미 존재하면 git checkout prd/{github-id}로 전환한다.

[3/5] PRD 파일을 등록하는 중...

git add {github-id}/PRD.md

git status로 스테이징된 파일이 {github-id}/PRD.md 1개뿐인지 확인한다. 다른 파일이 포함되면 해당 파일을 unstage한다.

[4/5] 저장하는 중...

git commit -m "feat: {github-id} PRD 초안 제출"

[5/5] GitHub에 올리는 중...

git push origin prd/{github-id}

push 완료 후, gh CLI로 PR을 생성한다:

gh pr create --repo {owner/repo} --title "PRD: {github-id}" --body "$(cat <<'EOF'
## PRD 초안 제출

- 작성자: {github-id}
- 파일: {github-id}/PRD.md

검증 결과: PASS (8/8)
EOF
)"

PR URL을 출력하고 완료를 안내한다.

완료 리포트

=== Day 6 PRD 제출 완료 ===
GitHub ID: {github-id}
파일: {github-id}/PRD.md
브랜치: prd/{github-id}
검증: PASS (8/8)
PR: {PR URL}

축하합니다! GitHub에 첫 PR을 올렸습니다.
운영진이 확인 후 승인할 예정입니다.

에러 처리

출력 위치