teams

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Teams — Agent Teams 자동 구성 및 실행

Teams — Agent Teams自动构建与执行

Overview

概述

사용자가 제시한 문제를 분석하여 적절한 Agent Teams를 자동으로 구성하고, 4가지 조율 패턴 중 최적 패턴을 선택하여 결과를 도출하는 편의 스킬이다. 단순 문제는 Agent Teams 없이 직접 해결하고, 복합 문제만 팀을 구성한다.

这是一项便捷技能，可分析用户提出的问题并自动构建合适的Agent Teams，从4种协调模式中选择最优模式来得出结果。简单问题无需Agent Teams直接解决，仅为复杂问题组建团队。

When to Use

使用场景

사용자가
```
/teams {문제 설명}
```
을 입력했을 때
```
/teams --pattern {패턴} {문제 설명}
```
으로 조율 패턴을 지정할 수도 있다
멀티 관점 분석, 대규모 구현, 설계 의사결정 등 여러 전문가의 협업이 필요한 문제에 적합

当用户输入"/teams {问题描述}"时
也可通过"/teams --pattern {模式} {问题描述}"指定协调模式
适用于需要多专家协作的问题，如多视角分析、大规模实现、设计决策等

Prerequisites

前置条件

특별한 전제조건 없음
코드 관련 작업 시 해당 프로젝트의 소스 코드 접근 가능 상태

无特殊前置条件
处理代码相关任务时，需处于可访问对应项目源代码的状态

Error Handling

错误处理

팀 생성 실패 (TeamCreate 에러): 메인 세션에서 단독으로 문제를 해결한다. "Agent Teams 구성에 실패하여 단독으로 처리합니다" 안내
Lead 생성 실패: 팀 생성 실패와 동일하게 단독 처리
Teammate 무응답 (10분 이상): 해당 역할을 제외하고 나머지 결과로 진행, 결과에 제외된 역할 명시
Lead 무응답: 메인 세션에서 단독으로 처리하며 fallback 사유 안내

团队创建失败（TeamCreate错误）：在主会话中单独解决问题。提示"Agent Teams构建失败，将单独处理该问题"
Lead创建失败：与团队创建失败相同，单独处理
Teammate无响应（超过10分钟）：排除该角色，基于剩余成员的结果继续推进，并在结果中注明被排除的角色
Lead无响应：在主会话中单独处理，并提示回退原因

Instructions

操作步骤

1단계: 문제 분석 및 복잡도 판정

步骤1：问题分析与复杂度判定

사용자가 제시한 문제를 분석하여 복잡도를 판정한다.

단순 (Agent Teams 불필요) — 다음 조건을 모두 만족:

단일 관점으로 충분 (교차 검증 불필요)
변경/분석 범위가 1~2개 파일 이내
명확한 정답이 존재 (설계 트레이드오프 없음)

→ 메인 세션에서 직접 해결하고 결과를 출력한다. 이하 단계를 건너뛴다.

복합 (Agent Teams 필요) — 위 조건 중 하나라도 불충족:

다관점 분석/교차 검증이 유의미
넓은 범위 또는 병렬 작업 가능
트레이드오프가 존재하여 토론이 가치 있음

→ 2단계로 진행한다.

分析用户提出的问题并判定复杂度。

简单（无需Agent Teams） — 需全部满足以下条件：

单一视角即可解决（无需交叉验证）
修改/分析范围在1~2个文件以内
存在明确答案（无设计权衡）

→ 在主会话中直接解决并输出结果。跳过后续步骤。

复杂（需要Agent Teams） — 不满足上述任一条件：

多视角分析/交叉验证有意义
范围较广或可并行处理
存在权衡，讨论具有价值

→ 进入步骤2。

2단계: 조율 패턴 결정

步骤2：协调模式确定

--pattern

옵션이 지정되면 해당 패턴을 사용한다. 미지정 시 문제 유형에서 자동 추론한다.

若指定了

--pattern

选项，则使用该模式。未指定时，根据问题类型自动推断。

4가지 조율 패턴

4种协调模式

이 패턴은 BF Workflow의 Lead 스킬들과 공유한다. Canonical definition: CLAUDE.md — 조율 패턴

