team-assemble

Team Assemble 是一款面向 Claude Code 的技能，用于分析任务、动态设计合适的专家智能体，并利用 Claude Code 的智能体团队功能将它们编排为一个团队来协同工作。

前提条件

使用前必须启用智能体团队（Agent teams）功能，具体设置说明见 references/enable-agent-teams.md。

适用场景

适合以下情况：

可分解为 2 个及以上独立子任务的复杂任务；
角色分离清晰的工作（例如研究 + 实现 + 验证）；
能从并行执行中受益的任务。

不适用于：单文件编辑、简单问题、纯顺序性工作。

核心原则

模型三档选择：按角色用途选择模型。opus 用于策略与判断（侦察、复杂执行）；sonnet 用于标准执行与验证（worker、qa、support）；haiku 用于探索与写作（researcher、editor）。细节见 references/agents.md。
无固定目录：智能体按任务动态设计。
示例库：references/agents.md 提供参考示例，但不是强制要求。

工作流

工作流依次为：阶段 1 任务分析 → 阶段 2 代码库侦察 → 阶段 3 整合并确认 → 阶段 4 执行 → 阶段 5 验证 → 阶段 6 完成与清理。其中验证失败会触发 support 修复，最多 3 次。

阶段 1：任务分析

分析用户请求，识别代码库中的相关区域：

检查项目结构、CLAUDE.md 文件和 README 文件；
识别代码库中与任务相关的部分；
判断代码库侦察（阶段 2）是否有帮助，或任务是否足够直接、可跳到阶段 3。

通过 AskUserQuestion 获取用户批准，示例提示会列出关注区域，并提供选项“Looks good, proceed”或“I'd like to adjust the scope”。

对于不需要代码库探索的直接任务，跳过阶段 2，直接进入阶段 3，并以 references/agents.md 为指南自行设计团队。

阶段 2：代码库侦察（并行）

并行启动侦察智能体探索代码库相关区域。

侦察配置：模型为 opus；subagent_type 为 general-purpose（通过提示词限制为只读）；在探索不同区域时并行启动多个侦察智能体。

侦察任务：每个侦察智能体阅读相关代码库区域并为任务提出智能体建议：

阅读关键文件（CLAUDE.md、README.md、源代码、配置）；
分析任务与代码库区域的交集；
提出所需智能体（名称、角色、任务、参考文件）；
参考 references/agents.md 中的示例，但可自由设计新智能体。

提示词模板见 references/prompt-templates.md 的 § Codebase Scout。

侦察输出格式包括：侦察报告（区域）、当前状态（文件结构摘要、与任务的相关性）、建议智能体表格（智能体、角色、任务、参考文件）、备注（区域特定约束或需遵循的模式）。

阶段 3：整合并确认团队

将侦察报告合并为最终团队构成：

去重：合并不同侦察智能体提出的相似建议；
差距分析：检查是否缺少角色；
添加 qa + support：验证/修复智能体始终包含；
依赖图：设计智能体之间的执行顺序；
定义验收标准：为阶段 5 验证提供可衡量的标准。

通过 AskUserQuestion 获取最终批准，示例提示会展示团队提案表格（含智能体、角色、任务、依赖）以及验收标准清单，并提供选项“Looks good, execute”或“I'd like to adjust roles”。若用户选择调整角色，则询问具体要更改什么；在 2 次以上修改请求后，切换为自由文本输入。

阶段 4：执行

创建团队并分配任务：

TeamCreate(team_name: "{keyword}-team", description: "Task description")

team_name 约定：核心关键词 + -team。为每个智能体创建 TaskCreate 条目，然后用 TaskUpdate 设置依赖。

启动队友：模型按角色应用三档选择（references/agents.md）；subagent_type 为 "general-purpose"；mode 为 "bypassPermissions"；并行时在单条消息中启动无 blockedBy 依赖的智能体；顺序时把前序智能体的结果注入下一个智能体的提示词。

队友提示词要求包括：上下文（项目背景及本任务在整体中的位置）、具体目标、参考文件（侦察智能体识别的文件路径）、约束（不应做什么、范围限制）、输出格式（预期交付物格式）、团队信息（team_name、任务 ID）。详细提示词结构见 references/prompt-templates.md。

阶段 5：验证

qa（sonnet）根据阶段 3 的每个验收标准进行评估。

验证流程示例提示词：

Agent(name: "qa", model: "sonnet", prompt: """

Acceptance Criteria

[ ] AC-1: {criterion}

Validation Target

{Phase 4 execution results}

Evaluate each criterion with evidence-based PASS/FAIL judgment. No PASS without evidence.

Output Format

失败处理：support（sonnet）只修复失败项，然后 qa 重新验证；验证/修复循环最多 3 轮；同一错误重复 3 次则立即停止；3 轮后暂停流程并向用户报告，包括重复失败项、已尝试的修复和推荐操作。

阶段 6：完成与清理

结果报告包含：验收标准、各智能体结果、交付物、验证历史（验证 N 次、应用 M 次修复）。

团队清理：

SendMessage(type: "shutdown_request", recipient: "{name}", content: "Work complete") TeamDelete()

常见错误与正确做法

未经用户批准就创建团队 → 在阶段 1 和阶段 3 通过 AskUserQuestion 获得批准；
没有验收标准就执行 → 始终在阶段 3 定义标准；
对简单任务运行侦察 → 直接任务跳过阶段 2；
跳过验证 → 执行后始终运行阶段 5；
忽略模型分档 → 按角色用途使用 opus/sonnet/haiku；
只从固定目录中选择 → 侦察智能体可自由设计，示例仅供参考；
忘记 TeamDelete → 始终先 shutdown_request，再 TeamDelete；
无限失败循环 → 最多 3 轮验证/修复，然后报告用户。

附加资源

references/agents.md：智能体示例库及模型分档指南；
references/prompt-templates.md：侦察、执行和 QA 提示词模板；
references/examples.md：完整示例，包括功能开发、重构、研究；
references/enable-agent-teams.md：如何在 Claude Code 中启用智能体团队。