核心概念

本章介绍 Harness Engineering 的五大支柱。每个都是一个深度话题 — 这里介绍基础,链接到更深入的内容。

上下文管理 (Context Management)

上下文是每次交互时喂给模型的信息。管理好上下文是 Agent 体验好坏的关键。

上下文窗口问题

每个模型都有有限的上下文窗口(8K–2M tokens)。你的 harness 必须决定:

  • 放什么进去 — 系统 prompt、对话历史、文件内容、工具调用结果
  • 丢弃什么 — 旧消息、冗余信息、已解决的线程
  • 什么顺序 — 上下文来源的优先级排序

策略对比

策略 原理 取舍
滑动窗口 保留最近 N 条消息 丢失早期上下文
摘要压缩 将旧上下文压缩为摘要 有损但紧凑
检索增强 (RAG) 按需检索相关上下文 需要索引
分层管理 多层:热(近期)+ 温(会话)+ 冷(归档) 复杂但高效

记忆与持久化 (Memory & Persistence)

记忆是跨会话存活的上下文。没有它,你的 Agent 每次醒来都是失忆状态。

记忆层级

┌─ 工作记忆 ──────── 当前对话上下文
├─ 会话记忆 ──────── 一次会话内存活(临时文件、状态)
├─ 长期记忆 ──────── 跨会话持久化(MEMORY.md、向量库)
└─ 共享记忆 ──────── 跨 Agent 可访问(团队知识库)

AGENTS.md / MEMORY.md 模式

一种基于文件的记忆模式,由 OpenClaw 和 Claude Code 推广:

  • AGENTS.md — Agent 配置、人格、规则(每次会话读取)
  • MEMORY.md — 策划过的长期记忆(Agent 读取 + 更新)
  • memory/YYYY-MM-DD.md — 每日原始日志(只追加)

这个模式简单、可移植、可版本控制 — Agent 的记忆存在纯文本文件里,人类可以阅读和编辑。


Skill / 工具编排 (Skill Orchestration)

Skill(也叫 tools、plugins、capabilities)让 Agent 的能力超越纯文本生成。

设计模式

模式 描述 示例
Thin harness + thick skills Harness 最小化;Skill 承载复杂性 OpenClaw skills
Thick harness + thin tools Harness 内置逻辑;工具很简单 Claude Code 内置工具
Plugin 市场 社区贡献的 Skill OpenClaw Skill Gallery

Agent 生命周期 (Agent Lifecycle)

Agent 经历不同阶段。Harness 管理它们之间的转换。

启动 → 初始化 → 活跃 → [暂停] → 关闭
 │        │       │       │
 │        │       │       └── 心跳 / 唤醒
 │        │       └── 处理消息、执行任务
 │        └── 加载记忆、读配置、检查权限
 └── 启动运行时、验证环境

多 Agent 协调 (Multi-Agent Coordination)

当多个 Agent 协同工作时,harness 变成编排器。

协调模式

模式 描述 适用场景
Hub-and-spoke 一个协调器分派给专业 Agent 任务分解
Peer-to-peer Agent 直接通信 协作编辑
Pipeline Agent A 的输出喂给 Agent B 顺序处理
Swarm 多个 Agent 独立处理子任务 并行探索

下一篇:架构模式 →