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: 마무리
        ├─ 최종 커밋
        ├─ docs/TASK.md 업데이트
        └─ (선택) PR 생성 안내

Phase 1: 분석

작업 타입 판별

브랜치 생성

# 예시: feat/guest-mode
git checkout -b {타입}/{kebab-case-설명}

분석 체크리스트

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

Phase 2: 구현

스킬 호출 순서

1. 데이터/로직 먼저: /developer 스킬 적용

   • Repository, 서비스, 유틸리티
   • 타입 정의, 인터페이스

2. UI/컴포넌트: /frontend 스킬 적용

   • Provider, Context
   • 페이지, 컴포넌트
   • Server Actions

기능 단위 커밋

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

git add <관련 파일들>
git commit -m "{타입}: {설명}"

커밋 메시지 규칙 (Conventional Commits):

feat: 게스트 모드 guestId 관리 함수 추가
feat: 프로젝트 로컬 저장소 구현
feat: AuthProvider 구현
fix: isGuestProject 버그 수정
refactor: 코드 정리

커밋 단위 기준:

• 하나의 논리적 변경 = 하나의 커밋
• 롤백 시 독립적으로 되돌릴 수 있는 단위
• 너무 작지 않게 (파일 하나씩 X)
• 너무 크지 않게 (전체 기능 한 번에 X)

Phase 3: 리뷰

/reviewer 스킬 적용

구현 완료 후 자동으로 리뷰 수행:

수정 루프

리뷰 → 이슈 발견 → 수정 (developer/frontend) → 재리뷰

이슈가 없거나 Minor만 남으면 Phase 4로 진행.

Phase 4: 마무리

최종 점검

pnpm build          # 빌드 확인
pnpm lint           # 린트 확인
pnpm test:run       # 테스트 확인 (있으면)

문서 업데이트

docs/TASK.md 체크리스트 업데이트:

• 완료된 항목 [x] 표시
• 진행률 갱신

최종 커밋 (필요시)

git add .
git commit -m "{타입}: {전체 작업 요약}"

PR 안내 (선택)

# 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"

주의사항

• 커밋 마킹 금지: Co-Author, Claude 마킹 절대 금지
• git -C 금지: git -C 명령어 사용 금지, 항상 working directory에서 직접 실행
• 브랜치 보호: main 직접 커밋 금지, 브랜치에서 작업
• 빌드 확인: 커밋 전 반드시 빌드 성공 확인
• 작은 단위: 큰 작업은 여러 브랜치로 분할 고려