Community연구 & 데이터 분석github.com

sametcelikbicak/task-decomposer

개발자가 복잡한 요청을 AI 친화적인 구조화된 작업 시퀀스로 분해할 수 있도록 도와주는 AI 에이전트 스킬입니다. 컨텍스트 윈도우 사용을 최적화하고, 멀티 세션 워크플로우를 관리하며, 더 적고 집중된 프롬프트로 더 나은 결과를 생성합니다. opencode, Claude Code, Cursor, Windsurf, GitHub Copilot과 호환됩니다.

task-decomposer란 무엇인가요?

이 스킬은 복잡한 소프트웨어 개발 요청을 구조화된 AI 프롬프트 시퀀스로 분해하여 에이전트 기반 코딩 도구의 효과를 극대화합니다. '목표 명확화 → 의존성 매핑 → 원자적 프롬프트 분할 → 컨텍스트 예산 계획 → 실행 순서'라는 5단계 프레임워크를 통해 사용자가 더 적고 집중된 상호작용으로 더 나은 결과를 얻을 수 있도록 돕습니다. 주요 문제는 컨텍스트 오버플로우와 모호한 프롬프트로 인해 AI가 얕은 결과를 생성하거나 작업을 잊어버리는 것입니다. 이 스킬은 각 프롬프트를 원자적이며, 독립적이고, 검증 가능하고, 컨텍스트 윈도우에 적합하게 만들어 이 문제를 해결합니다. 또한 `CONTEXT.md` 파일을 사용한 세션 간 핸드오프 메커니즘을 지원하며, 매 마일스톤마다 완료된 작업, 결정 사항, 다음 세션에 필요한 정보를 기록하여 여러 세션에 걸친 워크플로우에서도 일관성을 유지합니다. opencode, Claude Code, Cursor, Windsurf, GitHub Copilot과 같은 주요 AI 코딩 도구와 호환되며, 특정 에이전트와 독립적인 SKILL.md 형식으로 제공됩니다.

지원 대상✓Claude Code~Codex CLI✓Cursor✓OpenCode✓Windsurf
npx skills add sametcelikbicak/task-decomposer

Installed? Explore more 연구 & 데이터 분석 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Task Decomposer

복잡한 요청을 구조화된 AI 친화적 작업 시퀀스로 분해하는 방법을 안내합니다. 컨텍스트 윈도우 효율성, 명확한 의존성 순서, 측정 가능한 진행 상황을 최적화하여 사용자가 더 적고 집중된 상호작용으로 더 나은 결과를 얻을 수 있도록 돕습니다.

철학

대부분의 AI 사용 좌절은 하나의 근본 원인에서 비롯됩니다: 한 번에 너무 많은 것을 요청하는 것. 단일 모호한 프롬프트는 얕은 결과를 낳습니다. 작업 분해는 이를 역전시킵니다. 사용자(그리고 어시스턴트)가 원자적이고 의존성 순서가 있는 단위로 생각하도록 안내합니다.

모델: 계획 → 분할 → 프롬프트 → 검증 → 다음


사용자 대상 프레임워크

사용자가 크거나 모호한 것을 요청하면, 이 분해 프레임워크를 따라 안내하세요.

1단계: 목표 명확화

사용자에게 명확한 질문을 던져 진정한 목표를 정의하세요.

  • "이 작업이 완료되었을 때 당신이 원하는 단일 결과는 무엇인가요?"
  • "중요한 제약 조건은 무엇인가요? (마감일, 기술 스택, 표준)"
  • "성공은 어떤 모습인가요? 어떻게 검증할 건가요?"
  • "당신이 하지 않으려는 것은 무엇인가요? (반대 목표)"

결과물: 한 문단 분량의 목표 진술문. 3문장 이상이면 계속 다듬으세요.

2단계: 의존성 맵

사용자가 작업의 자연스러운 순서를 파악하도록 도우세요.

레벨 1 — 기반      (설정, 구성, 데이터 모델)
레벨 2 — 핵심 로직 (비즈니스 로직, API, 주요 기능)
레벨 3 — 다듬기    (UI, 오류 처리, 엣지 케이스)
레벨 4 — 검증      (테스트, 리뷰, 배포)

