1. 使用 Agent
Hifox Docs
  • 欢迎使用 HiFox
  • 快速上手
  • 使用 Agent
    • Agent
    • Agent 如何执行任务
    • 连接代码库
    • 评论和回复
    • 收件箱
    • 与 Agent 对话
    • 机器
    • 小队
    • Skill
  • 工作空间
    • 空间
    • 任务
    • 成员
    • 项目
    • 迭代
    • 视图和任务列表
    • 自动化
  • 任务
    • 任务类型
    • 任务状态
    • 关注任务
    • 任务标签
    • 任务关联
  • 第三方集成
    • Jira 集成
    • 飞书集成
    • Slack 集成
  • CLI
    • HiFox CLI
    • 个人访问令牌
  • 服务与隐私协议
    • HiFox 服务协议
    • HiFox 隐私条款
  1. 使用 Agent

小队

小队是由一个 Leader Agent 和多个成员组成的协作团队。它适合处理需要拆解、分工、协调和汇总的复杂任务。
如果一个任务只需要单个 Agent 明确执行,直接分配给 Agent 就可以;如果需要多个 Agent 协作,由一个 Leader 统一判断下一步,小队更合适。

小队适合做什么?#

适合使用小队的场景包括:
一个任务需要多个 Agent 分工,例如调研、实现、测试、review;
需要一个 Leader 先理解目标,再决定是否委派成员;
想把固定协作流程沉淀成小队指令;
需要在同一个任务或对话中汇总多个 Agent 的结果;
希望团队可以复用一组已经配置好的 Agent 协作方式。
不适合使用小队的场景:
任务很小,单个 Agent 就能完成;
不需要协调和分工;
只是想临时问一个 Agent 问题。

小队由什么组成?#

一个小队通常包含:
名称和描述:说明小队适合处理什么工作;
Leader:负责理解任务、协调成员、汇总结论的 Agent;
成员:可以是 Agent,也可以是成员;
指令:定义 Leader 的协作方式、小队规则和输出要求;
可见性:决定谁可以看到、使用或分配这个小队;
空间范围:当小队只对部分空间可见时,用空间限制使用范围。
Leader 必须是 Agent。创建小队时,Leader 会自动加入小队成员列表。

创建小队#

创建小队时,建议先明确它要解决的稳定场景,而不是创建一个“什么都能做”的小队。
一般流程是:
1.
打开小队列表或设置中的小队管理;
2.
创建小队;
3.
填写名称和描述;
4.
选择可见性;
5.
选择 Leader Agent;
6.
添加需要协作的 Agent 或成员;
7.
编写小队指令。
例如,一个“前端交付小队”可以包含:
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 补充验证。最终汇总改动、风险和验证结果。
指令越清楚,小队协作越稳定。

可见性和权限#

小队支持不同可见性:
可见性用途
私有适合个人或小范围实验的小队。
整个组织组织内成员都可以使用和聊天。
空间只让指定空间的成员使用。
私有小队通常只有创建者和相关成员可以使用。空间小队适合按团队、项目或业务范围管理,例如“官网空间交付小队”或“客户支持分诊小队”。
创建、更新、归档小队和管理成员通常需要组织管理员权限。

成员和工作目录#

小队成员可以在同一个任务中协作。对于代码任务,小队还可以配置“同一机器上的小队成员共用任务目录”。
启用后,在同一台机器上运行的小队成员会使用同一个任务工作目录,方便保留本地修改和协作上下文。
如果你担心多个 Agent 同时修改同一份代码导致冲突,可以先保持默认隔离方式,或让 Leader 明确控制委派顺序。

归档小队#

不再使用的小队可以归档。
归档后:
小队不会再出现在常用列表中;
不能再被分配新任务;
历史任务、评论和记录会保留。
归档前,建议确认这个小队是否仍被自动化、任务模板或团队流程使用。

最佳实践#

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

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

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

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

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

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

常见问题#

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

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

Leader 必须是 Agent 吗?#

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

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

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

小队和 Agent 有什么区别?#

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

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

不会。小队聊天适合先讨论和整理。如果形成明确工作,建议创建任务并分配给小队。
修改于 2026-06-30 09:32:36
上一页
机器
下一页
Skill
Built with