用途:refine 是 Maestro 工作流的最终质量打磨环节,前提是工作流已能正常运行,目标是让它更优秀,而非重新设计。它也可作为 diagnose → fix → refine 循环中发布前的最后一步。
必要准备:必须先调用 /agent-workflow,其中包含工作流原则、反模式与 Context Gathering Protocol;需先遵循该协议。若尚无工作流上下文,必须先运行 /teach-maestro。
主要能力(打磨清单): 提示词:每个提示词遵循 4 区模式(角色、上下文、指令、输出);输出 schema 明确且经过校验;用否定指令说明不该做什么;无矛盾指令;模糊任务加入 few-shot 示例;多步推理任务使用思维链。 工具描述:每个工具有多行描述,说明是什么、何时用、何时不用、返回什么;输入参数有描述与类型;错误响应有文档;描述中至少含一个输入/输出示例。 错误信息:具体而非笼统;建议纠正措施;包含上下文;结构化(code + message + details)。 日志:每次模型调用记录输入/输出 token、延迟、成本;工具调用记录输入输出;错误记录完整上下文;日志中脱敏 PII;Workflow ID 贯穿所有日志条目。 配置:魔法数字改为命名常量;环境相关值放入配置而非代码;默认值合理,配置用于覆盖;设置成本上限;为所有外部调用设置超时。
输出:对每个未通过项,给出问题所在(具体发现)、位置(文件、行或组件)、修复方式(具体建议)、优先级(critical / important / nice-to-have)。
优先级矩阵:critical 影响正确性或安全性,发布前用 /fortify 或 /guard;important 影响质量或可维护性,在当前周期用 /calibrate;nice-to-have 为外观或轻微不一致,留待下次 /refine。
后续步骤:打磨完成后运行 /evaluate,用真实场景验证打磨后的工作流。
限制与禁止:不得跳过清单,需逐项检查;不得未检查就标记通过;不得建议改变行为的改动(这是打磨而非重设计);不得在工作流功能正确之前进行打磨(先修复,后打磨)。