mcpField
C
compose

compose

github.com/sharpdeveyeAgent 工作流592338 次安装26 周前更新
代码仓库

关于 compose

compose 是用于设计多 Agent 系统的技能,面向构建 Agent 工作流的人员。它先判断是否确有多 Agent 需求,再指导拓扑、交接和监督器设计。

主要功能

  1. 01评估多 Agent 设计是否必要
  2. 02定义 Agent 角色、边界与输入
  3. 03规划交接条件和故障处理
  4. 04指导监督器与拓扑设计

适用场景

  1. 01判断单个 Agent 是否足够
  2. 02规划多 Agent 系统的角色与连接

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/sharpdeveye/maestro --skill compose

安装后在 Claude Code 中输入/compose确认已加载。

详细介绍

必须进行的准备工作

调用 /agent-workflow — 其中包含工作流原则、反模式和上下文收集协议。继续之前,请遵循该协议 — 如果尚无工作流上下文,必须先运行 /teach-maestro。 查阅 agent-workflow 技能中的 agent-architecture 参考资料,了解拓扑模式以及何时适合采用多 Agent。


设计一个多 Agent 系统。但首先 — 你确定需要多 Agent 吗?

步骤 1:组合前检查

继续之前,请回答以下问题:

  1. 是否已尝试过单 Agent,但未能成功?(如果没有,请先尝试单 Agent)
  2. 需要多个 Agent 解决的具体局限是什么?(如果说不出来,就不需要多 Agent)
  3. 成本和延迟的增加是否值得?(多 Agent = 成本和延迟增加 2-10 倍)

如果说不出具体的局限,请改用 /amplify 增强单 Agent。

步骤 2:设计拓扑

选择合适的架构模式(查阅 agent-workflow 技能中的 agent-architecture 参考资料):

为系统中的每个 Agent 定义:

## Agent: [Name]
Role: [One sentence]
Responsibilities: [What it does]
Boundaries: [What it does NOT do]
Tools: [List of tools this agent has access to]
Input: [What it receives]
Output: [What it produces]
步骤 3:设计交接

为每个 Agent 间的连接定义:

## Handoff: [Agent A] → [Agent B]
Trigger: [When does A hand off to B?]
Payload: [What data is passed?]
Expected response: [What does A expect back?]
Timeout: [How long to wait?]
Failure handling: [What if B fails?]
步骤 4:设计监督者

每个多 Agent 系统都需要一个监督者:

  • 监控 Agent 的运行状况和性能
  • 将任务路由到合适的 Agent
  • 处理故障并升级问题
  • 执行全局约束(预算、时间、质量)
组合检查清单
  • 每个 Agent 都有明确且互不重叠的角色
  • 为每个连接定义了交接协议
  • 已采用监督者模式
  • 成本和延迟预算涵盖所有 Agent
  • 在每个交接点都能处理故障模式
  • 通过阅读拓扑图即可理解系统
建议的下一步

完成组合后,运行 /fortify,为每次交接添加错误处理;然后运行 /evaluate,端到端测试多 Agent 系统。

切勿:

  • 为单 Agent 能处理的问题构建多 Agent 系统
  • 创建职责重叠的 Agent
  • 省略监督者(自主协作群体难以预测)
  • 在所有 Agent 之间传递完整上下文(只传递必要内容)
  • 未定义交接协议就进行组合

评论

支持 Markdown