Learn Harness Engineering 课程导读：以闭环 Harness 机制系统性驯服 AI 编码 Agent

【免费下载链接】learn-harness-engineeringHarness engineering beginner tutorial, from 0 to 1项目地址https://gitcode.com/gh_mirrors/le/learn-harness-engineering点击查看免费下载本文是 Learn Harness Engineering 课程的入口导读。该课程聚焦 AI 编码 Agent如 Codex、Claude Code的工程化核心理念是harness 并不能让模型更聪明而是通过目标定义、初始化、运行反馈、验证、收尾交接等环节为 Agent 建立一个闭环的工作系统。读完本文你将理解这门课的核心机制与学习路径并能在本仓库中找到可直接复制的 AGENTS.md、init.sh、feature_list.json 等最小 harness 模板以及 14 场理论讲座与 8 个实战项目的完整配套资源。课程定位面向 AI 编码 Agent 的 Harness Engineering 系统课Learn Harness Engineering 是一套专为 AI 编码 Agent 工程设计的入门课程from 0 to 1。它综合了行业内前沿的 Harness Engineering 理论与实践主要参考了 OpenAI 关于在 agent-first 世界中运用 Codex 的 harness 工程实践、Anthropic 关于长时运行 Agent 有效 harness 及长时应用开发的 harness 设计方法以及社区整理的 Awesome Harness Engineering 资源清单。课程的目标不是泛泛讨论提示词技巧而是通过系统化的环境设计、状态管理、验证与控制系统让 Codex、Claude Code 这类 agentic 编码工具真正变得可靠——即用显式的规则与边界约束 AI 编码助手帮助开发者完成构建功能、修复缺陷、自动化开发任务等工作。课程的完整入口文档位于 docs/en/index.md另有 docs/ar/index.md、docs/zh/index.md 等多语言版本所有讲座、项目与模板均从该入口展开。Harness 的核心机制为模型建立闭环工作系统课程反复强调一个关键论断harness 不改变模型本身的能力它改变的是模型所处的工作环境。一个有效的 harness 为 Agent 建立的是闭环工作系统——目标、执行、反馈、验证、交接形成回路Agent 在其中被反复校正而不是一次性自由发挥。课程首页用一张 Mermaid 图概括了这一闭环的核心流程这个闭环包含六个环节每一环在仓库中都有对应的真实产物1. 清晰目标Clear ObjectiveAGENTS.md流程的起点是明确目标。课程主张用AGENTS.md把项目边界、启动规则、分层约定、完成定义Definition of Done写成 Agent 可读的规范文件让 Agent 在动手前先读规则。仓库中 projects/project-01/solution/AGENTS.md 是一个完整的实例其内容结构体现了课程的典型做法Startup Rules写代码前必须按顺序完成——完整阅读本文件、阅读架构文档、阅读产品需求文档、运行bash init.sh验证构建、阅读 feature_list.json 了解功能状态分层边界Electron Layer Boundaries明确 Main Process、Preload、Renderer、Services 四层各自的职责与禁止事项如 Renderer 禁止导入fs/path/electron所有 IPC 通道名在src/shared/types.ts中统一定义ConventionsTypeScript 严格模式、仅用命名导出、异步操作统一返回 Promise 等工程约定Definition of Done类型检查通过、应用可启动、功能在feature_list.json中标记为pass并附证据、遵守分层边界、运行期无控制台错误。2. 初始化Initializationinit.sh每次会话从干净、可验证的基线开始是课程反复强调的原则。init.sh负责在克隆仓库或恢复工作时先验证项目能否干净构建失败则先修构建再动手。projects/project-01/solution/init.sh 展示了最简形态依次执行依赖安装npm install、类型检查npm run check、构建npm run build全部通过才提示Run npm run dev to launch the application并全程使用set -euo pipefail保证任一步失败即终止。而 skills/harness-creator/templates/init.sh 给出了可复制的通用版模板它会根据锁文件自动选择 pnpm / yarn / bun / npm按check→typecheck→type-check的顺序探测可用的脚本依次执行 lint、test、build对于 Python 项目则运行pytest与compileall语法检查此外还覆盖了 Gogo test ./...、Rustcargo test、Maven、Gradle、.NET 等语言栈结尾会提示阅读 feature_list.json、挑选一个未完成功能、实现后重新验证再宣称完成。3. 运行任务Run TasksAI Agent初始化通过后Agent 开始执行任务。这一环本身不依赖 harness但 harness 决定了任务如何被拆解、边界如何被约束——这正是课程中约束 Agent 行为要解决的问题。4. 运行反馈Runtime FeedbackCLI / LogsAgent 在任务中遇到问题时需要从 CLI 输出、日志等运行时反馈中获取信息并自动修复Auto-fix。课程主张让运行时可观测、可调试例如要求结构化 JSON 日志、记录关键事件文档导入、索引完成、答案生成的元数据。可参见 projects/project-06/solution/clean-state-checklist.md 中关于日志的检查项所有日志必须是可解析的 JSON包含 timestamp、level、service、message 字段导入/索引/问答等操作要输出 INFO 级结构化事件。5. 验证与 QAVerify QATest suite代码完成后进入验证环节。课程强调使用完整 pipeline 的测试而非局部冒烟检查并在测试失败时把信息反馈回运行环节继续修复。这对应课程中的讲座主题为什么端到端测试会改变结果lecture-10。6. 清理与交接Cleanup Handoffclaude-progress.md通过验证后会话需要留下干净的交接状态。课程用claude-progress.md记录会话做了什么、做了哪些决策、遇到什么问题、下次会话做什么在多会话项目中还有session-handoff.md承载更详细的交接信息。projects/project-01/solution/claude-progress.md 给出了会话日志的实际格式包含会话编号与日期、耗时与目标、已完成事项清单、关键决策如使用构造器注入 PersistenceService 以保持服务可测试、遗留问题、下次会话计划。projects/project-02/solution/session-handoff.md 则展示了更完整的交接结构上会话完成内容含涉及的具体 IPC 通道、组件与服务、剩余工作、做出的决策如新增 GET_DOCUMENT_CONTENT 通道而非把内容合并进 GET_DOCUMENT以保持列表视图载荷轻量、修改过的文件清单、阻塞项、下一步计划——这正是课程中长时运行任务保持连续性与每个会话必须留下干净状态两讲lecture-05、lecture-12在仓库中的落地产物。你将掌握的核心能力课程首页列出了学习完成后应掌握的五项核心能力每一项都有对应的讲座与仓库佐证用显式规则和边界约束 Agent 行为通过 AGENTS.md 的分层边界与约定限制 Agent 的行动范围对应 projects/project-01/solution/AGENTS.md在长时、多会话任务中维护上下文通过 session-handoff、progress 文件实现跨会话连续性对应 lecture-05 与 projects/project-02/solution/session-handoff.md阻止 Agent 过早宣布成功通过验证环节与完成定义防止虚假胜利对应 lecture-09用完整 pipeline 测试与自我反思验证工作强调端到端测试而非局部验证对应 lecture-10让运行时可观测、可调试结构化日志、事件元数据、状态清单对应 lecture-11 与 projects/project-06/solution/clean-state-checklist.md。值得一提的是课程把功能清单feature_list.json作为 harness 的基础原语对应 lecture-08。仓库中 projects/project-01/solution/feature_list.json 展示了其规范每个功能包含 id、name、description、statuspass/fail/not-started、evidence可验证的证据与 testedAt 时间戳并且从不删除功能条目。这一设计让 Agent 与人类开发者都能以同一份文件作为项目进度的唯一事实来源source of truth。课程结构四条学习路径课程分为四个部分覆盖理论、实践、模板与前沿解析讲座Lectures14 场理论课从 docs/en/lectures/lecture-01-why-capable-agents-still-fail/index.md 开始按目录顺序依次涵盖主题取自各讲座目录命名为什么能力强的 Agent 仍会失败lecture-01harness 到底是什么lecture-02为什么仓库必须成为唯一事实来源lecture-03为什么单一巨型指令文件会失败lecture-04为什么长时任务会丢失连续性lecture-05为什么初始化需要独立阶段lecture-06为什么 Agent 会越界与做不完lecture-07为什么功能清单是 harness 原语lecture-08为什么 Agent 过早宣布胜利lecture-09为什么端到端测试会改变结果lecture-10为什么可观测性应内置在 harness 中lecture-11为什么每个会话必须留下干净状态lecture-12循环工程Loop Engineeringlecture-13图工程Graph Engineeringlecture-14项目Projects8 个实战任务每个项目都提供 starter起点与 solution带完整 harness 的参考实现两套目录例如 projects/project-01、projects/project-02、projects/project-03、projects/project-04、projects/project-05、projects/project-06。项目主题依次为baseline 对比最小 harness、Agent 可读的工作区、多会话连续性、增量索引、基于证据的问答验证、运行时可观测性与调试、第一个循环、第一个图。资源库可直接复制的模板课程强调复制即用仓库中 skills/harness-creator/templates 提供了完整的模板包包括agents.md、feature-list.json、init.sh、progress.md、session-handoff.md等文件可直接放进自己的仓库使用。与之配套的技能说明见 skills/harness-creator/SKILL.md。前沿 Harness 设计解析课程将自身框架映射到真实产品上分析了 Pi、Claude Code、Codex、DeepSeek 实际如何设计 harness入口见 docs/en/harness-designs/index.md四家分别对应 pi、claude-code、codex、deepseek 的分析文档。下一步如何开始课程首页给出的推荐路径是先读理论从 Lecture 01为什么能力强的 Agent 仍会失败 开始理解 harness engineering 背后的动机与理论再做实战进入 Project 01baseline 对比最小 harness对照 starter 与 solution亲手完成第一个真实任务最后取模板从 skills/harness-creator/templates 拿走最小 harness 包AGENTS.md、feature_list.json、claude-progress.md 等应用到自己的项目。小结Learn Harness Engineering 的核心洞见可以浓缩为一句话问题不在模型不够聪明而在 Agent 缺少一个闭环的工作系统。从 AGENTS.md 的目标约束、init.sh 的基线验证到运行时反馈、端到端验证再到 claude-progress.md 的会话交接课程把让 AI 编码助手真正可靠这件事拆解成了一整套可学习、可复制、可验证的工程方法。无论你是初次接触 Agent 工程还是已有实践想系统化这门课的 14 场讲座、8 个项目和模板库都能提供一条从 0 到 1 的完整路径。赞分享【免费下载链接】learn-harness-engineeringHarness engineering beginner tutorial, from 0 to 1项目地址https://gitcode.com/gh_mirrors/le/learn-harness-engineering点击查看免费下载相关推荐Learn Harness Engineering 课程导读为 AI 编码 Agent 构建可靠的 Harness 工程体系Learn Harness Engineering 课程导读为 AI 编码 Agent 构建可靠的 Harness 工程体系 Learn Harness En从提示词到系统Learn Harness Engineering 开源课程带你为 AI 编码 Agent 构建可靠的 Harness从提示词到系统Learn Harness Engineering 开源课程带你为 AI 编码 Agent 构建可靠的 Harness 本文以 learn haLearn Harness Engineering 从 0 到 1为 AI 编程 Agent 构建可靠的闭环工作系统Learn Harness Engineering 从 0 到 1为 AI 编程 Agent 构建可靠的闭环工作系统 本指南基于 Learn Harness创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考