【免费下载链接】learn-harness-engineeringHarness engineering beginner tutorial, from 0 to 1项目地址https://gitcode.com/gh_mirrors/le/learn-harness-engineering点击查看免费下载本栏目的核心任务是把 learn-harness-engineering 课程讲义中的 harness 理论与当前真实的前沿产品逐一对照回答唯一一个问题它们的 harness 是怎么设计的。阅读本篇后你将掌握一套可复用的五子系统分析框架指令、工具、环境、状态、反馈理解四种截然不同的 harness 设计哲学并学会把头部团队的产品决策翻译回课程概念直接应用到自己的项目中。拆什么模型权重之外的一切栏目对每个产品只关心一件事——围绕模型的那层工程基础设施。按照课程定义harness 就是模型权重之外的一切见 第二讲「Harness 到底是什么」。它包含五个子系统指令instructions、工具tools、环境environment、状态state、反馈feedback以及六大核心机制上下文连续性、初始化、验证、可观测性、交接handoff与循环loop。栏目刻意不谈三件事模型推理能力强不强、某次跑分高不高、以及这个 agent 能做什么。这些属于模型层和产品层的问题。这里只拆 harness——一切位于模型权重之外、决定模型能力有多少能真正落地的工程层。为什么值得拆模型强不等于执行可靠第一讲的核心论断是模型能力强不等于执行可靠。同一套模型放在不同的 harness 里表现可以差一个数量级。讲义回答的是应该怎么做而这些前沿产品回答的是头部团队实际怎么做。第二讲用一个厨房类比解释了这一点给一位好厨师配上一台坏灶台最好的食材也做不出菜来。code/harness-components.md见 示例文件给出了本地编码 agent 的 harness 组件清单系统提示、AGENTS.md、bash 工具、文件读写工具、git 访问、本地文件系统、启动脚本、测试命令、stop 钩子、lint 检查、evaluator 循环——只要更换其中任何一项你就在改变一个有效的 agent。因此把四个真实产品放在一起对照你会看到同一个核心机制被不同团队用完全不同的方式落地。每个产品都是一组独立的设计决策集合而这正是拆解它们的价值所在。分析框架课程的五子系统模型拆解的前提是先建立统一的分析框架。第二讲给出了五子系统模型原文含 Mermaid 图指令子系统菜谱架AGENTS.md/CLAUDE.md承载项目概览、技术栈版本、首次运行命令、不可违背的硬性约束以及指向更详细文档的链接工具子系统刀具架shell、文件、测试等工具的可用范围遵循最小权限原则环境子系统灶台通过pyproject.toml、package.json、.nvmrc、Docker 等让环境状态自描述、可复现状态子系统备餐台用PROGRESS.md等文件记录进度支撑长任务的连续性反馈子系统质检窗在AGENTS.md中显式列出验证命令测试、类型检查、lint、完整验证这是 ROI 最高的子系统。四篇产品拆解文章都使用这套五子系统框架进行结构化评估每篇末尾包含两节映射到课程框架把产品设计翻译回课程概念与值得借鉴的设计可直接抄进自己项目的决策。四种设计哲学的横向对照四个产品代表了 harness 设计光谱上四种截然不同的位置产品一句话定位核心设计决策Pi极简内核 可编程扩展最小系统提示 按需加载把上下文工程做到系统提示之外Claude Code完整的 agent 运行时环境分层记忆、五级压缩、权限、钩子、子智能体开箱即用Codexharness 哲学的极致仓库即事实来源AGENTS.md 只是目录页worktree 隔离环境DeepSeek Harness独立于模型的运行时Everything is a Plugin连 agent 循环本身都可替换Pi极简内核 可编程扩展Pi拆解文章把自己定位为minimal agent harness——注意它没有自称最强 coding agent而是把定位死死绑在harness这个词上。其哲学是最小系统提示 按需加载核心不填充大量如果…那么…规则而是提供四个可配置层次——ExtensionsTypeScript hooks挂在生命周期事件上、Skills按需加载的能力包遵循 progressive disclosure、Prompt templates可复用的 Markdown 提示、ThemesTUI 外观。它最具代表性的机制集中在上下文工程可编程的 compaction 策略可换成主题式、代码感知式、甚至由另一模型生成 summary、动态上下文extensions 在每轮推理前注入消息、过滤历史、实现 RAG、以及 session 树sessions are stored as trees/tree命令可回到任意历史节点继续工作。这一切的代价是你需要自己写 extensions 或安装社区包如 pi-agent-harness 提到的 skill-router、session-summary、extract-patterns、telemetry。Claude Code完整运行时环境Claude Code拆解文章是 Anthropic 可靠性由 harness 而非模型保证理念的产品化实现。它的核心贡献在于把课程中的多个抽象概念变成开箱即用的产品机制多级指令体系CLAUDE.md 按四级作用域加载组织策略级、用户级~/.claude/CLAUDE.md、项目级./CLAUDE.md、本地级CLAUDE.local.md子目录级按需加载另有 auto memory每 session 最多加载 200 行 / 25KB五级 compaction 管道从无损裁剪工具输出开始到结构化提取最后才用有损 LLM summary配有过压保护权限系统非事事询问而是七个模式 ML 分类器低风险放行、高风险按策略询问或拒绝HooksPostToolUse强制检查、Stop拦截过早宣布完成——把防止 agent 过早宣布胜利变成确定性机制Subagent独立 sidechain 对话历史不污染父 agent 上下文。Codex仓库即事实来源Codex拆解文章与Harness Engineering这篇命名了整个领域的文章直接相关其哲学可浓缩为一句话仓库即事实来源AGENTS.md 只是目录页工程的价值在于设计环境、表达意图、构建反馈循环。最核心的设计决策AGENTS.md 是目录页而非百科全书保持约 100 行超出的内容拆进docs/目录让 agent 按需读取——这正是给地图别给教程的权威出处只约束不变量不微管理实现dont micromanage the implementation; focus on invariants只写死约束和验证命令实现细节交给模型worktree 环境隔离每个任务在独立 git worktree 中执行配合本地可观测栈日志、指标、追踪让边界由环境强制而非提示词恳求核心级 subagentspawn_agent/wait_agent工具让模型显式创建子代理并分配独立 session 历史与工具集配置存于.codex/agents/*.toml。DeepSeek HarnessEverything is a PluginDeepSeek Harness拆解文章提出了更激进的问题harness 能不能脱离具体模型成为一个独立的运行时答案是肯定的而且推到极致——官方定义Agent Model Environment Tools State架构文档明确写着 Every part of the product is a plugin包括模型适配器、工具注册表、session 日志乃至 agent 循环本身There is no privileged core to patch。它有三个架构核心能力接缝Capability Seam每个能力拆成 Service Definition声明接口→ Service Provider实现→ Consumer通常是模型可见的工具三层替换 Provider 时模型看到的工具形态不变事件管道turn/start → agent/pre-step → step/start → LLM request → tool/call → tools/pre-execute → tools/execute → tool/result → step/end每个阶段都是插件可挂载的事件点——加权限检查就监听tools/pre-execute加记忆就注入agent/pre-step改请求就接agent/requestModel-visible means logged一切进入模型请求的内容必须能从 session 日志重建这是一个由 runtime 不变量强制执行的约束——可观测性不是事后加的日志而是 harness 的一级约束配合 append-only 的 Session Event Logsession 状态始终可回放。怎么读这个栏目栏目给出了明确的阅读路径建议先读讲义的前几讲尤其是 第二讲「Harness 到底是什么」建立五子系统框架再回到这里看真实产品如何落地这些机制。第二讲还提供了实践入口课堂提到的 Project 01. Prompt-only vs. rules-first 可以让你亲手体会只有提示词与有最小 harness的差别。每篇产品文章的末尾两节是关键杠杆映射到课程框架把产品决策翻译回课程概念便于横向比较——例如把四个产品放进五子系统评分表你会看到 Pi 在状态子系统靠 session 树、Claude Code 靠可续写的 session 存储、Codex 靠 Write 策略状态写进文件和文档、DeepSeek 靠 append-only 事件日志四套完全不同的答案值得借鉴的设计可直接摘抄的设计决策例如把 compaction 策略做成可替换接口用 hooks 做确定性检查而不是信任模型自评只传环境增量而非每轮重发完整系统上下文把每个循环步骤变成事件点。从拆解到实践四条可迁移的工程结论对照四个产品后可以提炼出几条不依赖具体产品的工程结论指令不是越厚越好Pi 的最小系统提示、Claude Code 的多级作用域、Codex 的 100 行目录页殊途同归——都反对一个巨型指令文件见 第四讲靠文件拆分与按需加载控制上下文成本反馈回路必须机制化Claude Code 的 hooks、Codex 的验证命令标准、DeepSeek 的tools/pre-execute事件都把验证从提示词恳求变成了运行时强制状态与上下文连续性需要存储层支撑session 树、history.jsonl/resume、append-only 事件日志都是把交接从口头约定变成可回放的工程设施扩展性来自事件面而非配置开关Pi 的 extensions 与 DeepSeek 的事件管道证明把循环的每个步骤变成可挂载点比提供一堆配置参数更能适应未来需求。这些结论可以直接套用回自己的项目先在AGENTS.md里写好验证命令反馈子系统用PROGRESS.md维护进度状态子系统把长文档拆进docs/按需引用指令子系统——这正是课程 实践项目 系列从零到一搭建 harness 的路径。赞分享【免费下载链接】learn-harness-engineeringHarness engineering beginner tutorial, from 0 to 1项目地址https://gitcode.com/gh_mirrors/le/learn-harness-engineering点击查看免费下载相关推荐Learn Harness Engineering 前沿 Harness 设计拆解以五子系统框架透视 Pi、Claude Code、Codex 与 DeepSeek HarnessLearn Harness Engineering 前沿 Harness 设计拆解以五子系统框架透视 Pi、Claude Code、Codex 与 DeepSLearn Harness Engineering用五子系统框架拆解 Claude Code 的 Harness 设计Learn Harness Engineering用五子系统框架拆解 Claude Code 的 Harness 设计 本篇技术指南以 Anthropic 官learn-harness-engineering 实战解码 Pi、Claude Code、Codex 与 DeepSeek Harness 的四种前沿 harness 架构learn harness engineering 实战解码 Pi、Claude Code、Codex 与 DeepSeek Harness 的四种前沿 ha上一篇ComfyUI-Inpaint-CropAndStitch vs 传统Inpaint为什么选择这款局部修复神器下一篇2025 Rust-CPython全指南从绑定原理到项目实战创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
