القائمة
작업 오케스트레이션 스킬. 분석 → 구현 → 리뷰 → 커밋까지 전체 워크플로우 관리. 기능 개발, 버그 수정 등 모든 작업에 사용.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
검증 스킬. 빌드, 린트, 테스트, E2E 검증. 커밋/PR 전 필수 실행. AI가 스스로 코드를 검증하는 자체 검증 루프.
기능 개발 스킬. Repository 패턴, 태스크 프로세스, 코드 컨벤션. 코드 작성 시 사용.
코드 리뷰 스킬. 버그, 보안, 성능, 가독성 체크. PR 리뷰, 자기 검토 시 사용.
프론트엔드 개발 스킬. RSC 보안, 서버/클라이언트 분리, SEO. 프론트엔드 작업 시 사용.
| name | task |
| description | 작업 오케스트레이션 스킬. 분석 → 구현 → 리뷰 → 커밋까지 전체 워크플로우 관리. 기능 개발, 버그 수정 등 모든 작업에 사용. |
통합 워크플로우 오케스트레이션. 작업 분석부터 Git 커밋까지 전체 사이클 관리.
/task "작업 설명"
│
├─ Phase 1: 분석
│ ├─ 요구사항 파악
│ ├─ 영향받는 파일 식별
│ ├─ 작업 타입 결정 (feat/fix/refactor)
│ └─ 브랜치 생성
│
├─ Phase 2: 구현
│ ├─ /developer 스킬 적용 (데이터 계층, 로직)
│ ├─ /frontend 스킬 적용 (UI, 컴포넌트)
│ └─ 기능 단위로 중간 커밋
│
├─ Phase 3: 리뷰
│ ├─ /reviewer 스킬 적용
│ ├─ [Critical] 이슈 → Phase 2로 돌아가 수정
│ ├─ [Major] 이슈 → Phase 2로 돌아가 수정
│ └─ [Minor] 이슈 → 선택적 수정
│
└─ Phase 4: 마무리
├─ 최종 커밋
├─ docs/TASK.md 업데이트
└─ (선택) PR 생성 안내
| 타입 | 브랜치 접두사 | 설명 |
|---|---|---|
| 새 기능 | feat/ | 새로운 기능 추가 |
| 버그 수정 | fix/ | 버그 수정 |
| 리팩토링 | refactor/ | 코드 개선 (기능 변경 없음) |
| 문서 | docs/ | 문서 작성/수정 |
| 스타일 | style/ | 코드 포맷팅 |
| 테스트 | test/ | 테스트 추가/수정 |
# 예시: feat/guest-mode
git checkout -b {타입}/{kebab-case-설명}
데이터/로직 먼저: /developer 스킬 적용
UI/컴포넌트: /frontend 스킬 적용
구현 중 의미 있는 단위마다 커밋:
git add <관련 파일들>
git commit -m "{타입}: {설명}"
커밋 메시지 규칙 (Conventional Commits):
feat: 게스트 모드 guestId 관리 함수 추가
feat: 프로젝트 로컬 저장소 구현
feat: AuthProvider 구현
fix: isGuestProject 버그 수정
refactor: 코드 정리
커밋 단위 기준:
구현 완료 후 자동으로 리뷰 수행:
| 우선순위 | 조치 |
|---|---|
| [Critical] | 반드시 수정 → Phase 2 |
| [Major] | 수정 권장 → Phase 2 |
| [Minor] | 선택적 수정 |
리뷰 → 이슈 발견 → 수정 (developer/frontend) → 재리뷰
이슈가 없거나 Minor만 남으면 Phase 4로 진행.
/verify 실행
├─ pnpm build # 빌드 확인
├─ pnpm lint # 린트 확인
└─ pnpm test:run # 테스트 확인
규칙: 커밋 전에 반드시 /verify 스킬을 실행하여 자체 검증 루프를 거쳐야 합니다. 검증 실패 시 Claude가 스스로 수정하고 재검증합니다.
[x] 표시새 디렉토리 생성 또는 주요 변경 시 해당 디렉토리에 CLAUDE.md 작성:
# {디렉토리명}
## 역할
{이 디렉토리의 책임과 목적}
## 파일 구조
| 파일 | 역할 |
|------|------|
| example.ts | {간단한 설명} |
## 의존성
- {의존하는 다른 모듈}
---
최종 수정: YYYY-MM-DD
필수 포함 항목:
--- 구분선 후 기재)git add .
git commit -m "{타입}: {전체 작업 요약}"
# PR 생성이 필요하면:
git push -u origin {브랜치명}
gh pr create --title "{제목}" --body "{설명}"
/task 게스트 모드 + 로컬 저장소 구현
1. 분석
- 타입: feat (새 기능)
- 브랜치: feat/guest-mode
- 영향: lib/, storage/, components/providers/
- 스킬: developer → frontend
2. 구현
- /developer: guest.ts, project.local.ts, chapter.local.ts
- 커밋: "feat: implement guest mode and local repositories"
- /frontend: AuthProvider.tsx
- 커밋: "feat: add AuthProvider with guest support"
3. 리뷰
- /reviewer 실행
- [Major] isGuestProject 버그 발견
- 수정 후 재리뷰 → 통과
4. 마무리
- pnpm build ✓
- docs/TASK.md 업데이트
- 커밋: "fix: resolve review issues"
git -C 명령어 사용 금지, 항상 working directory에서 직접 실행