질문: "다음 단계가 시작되기 전에 반드시 존재해야 하는 것은 무엇인가요?"

결과물: 의존성이 표시된 3~7개 단계의 번호 목록.

3단계: 원자적 프롬프트로 분할

사용자가 AI에게 제공할 각 프롬프트는 다음과 같아야 합니다.

속성설명
원자적하나의 논리적 변경 — 하나의 파일, 하나의 관심사
독립적이전 기록 없이도 실행할 수 있는 충분한 컨텍스트 포함
검증 가능명확한 승인/거부 기준
윈도우 적합컨텍스트 윈도우에 무리 없이 맞음 (명령어 약 40K 토큰 미만)

각 분할 조각의 템플릿:

## 작업: [짧은 이름]
## 컨텍스트
[2~3문장: 무엇이 존재하고, 무엇이 없으며, 관련 파일은 무엇인지]
## 요구 사항
- [AI가 해야 할 일의 목록]
- [생성/수정할 특정 파일]
## 승인 기준
- [이 작업이 올바르게 완료되었는지 확인하는 방법]
## 제약 조건
- [따라야 할 패턴, 피해야 할 사항]

결과물: 사용자가 한 번에 하나씩 붙여넣을 수 있는 3~7개의 프롬프트 카드.

4단계: 컨텍스트 예산 계획

컨텍스트 윈도우 한계에 대해 사용자에게 경고하고 그에 따라 계획을 수립하세요.

  • 세션 1 (기반 + 핵심): 약 3개 프롬프트, 새로 시작
  • 세션 2 (다듬기 + 검증): 약 3개 프롬프트, 새로 시작
  • 세션 간 핸드오프: 각 세션을 CONTEXT.md 요약으로 마무리

각 마일스톤에서 CONTEXT.md를 생성하세요.

# 컨텍스트 핸드오프 — [마일스톤 이름]

## 완료된 작업
- [x] 완료 항목 1 — /path/to/file
- [x] 완료 항목 2 — /path/to/file

## 결정 사항
- 이유 Z로 인해 X 대신 Y 선택
- API 반환 형태: { ... }

## 다음 세션
- 의존성을 포함한 나머지 작업
- 다음 에이전트가 먼저 읽어야 할 파일

## 상태
- 브랜치: feature/xyz
- 적용된 마이그레이션: 3
- 추가된 환경 변수: DATABASE_URL, API_KEY

5단계: 실행 순서

최종 계획을 사용자에게 제시하세요.

## 실행 계획

1단계 — 기반 (세션 1)
  프롬프트 1: 프로젝트 스캐폴딩 및 구성 설정
  프롬프트 2: 데이터베이스 스키마 및 모델 생성
  프롬프트 3: 인증 미들웨어 구현
  └─ 검증: `npm run dev` 실행, 로그인 페이지 로드 확인

2단계 — 핵심 로직 (세션 1 계속)
  프롬프트 4: 사용자 CRUD API 구축
  프롬프트 5: 비즈니스 로직 서비스 구현
  └─ 검증: 테스트 실행, API 응답 확인

3단계 — 다듬기 (세션 2)
  프롬프트 6: 오류 처리 및 유효성 검사 추가
  프롬프트 7: UI 컴포넌트 스타일링
  └─ 검증: 수동 QA 흐름

4단계 — 검증 (세션 2 계속)
  프롬프트 8: 누락된 테스트 작성
  └─ 검증: 커버리지 >= 80%, 모든 테스트 통과

어시스턴트 동작

사용자가 큰 작업을 요청할 때

  1. 즉시 구현을 시작하지 마세요
  2. 대신, 목표 명확화 질문(1단계)으로 응답하세요
  3. 목표가 명확해지면 확인을 위해 의존성 맵을 제시하세요
  4. 사용자가 승인하면 프롬프트 카드가 포함된 실행 계획을 생성하세요
  5. 즉시 프롬프트 1을 실행하거나 사용자가 직접 진행하도록 선택권을 주세요

컨텍스트가 가득 찰 때

