swarm

蜂群 Swarm

分析用户任务，自动规划 Agent 团队结构（角色、数量、提示词），确认后执行团队协作。

核心流程

分析任务 → 选择团队模式 → 设计角色与提示词 → 用户确认 → 创建团队 → 分配任务 → 监控执行

第一步：分析任务

收到用户任务描述后，从以下维度分析：

维度	评估内容
任务类型	功能开发 / 代码审计 / Bug 调试 / 技术选型 / 重构迁移
可并行度	哪些子任务可以同时进行
文件冲突	不同角色是否会修改同一文件
依赖关系	哪些任务必须按顺序执行
复杂度	决定团队规模（2-8 人）

第二步：选择团队模式

根据分析结果，从预定义模式中选择最匹配的模式。详见 references/team-patterns.md。

五种基础模式：

1. 功能开发 — 新功能、跨层变更
2. 代码审计 — PR Review、安全审计
3. 调试竞争 — Bug 排查、假设验证
4. 研究辩论 — 技术选型、方案评估
5. 重构迁移 — 大规模重构、架构迁移

可混合使用或自定义。如果任务不完全匹配任何模式，基于模式原则自行设计。

第三步：设计角色与提示词

为每个 teammate 设计：

1. 角色名称：简短描述（如 frontend-dev、security-reviewer）
2. Agent 类型：根据职责选择（详见 references/agent-types.md）
3. 模型：根据任务复杂度选择（opus/sonnet/haiku）
4. 权限模式：default / plan / bypassPermissions
5. 提示词：包含角色、职责、文件范围、输出要求、协作规则
6. 文件范围：明确可操作的目录，避免冲突

提示词结构：

角色：{role}
职责：{responsibilities}

工作范围：
- 只修改：{allowed_dirs}
- 不要触碰：{excluded_dirs}

输出要求：
- {output_format}

协作规则：
- 发现跨模块影响时，通过消息通知 {related_teammate}
- 完成后标记任务为 completed

完成标准：
- {completion_criteria}

第四步：展示计划并确认

以结构化格式展示团队计划，等待用户确认：

## 团队计划

**任务**：{task_description}
**模式**：{pattern_name}
**团队规模**：{count} 人

### 角色分配

| # | 角色 | Agent 类型 | 模型 | 职责概要 |
|---|------|-----------|------|---------|
| 1 | {name} | {type} | {model} | {summary} |
| ...

### 任务列表与依赖

| ID | 任务 | 负责人 | 依赖 |
|----|------|--------|------|
| 1 | {task} | {owner} | - |
| 2 | {task} | {owner} | blockedBy: 1 |
| ...

### 文件分工（避免冲突）

| 角色 | 可操作目录 |
|------|-----------|
| {name} | {dirs} |
| ...

确认此计划？(Y/修改建议)

使用 AskUserQuestion 工具让用户确认或提出修改。

第五步：创建团队并执行

用户确认后，按以下顺序执行：

5.1 创建团队

TeamCreate → team_name: "{task-slug}"

5.2 创建任务列表

按计划创建所有任务（TaskCreate），设置依赖关系（TaskUpdate + addBlockedBy）。

5.3 启动 Teammates

对每个角色，使用 Task 工具启动 teammate：

Task → subagent_type: "{agent_type}"
       name: "{role_name}"
       team_name: "{team_name}"
       model: "{model}"
       mode: "{permission_mode}"
       prompt: "{designed_prompt}"