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-설명}
# 예: feat/tag-filter, fix/search-bug

분석 체크리스트

[ ] 요구사항 명확히 이해
[ ] 영향받는 파일/모듈 식별
[ ] 필요한 스킬 결정 (developer, frontend, 둘 다)
[ ] 작업 단위 분할 (커밋 단위)

Phase 2: 구현

스킬 호출 순서

데이터/로직 먼저: /developer 스킬 적용
- 타입 정의, 인터페이스
- Storage 유틸리티
- 비즈니스 로직
UI/컴포넌트: /frontend 스킬 적용
- React 컴포넌트
- 커스텀 훅
- 스타일링

기능 단위 커밋

구현 중 의미 있는 단위마다 커밋:

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 직접 커밋 금지, 브랜치에서 작업
빌드 확인: 커밋 전 반드시 빌드 성공 확인
작은 단위: 큰 작업은 여러 브랜치로 분할 고려