PRD 초안을 작성하고 형식을 검증한 뒤 GitHub PR 제출을 안내한다. "PRD 작성", "PRD 검증", "Day 6", "6일차", "PR 제출", "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 템플릿 실행 흐름 Step 0: 환경 사전 체크 스킬 시작 시 진행 전에 아래를 자동으로 확인한다: 결과를 참가자에게 보여준다: 하나라도 실패하면 해당 항목의 해결 방법을 안내하고, 해결 후 다시 체크한다. 모든 항목이 통과할 때까지 다음 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를 보여주고 확인만 받는다: 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으로 프로젝트 주제를 묻는다: "캠프에서 만든 스킬 기반"을 선택하면, .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 원하는 상태 원하는 상태 텍스트가 존재하고 10자 이상인가 필수 5 성공 기준 성공 기준 텍스트가 존재하고 10자 이상인가 필수 6 스킬 섹션 스킬 헤딩이 존재하는가 필수 7 스킬 2개 이상 스킬 테이블에서 1 , 2 등 번호로 시작하는 데이터 행이 2개 이상 (헤더행, 구분선 제외) 필수 8 변화 기록 변화 기록 헤딩이 존재하는가 필수 검증 결과 출력 보완 필요인 경우 누락된 항목을 구체적으로 안내한다: Step 3: 제출 (git + PR) 검증 PASS 후, AskUserQuestion: "나중에 할게요" 선택 시: "준비되면 다시 이 스킬을 실행해주세요." 안내 후 종료. "네, 제출해주세요" 선택 시 아래를 실행한다. 각 단계마다 한글 진행 상태를 출력한다: 브랜치가 이미 존재하면 git checkout prd/{github id} 로 전환한다. git status 로 스테이징된 파일이 {github id}/PRD.md 1개뿐인지 확인한다. 다른 파일이 포함되면 해당 파일을 unstage한다. push 완료 후, gh CLI로 PR을 생성한다: PR URL을 출력하고 완료를 안내한다. 완료 리포트 에러 처리 상황 대응 git 미설치 "git이 설치되어있지 않습니다. 운영진에게 도움을 요청해주세요." gh CLI 미설치 " brew install gh 를 입력해주세요." 실패 시 운영진 호출 안내 gh 미인증 " gh auth login 을 입력하고 GitHub 계정으로 로그인해주세요." PRD.md 파일 없음 "PRD 파일이 아직 없어요. 먼저 작성할까요?" 검증 보완 필요 누락 항목 + 구체적 예시 안내 + 수정 도움 git 브랜치 이미 존재 기존 브랜치로 자동 전환 push 실패 (인증) "GitHub 로그인이 필요합니다. gh auth login 을 실행해주세요." push 실패 (권한) "이 프로젝트에 제출 권한이 없어요. Slack에서 운영진(@zoon)에게 '권한이 필요합니다'라고 메시지를 보내주세요." repo clone 안 됨 "프로젝트를 먼저 다운로드해야 해요. 터미널에 gh repo clone {owner/repo} 를 입력해주세요." GitHub ID 형식 오류 "GitHub ID에는 영문, 숫자, 하이픈( )만 사용할 수 있어요." 출력 위치 경로 내용 {github id}/PRD.md 참가자 PRD 문서

day6-prd-submit