Team Assemble 是一款用于 Claude Code 的技能，用于分析任务、动态设计合适的专家智能体，并利用 Claude Code 的 agent teams 功能将它们编排为一个团队来协同完成工作。
用途与适用场景
该技能面向复杂任务：可分解为 2 个或以上独立子任务；角色分工清晰的工作（例如研究 + 实现 + 验证）；能从并行执行中获益的任务。它明确不建议用于：单文件编辑、简单问题、纯串行工作。
前提条件
需要先启用 agent teams，设置方法见 references/enable-agent-teams.md。
核心原则
- 三级模型：按角色用途选择。opus 用于策略/判断（侦察、复杂执行）；sonnet 用于标准执行/验证（worker、qa、support）；haiku 用于探索/撰写（researcher、editor）。细节见 references/agents.md。
- 无固定目录：智能体按每个任务动态设计。
- 示例库：references/agents.md 提供参考示例，但并非强制。
工作流
整体流程为：Phase 1 任务分析 → Phase 2 代码库侦察 → Phase 3 整合与确认 → Phase 4 执行 → Phase 5 验证 → Phase 6 完成与清理。验证失败会回到 support 修复（最多 3 次）。
Phase 1：任务分析
分析用户请求并识别代码库中的相关区域：检查项目结构、CLAUDE.md 文件和 README 文件；识别代码库中与任务相关的部分；判断代码库侦察（Phase 2）是否有帮助，或任务是否足够直接、可跳过至 Phase 3。通过 AskUserQuestion 获取用户批准，提示会列出已识别到的关注区域（例如 src/auth/、tests/auth/ 等，并标注是否直接影响），选项为“看起来不错，继续”或“我想调整范围”。对于不需要代码库探索的直接任务，跳过 Phase 2，直接进入 Phase 3，并自行参考 references/agents.md 设计团队。
Phase 2：代码库侦察（并行）
并行启动 scout 智能体来探索代码库的相关区域：模型为 opus，subagent_type 为 general-purpose（通过提示约束为只读）；探索不同区域时同时启动多个 scout。每个 scout 读取相关代码库区域并为任务提出智能体建议：读取关键文件（CLAUDE.md、README.md、源代码、配置）；分析任务与代码库区域的交集；提出所需智能体（名称、角色、任务、参考文件）；参考 references/agents.md 中的示例，但可自由设计新智能体。提示模板见 references/prompt-templates.md 的 Codebase Scout 部分。
Scout 输出格式包括：Scout Report（区域）、Current State（文件结构摘要、与任务的相关性）、Proposed Agents 表格（Agent、Role、Tasks、Reference Files）、Notes（该区域特有的约束或需遵循的模式）。
Phase 3：整合与确认团队
将 scout 报告合并为最终团队组成：去重（合并不同 scout 提出的相似智能体）；差距分析（检查缺失角色）；添加 qa + support（验证/修复智能体始终包含）；依赖图（设计智能体之间的执行顺序）；定义验收标准（用于 Phase 5 验证的可衡量标准）。通过 AskUserQuestion 获取最终批准，展示拟议团队表格（包含序号、Agent、Role、Tasks、Dependencies）以及验收标准清单，选项为“看起来不错，执行”或“我想调整角色”。若用户选择调整角色，则询问具体要改什么；超过 2 次修订请求后，切换为自由文本输入。
Phase 4：执行
创建团队并分发任务：TeamCreate(team_name: "{keyword}-team", description: "任务描述")，team_name 约定为核心关键词 + -team。为每个智能体创建 TaskCreate 条目，然后用 TaskUpdate 设置依赖。
启动队友：按角色应用三级模型（references/agents.md）；subagent_type 为 general-purpose；mode 为 bypassPermissions；无 blockedBy 依赖的智能体在单条消息中并行启动；串行时把前序智能体的结果注入下一个智能体的提示中。
队友提示需包含：上下文（项目背景及本任务在整体中的位置）、具体目标（要达成的确切结果）、参考文件（scout 识别出的文件路径）、约束（不应做什么、范围限制）、输出格式（预期交付物格式）、团队信息（team_name、任务 ID）。详细提示结构见 references/prompt-templates.md。
Phase 5：验证
qa（sonnet）评估 Phase 3 中的每项验收标准。验证过程会接收验收标准清单与 Phase 4 执行结果，逐项做基于证据的 PASS/FAIL 判断，无证据不得判 PASS，输出表格（序号、Criterion、Verdict、Evidence），给出 Overall: PASS / FAIL，并对 FAIL 项附带修复建议。
FAIL 处理：support（sonnet）只修复 FAIL 项，然后 qa 重新验证；最多 3 轮验证/修复循环；若同一错误重复 3 次则立即停止。3 轮后暂停流水线并向用户报告，内容包括重复失败项、已尝试的修复（3 次）以及推荐的人工操作。
Phase 6：完成与清理
结果报告包含：验收标准（逐项 PASS）、各智能体结果、交付物（文件路径或输出）、验证历史（验证 N 次、修复 M 次）。团队清理：发送 SendMessage(type: "shutdown_request", recipient: "{name}", content: "Work complete")，然后 TeamDelete()。
常见错误与正确做法
- 未经用户批准就创建团队 → 在 Phase 1 与 Phase 3 通过 AskUserQuestion 获取批准。
- 没有验收标准就执行 → 始终在 Phase 3 定义标准。
- 对简单任务运行 scout → 对直接的工作跳过 Phase 2。
- 跳过验证 → 执行后始终运行 Phase 5。
- 忽略模型分级 → 按角色用途使用 opus/sonnet/haiku。
- 只从固定目录中挑选 → scout 自由设计；示例仅供参考。
- 忘记 TeamDelete → 始终 shutdown_request → TeamDelete。
- 无限 FAIL 循环 → 最多 3 轮验证/修复，然后报告用户。
附加资源
references/agents.md — 智能体示例库与模型分级指南；references/prompt-templates.md — Scout、执行与 QA 的提示模板；references/examples.md — 实战示例：功能开发、重构、研究；references/enable-agent-teams.md — 如何在 Claude Code 中启用 agent teams。