Harness Engineering：AI Agent 驾驭工程

1
2
3
4
5
6
7

类比：
┌─────────────────────────────────────────────────────┐
│  Model = CPU        → 原始计算能力                   │
│  Context Window = RAM → 有限的工作内存              │
│  Agent Harness = OS  → 管理上下文、启动序列、工具调用 │
│  Agent = Application → 具体的用户逻辑               │
└─────────────────────────────────────────────────────┘

1
2
3
4
5

docs/
├── design/           # 设计文档，带验证状态
├── architecture/     # 架构地图，模块分层
├── quality/          # 质量评级，追踪缺口
└── plans/            # 计划作为一等公民，版本化

1
2
3
4
5
6
7
8
9

Harness Components
├── Context Engineering
│   ├── 代码库中的知识库
│   └── 动态上下文（observability、浏览器导航）
├── Architectural Constraints
│   ├── LLM-based agent 监控
│   └── 确定性 linter + 结构测试
└── "Garbage Collection"
    └── 定期 agent 找不一致、违反约束

1
2
3
4
5

v1: 单 agent → 失败（任务太复杂）
v2: 多 agent + 共享状态文件 → 失败（锁竞争）
v3: Planner + Executor + Workers → 瓶颈在最慢的 worker
v4: Continuous Executor → agent 被过多角色压垮
v5: Root Planner → Subplanners → Workers → 成功！

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21

┌─────────────────────────────────────────────────────┐
│                 Root Planner                        │
│  • 理解整体状态                                      │
│  • 分解任务                                          │
│  • 不写代码                                          │
└──────────────────┬──────────────────────────────────┘
                   │ spawns
                   ▼
┌─────────────────────────────────────────────────────┐
│               Subplanners                           │
│  • 完全拥有子任务                                    │
│  • 递归分解                                          │
└──────────────────┬──────────────────────────────────┘
                   │ spawns
                   ▼
┌─────────────────────────────────────────────────────┐
│                  Workers                            │
│  • 不知道大局                                        │
│  • 只管自己的任务                                    │
│  • 完成后写 handoff                                  │
└─────────────────────────────────────────────────────┘