패턴	핵심 동작	적합한 문제 유형	BF Lead
distribute	Lead가 작업을 분배 → 각 agent가 독립 수행 → Lead가 취합	병렬 구현, 대규모 리서치, 문서 생성	bf-lead-plan
monitor	Lead가 agent를 스폰하고 진행 상황 모니터링 + 에스컬레이션 처리	TDD 구현, 장시간 작업, 단계적 빌드	bf-lead-implement
discourse	독립 분석 → 교차 검증 → 합의/미합의 분리	코드 리뷰, 설계 의사결정, 아키텍처 분석	bf-lead-review
sequence	Lead가 단계별로 순차 트리거, 분기만 수행	멀티 페이즈 파이프라인, 의존성 체인	bf-lead-orchestrate

자동 추론 규칙:

문제 유형	기본 패턴
코드 리뷰/분석	discourse
설계 의사결정	discourse
디버깅/조사	discourse
구현 (대규모, 병렬 가능)	distribute
구현 (순차 의존성 있음)	monitor
리서치/비교	distribute
멀티 페이즈 작업	sequence

该模式与BF Workflow的Lead技能共享。标准定义：CLAUDE.md — 协调模式

模式	核心动作	适用问题类型	BF Lead
distribute	Lead分配任务 → 各agent独立执行 → Lead汇总	并行实现、大规模调研、文档生成	bf-lead-plan
monitor	Lead生成agent并监控进度 + 处理升级请求	TDD实现、长时间任务、分步构建	bf-lead-implement
discourse	独立分析 → 交叉验证 → 区分共识/分歧	代码审查、设计决策、架构分析	bf-lead-review
sequence	Lead按顺序触发各阶段，仅处理分支	多阶段流水线、依赖链任务	bf-lead-orchestrate

自动推断规则：

问题类型	默认模式
代码审查/分析	discourse
设计决策	discourse
调试/调查	discourse
实现（大规模、可并行）	distribute
实现（有顺序依赖）	monitor
调研/对比	distribute
多阶段任务	sequence

3단계: 팀 구성 결정

步骤3：团队构建决策

조율 패턴과 문제 유형에 따라 역할, 인원, 모델을 결정한다. 아래 테이블은 가이드라인이며, 문제 특성에 따라 조정한다.

유형	인원	모델 배당	역할 예시
코드 리뷰/분석	2~3명	전원 opus	Reviewer-A, Reviewer-B, (Convention Guard)
설계 의사결정	2~3명	전원 opus	Architect-A, Architect-B, (Domain Expert)
디버깅/조사	2~3명	opus + sonnet	Investigator(sonnet), Analyst(opus), (Reproducer(sonnet))
구현 (대규모)	3~4명	Lead opus, Impl sonnet	Lead, Implementer-A, Implementer-B, (Integrator)
리서치/비교	2~4명	조사 sonnet, 종합 opus	Researcher-A(sonnet), Researcher-B(sonnet), Synthesizer(opus)

제약:

최대 teammate 수: 5명 (Lead 포함)
분석/리뷰/설계 유형은 교차 검증 품질을 위해 opus 우선
구현/리서치 유형은 비용 효율을 위해 sonnet 작업자 + opus 종합자 패턴

根据协调模式和问题类型确定角色、人数及模型。下表为指导方针，可根据问题特性调整。

类型	人数	模型分配	角色示例
代码审查/分析	2~3人	全部使用opus	Reviewer-A, Reviewer-B, (Convention Guard)
设计决策	2~3人	全部使用opus	Architect-A, Architect-B, (Domain Expert)
调试/调查	2~3人	opus + sonnet	Investigator(sonnet), Analyst(opus), (Reproducer(sonnet))
实现（大规模）	3~4人	Lead使用opus，实现者使用sonnet	Lead, Implementer-A, Implementer-B, (Integrator)
调研/对比	2~4人	调研者使用sonnet，汇总者使用opus	Researcher-A(sonnet), Researcher-B(sonnet), Synthesizer(opus)

限制：

最大teammate数量：5人（包含Lead）
分析/审查/设计类型为保证交叉验证质量，优先使用opus
实现/调研类型为兼顾成本效益，采用sonnet执行者 + opus汇总者模式

4단계: 팀 생성 및 작업 배분

步骤4：团队创建与任务分配

TeamCreate로 팀을 생성한다 (team_name:
```
teams-{timestamp}
```
형식).
Lead 에이전트를 생성한다:
- Task tool로 Lead 생성 (
```
model: opus
```
  ,
```
subagent_type: general-purpose
```
  )
