关于 compose
compose 是用于设计多 Agent 系统的技能,面向构建 Agent 工作流的人员。它先判断是否确有多 Agent 需求,再指导拓扑、交接和监督器设计。
主要功能
- 01评估多 Agent 设计是否必要
- 02定义 Agent 角色、边界与输入
- 03规划交接条件和故障处理
- 04指导监督器与拓扑设计
适用场景
- 01判断单个 Agent 是否足够
- 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:组合前检查
继续之前,请回答以下问题:
- 是否已尝试过单 Agent,但未能成功?(如果没有,请先尝试单 Agent)
- 需要多个 Agent 解决的具体局限是什么?(如果说不出来,就不需要多 Agent)
- 成本和延迟的增加是否值得?(多 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