AgentSkillsCN

agent-teamworks

多智能体团队工作流——4个专业团队的自主协作系统

SKILL.md
--- frontmatter
name: agent-teamworks
description: Multi-Agent Team Workflow - 4개 전문 팀 자율 협업 시스템
version: 2.0.0
team_pattern: true
agents:
  - executor
  - executor-high
  - architect
  - planner
triggers:
  keywords:
    - "/team"
    - "/teamwork"
    - "team dev"
    - "team quality"
    - "team ops"
    - "team research"
model_preference: sonnet
auto_trigger: true

Agent Teamworks - Multi-Agent Team Workflow

4개 전문 팀(Dev, Quality, Ops, Research)이 Agent Teams 패턴으로 자율 협업하는 시스템

아키텍처

code
/auto (복잡도 기반 라우팅)
  │
  ├─ score < 4 → 기존 경로
  └─ score >= 4 → Team Coordinator
                    │
        ┌───────────┼───────────┬───────────┐
        ▼           ▼           ▼           ▼
    Dev Team    Quality Team  Ops Team   Research Team

서브커맨드

커맨드동작
/team dev "작업"Dev Team 단독 실행
/team quality "작업"Quality Team 단독 실행
/team ops "작업"Ops Team 단독 실행
/team research "작업"Research Team 단독 실행
/teamwork "프로젝트"Coordinator → 4팀 오케스트레이션
/team status현재 팀 실행 상태 조회

Agent Teams 실행

/team {팀명} "작업" 실행 시

code
# Step 1: 팀 생성
TeamCreate(team_name="team-{팀명}-{task}")

# Step 2: 팀 에이전트 스폰
Agent(
  subagent_type="executor",
  name="{팀명}-executor",
  description="{팀명} Team 작업 실행",
  team_name="team-{팀명}-{task}",
  model="sonnet",
  prompt="{작업 설명}"
)

# Step 3: 완료 후 정리
SendMessage(to="{팀명}-executor", message={type: "shutdown_request"})
TeamDelete()

/teamwork "프로젝트" 실행 시 (4팀 오케스트레이션)

code
# Step 1: 프로젝트 팀 생성
TeamCreate(team_name="teamwork-{project}")

# Step 2: 4팀 병렬 스폰
Agent(
  subagent_type="architect",
  name="dev-lead",
  description="Dev Team: 설계 + 구현",
  team_name="teamwork-{project}",
  model="opus",
  prompt="Dev Team Lead로서 프로젝트를 진행하세요: {프로젝트 설명}
  역할: Architect → Frontend/Backend → Tester → Docs → Integrator"
)

Agent(
  subagent_type="qa-tester",
  name="quality-lead",
  description="Quality Team: PDCA 검증",
  team_name="teamwork-{project}",
  model="sonnet",
  prompt="Quality Team Lead로서 품질 검증을 수행하세요: {프로젝트 설명}
  역할: Reviewer → Analyzer → GapDetector → SecurityChecker"
)

Agent(
  subagent_type="researcher",
  name="research-lead",
  description="Research Team: 조사 및 분석",
  team_name="teamwork-{project}",
  model="sonnet",
  prompt="Research Team Lead로서 리서치를 수행하세요: {프로젝트 설명}
  역할: CodeAnalyst → WebResearcher → DataScientist → Synthesizer"
)

# Step 3: 팀 간 조율 (SendMessage 활용)
SendMessage(to="dev-lead", summary="리서치 결과 전달", message="research-lead 결과: ...")
SendMessage(to="quality-lead", summary="구현 결과 검증 요청", message="dev-lead 구현 완료: ...")

# Step 4: 모든 팀 완료 후 정리
SendMessage(to="dev-lead", message={type: "shutdown_request"})
SendMessage(to="quality-lead", message={type: "shutdown_request"})
SendMessage(to="research-lead", message={type: "shutdown_request"})
TeamDelete()

팀 구성

Dev Team

TeamLead → [Architect, Frontend, Backend, Tester, Docs] → Integrator

Quality Team (PDCA)

Planner → [Reviewer, Analyzer, GapDetector, SecurityChecker] → Iterator/Reporter

  • gap < 90%: Iterator → 재검증 (최대 5회)
  • gap >= 90%: Reporter → 보고서

Ops Team

TeamLead → [CI_CD, Infra, Monitor, Security] → Integrator

Research Team

TeamLead → [CodeAnalyst, WebResearcher, DataScientist, DocSearcher] → Synthesizer

복잡도 → 팀 배치

점수투입 팀
0-3기존 경로
4-5Dev
6-7Dev + Quality
8-9Dev + Quality + Research
104팀 전체

코드 위치

파일역할
src/agents/teams/base_team.py추상 기반 클래스
src/agents/teams/prompts.py프롬프트 중앙 관리
src/agents/teams/dev_team.pyDev Team
src/agents/teams/quality_team.pyQuality Team
src/agents/teams/ops_team.pyOps Team
src/agents/teams/research_team.pyResearch Team
src/agents/teams/coordinator.pyCoordinator