대화 크기를 모니터링하세요. 컨텍스트 한도에 근접하면:

  1. 결정 사항과 상태를 CONTEXT.md로 요약하세요
  2. 사용자에게 새 세션을 시작하라고 조언하세요
  3. 새 세션의 첫 번째 프롬프트에 CONTEXT.md를 포함시키라고 알리세요

사용자가 프롬프트 작성 방법을 모를 때

템플릿을 제공하세요.

"[파일/영역]에 [작업]을 해야 합니다.
구체적으로:
- [요구 사항 1]
- [요구 사항 2]
하지 말아야 할 것: [피해야 할 사항]
검증 방법: [기준]"

피해야 할 안티 패턴

안티 패턴실패 이유대신 이렇게
"전체 앱을 만들어 줘"컨텍스트 오버플로우, 모든 부분이 얕아짐5~10개의 원자적 프롬프트로 분해
세션 중간 컨텍스트 전환이전 컨텍스트가 토큰 낭비프롬프트 완료 → CONTEXT.md → 새 세션
승인 기준 없음AI가 일찍 멈추거나 과도하게 엔지니어링프롬프트당 1~3개의 구체적인 검사 항목 작성
암시적 의존성AI가 잘못된 가정을 함"Y 전에 X가 반드시 존재해야 함"을 명시적으로 명시
모호한 성공 기준완료 시점을 알 수 없음"POST /users 시 API가 200과 함께 { id }를 반환"

예시

예시 1: 풀스택 기능 계획

사용자: "결제 페이지를 추가해야 해요"

에이전트 응답이 프레임워크를 사용:

  1. 목표 명확화: "어떤 결제 제공업체를 사용하나요? 단일 상품인가요, 가변 금액인가요? 결제 수단을 저장하나요? 준수해야 할 규정이 있나요?"
  2. 의존성 맵: Stripe 설정 → 체크아웃 API → 결제 양식 UI → 성공/실패 페이지 → 테스트
  3. 프롬프트 카드:
    • 프롬프트 1: "Stripe SDK 설정, /api/create-payment-intent 엔드포인트 생성"
    • 프롬프트 2: "Stripe Elements를 사용한 React 체크아웃 양식 구축"
    • 프롬프트 3: "오류 처리를 포함한 결제 성공/실패 페이지 추가"
    • 프롬프트 4: "결제 흐름 엣지 케이스에 대한 테스트 작성"
  4. 컨텍스트 예산: 세션 1 (프롬프트 12), 세션 2 (프롬프트 34)

예시 2: 컨텍스트 복구

사용자가 새 세션을 시작: "지난번에 결제 페이지 작업을 하고 있었어요"

에이전트: "프로젝트 루트에 CONTEXT.md 파일이 있는지 확인해볼게요..."

파일이 있으면: 읽고 중단했던 부분부터 계속 진행. 파일이 없으면: "마지막으로 작동했던 것은 무엇인가요? 주요 결정 사항을 기억하시나요?"라고 질문.

예시 3: 막힌 사용자 구출

사용자: "내 프롬프트가 무시당하고 있어요. AI가 계속 주제에서 벗어나요"

에이전트: "프롬프트가 너무 광범위할 수 있습니다. 재구성하는 것을 도와드릴게요. 무엇을 달성하려고 하시나요?"

1~3단계를 진행하고 집중된 단일 프롬프트 카드를 생성하세요.


참고: 어떤 접근 방식을 사용해야 할 때

사용자 말접근 방식
"로그인 페이지 추가해 줘"작음 → 그냥 실행 (분해 불필요)
"이커머스 사이트를 구축해 줘"큼 → 전체 프레임워크 사용
"우리가 한 걸 계속 까먹어요"컨텍스트 가득 참 → CONTEXT.md 핸드오프 생성
"어디서부터 시작해야 할지 모르겠어요"모호함 → 먼저 목표 명확화
"이 PR이 있는데, 테스트를 작성해 줘"구체적 → 그냥 실행, 분해 불필요
"내 프롬프트가 너무 길고 AI가 일부를 무시해요"비대함 → 원자적 프롬프트로 분할

관련 스킬