用途:指导设计 O-Agent(Orchestrator Agent,编排智能体)系统,用于通过单一统一接口管理由专用智能体组成的集群,即创建、指挥、监控和删除智能体。适用场景包括设计多智能体系统、构建集群管理架构、创建可扩展的智能体工作流、实现单一接口模式。
前提条件:理解三大支柱(@three-pillars-orchestration.md);熟悉智能体生命周期模式(@agent-lifecycle-crud.md);可查阅 Claude Agent SDK 文档。
SDK 限制:编排模式需要 Claude Agent SDK 与自定义 MCP 工具。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/description/tools/model 的 frontmatter 与系统提示;3)编写编排智能体系统提示,明确其只负责协调而不直接做工作、不直接读文件或写代码,并包含分析、创建、指挥、监控、汇总、报告、删除的流程模式与上下文保护原则;4)定义管理工具(MCP),如 create_agent、command_agent、check_agent_status、list_agents、delete_agent、read_agent_logs;5)设计可观测层,追踪智能体状态、上下文用量、成本、工具调用、结果与耗时,组件含智能体卡片、事件流、成本跟踪、结果检查器、日志查看器;6)设计工作流阶段,示例为标准三阶段:Scout(并行创建与指挥、监控、汇总)→ Build(依据侦察报告实现并汇总改动)→ Review(验证并生成最终报告),最后清理删除全部智能体;7)规划部署架构,组件包括 Claude Agent SDK、MCP 服务器、数据库、WebSocket、UI/CLI。
输出格式应包含名称、用途、规模、智能体模板表、编排配置(系统提示、管理工具、可观测性)、工作流设计、架构图与实现说明。另附设计检查清单与反模式(如编排者亲自干活、缺少可观测性、保留已死智能体、无生命周期管理、使用通用智能体)。版本记录:v1.0.0(2025-12-26)初始发布。具体价格、收费与更多平台信息暂未提供。