القائمة
COTATO 프로젝트 PR 생성 워크플로우. "PR 만들어줘", "pull request", /pr 입력 시 사용. [TYPE]: 제목 형식, PR 템플릿 준수, develop 기준.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
COTATO 프로젝트 코드 리뷰 워크플로우. "코드 리뷰해줘", "review" 입력 시 사용. CRITICAL/HIGH/MEDIUM/LOW 심각도 분류, 프로젝트 컨벤션 준수 확인.
COTATO 프로젝트 커밋 워크플로우. "커밋해줘", "commit", /commit 입력 시 사용. atomic 단위 커밋 분리, secret guard, 계획 승인 후 실행.
COTATO 프로젝트 문서 작성 워크플로우. "문서 만들어줘", "README 써줘" 입력 시 사용. README/설계문서/ADR 구조, Why 중심 서술.
COTATO 프로젝트 GitHub 이슈 생성 워크플로우. "이슈 만들어줘", /issue 입력 시 사용. [TYPE]: 제목 형식, 템플릿 준수, 브랜치 자동 생성.
COTATO 프로젝트 릴리즈 자동화 워크플로우. "릴리즈해줘", "release PR", /release 입력 시 사용. develop→release/X.Y.Z→main, GitHub Release draft 자동 생성.
COTATO UI 패키지 Storybook 스토리 작성 워크플로우. "스토리 만들어줘", "스토리북", /storybook 입력 시 사용. CSF3 패턴, packages/ui 구조 준수.
다음 요청이 오면 이 스킬을 사용한다:
pull request/prdevelop 브랜치에서 갈라진 전체 변경을 분석한다. 최신 커밋 하나만 보지 않는다.[TYPE]: 한국어 요약 형식 — 콜론(:)은 필수다. (예: [FEAT]: 로그인 API 연동)develop. 다르면 사용자에게 먼저 물어본다.git log develop...HEAD --oneline으로 포함될 커밋 전체 확인git diff develop...HEAD --stat으로 전체 변경 파악{type}과 {scope} 추출 → 라벨 결정git push -u origin <branch> 수행gh pr create 실행⚠️ CRITICAL: PR 제목은 반드시
[TYPE]:형태로 콜론(:)을 포함한다.[TYPE]단독으로 쓰는 것은 금지.
[TYPE]: <전체 변경사항을 아우르는 한국어 요약>
| 커밋 타입 | TYPE |
|---|---|
feat | [FEAT]: |
fix | [FIX]: |
design | [DESIGN]: |
style | [STYLE]: |
ui | [UI]: |
refactor | [REFACTOR]: |
docs | [DOCS]: |
test | [TEST]: |
chore | [CHORE]: |
ci | [CI]: |
perf | [PERF]: |
security | [SECURITY]: |
PR 라벨은 GitHub Actions workflow 두 개가 자동 처리한다.
--label은 아래 기준으로만 추가한다.
- type 라벨:
.github/workflows/type-labeler.yml— PR 제목의[TYPE]:패턴 감지 후 자동 부착- scope 라벨:
.github/labeler.yml— 변경된 파일 경로 기반 자동 부착따라서
gh pr create실행 시--label을 별도로 지정하지 않아도 된다. workflow가 실패하는 경우에만 아래 표를 참고해 수동으로 추가한다.
| type | 라벨 |
|---|---|
feat | ✨ Feature |
fix | 🐛 Bug |
refactor | 💦 Refactor |
design | 🎨 Style |
style | 🎨 Style |
ui | 📷 UI |
docs | 📄 Documentation |
test | 🌊 TEST |
chore | 🧹 CHORE |
ci | 😎 DevOps |
perf | 💦 Refactor |
security | 🐛 Bug |
| scope | 라벨 |
|---|---|
homepage | 🥔 HOMEPAGE |
recruit | 🥔 RECRUIT |
root / ui | 🍟 COMMON |
.github/PULL_REQUEST_TEMPLATE.md 의 모든 섹션을 빠짐없이 채운다:
## ISSUE 🔗
close #<이슈번호>
<br><br>
## What is this PR? 🔍
<br><br>
## Screenshot 📷
<!-- 구현된 기능/디자인 gif — 에이전트는 가이드 주석만 유지 -->
<br><br>
## Test Checklist ✔
- [ ] <검증 항목 1>
- [ ] <검증 항목 2>
커밋이 1개인 경우:
- **💡 배경**: 왜 이 작업이 필요했는지 설명합니다.
- **✨ 주요 변경사항**: 무엇을 어떻게 바꿨는지 설명합니다.
- **🧪 리뷰 포인트**: 리뷰어가 집중해야 할 부분 (불명확하면 생략 가능)
커밋이 2개 이상인 경우:
### 1. feat(recruit): 사용자 프로필 컴포넌트 추가
- **💡 배경**: ...
- **✨ 주요 변경사항**: ...
- **🧪 리뷰 포인트**: ...
### 2. fix(recruit): 토큰 갱신 오류 수정
- **💡 배경**: ...
- **✨ 주요 변경사항**: ...
gh pr create \
--title "[FEAT]: PR 제목" \
--body "$(cat <<'EOF'
## ISSUE 🔗
close #12
<br><br>
## What is this PR? 🔍
...
<br><br>
## Screenshot 📷
<!-- 구현된 기능/디자인 gif -->
<br><br>
## Test Checklist ✔
- [ ] 기능 동작 확인
- [ ] 엣지 케이스 확인
EOF
)"
라벨은
type-labeler.yml/labeler.ymlworkflow가 자동 처리하므로--label생략.
[TYPE] 뒤에 콜론(:)을 빠뜨리지 않는다 — [FEAT]은 틀렸고 [FEAT]:이 맞다