- ```
team_name
```
  파라미터로 팀에 합류시킨다
- Lead에게 전달할 정보:
  - 원본 문제 설명
  - 결정된 팀 구성 (역할, 인원, 모델)
  - 각 teammate에게 할당할 작업 내용
  - Discourse 진행 지침 (아래 4단계 참조)
Lead가 teammate를 생성한다:
- 각 역할에 맞는 모델로 teammate 생성 (Task tool의
```
model
```
  파라미터 사용)
- 모든 teammate에게
```
team_name
```
  파라미터로 동일 팀에 합류시킨다
- TaskCreate로 각 teammate에게 작업을 할당한다
메인 세션은 Lead의 최종 결과만 수신한다 (컨텍스트 보존).

通过TeamCreate创建团队（team_name格式：
```
teams-{timestamp}
```
）。
创建Lead agent：
- 使用Task工具创建Lead（
```
model: opus
```
  ,
```
subagent_type: general-purpose
```
  ）
- 通过
```
team_name
```
  参数将其加入团队
- 向Lead传递以下信息：
  - 原始问题描述
  - 确定的团队构成（角色、人数、模型）
  - 分配给各teammate的任务内容
  - Discourse执行指南（参考下方4步骤）
Lead创建teammate：
- 为各角色匹配对应模型创建teammate（使用Task工具的
```
model
```
  参数）
- 通过
```
team_name
```
  参数将所有teammate加入同一团队
- 通过TaskCreate为各teammate分配任务
主会话仅接收Lead的最终结果（保留上下文）。

5단계: 조율 패턴 실행

步骤5：协调模式执行

선택된 조율 패턴에 따라 Lead가 다른 절차로 진행한다.

Lead根据所选协调模式执行不同流程。

Discourse 패턴 (리뷰, 설계, 분석)

Discourse模式（审查、设计、分析）

독립 작업: 각 teammate가 자신의 할당 작업을 독립적으로 수행한다.
결과 공유: Lead가 각 teammate의 결과를 수집한다.
교차 검증: Lead가 결과를 종합하여 teammate들에게 공유하고, teammate끼리 SendMessage로 직접 challenge/agree/보완한다.
합의 판정: Lead가 합의된 사항과 미합의 쟁점을 분리한다.
최종 종합: Lead가 결과를 정리하여 메인 세션에 전달한다.

独立工作：各teammate独立完成分配的任务。
结果收集：Lead收集各teammate的结果。
交叉验证：Lead汇总结果并共享给teammate，teammate通过SendMessage直接提出质疑/同意/补充。
共识判定：Lead区分达成共识的事项与存在分歧的争议点。
最终汇总：Lead整理结果并传递给主会话。

Distribute 패턴 (병렬 구현, 리서치)

Distribute模式（并行实现、调研）

작업 분배: Lead가 문제를 독립 단위로 분할하여 각 teammate에게 할당한다.
병렬 실행: 각 teammate가 독립적으로 작업을 수행한다. (파일 겹침이 없도록 분배)
"done" 수집: Lead가 각 teammate로부터 완료 신호를 수신한다.
취합 및 통합: Lead가 결과를 통합하고 불일치가 있으면 조정한다.
최종 결과: Lead가 통합 결과를 메인 세션에 전달한다.

任务分配：Lead将问题拆分为独立单元，分配给各teammate。
并行执行：各teammate独立完成任务。（需避免文件重叠）
收集"完成"信号：Lead接收各teammate的完成信号。
汇总与整合：Lead整合结果，若存在不一致则进行调整。
最终结果：Lead将整合后的结果传递给主会话。

Monitor 패턴 (TDD 구현, 장시간 작업)

Monitor模式（TDD实现、长时间任务）

agent 스폰: Lead가 작업 agent를 스폰한다.
진행 모니터링: 각 agent로부터 "done" 또는 "stuck" 신호를 수신한다.
에스컬레이션 처리: "stuck" 수신 시 Lead가 판단하여 재시도 또는 접근 전환을 지시한다.
상태 업데이트: Lead가 진행 상태를 관리한다.
최종 보고: 모든 agent 완료 후 결과를 메인 세션에 전달한다.

