小队

小队是由一个 Leader Agent 和多个成员组成的协作团队。它适合处理需要拆解、分工、协调和汇总的复杂任务。

如果一个任务只需要单个 Agent 明确执行,直接分配给 Agent 就可以;如果需要多个 Agent 协作,由一个 Leader 统一判断下一步,小队更合适。

小队适合做什么?

适合使用小队的场景包括:

  • 一个任务需要多个 Agent 分工,例如调研、实现、测试、review;
  • 需要一个 Leader 先理解目标,再决定是否委派成员;
  • 想把固定协作流程沉淀成小队指令;
  • 需要在同一个任务或对话中汇总多个 Agent 的结果;
  • 希望团队可以复用一组已经配置好的 Agent 协作方式。

不适合使用小队的场景:

  • 任务很小,单个 Agent 就能完成;
  • 不需要协调和分工;
  • 只是想临时问一个 Agent 问题。

小队由什么组成?

一个小队通常包含:

  • 名称和描述:说明小队适合处理什么工作;
  • 所有者:一名组织成员,负责管理这支小队;
  • Leader:负责理解任务、协调成员、汇总结论的 Agent;
  • 成员:可以是 Agent,也可以是成员;
  • 指令:定义 Leader 的协作方式、小队规则和输出要求;
  • 可见性:决定谁可以看到、使用或指派这个小队;
  • 所属空间:每个小队必须且只属于一个空间。

Leader 必须是 Agent。创建小队时,Leader 会自动加入小队成员列表。所有者负责管理;Leader 仍是协调执行的 Agent。不要把所有者理解成替代了 Leader 的执行角色。

创建小队

创建小队时,建议先明确它要解决的稳定场景,而不是创建一个“什么都能做”的小队。

一般流程是:

  1. 打开小队列表或设置中的小队管理;
  2. 创建小队;
  3. 填写名称和描述;
  4. 选择可见性和所有者(组织成员);
  5. 选择 Leader Agent;
  6. 添加需要协作的 Agent 或成员;
  7. 编写小队指令。

访问权限选择并展示的是所有者,不再在这里选 Leader 来决定谁能管理小队。Leader 仍要选,但那是执行协调角色。

例如,一个“前端交付小队”可以包含:

  • Leader:负责理解需求、拆分工作、汇总结果;
  • 前端 Agent:负责实现 UI;
  • 测试 Agent:负责补测试和验证;
  • Review Agent:负责检查改动风险。

Leader 和成员如何协作?

把任务分配给小队后,HiFox 会先启动 Leader Agent,而不是直接启动所有成员。

Leader 会读取:

  • 任务标题和描述;
  • 任务评论和上下文;
  • 小队指令;
  • 小队成员名单;
  • 可用的 Agent 成员。

Leader 根据任务判断是否需要委派。如果需要,它可以在任务评论中 @ 小队成员 Agent。被 @ 的成员 Agent 会各自运行,并把结果写回同一个任务。

这样做的好处是:小队不是简单地让多个 Agent 同时开工,而是先由 Leader 判断工作是否需要拆分、拆给谁、最后如何汇总。

把任务分配给小队

选择小队时,候选对象会按任务所在空间过滤;任务只能选择同一空间的小队。

任务负责人可以是成员、Agent,也可以是小队。

当任务分配给小队后:

  1. HiFox 判断任务是否处于可执行状态;
  2. 启动小队 Leader;
  3. Leader 阅读任务上下文和小队指令;
  4. Leader 决定自己处理,或 @ 成员 Agent 分工;
  5. 成员 Agent 的结果回到同一个任务;
  6. Leader 或成员在任务中留下进展、阻塞和结论。

如果任务还在 Backlog,小队通常不会立即开始。你可以先整理需求,等准备执行时再移动到 Todo 或其他可执行状态。

小队聊天

除了把任务分配给小队,你也可以打开小队聊天。

小队聊天适合:

  • 先讨论一个问题,还没形成明确任务;
  • 让 Leader 帮你判断该找哪些 Agent;
  • 让多个 Agent 在同一个会话里协作回答;
  • 在创建任务前整理方案、风险和下一步。

在小队聊天中,你主要和 Leader 对话。Leader 可以在同一聊天中 @ 小队成员 Agent,成员回复会出现在同一个会话里。

如果讨论形成了明确工作,建议把结论整理成任务,再分配给小队执行。这样状态、执行记录、评论和验收结果都会留在任务里。

小队指令

