| name | team-assemble |
| description | This skill should be used when the user asks to "팀 구성해줘", "team assemble", "전문가 팀으로 해줘", "팀으로 해줘", "swarm", "병렬로 전문가 팀", or wants to decompose a complex task into specialist roles executed via TeamCreate. Also triggers when user describes a task clearly benefiting from parallel expert execution. |
Team Assemble
작업을 분석하여 전문가 팀을 동적으로 구성하고 TeamCreate 기반으로 즉시 실행하는 스킬.
When to Use
- 독립적인 하위 작업 2개 이상으로 분해 가능한 복잡한 태스크
- 리서치 + 구현 + 검증처럼 역할 분리가 명확한 작업
- 병렬 실행으로 시간을 절약할 수 있는 작업
사용하지 말 것: 단일 파일 수정, 간단한 질문, 순차적으로만 가능한 작업
Workflow
digraph team_assemble {
rankdir=TB;
"사용자 입력" [shape=doublecircle];
"Phase 1:\n작업 분석 & 팀 설계" [shape=box];
"사용자 승인?" [shape=diamond];
"Phase 2:\nTeamCreate & TaskCreate" [shape=box];
"Phase 3:\nTeammate 실행" [shape=box];
"Phase 4:\n결과 종합 & 정리" [shape=box];
"완료" [shape=doublecircle];
"사용자 입력" -> "Phase 1:\n작업 분석 & 팀 설계";
"Phase 1:\n작업 분석 & 팀 설계" -> "사용자 승인?";
"사용자 승인?" -> "Phase 1:\n작업 분석 & 팀 설계" [label="수정"];
"사용자 승인?" -> "Phase 2:\nTeamCreate & TaskCreate" [label="승인"];
"Phase 2:\nTeamCreate & TaskCreate" -> "Phase 3:\nTeammate 실행";
"Phase 3:\nTeammate 실행" -> "Phase 4:\n결과 종합 & 정리";
"Phase 4:\n결과 종합 & 정리" -> "완료";
}
Phase 1: 작업 분석 & 팀 설계
작업을 분석하여 다음을 결정:
- 역할 분해 — 독립적인 하위 작업으로 분해하고 전문가 역할 부여
- 모델 선택 — 역할별 최적 모델 배정
- 의존성 그래프 — 선행 관계 결정
역할-모델 매핑
| 역할 유형 | 모델 | 예시 |
|---|
| 기획/설계/의사결정 | opus | architect, planner, lead |
| 분석/리서치/복잡한 판단 | opus | analyzer, researcher, code-reviewer |
| 구현/실행/수집 | sonnet | implementer, collector, writer |
| 검증/정리/포맷팅 | sonnet | validator, formatter, tester |
경계 역할 판단: "새로운 판단을 내려야 하는가?" → opus. "주어진 기준대로 실행하는가?" → sonnet.
팀 구성 제안
AskUserQuestion으로 반드시 승인을 받은 후 진행:
팀 구성 제안: {team-name}
| # | 역할 | 모델 | 담당 작업 | 의존성 |
|---|------|------|----------|--------|
| 1 | role-name | opus | 작업 설명 | - |
| 2 | role-name | sonnet | 작업 설명 | #1 |
Options: "좋아요, 실행해주세요" / "역할 수정이 필요해요"
"역할 수정" 선택 시 구체적으로 뭘 바꿀지 질문. 2회 이상 수정 요청 시 자유 텍스트 입력으로 전환.
Phase 2: 팀 생성 & 태스크 분배
승인 후 순서대로 실행:
TeamCreate(team_name: "{keyword}-team", description: "작업 설명")
team_name 규칙: 작업 핵심 키워드 + -team (예: migration-team, research-team)
각 역할별 TaskCreate 호출 후 TaskUpdate로 blockedBy 의존성 설정:
TaskCreate(subject: "#1 {역할}: {작업 요약}", description: "상세 설명", activeForm: "{작업} 진행 중")
TaskUpdate(taskId: "2", addBlockedBy: ["1"])
Phase 3: Teammate 실행
핵심 메커니즘: Task 도구는 foreground(기본)에서 blocking — teammate가 끝날 때까지 대기하고 결과 텍스트를 반환. 이 반환값이 teammate의 작업 결과.
병렬 실행
blockedBy가 없는 태스크들을 단일 메시지에서 동시에 Task 호출:
Task(name: "analyst", team_name: "...", subagent_type: "general-purpose", model: "opus", prompt: "...", mode: "bypassPermissions")
Task(name: "collector", team_name: "...", subagent_type: "general-purpose", model: "sonnet", prompt: "...", mode: "bypassPermissions")
// 두 Task 완료 후 각각의 결과 텍스트 수신
순차 실행 (의존성)
선행 Task의 반환값을 다음 teammate 프롬프트에 삽입:
Task(name: "writer", prompt: "선행 작업 결과:\n{result_1}\n\n이 결과를 바탕으로...")
Teammate 프롬프트 필수 요소
- 맥락 — 전체 프로젝트와 이 작업의 관계
- 구체적 목표 — 정확히 무엇을 달성해야 하는지
- 제약조건 — 하지 말아야 할 것, 변경 범위 제한
- 출력 형식 — 결과물 형태 (텍스트/파일/테이블)
- 팀 정보 — team_name, task ID → TaskUpdate 완료 표시 지시
상세 프롬프트 템플릿은 references/prompt-templates.md 참조.
Phase 4: 결과 종합 & 정리
결과 수집
모든 teammate 결과를 종합하여 사용자에게 보고:
## 팀 실행 결과: {team-name}
### 1. {역할}: {작업} → {결과 요약}
### 최종 산출물
- {파일 경로 또는 결과물 목록}
팀 정리
foreground Task 완료 후 teammate는 idle 상태. 정리 순서:
SendMessage(type: "shutdown_request", recipient: "{name}", content: "작업 완료")
TeamDelete() // 모든 teammate 종료 확인 후
shutdown_request에 응답 없으면 이미 종료된 것 — 무시하고 TeamDelete 진행.
Common Mistakes
| 실수 | 올바른 방법 |
|---|
| 사용자 승인 없이 팀 생성 | Phase 1에서 반드시 AskUserQuestion으로 승인 |
| 모든 작업을 순차 실행 | 독립 작업은 단일 메시지에서 병렬 Task 호출 |
| teammate 프롬프트가 모호 | 맥락 + 목표 + 제약 + 출력형식 필수 포함 |
| TeamDelete 누락 | 반드시 shutdown_request → TeamDelete 순서로 정리 |
| 모든 역할에 opus 사용 | 실행/수집 역할은 sonnet으로 비용 절약 |
Quick Reference
Phase 1: 분석 → AskUserQuestion (팀 구성 승인)
Phase 2: TeamCreate → TaskCreate × N → TaskUpdate (의존성)
Phase 3: Task × N (병렬) → 결과 전달 → Task × N (후속)
Phase 4: 결과 종합 → shutdown_request × N → TeamDelete
Additional Resources
Reference Files
references/examples.md — DB 마이그레이션, 경쟁사 분석, 풀스택 구현 등 3개 worked example (전체 Phase 1~3 흐름)references/prompt-templates.md — 역할별 teammate 프롬프트 템플릿 (analyst, implementer, validator) 및 작성 팁
