refine

必须执行的准备工作

调用 /agent-workflow — 其中包含工作流原则、反模式和上下文收集协议。继续之前，请遵循该协议 — 如果尚无工作流上下文，必须先运行 /teach-maestro。

---

这是最后一轮质量检查。工作流已经可以运行 — 现在让它更加出色。

优化检查清单

提示词

• 每个提示词都遵循 4 区域模式（角色、上下文、指令、输出）
• 输出架构明确且经过验证
• 负面指令清楚说明哪些事情不要做
• 没有相互矛盾的指令
• 为有歧义的任务提供少量示例
• 对多步推理任务使用思维链

工具描述

• 每个工具都有多行描述：用途、何时使用、何时不要使用、返回内容
• 输入参数都注明描述和类型
• 记录错误响应
• 描述中至少包含一个输入/输出示例

错误消息

• 错误消息具体明确（而非“发生错误”）
• 错误消息提供纠正建议
• 错误消息包含上下文（正在尝试执行什么操作）
• 错误采用结构化格式（代码 + 消息 + 详情）

日志记录

• 记录每次模型调用（输入令牌数、输出令牌数、延迟、成本）
• 记录工具调用及其输入和输出
• 记录错误及完整上下文
• 从日志中脱敏个人身份信息
• 工作流 ID 贯穿所有日志条目

配置

• 所有魔法数字都定义为具名常量
• 特定环境的值放在配置中，而非代码中
• 默认值合理 — 配置用于覆盖默认值
• 设置成本上限
• 为所有外部调用设置超时值

输出

对于每个未通过的检查项，请提供：

1. 问题所在（具体发现）
2. 所在位置（文件、行号或组件）
3. 修复方法（具体建议）
4. 优先级（critical / important / nice-to-have）

优先级矩阵

优先级	标准	Maestro 操作
Critical	影响正确性或安全性	发布前执行 /fortify 或 /guard
Important	影响质量或可维护性	在当前周期执行 /calibrate
Nice-to-have	外观或轻微的不一致	留待下一轮 /refine 处理

建议的下一步

优化完成后，运行 /evaluate，根据真实场景验证经过润色的工作流。

绝不可：

• 跳过检查清单 — 逐项检查
• 未经检查就标记为通过
• 建议会改变行为的修改（这是润色，不是重新设计）
• 在工作流功能正确之前进行优化（先修复，最后优化）