生成agent：Lead生成执行任务的agent。
进度监控：接收各agent的"完成"或"卡住"信号。
升级处理：收到"卡住"信号时，Lead判断后指示重试或转换方法。
状态更新：Lead管理执行进度。
最终报告：所有agent完成后，将结果传递给主会话。

Sequence 패턴 (멀티 페이즈 파이프라인)

Sequence模式（多阶段流水线）

단계 정의: Lead가 전체 작업을 순차 단계로 분해한다.
순차 트리거: 각 단계의 agent를 순서대로 스폰한다.
분기 판단: 각 단계 완료 신호에 따라 다음 단계를 결정한다.
파이프라인 완료: 모든 단계 완료 후 결과를 메인 세션에 전달한다.

阶段定义：Lead将整体任务拆解为顺序阶段。
顺序触发：按顺序生成各阶段的agent。
分支判断：根据各阶段的完成信号确定下一阶段。
流水线完成：所有阶段完成后，将结果传递给主会话。

공통: 쟁점 해소 프로토콜

通用：争议解决协议

모든 패턴에서 teammate 간 의견 충돌 시 동일한 프로토콜을 따른다:

Teammate 직접 대화: SendMessage로 직접 challenge/agree/보완 → 합의 시 Lead에 결론만 보고
미합의 시 Lead 중재: 프로젝트 방향성 기준으로 판단 → Lead 결정으로 확정
그래도 미합의 → 버린다 (기록): 최종 결과에 "미합의 쟁점"으로 포함, 더 이상 토큰을 쓰지 않음

所有模式中teammate意见冲突时，遵循同一协议：

Teammate直接对话：通过SendMessage直接提出质疑/同意/补充 → 达成共识时仅向Lead报告结论
未达成共识时Lead调解：以项目方向为基准判断 → 以Lead的决定为准
仍未达成共识 → 记录并搁置：在最终结果中以"未达成共识的争议点"列出，不再消耗更多令牌

6단계: 결과 제시

步骤6：结果呈现

메인 세션은 Lead로부터 받은 결과를 다음 구조로 사용자에게 출력한다:

undefined

主会话将从Lead处收到的结果按以下结构输出给用户：

undefined

결과 요약

结果摘要

{문제에 대한 핵심 결론 1~3줄}

{针对问题的核心结论1~3行}

합의 사항

共识事项

{팀원 전원이 동의한 결론/권장사항}
...

{所有成员一致同意的结论/建议}
...

미합의 쟁점 (있는 경우)

未达成共识的争议点（如有）

쟁점	입장 A	입장 B	근거
...	...	...	...

争议点	立场A	立场B	依据
...	...	...	...

권장 액션

建议行动

{사용자가 취해야 할 구체적 다음 단계}
...


- 합의 사항이 명확하면 미합의 섹션은 생략한다.
- 구현 유형인 경우 코드 변경 사항을 직접 포함한다.

{用户需采取的具体下一步}
...


- 若共识事项明确，可省略未达成共识部分。
- 若为实现类问题，需直接包含代码变更内容。

7단계: 정리

步骤7：收尾

Lead에게 shutdown_request를 보낸다 (Lead가 teammate들을 먼저 shutdown한 뒤 자신도 종료).
모든 teammate 종료를 확인한 뒤 TeamDelete로 팀을 삭제한다.

向Lead发送shutdown_request（Lead先关闭所有teammate，再自行终止）。
确认所有teammate终止后，通过TeamDelete删除团队。

Fallback

回退方案

팀 생성 실패 (TeamCreate 또는 Lead 생성 에러): 메인 세션에서 단독으로 문제를 해결한다. 사용자에게 "Agent Teams 구성에 실패하여 단독으로 처리합니다"를 알린다.
Teammate 무응답 (10분 이상 미응답): 해당 역할을 제외하고 나머지 teammate 결과로 진행한다. 결과에 제외된 역할을 명시한다.
Lead 무응답: 메인 세션에서 단독으로 처리하며 fallback 사유를 알린다.

团队创建失败（TeamCreate或Lead创建错误）：在主会话中单独解决问题。告知用户"Agent Teams构建失败，将单独处理该问题"
Teammate无响应（超过10分钟）：排除该角色，基于剩余成员的结果继续推进，并在结果中注明被排除的角色
Lead无响应：在主会话中单独处理，并提示回退原因

Output Format

输出格式

대화 출력만 생성한다. 별도 파일을 생성하지 않는다.

仅生成对话输出，不创建单独文件。