name: orchestration-prompts description: 编写具有阶段和聚合功能的编排器工作流提示。在涉及设计多阶段工作流、编写代理命令提示或实现结果聚合模式时使用。 allowed-tools: Read, Grep, Glob
编排提示技能
编写具有适当阶段设计和结果聚合的编排器工作流提示。
目的
指导创建多智能体编排工作流的提示,包括阶段过渡、代理命令和结果聚合。
何时使用
- 编写编排器系统提示
- 设计阶段特定的代理命令
- 创建聚合和报告提示
- 构建工作流过渡逻辑
先决条件
- 理解编排器架构 (@single-interface-pattern.md)
- 熟悉生命周期模式 (@agent-lifecycle-crud.md)
- 了解结果模式 (@results-oriented-engineering.md)
提示类型
1. 编排器系统提示
定义编排器行为的身份提示:
# 编排器代理
## 目的
管理和协调专门代理以完成复杂任务。
您不直接执行工作 - 您编排其他代理。
## 能力
- 从模板创建专门代理
- 用详细提示命令代理
- 监控代理进度
- 聚合和报告结果
- 在工作完成后删除代理
## 工作流模式
1. 分析任务需求
2. 创建适当的代理
3. 用详细指令命令代理
4. 监控进度
5. 聚合结果
6. 向用户报告
7. 删除代理
## 上下文保护
- 将您的上下文专注于编排
- 将详细工作委托给专门代理
- 不要直接读取文件
- 不要编写代码
## 可用模板
- scout-fast: 快速侦察(俳句)
- builder: 代码实现(十四行诗)
- reviewer: 代码审查(十四行诗)
- planner: 任务规划(十四行诗)
## 可用工具
- 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)
2. 侦察命令提示
发送给侦察代理的命令:
## 侦察命令:代码库分析
分析代码库的[SPECIFIC_AREA]。
专注于:
1. 文件结构和组织
2. 关键模式和惯例
3. 依赖关系和关系
4. 潜在问题或关注点
以以下格式提供结果:
### 分析的文件
[检查的文件列表]
### 关键发现
1. [发现及文件引用]
2. [发现及文件引用]
### 观察到的模式
- [模式1]
- [模式2]
### 建议
1. [可操作建议]
2. [可操作建议]
### 状态
[完成/部分/阻塞]
3. 构建器命令提示
发送给实现代理的命令:
## 构建器命令:实现
基于侦察报告实现[FEATURE]。
### 需求
[来自侦察发现或用户请求]
### 方法
[建议的实现方法]
### 要修改的文件
- [file1.ts]: [所需更改]
- [file2.ts]: [所需更改]
### 要创建的文件
- [new-file.ts]: [目的]
### 约束
- 遵循现有模式
- 保持向后兼容性
- 添加适当的测试
以以下格式提供结果:
### 消耗的资产
[读取的文件、使用的报告]
### 产生的资产
[创建或修改的文件]
### 更改摘要
[更改的简要描述]
### 测试
[测试结果(如果适用)]
### 状态
[完成/部分/阻塞]
4. 审查器命令提示
发送给审查代理的命令:
## 审查器命令:验证
审查来自[BUILDER_AGENT]的实现。
### 上下文
[侦察发现和构建器更改]
### 审查标准
1. 正确性:是否满足需求?
2. 质量:是否遵循模式?
3. 安全性:是否存在漏洞?
4. 性能:是否存在问题?
5. 测试:覆盖率是否足够?
以以下格式提供结果:
### 消耗的资产
[审查的文件、引用的报告]
### 按严重性分类的发现
**阻断者:**
[必须修复的问题]
**高风险:**
[重要问题]
**中等风险:**
[应解决的问题]
**低风险:**
[可选修复的问题]
### 裁决
[通过/通过但有建议/失败]
### 建议
[按优先级列出的改进列表]
### 状态
[完成]
5. 聚合提示
用于合并结果的提示:
## 聚合:最终报告
从所有代理结果编译最终报告。
### 输入
- 侦察报告:[摘要]
- 构建器报告:[摘要]
- 审查器报告:[摘要]
### 输出格式
## 任务完成报告
**任务:** [原始任务]
**持续时间:** [总时间]
**成本:** [总成本]
### 阶段摘要
| 阶段 | 代理 | 持续时间 | 状态 |
| --- | --- | --- | --- |
| 侦察 | [n] | [时间] | [状态] |
| 构建 | [n] | [时间] | [状态] |
| 审查 | [n] | [时间] | [状态] |
### 结果
**创建的文件:**
[列表]
**修改的文件:**
[列表]
### 审查摘要
[来自审查器]
### 未完成项
[任何剩余工作]
### 结论
[1-2句摘要]
工作流阶段设计
标准阶段
| 阶段 | 目的 | 代理 | 输出 |
|---|---|---|---|
| 侦察 | 理解 | 1-3 侦察员 | 发现报告 |
| 规划 | 设计 | 1 规划员 | 实现计划 |
| 构建 | 实现 | 1-2 构建器 | 代码更改 |
| 审查 | 验证 | 1 审查员 | 审查报告 |
| 报告 | 总结 | 编排器 | 最终报告 |
阶段过渡
侦察完成 --> 聚合发现 --> 规划阶段
规划完成 --> 验证计划 --> 构建阶段
构建完成 --> 聚合更改 --> 审查阶段
审查完成 --> 检查裁决 --> 报告或迭代
条件流
## 条件:审查失败
如果审查员裁决为“失败”:
1. 解析阻断问题
2. 创建构建器代理
3. 命令:修复特定问题
4. 重新运行审查阶段
5. 最多 3 次迭代
如果 3 次迭代后仍然失败:
1. 报告部分完成
2. 列出未解决的问题
3. 请求用户干预
提示工程技巧
对于编排器提示
- 明确不直接执行工作
- 列出可用工具和模板
- 定义清晰的工作流模式
- 强调上下文保护
对于代理命令
- 包含所有所需上下文
- 指定精确的输出格式
- 列出要检查/修改的文件
- 设置明确的范围边界
对于聚合
- 定义输入源
- 指定输出结构
- 包括要计算的指标
- 处理部分结果
输出格式
编写编排提示时,提供:
## 编排提示设计
### 编排器系统提示
[完整的系统提示]
### 代理命令模板
**侦察命令:**
[带占位符的模板]
**构建器命令:**
[带占位符的模板]
**审查器命令:**
[带占位符的模板]
### 阶段过渡
[流程图表或描述]
### 聚合格式
[最终报告模板]
### 错误处理
[失败场景和响应]
设计清单
- [ ] 编排器系统提示完成
- [ ] 侦察命令模板创建
- [ ] 构建器命令模板创建
- [ ] 审查器命令模板创建
- [ ] 聚合格式定义
- [ ] 阶段过渡文档化
- [ ] 错误处理覆盖
- [ ] 输出格式标准化
反模式
| 反模式 | 问题 | 解决方案 |
|---|---|---|
| 模糊命令 | 代理输出差 | 具体指令 |
| 无输出格式 | 结果不可解析 | 标准模板 |
| 缺少上下文 | 代理重新发现信息 | 包含侦察发现 |
| 无错误处理 | 工作流中断 | 条件流 |
| 编排器执行工作 | 上下文污染 | 严格委托 |
交叉引用
- @single-interface-pattern.md - 编排器架构
- @results-oriented-engineering.md - 结果格式
- @multi-agent-context-protection.md - 上下文边界
- @orchestrator-design skill - 系统设计
版本历史
- v1.0.0 (2025-12-26): 初始发布
最后更新
日期: 2025-12-26 模型: claude-opus-4-5-20251101