| name | task |
| description | 작업 오케스트레이션 스킬. 분석 → 구현 → 리뷰 → 커밋까지 전체 워크플로우 관리. 기능 개발, 버그 수정 등 모든 작업에 사용. |
Task Skill
통합 워크플로우 오케스트레이션. 작업 분석부터 Git 커밋까지 전체 사이클 관리.
워크플로우
/task "작업 설명"
│
├─ Phase 1: 분석
│ ├─ 요구사항 파악
│ ├─ 영향받는 파일 식별
│ ├─ 작업 타입 결정 (feat/fix/refactor)
│ └─ 브랜치 생성
│
├─ Phase 2: 구현
│ ├─ /developer 스킬 적용 (타입, 스토리지, 로직)
│ ├─ /frontend 스킬 적용 (UI, 컴포넌트)
│ └─ 기능 단위로 중간 커밋
│
├─ Phase 3: 리뷰
│ ├─ /reviewer 스킬 적용
│ ├─ [Critical] 이슈 → Phase 2로 돌아가 수정
│ ├─ [Major] 이슈 → Phase 2로 돌아가 수정
│ └─ [Minor] 이슈 → 선택적 수정
│
└─ Phase 4: 마무리
├─ /verify 실행
├─ 최종 커밋
└─ (선택) PR 생성 안내
Phase 1: 분석
작업 타입 판별
| 타입 | 브랜치 접두사 | 설명 |
|---|
| 새 기능 | feat/ | 새로운 기능 추가 |
| 버그 수정 | fix/ | 버그 수정 |
| 리팩토링 | refactor/ | 코드 개선 (기능 변경 없음) |
| 문서 | docs/ | 문서 작성/수정 |
| 스타일 | style/ | 코드 포맷팅 |
| 테스트 | test/ | 테스트 추가/수정 |
브랜치 생성
git checkout -b {타입}/{kebab-case-설명}
분석 체크리스트
Phase 2: 구현
스킬 호출 순서
-
데이터/로직 먼저: /developer 스킬 적용
- 타입 정의, 인터페이스
- Storage 유틸리티
- 비즈니스 로직
-
UI/컴포넌트: /frontend 스킬 적용
기능 단위 커밋
구현 중 의미 있는 단위마다 커밋:
git add <관련 파일들>
git commit -m "{타입}: {설명}"
커밋 메시지 규칙 (Conventional Commits):
feat: add tag filtering logic
feat: implement TagFilter component
fix: search not matching partial text
refactor: extract storage utilities
커밋 단위 기준:
- 하나의 논리적 변경 = 하나의 커밋
- 롤백 시 독립적으로 되돌릴 수 있는 단위
Phase 3: 리뷰
/reviewer 스킬 적용
구현 완료 후 자동으로 리뷰 수행:
| 우선순위 | 조치 |
|---|
| [Critical] | 반드시 수정 → Phase 2 |
| [Major] | 수정 권장 → Phase 2 |
| [Minor] | 선택적 수정 |
수정 루프
리뷰 → 이슈 발견 → 수정 (developer/frontend) → 재리뷰
이슈가 없거나 Minor만 남으면 Phase 4로 진행.
Phase 4: 마무리
최종 점검 (/verify 스킬 호출)
/verify 실행
├─ pnpm build # 빌드 확인
├─ pnpm lint # 린트 확인
└─ pnpm test:run # 테스트 확인
디렉토리별 CLAUDE.md 작성/갱신
새 디렉토리 생성 또는 주요 변경 시 해당 디렉토리에 CLAUDE.md 작성.
최종 커밋 (필요시)
git add .
git commit -m "{타입}: {전체 작업 요약}"
예시
입력
/task 태그 필터링 기능 추가
실행 흐름
1. 분석
- 타입: feat (새 기능)
- 브랜치: feat/tag-filter
- 영향: src/shared/types/, src/popup/components/
- 스킬: developer → frontend
2. 구현
- /developer: 필터 로직, 타입 정의
- 커밋: "feat: add tag filter logic"
- /frontend: TagFilter.tsx 컴포넌트
- 커밋: "feat: implement TagFilter component"
3. 리뷰
- /reviewer 실행
- [Minor] 변수명 개선 제안
- 선택적 수정
4. 마무리
- /verify: 빌드/린트/테스트 통과
- 완료
주의사항
- 커밋 마킹 금지: Co-Author, Claude 마킹 절대 금지
- 브랜치 보호: main 직접 커밋 금지, 브랜치에서 작업
- 빌드 확인: 커밋 전 반드시 빌드 성공 확인
- 작은 단위: 큰 작업은 여러 브랜치로 분할 고려
