harness-orchestration

name	harness-orchestration
description	当你要选择编排模式（工作流 vs 自主 Agent vs 混合）、设计执行路径、选择模型、决定框架时使用；当需要权衡"确定性与可靠性"vs"灵活性与动态决策"时使用。不适用于约束/验证/纠正的实现（见 harness-constrain-verify）。

编排模式（Orchestration）

角色与读者

面向需要决定"Agent 的执行路径是预先设定还是动态生成"的开发者。本 Skill 服务的目标：按任务性质选择最合适的编排模式，并选对模型。核心认识：从简单到复杂——先优化提示词，再考虑工作流，最后才引入自主 Agent。

核心原则（配正例/反例）

1. 从简单到复杂的原则

   • 单个 LLM 调用能解决就不引入 Agent 系统；能清晰分解为固定子任务用工作流；需要动态决策才用自主 Agent。
   • 记住：Agent 系统通常用延迟和成本换任务性能，应谨慎权衡。

2. 工作流（确定性编排）vs 自主 Agent（动态决策）

   • 工作流：预定义代码路径，节点间流转代码固定，LLM 只在节点内部理解生成。优势：严格流程控制（"付款前不能预订"由代码强制）+ 安全性（提示注入最多影响当前节点）。
   • 自主 Agent：执行路径由 Agent 根据环境反馈实时决定（ReAct 循环）。必须设计明确停止条件（任务完成/调用 final_answer/无工具调用/错误超限/最大轮次），否则死循环。
   • 混合：关键合规流程用工作流，灵活决策部分切自主模式。

3. 三个核心原则（Anthropic 经验）

   • 保持简单（直接 API 调用优于复杂框架，每多一层抽象都是调试新盲区）；保持透明（显示规划步骤/执行日志/决策轨迹）；设计好工具接口 ACI（从 Agent 视角设计接口，防呆 Poka-yoke）。

4. 模型选型维度

   • 绝大多数 Agent 需要支持思考（Reasoning）的模型（多步思考/工具选择，不带思考的模型表现差）。例外：单步简单任务、Computer Use 点击固定位置。
   • 关注输出速度（多轮推理，每轮等待输出，20 轮 × 每轮慢 2 秒 = 多等 40 秒）+ 多模态支持。
   • 策略边界：模型具备能力 ≠ 产品允许调用；业务关键任务备人工接管或合规模型替代路径。

5. 选框架：用尽可能少的抽象层让你专注业务逻辑

   • 不学会某个具体框架的用法，而是看它能否用最少抽象层表达业务。模型每几个月迭代，具体框架会过时，但"看到什么、能做什么、如何验证"不会过时。

执行流程（SOP 检查清单）

1. 从最简单方案开始（单个 LLM 调用 + 优化提示词）。
2. 能分解为固定子任务 → 工作流（确定性+安全）。
3. 需动态决策 → 自主 Agent（设停止条件）。
4. 混合关键合规流程 + 灵活决策。
5. 选模型（思考能力 + 输出速度 + 多模态 + 策略边界）+ 选框架（最少抽象）。

禁止清单（写清合法例外）

• 禁止为简单任务引入自主 Agent（延迟和成本换性能，不值得）。例外：优化提示词/工作流解决不了才上自主 Agent。
• 禁止自主 Agent 无停止条件（死循环/过度执行）。例外：明确退出条件（任务完成/最终输出/无工具调用/错误超限/最大轮次）。
• 禁止用不带思考的模型做多步决策。例外：单步简单任务、GUI 固定位置点击。
• 禁止选模型只看排行榜（在自己任务上评估）。例外：第 7 章评估驱动选型。
• 禁止堆复杂框架。例外：最少抽象层专注业务逻辑。

参考资料

• 本书第 1.2.3-1.2.4 节（如何选择模型、编排模式）+ 第 1.2.6 节（三大核心原则）。
• 笔记 01-AI-Agent入门.md 第 1.7-1.8 节。