名称: 编排器设计 描述: 设计用于多代理车队管理的O-Agent系统。在构建编排器代理、设计多代理架构或创建代理车队控制的统一接口时使用。 允许工具: Read, Grep, Glob
编排器设计技能
设计用于管理专业化代理车队的O-Agent（编排器代理）系统。
目的
指导编排器系统的架构设计，该系统通过单一统一接口创建、命令、监控和删除专业化代理。
使用时机
- 设计多代理系统
- 构建车队管理架构
- 创建可扩展的代理工作流
- 实现单一接口模式
前提条件
- 理解三大支柱（@three-pillars-orchestration.md）
- 熟悉代理生命周期模式（@agent-lifecycle-crud.md）
- 访问Claude Agent SDK文档
SDK要求
实施说明：编排器模式需要具有自定义MCP工具的Claude Agent SDK。Claude Code子代理无法生成其他子代理。
设计流程
步骤1：定义编排范围
回答以下问题：
- 将编排哪些工作流？
- 需要哪些代理类型？
- 预期规模是什么？
- 需要什么可观测性？
输出：范围文档（需求和约束）
步骤2：设计代理模板
针对每种需要的代理类型：
| 模板 | 目的 | 模型 | 工具 |
|---|---|---|---|
| scout-fast | 快速侦察 | Haiku | Read, Glob, Grep |
| builder | 代码实现 | Sonnet | Read, Write, Edit, Bash |
| reviewer | 代码审查 | Sonnet | Read, Grep, Glob, Bash |
| planner | 任务规划 | Sonnet | Read, Glob, Grep |
模板结构：
---
name: template-name
description: 此代理的功能
tools: [tool1, tool2]
model: sonnet|haiku
---
# 系统提示
[代理特定指令]
步骤3：设计编排器系统提示
编排器需要一个特定的身份：
# 编排器代理
## 目的
管理和协调专业化代理以完成复杂任务。
您不直接执行工作——您编排其他代理。
## 能力
- 从模板创建专业化代理
- 用详细提示命令代理
- 监控代理进度
- 聚合和报告结果
- 工作完成后删除代理
## 工作流模式
1. 分析任务需求
2. 创建适当的代理
3. 用详细指令命令代理
4. 监控进度
5. 聚合结果
6. 报告给用户
7. 删除代理
## 上下文保护
- 保持您的上下文专注于编排
- 将详细工作委托给专业化代理
- 不直接读取文件
- 不编写代码
步骤4：定义管理工具
设计用于代理管理的MCP工具：
| 工具 | 目的 | 参数 |
|---|---|---|
create_agent |
启动新代理 | template, name |
command_agent |
向代理发送提示 | agent_id, prompt |
check_agent_status |
获取代理进度 | agent_id |
list_agents |
查看所有活跃代理 | - |
delete_agent |
清理代理 | agent_id |
read_agent_logs |
查看代理响应 | agent_id |
步骤5：设计可观测性层
要跟踪的关键指标：
| 指标 | 目的 |
|---|---|
| 代理状态 | 了解运行中的内容 |
| 上下文使用 | 监控令牌消耗 |
| 成本 | 跟踪每个代理的花费 |
| 工具调用 | 查看代理正在做什么 |
| 结果 | 验证输出 |
| 时间 | 测量执行持续时间 |
可观测性组件：
- 代理卡片 - 每个代理的状态、模型、上下文、成本
- 事件流 - 所有活动的实时日志
- 成本跟踪 - 每个代理和总成本
- 结果检查器 - 消耗/产生的资产
- 日志查看器 - 可筛选的活动历史
步骤6：设计工作流阶段
标准编排工作流：
阶段1：侦察
├── 创建侦察代理（并行）
├── 命令每个代理具体区域
├── 监控直到完成
└── 聚合发现
阶段2：构建
├── 创建构建代理
├── 命令其使用侦察报告
├── 监控实施
└── 聚合变更
阶段3：审查
├── 创建审查代理
├── 命令其验证实施
├── 监控审查
└── 生成最终报告
清理：删除所有代理
步骤7：规划部署架构
SDK实施所需的组件：
| 组件 | 目的 |
|---|---|
| Claude Agent SDK | 核心编排 |
| MCP服务器 | 代理管理工具 |
| 数据库 | 代理状态持久化 |
| WebSocket | 实时更新 |
| UI/CLI | 用户界面 |
输出格式
设计编排器系统时，提供：
## 编排器系统设计
**名称**：[系统名称]
**目的**：[1-2句话]
**规模**：[预期代理数量和并发性]
### 代理模板
| 模板 | 目的 | 模型 | 工具 |
| --- | --- | --- | --- |
| ... | ... | ... | ... |
### 编排器配置
**系统提示**：[包含或文件引用]
**管理工具**：[MCP工具列表]
**可观测性**：[指标和组件]
### 工作流设计
[包含代理创建/删除点的阶段图]
### 架构
[带有组件的部署图]
### 实施说明
[SDK考虑、约束、扩展因素]
设计检查清单
- [ ] 编排范围已定义
- [ ] 代理模板已设计
- [ ] 编排器系统提示已编写
- [ ] 管理工具已指定
- [ ] 可观测性层已规划
- [ ] 工作流阶段已设计
- [ ] 部署架构已规划
反模式
| 避免 | 原因 | 替代方案 |
|---|---|---|
| 编排器执行工作 | 上下文污染 | 委托一切 |
| 缺少可观测性 | 盲目操作 | 跟踪所有指标 |
| 保留死代理 | 资源浪费 | 完成后删除 |
| 无生命周期管理 | 无法扩展 | CRUD操作 |
| 通用代理 | 工作不集中 | 专业化模板 |
交叉引用
- @three-pillars-orchestration.md - 框架基础
- @single-interface-pattern.md - O-Agent架构
- @agent-lifecycle-crud.md - 生命周期管理
- @multi-agent-context-protection.md - 上下文边界
- @results-oriented-engineering.md - 结果模式
版本历史
- v1.0.0 (2025-12-26)：初始发布
最后更新
日期： 2025-12-26 模型： claude-opus-4-5-20251101