Agent Harness

一句话总结：先决定“用什么组合”，再逐层执行。

核心关系：

决策树 → 选择“管道 + 哪个工作流”
管道 = 执行框架（通用）
工作流 = 工作内容（具体）

---

⚠️ 执行前检查（必须逐项确认）

收到任务时，先回答以下问题：

1. 1. [ ] 核心任务是什么？（多步骤 / 单步骤）
2. [ ] 需求是否明确？（明确 → 下一步 / 不明确 → 加载 06-INVERSION.md）
3. [ ] 是否需要多步骤执行？（是 → 管道 + 其他）
4. [ ] 具体内容是什么？（对应哪个工作流）

响应格式：

[执行前检查]
问题1：xxx → 结论
问题2：xxx → 结论
...
最终决策：管道 + 工作流/{名称}
或：最终决策：反转（独立模式）

层级关系图

┌─────────────────────────────────────────────────────────────┐
│ 层级执行顺序 │
│ │
│ 步骤1 ──→ 步骤2 ──→ 步骤3 ──→ 步骤4 ──→ 步骤5 │
│ │ │ │ │ │ │
│ ▼ ▼ ▼ ▼ ▼ │
│ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ │
│ │决策 │→│管道 │→│工作流 │→│模板 │→│质量 │ │
│ │01- │ │02- │ │03- │ │04- │ │05- │ │
│ │决策 │ │管道 │ │工作流 │ │模板 │ │质量 │ │
│ └────────┘ └────────┘ └────────┘ └────────┘ └────────┘ │
│ │
│ 决策树决定“用什么组合”， │
│ 管道决定“通用执行流程”， │
│ 工作流决定“具体工作内容” │
└─────────────────────────────────────────────────────────────┘

类比

🍳 烹饪场景：

• - 决策树 = 顾客点单（“今天要辣的”）
• 管道 = 烹饪方法（先热锅，不管做什么）
• 工作流 = 具体菜谱（如何做鱼香肉丝）
• 模板 = 摆盘风格（如何装盘）

💻 软件场景：

• - 决策树 = 任务分类（“这是一个研究任务”）
• 管道 = 执行流程（先分解，不管研究什么）
• 工作流 = 研究方法（四步法）
• 模板 = 报告格式（标题-摘要-正文-结论）

执行流程

步骤1 — 决策（加载 01-DECISION.md）

[步骤1] 读取 references/01-DECISION.md
决定：管道 + 哪个工作流

常见组合：

• - 管道 + 研究 → 研究任务
• 管道 + 子代理 → 协调任务
• 管道 + 上下文 → 压缩任务
• 管道 + 分析 → 分析任务

步骤2 — 执行框架（加载 02-PIPELINE.md）

[步骤2] 读取 references/02-PIPELINE.md
理解：通用四步执行流程

管道步骤：
步骤1：规划
步骤2：执行
步骤3：总结
步骤4：检查

步骤3 — 具体内容（加载 03-WORKFLOWS/{名称}.md）

[步骤3] 读取 references/03-WORKFLOWS/{对应工作流}.md
执行：具体工作内容

研究 = 四步研究（分解→研究→综合→报告）
子代理 = 四步协调（分析→分解→并行→合并）
上下文 = 四步压缩（评估→策略→执行→验证）
分析 = 四步分析（分解→收集→比较→结论）

步骤4 — 输出模板（加载 04-TEMPLATES/{名称}.md）

[步骤4] 读取 references/04-TEMPLATES/{对应模板}.md
生成：结构化最终输出

步骤5 — 质量检查（加载 05-QUALITY.md）

[步骤5] 读取 references/05-QUALITY.md
验证：输出质量符合标准

快速参考：常见组合

禁止行为

• - ❌ 跳过步骤：未完成步骤1直接进入步骤3
• ❌ 混淆层级：将管道和工作流视为同一事物
• ❌ 缺少模板：输出内容但格式混乱
• ❌ 缺少检查：未进行质量验证就结束

完成标志

[agent-harness 执行完成]
✓ 步骤1-5已完成
✓ 组合：管道 + 工作流/{名称}
✓ 禁止行为检查：通过

文件索引