关于 orchestration
orchestration 是用于规划项目工作流并协调各阶段能力的技能。它分类项目模式、拆解目标、评估计划,并定义阶段门槛及多 Agent 协作方式。
主要功能
- 01将项目归为三种模式
- 02把目标拆解为能力计划
- 03按成本、风险、延迟和多样性评分
- 04通过阶段门槛验证就绪状态
- 05协调层级、顺序和并行 Agent
- 06为子 Agent 提炼上下文
适用场景
- 01选择并排列项目所需技能
- 02规划跨开发阶段的工作
- 03在进入下一阶段前检查就绪状态
- 04协调 Agent 执行多步任务
MCP 相关
该技能涵盖发现 MCP 服务并将子 Agent 的工具调用路由至对应服务,也说明 MCP 资源、工具、提示词和采样在编排中的作用。
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ oakoss/ agent-skills --skill orchestration安装后在 Claude Code 中输入/orchestration确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/context-distillation.mderror-handling.mdgoal-decomposition.mdmcp-orchestration.mdmulti-agent-coordination.mdproject-patterns.md详细介绍
编排
概述
在项目生命周期内协调技能、框架和工作流。将基于模式的项目分类与目标分解、分层任务规划和多 Agent 协作相结合。
在做出项目级工作流决策时使用此技能:启用哪些框架、按什么顺序启用,以及如何在各阶段之间验证进度。有关 Claude Code 特定的 Agent 实现细节(Agent 配置、批次大小、提示词工程),请改用 agent-patterns 技能。
此技能不能替代项目管理工具。它提供决策框架,用于安排各项能力的执行顺序,并在每个转换节点验证是否已做好准备。
快速参考
| 需求 | 操作 |
|---|---|
| 识别项目类型 | 分类为模式 A / B / C |
| 安排框架顺序 | 遵循特定模式的阶段顺序 |
| 分解目标 | 提取所需效果,匹配能力 |
| 验证准备情况 | 推进前检查阶段关卡标准 |
| 查找替代方案 | 为每个步骤生成备用能力 |
| 评估计划 | 评估成本、延迟、风险、多样性 |
| 协调 Agent | 根据任务类型选择编排模式 |
| 传递上下文 | 使用上下文提炼方法为子 Agent 提供上下文 |
模式识别
选择框架或技能前,先对每个项目进行分类。
| 模式 | 特征 | 时间线 |
|---|---|---|
| A:简单功能 | 现有系统、情况明确、单一团队 | 1-5 天 |
| B:新产品/系统 | 从零开始,安全/合规至关重要 | 4-12 周 |
| C:AI 原生/复杂 | AI Agent、RAG、知识图谱、编排 | 8-20 周 |
阶段关卡
未满足关卡标准时,不要推进。
| 关卡 | 进入标准 |
|---|---|
| 设计(阶段 2) | PRP 完成、问题已验证、成功指标、用户故事 |
| 开发(3) | 架构已记录、数据模型已设计、安全威胁已映射 |
| 测试(阶段 4) | 功能已完成、单元测试覆盖率超过 80%、代码审查通过、SAST 检查通过 |
| 部署(5) | 所有测试通过、UAT 已完成、安全测试通过、覆盖率超过 90% |
评分函数
计划根据加权效用进行评估:
| 因素 | 权重 | 评分 |
|---|---|---|
| 成本 | 0.3 | 免费=1.0、低=0.8、中=0.5、高=0.2 |
| 风险 | 0.3 | 安全=1.0、低=0.8、中=0.5、高=0.2 |
| 延迟 | 0.2 | 即时=1.0、快=0.7、慢=0.3 |
| 多样性 | 0.2 | min(unique_domains / 5, 1.0) |
修正项:最近使用过(在 3 个步骤内)则扣减 30%;新能力则奖励 20%。
多 Agent 编排模式
| 模式 | 用例 |
|---|---|
| 分层 | 父 Agent 委派给专门的子 Agent |
| 顺序 | 专家链(架构师 -> 开发 -> 审查) |
| 并行 | 同时运行相互独立的任务 |
| 交接 | 一个 Agent 将上下文传递给下一个 Agent |
关键规则:委派深度最多为 3;使用上下文提炼方法(而非完整代码库);记录所有 Agent 交互。
MCP 集成
MCP(Model Context Protocol)规范了 Agent 连接外部工具、数据源和提示词模板的方式。编排器会在启动时发现可用的 MCP 服务,并将子 Agent 发出的工具调用路由到正确的服务。
| MCP 原语 | 在编排中的作用 |
|---|---|
| 资源 | 在开始工作前发现可用数据(架构、配置、文档) |
| 工具 | 使用类型化参数执行经过验证的操作 |
| 提示词 | 在多个 Agent 之间复用特定领域的指令模板 |
| 采样 | 允许服务在执行过程中请求 AI 推理 |
常见错误
| 错误 | 正确做法 |
|---|---|
| 将所有项目都视为模式 A(简单功能) | 先分类:在选择框架前,确定属于模式 A(简单)、B(新产品)还是 C(AI 原生) |
| 为了加快进度而跳过阶段关卡 | 达到关卡标准后再推进;跳过关卡会导致返工不断累积 |
| 同时激活所有可用技能 | 每个阶段限制为 1-3 项技能,并明确交付成果和交接内容 |
| 未记录能力选择的决策 | 在每一步记录理由、考虑过的替代方案、评分和拒绝原因 |
| 未验证前置条件就构建 HTN 计划 | 首先根据每项能力的要求检查项目状态(文件、依赖项、环境变量) |
| 委派时没有明确的目标清单 | 每个子 Agent 都需要目标、约束、最大令牌数和可用工具 |
| 将整个代码库交给子 Agent | 使用上下文提炼,只传递相关符号和事实 |
委派
- 发现项目模式并分类范围:使用
ExploreAgent 调查代码库、依赖项和需求 - 执行多阶段编排计划:使用
TaskAgent 实现各阶段的交付成果,并验证关卡 - 设计架构和能力序列:使用
PlanAgent 分解目标并构建经过评分的 HTN 计划
参考资料
- goal-decomposition.md -- HTN 规划、目标分析、能力匹配、前置条件验证、评分、决策记录
- project-patterns.md -- 模式 A/B/C 分类、阶段序列、按阶段协调技能、并行化
- multi-agent-coordination.md -- 分层、顺序、并行编排模式、委派清单、递归限制
- mcp-orchestration.md -- MCP 架构、资源、工具、提示词、多服务编排、双向采样
- context-distillation.md -- 符号索引、事实提取、递归上下文缩减、令牌管理
- error-handling.md -- 目标偏移、工具故障、上下文溢出、熔断器、恢复策略、日志记录
评论
支持 Markdown