walkinglabs/learn-harness-engineering

这个项目是什么？

Learn Harness Engineering 是一个免费的开源课程，教你如何构建支持系统，使 AI 编码代理（如 Claude、GPT 或 Codex）在真实软件项目中可靠工作。它不是关于编写更好的提示——而是关于设计 AI 运行的环境。

核心思想：即使是最强大的 AI 模型，如果你不提供适当的结构，也会在真实工程任务中失败。该课程展示了如何构建这种结构，它称之为 harness。

harness 做什么？

README 解释说，harness 有五个子系统，每个都有特定的工作：

• 指令 – 告诉代理做什么、按什么顺序做，以及开始前要阅读什么。不是一个大文件，而是一种渐进式披露结构，代理按需导航。
• 状态 – 跟踪已完成、进行中和下一步的工作。保存到磁盘，以便下一个会话从上一个会话结束的地方继续。
• 验证 – 只有通过的测试套件才算证据。代理不能在没有可运行证明的情况下声称成功。
• 范围 – 将代理限制为一次只处理一个功能。不越界，不半途而废多个事情，不重写功能列表以隐藏未完成的工作。
• 会话生命周期 – 开始时初始化，结束时清理，并为下一个会话留下干净的重新启动路径。

README 包含一个图表显示这些如何组合在一起，以及一个文本版本说：“模型决定写什么代码。harness 管理它何时、何地以及如何写。”

课程内容是什么？

课程分为三个部分：

• 讲座 – 14 个概念单元，解释 harness 工程背后的理论。
• 项目 – 8 个动手项目，你从零开始构建一个代理工作区。
• 资源库 – 可复制的模板（如 AGENTS.md、feature_list.json、init.sh），你可以直接放入自己的仓库。

还有一个 技能 部分，包括一个 harness-creator 技能，可以在几分钟内为你的项目搭建一个生产级 harness。

如何立即使用？

README 提供了一个快速开始：如果你已经在使用编码代理，你可以通过向项目根目录添加四个文件来立即改进它：

• AGENTS.md – 代理的操作手册
• init.sh – 运行安装 + 验证 + 启动
• feature_list.json – 存在哪些功能，哪些已完成
• claude-progress.md – 会话进度日志（名称是历史性的，但与代理无关；任何代理都可以使用）

这些文件位于你的仓库中，因此每个会话都从相同的状态开始。README 说仅此一项就能使代理会话“比仅靠提示运行稳定得多”。

顶点项目是什么？

所有六个（现在八个）课程项目都围绕同一个产品：一个真实的应用。README 在句子中间截断，但明确说明项目是围绕一个单一的真实应用程序构建的。

最近有什么新内容？

README 突出了两个主要更新：

• 2026 年 8 月：添加了一个关于 前沿 Harness 设计分解 的新部分 – 四个深入探讨真实产品（Pi、Claude Code、Codex、DeepSeek）如何构建其 harness，应用课程的五子系统框架。还添加了关于 图工程 的讲座 14 和项目 08，将工作流绘制为图。
• 2026 年 7 月：添加了关于 循环工程 的讲座 13 和项目 07，构建你的第一个自动化循环，以及目标循环、定时循环和制造者-检查者循环的代码模板。

其他细节

• 语言：课程提供 15 种语言版本（英语、中文、日语、韩语、西班牙语、法语、俄语、德语、阿拉伯语、越南语、乌兹别克语、土耳其语、葡萄牙语-巴西、乌克兰语等）。
• PDF：有一个构建管道生成 PDF 课程书（npm run pdf:build），输出到 artifacts/pdfs/。
• 许可证：MIT。
• 社区：有一个 Discord 链接加入社区。

为什么这个课程存在？

README 解释了动机：模型可以写代码，但它们能否在真实仓库中可靠地完成真实工程任务，跨多个会话，无需持续人工监督？目前，答案是“没有 harness 不行”。该课程教你如何构建那个 harness，这样你可以信任你的 AI 代理完成工作，而你验证结果而不是清理它。

简而言之：Learn Harness Engineering 是一个实用的、基于项目的课程，为你提供框架和工具，将 AI 编码代理从有时有帮助的助手转变为可靠的队友。