Optimization task-generator

PRD 문서를 세부 실행 가능한 Task 목록으로 분해한다. 각 Task는 독립적으로 실행 가능하고 검증 가능해야 한다.

install

source · Clone the upstream repo

git clone https://github.com/sunLeee/optimization

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/sunLeee/optimization "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.claude/skills/process/task-generator" ~/.claude/skills/sunleee-optimization-task-generator && rm -rf "$T"

manifest: .claude/skills/process/task-generator/SKILL.md

source content

Task Generator Skill

PRD 문서를 세부 실행 가능한 Task 목록으로 분해한다. 각 Task는 독립적으로 실행 가능하고 검증 가능해야 한다.

목적

PRD 실행화: 추상적인 요구사항을 구체적인 실행 단계로 변환
작업 추적: 체크박스 기반 진행 상황 관리
의존성 관리: Task 간 선후 관계 명시
검증 가능성: 각 Task의 완료 조건을 명확히 정의

Prerequisites

이 스킬은 복잡한 reasoning이 필요하므로:

모델: Opus (claude-opus-4-5-20251101)
extended thinking 활성화 권장

사용 시점

사용자가 다음과 같은 요청을 할 때 이 스킬을 사용한다:

"task 생성해줘", "task 목록 만들어줘"
"PRD를 task로 분해해줘"
"@tasks/user-auth-prd.md로 task 생성해줘"
3-step-workflow의 Step 2 진행 시

워크플로우

1. PRD 파일 로드

```
tasks/{feature}-prd.md
```
읽기

2. High-Level 계획 제안

주요 Task 목록 제시
사용자 승인 대기

3. 세부 Task 생성

Sub-task 분해
관련 파일 목록
각 Task별 완료 기준 자동 생성 (NEW)

4. 완료 기준 검증

모든 Task에 완료 기준 존재 확인
검증 명령어 유효성 확인
```
tasks/tasks-{feature-name}.md
```
저장

입력

PRD 파일: tasks/{feature}-prd.md

Task 분해 원칙

1. Granularity (세분화)

각 Sub-task는 15-30분 내 완료 가능해야 한다. 너무 크면 검증이 어렵고, 너무 작으면 오버헤드가 증가한다.

2. Independence (독립성)

각 Sub-task는 독립적으로 실행 가능해야 한다. 순서 의존성이 있는 경우 명시한다.

3. Verifiability (검증 가능성)

각 Sub-task 완료 조건이 명확해야 한다. "완료"의 정의가 모호하면 안 된다.

4. Testability (테스트 가능성)

구현 task에는 대응하는 테스트 task를 포함한다. 코드와 테스트는 쌍으로 관리한다.

Task 목록 템플릿

상세 템플릿: [@templates/skill-examples/task-generator/task-template.md]

핵심 내용:

Relevant Files: 관련 파일 목록 (신규/수정 상태 표시)
Tasks: Major Task → Sub-task 계층 구조
Progress Summary: 진행률 테이블 자동 생성

실행 지침

Step 1: High-Level 계획 제안

PRD를 분석한 후, 먼저 상위 Task 목록만 제시하고 승인을 요청한다.

PRD를 분석했습니다. 다음과 같은 구조로 Task를 생성하겠습니다:

**Task 1**: 데이터 모델 정의 (Prisma Schema)
**Task 2**: API 엔드포인트 구현
**Task 3**: 프론트엔드 컴포넌트
**Task 4**: 테스트 및 문서화

이 구조로 진행할까요? (y/n)
수정이 필요하면 말씀해주세요.

Step 2: 사용자 승인 후 세부 분해

승인을 받은 후에만 Sub-task 목록을 생성한다.

Step 3: Relevant Files 섹션 생성

기존 코드베이스를 분석하여 관련 파일 식별
새로 생성할 파일 목록 포함
테스트 파일은 항상 포함

명명 규칙 참조: [@templates/skill-examples/task-generator/task-template.md]

완료 기준 자동 생성

상세 가이드: [@templates/skill-examples/task-generator/completion-criteria-guide.md] 지표 카탈로그: [@templates/skill-examples/task-generator/metrics-catalog.md]

핵심 원칙:

모든 완료 기준은 정량적으로 측정 가능해야 함
Task 유형별 자동 생성 (Python, API, Notebook, DB, ML, 문서)
프로젝트별 임계값 커스터마이징 지원

DO (해야 할 것)

PRD의 모든 요구사항 커버: Functional Requirements → Task 매핑
테스트 Task 포함: 구현 Task에 대응하는 테스트 Task 필수
의존성 명시: Sub-task 간 의존 관계 명확화
완료 조건 명확화: 각 Sub-task의 "완료" 정의 (자동 생성 활용)

DON'T (하지 말 것)

너무 큰 Task: 1시간 이상 걸리는 Sub-task는 더 분해
모호한 Task: "개선하기", "최적화하기" 같은 모호한 표현 금지
테스트 누락: 모든 구현 Task에 테스트 Task 대응
완료 기준 누락: 모든 Task에 구체적인 완료 기준 필수 (자동 생성 활용)

출력 위치

tasks/tasks-{feature-name}.md

예시:

```
tasks/tasks-user-profile-card.md
```
```
tasks/tasks-email-notification.md
```

디렉토리 자동 생성: tasks/ 디렉토리가 없으면 자동 생성

AskUserQuestion 활용 지점

지점 1: High-Level 계획 승인 (필수)

타이밍: PRD 분석 직후, 세부 Task 생성 전

질문 예시:

questions:
  - question: "다음 구조로 Task를 생성할까요?"
    header: "계획 승인"
    multiSelect: false
    options:
      - label: "승인 - 이대로 진행 (권장)"
        description: "제안된 구조로 세부 Task를 생성합니다"
      - label: "수정 필요"
        description: "구조를 수정한 후 다시 제안받습니다"
      - label: "Task 추가"
        description: "추가 Task를 제안합니다"

지점 2: 테스트 전략 선택 (권장)

타이밍: Task 분해 중