team-assemble

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Team Assemble

Team Assemble技能

작업을 분석하여 전문가 팀을 동적으로 구성하고 TeamCreate 기반으로 즉시 실행하는 스킬.

该Skill可分析任务并动态组建专家团队，基于TeamCreate立即执行任务。

When to Use

使用场景

독립적인 하위 작업 2개 이상으로 분해 가능한 복잡한 태스크
리서치 + 구현 + 검증처럼 역할 분리가 명확한 작업
병렬 실행으로 시간을 절약할 수 있는 작업

사용하지 말 것: 단일 파일 수정, 간단한 질문, 순차적으로만 가능한 작업

可分解为2个以上独立子任务的复杂任务
像研究+实现+验证这样角色分工明确的任务
可通过并行执行节省时间的任务

请勿使用场景: 单一文件修改、简单问题、仅能按顺序执行的任务

Workflow

工作流

dot

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결과 종합 & 정리" -> "완료";
}

dot

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: 작업 분석 & 팀 설계

Phase 1: 任务分析 & 团队设计

작업을 분석하여 다음을 결정:

역할 분해 — 독립적인 하위 작업으로 분해하고 전문가 역할 부여
모델 선택 — 역할별 최적 모델 배정
의존성 그래프 — 선행 관계 결정

分析任务并确定以下内容:

角色分解 — 将任务分解为独立子任务并分配专业角色
模型选择 — 为各角色分配最优模型
依赖关系图 — 确定任务的先后关系

역할-모델 매핑

角色-模型映射

역할 유형	모델	예시
기획/설계/의사결정	opus	architect, planner, lead
분석/리서치/복잡한 판단	opus	analyzer, researcher, code-reviewer
구현/실행/수집	sonnet	implementer, collector, writer
검증/정리/포맷팅	sonnet	validator, formatter, tester

경계 역할 판단: "새로운 판단을 내려야 하는가?" → opus. "주어진 기준대로 실행하는가?" → sonnet.

角色类型	模型	示例
规划/设计/决策	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회 이상 수정 요청 시 자유 텍스트 입력으로 전환.

必须通过AskUserQuestion获得用户批准后再推进:

团队组建提案: {team-name}

| # | 角色 | 模型 | 负责任务 | 依赖关系 |
|---|------|------|----------|--------|
| 1 | role-name | opus | 任务说明 | - |
| 2 | role-name | sonnet | 任务说明 | #1 |

选项: "好的，执行吧" / "需要修改角色"

若选择“修改角色”，需询问具体修改内容。若用户请求修改2次以上，则切换为自由文本输入模式。

Phase 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"])

获得批准后按顺序执行:

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 실행

Phase 3: Teammate执行

핵심 메커니즘: Task 도구는 foreground(기본)에서 blocking — teammate가 끝날 때까지 대기하고 결과 텍스트를 반환. 이 반환값이 teammate의 작업 결과.

核心机制: Task工具在前台(默认)为阻塞式 — 等待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 완료 후 각각의 결과 텍스트 수신

对无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이 결과를 바탕으로...")

将前置Task的返回值插入到后续teammate的prompt中:

Task(name: "writer", prompt: "前置任务结果:\n{result_1}\n\n基于此结果...")

Teammate 프롬프트 필수 요소

Teammate prompt必备要素

맥락 — 전체 프로젝트와 이 작업의 관계
구체적 목표 — 정확히 무엇을 달성해야 하는지
제약조건 — 하지 말아야 할 것, 변경 범위 제한
출력 형식 — 결과물 형태 (텍스트/파일/테이블)
팀 정보 — team_name, task ID → TaskUpdate 완료 표시 지시

상세 프롬프트 템플릿은 references/prompt-templates.md
참조.

上下文 — 整体项目与当前任务的关系
具体目标 — 明确需要达成的内容
约束条件 — 禁止操作、修改范围限制
输出格式 — 结果的呈现形式(文本/文件/表格)
团队信息 — team_name、task ID → 指示完成TaskUpdate标记

详细prompt模板请参考 references/prompt-templates.md
.

Phase 4: 결과 종합 & 정리

Phase 4: 结果汇总 & 整理

결과 수집

结果收集

모든 teammate 결과를 종합하여 사용자에게 보고:

undefined

汇总所有teammate的结果并向用户汇报:

undefined

팀 실행 결과: {team-name}

团队执行结果: {team-name}

1. {역할}: {작업} → {결과 요약}

1. {角色}: {任务} → {结果摘要}

최종 산출물

最终产出

{파일 경로 또는 결과물 목록}

undefined

{文件路径或结果列表}

undefined

팀 정리

团队整理

foreground Task 완료 후 teammate는 idle 상태. 정리 순서:

SendMessage(type: "shutdown_request", recipient: "{name}", content: "작업 완료")
TeamDelete()  // 모든 teammate 종료 확인 후

shutdown_request에 응답 없으면 이미 종료된 것 — 무시하고 TeamDelete 진행.

前台Task完成后，teammate将处于idle状态。整理顺序:

SendMessage(type: "shutdown_request", recipient: "{name}", content: "任务完成")
TeamDelete()  // 确认所有teammate结束后执行

若shutdown_request未收到响应，则说明teammate已结束 — 可忽略并继续执行TeamDelete。

Common Mistakes

常见错误

실수	올바른 방법
사용자 승인 없이 팀 생성	Phase 1에서 반드시 AskUserQuestion으로 승인
모든 작업을 순차 실행	독립 작업은 단일 메시지에서 병렬 Task 호출
teammate 프롬프트가 모호	맥락 + 목표 + 제약 + 출력형식 필수 포함
TeamDelete 누락	반드시 shutdown_request → TeamDelete 순서로 정리
모든 역할에 opus 사용	실행/수집 역할은 sonnet으로 비용 절약

错误	正确做法
未获用户批准就创建团队	在Phase 1中必须通过AskUserQuestion获得批准
所有任务都按顺序执行	独立任务需在单条消息中并行调用Task
teammate prompt模糊不清	必须包含上下文+目标+约束+输出格式
遗漏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

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) 및 작성 팁

references/examples.md
— 包含数据库迁移、竞品分析、全栈实现等3个完整示例（覆盖Phase 1~3全流程）
references/prompt-templates.md
— 各角色的teammate prompt模板（analyst, implementer, validator）及编写技巧