Harness 是什么
从一段代码开始

开场 · 一个脑筋急转弯

把大象放进冰箱需要几步？

3

步

① 打开冰箱
② 放大象
③ 关冰箱

开场

你有没有想过这件事

刚才你脱口而出"4 步"的时候——已经在依赖上下文了。LLM 也是同样的工作方式。换个真实点的问题再看一遍——

第一章 · 拆开 Agent

旧的定义 vs 新的定义

→ 公式 Agent = Model + Harness 由 LangChain 团队 @Vtrivedy10 推动定型

第一章 · 拆开 Agent

为什么 2026 年突然都在讲 Harness？

第一章 · 拆开 Agent

Harness 干的四件事

第二章 · 50 行代码看一个 Harness

这就是一个完整的 Harness

def run(user_message):
    messages = [{"role": "user", "content": user_message}]

    while True:
        response = client.messages.create(
            model="claude-sonnet-4-6",
            tools=tools,
            messages=messages,
        )
        messages.append({"role": "assistant",
                         "content": response.content})

        if response.stop_reason != "tool_use":
            return response.content[0].text   # 模型说完了

        # 模型要调工具，依次执行
        tool_results = []
        for block in response.content:
            if block.type == "tool_use":
                result = execute_tool(block.name, block.input)
                tool_results.append({
                    "type": "tool_result",
                    "tool_use_id": block.id,
                    "content": result,
                })
        messages.append({"role": "user",
                         "content": tool_results})

第三章 · 跟着代码跑一遍

第 1 轮：模型说"我要读文件"

# response.content
[
  {"type": "text",
   "text": "好的，我先读 a.txt"},
  {"type": "tool_use",
   "name": "read_file",
   "input": {"path": "a.txt"}}
]
stop_reason = "tool_use"

第三章 · 跟着代码跑一遍

第 2 轮：模型说"我要写文件"

# response.content
[
  {"type": "text",
   "text": "好，我来写摘要"},
  {"type": "tool_use",
   "name": "write_file",
   "input": {
     "path": "b.txt",
     "content": "今天天气..."
   }}
]
stop_reason = "tool_use"

第三章 · 跟着代码跑一遍

第 3 轮：模型说"完成了"

# response.content
[
  {"type": "text",
   "text": "已完成。摘要内容是..."}
]
stop_reason = "end_turn"

第四章 · 现实里没那么简单

Harness 的其他细节 — 完整形态

把 4 件事放到生产环境里，每一步都会再"长出"一层周边能力——这就是真实的 Harness 全貌。

第四章 · 产品落地深挖

工具系统 — 内置 + MCP + 失败处理

工具是 Harness 和真实世界的接口。3 个产品里马上要面对的问题：怎么定义、太多怎么办、失败怎么办。

第四章 · 现实里没那么简单

一行代码，省 70% 的钱

# 给长前缀加一行：
{
  "type": "text",
  "text": "...一段长背景...",
  "cache_control": {"type": "ephemeral"}
}

第四章 · 产品落地深挖

记忆体系 — 三大 Harness 框架对比

Claude Code、OpenClaw、Hermes Agent 三大框架的"记忆体系"做法各有取舍——选型时要先看记忆怎么管。

第五章 · 对我们的启发

CLAUDE.md 的魔力

—— 先从团队约定的一份 CLAUDE 标准开始

打开 Claude Code 写一句话它就懂——背后是 harness 启动时偷偷做的三件事。CLAUDE.md 是项目的"长期记忆"。

第五章 · 对我们的启发

不要焦虑

—— 软件工程是 Harness 的 Harness

讲完 Harness，最容易冒出一个念头："我会不会被取代？" 回头看 30 年——每一次新工具出现，没让工程师消失，反而让工程师更值钱。

第五章 · 对我们的启发

团队知识沉淀

—— 互相蒸馏，让团队更 NB

Harness 公开、模型公开、Skill 公开——真正不可复制的是团队领域知识。 业内多家公司已经把这件事工程化，我们也该跟上。

收尾

行动清单 & Q&A