SuperAPI AI 工具集

agent-team-orchestration

智能体与模型

查看项目

更新于 11-01 21:29

技能介绍

用途

Agent Team Orchestration 是一套用于运行多智能体团队的生产级操作手册,目标是在多个智能体之间建立清晰的角色、结构化的任务流和明确的质量门禁。它适合需要持续协作、多次交接、智能体之间相互依赖产出的工作流,而不是单次委派或简单问答。

主要能力

该技能围绕四个核心概念展开:

  1. 角色:每个智能体只有一个主要角色,避免职责重叠造成混乱。资料列出的角色包括:

    • 编排者(Orchestrator):路由工作、跟踪状态、做优先级判断,建议使用高推理能力模型。
    • 构建者(Builder):产出代码、文档、配置等产物,机械性工作可使用成本更低的模型。
    • 审查者(Reviewer):验证质量、指出缺口,建议使用高推理能力模型。
    • 运维(Ops):负责定时任务、站会、健康检查、调度,使用可靠且成本最低的模型。
  2. 任务状态:每个任务经过明确的生命周期:收件箱 → 已分配 → 进行中 → 审查 → 完成或失败。规则包括:状态转换由编排者负责,不依赖智能体自行更新状态;每次转换都要有评论说明谁、做了什么、为什么;失败是合法的终态,需记录原因后继续。

  3. 交接:工作在不同智能体之间传递时,交接消息必须包含:已完成内容摘要、产物所在的确切文件路径、如何验证(测试命令或验收标准)、已知问题(未完成或有风险的部分)、下一步动作。资料给出了坏交接与好交接的对比示例。

  4. 审查:跨角色审查防止质量漂移。构建者审查规格是否可行、缺什么;审查者检查构建是否符合规格、边界情况;编排者审查优先级是否当前正确。资料指出,跳过审查步骤后,质量通常会在 3 到 5 个任务内下降。

使用方式

资料提供了一个最小 2 智能体团队的快速开始流程:

  1. 定义角色:编排者(你)负责路由任务、跟踪状态、报告结果;构建者负责执行工作、产出产物。
  2. 生成任务:创建任务记录(文件、数据库或任务板);生成构建者时提供任务 ID 和描述、产物输出路径、交接说明(产出什么、放在哪里)。
  3. 完成后:审查产物、标记完成、报告。
  4. 加入审查者:构建者产出产物 → 审查者检查 → 编排者发布或退回。

资料还提到多个参考文件,在特定场景下阅读:定义智能体、角色、模型、工作区时阅读 team-setup.md;设计任务状态、转换、评论时阅读 task-lifecycle.md;设置异步/同步通信、产物路径时阅读 communication.md;实现具体工作流(规格→构建→测试、并行研究、升级)时阅读 patterns.md。

适用场景

该技能适用于持续性的团队工作流,即多个智能体在多个任务中依赖彼此产出的重复协作模式。资料明确列出不适合使用的情况:

  • 单智能体设置:遵循标准 AGENTS.md 约定即可,团队编排会增加不必要的开销。
  • 一次性任务委派:直接使用 sessions_spawn。本技能面向有多次交接的持续工作流。
  • 简单问题路由:如果只是把问题转发给专家,那是消息,不是工作流。

限制与常见陷阱

资料列出了以下常见陷阱:

  • 生成智能体时未指定清晰的产物输出路径,导致找不到产出。应在生成提示中指定确切输出路径,使用结构可预测的共享产物目录。
  • 没有审查步骤导致质量漂移。每个产物至少应经过一次非产出者的检查。
  • 智能体不评论任务进度,造成协调盲区。要求在开始、阻塞、交接、完成时评论;如果智能体沉默,应假定它卡住了。
  • 分配任务前未核实智能体能力,例如给没有浏览器访问权限的智能体分配浏览器测试,给纯文本模型分配图像工作。
  • 编排者亲自做执行工作。编排者负责路由和跟踪,不应构建;一旦开始“顺手做一下”,就会失去对团队其余部分的监督。

暂未提供的信息

资料未提供该技能的收费、价格、平台支持、具体安装命令或代码示例。