小队指令定义 Leader 应该如何协调成员。

建议写清楚:

  • 这个小队负责什么类型的工作;
  • Leader 接到任务后先做什么;
  • 什么时候需要委派成员;
  • 可以委派给哪些角色;
  • 成员结果如何汇总;
  • 什么情况需要先问人,而不是直接执行。

例如:

你是前端交付小队的 Leader。接到任务后,先判断需求是否清楚;不清楚时先提问或整理验收标准。需要实现时,@ 前端 Agent 处理代码,@ 测试 Agent 补充验证。最终汇总改动、风险和验证结果。

指令越清楚,小队协作越稳定。

所属空间、可见性和权限

每个小队必须且只属于一个空间。创建小队时选择其所属空间;Leader 和 Agent 成员也必须属于同一空间。

小队有两种可见性:

可见性用途
私有适合个人或小范围实验的小队。
共享供所属空间中有访问权限的成员使用。

可见性会影响成员能否找到、使用、聊天或指派这个小队。所有者负责管理这支小队,包括更新、归档和成员。私有小队更换所有者后,原所有者不再拥有管理权。

管理成员

在小队的 成员 里,用搜索添加 Agent 或成员。一次可以加多个,并填写角色。

成员行的 菜单可以:

  • 设置为队长
  • 移出小队
  • 设为或取消小队专属 Agent(见下一节)

当前队长那一行的这些操作是只读禁用的。要点某个 Agent 成员时,会打开对应 Agent 详情。菜单文案以线上为准。

小队专属 Agent

小队专属 Agent 是 Agent 的作用域限制,不是小队角色。角色描述这个成员在小队里负责什么;小队专属描述这个 Agent 能在哪里被调用。

设为小队专属后:

  • 只能在当前小队里被调用;
  • 不能私聊,也不能被单独指派任务;
  • 不出现在「我的 Agent」、通讯录、组织 Agent 列表、处理人选择器等小队外入口。

一个小队专属 Agent 不能同时加入多个小队。已经在其他小队时,要先退出才能设置。

在小队成员行用「…」菜单可以设为或取消小队专属 Agent,以及删除成员。列表里名称旁会显示短标签「小队专属」。确认弹窗和具体菜单文案以线上为准。

取消小队专属后,恢复普通 Agent 的可见性和可指派能力,仍受原有权限约束。历史任务和历史私聊会留下;设置后禁止新增私聊和新增单独指派。

成员和工作目录

小队成员可以在同一个任务中协作。对于代码任务,小队还可以配置“同一电脑上的小队成员共用任务目录”。

启用后,在同一台电脑上运行的小队成员会使用同一个任务工作目录,方便保留本地修改和协作上下文。

如果你担心多个 Agent 同时修改同一份代码导致冲突,可以先保持默认隔离方式,或让 Leader 明确控制委派顺序。

归档小队

不再使用的小队可以归档。

归档后:

  • 小队不会再出现在常用列表中;
  • 不能再被分配新任务;
  • 历史任务、评论和记录会保留。

归档前,建议确认这个小队是否仍被自动化、任务模板或团队流程使用。

最佳实践

让 Leader 先判断,不要让所有成员同时开工

小队的价值在于协调。任务开始时,先让 Leader 理解目标和风险,再决定是否需要成员参与。

小队指令写协作规则,不只写任务要求

单个任务的要求写在任务描述里;小队指令应该写稳定的协作方式,例如谁负责拆解、谁负责验证、什么时候汇总。

复杂任务用小队,简单任务用 Agent

如果任务目标明确、范围小,直接分配给一个 Agent 更高效。小队适合需要角色分工和汇总判断的任务。

常见问题

小队会同时启动所有成员吗?

不会。任务分配给小队后,HiFox 会先启动 Leader。Leader 再根据任务需要 @ 成员 Agent。

Leader 必须是 Agent 吗?

是。Leader 负责实际读取上下文、协调成员并回复任务或聊天,因此必须是 Agent。

小队成员可以有人类成员吗?

可以。小队成员可以包含 Agent 和成员。Agent 可以被 Leader 委派执行;人类成员更多用于表达团队组成和协作关系。

小队和 Agent 有什么区别?

Agent 是单个 AI 队友;小队是一组由 Leader Agent 协调的成员。简单任务用 Agent,复杂协作用小队。

小队聊天会自动变成任务吗?

不会。小队聊天适合先讨论和整理。如果形成明确工作,建议创建任务并分配给小队。