Learn Harness Engineering

简体中文

English

简体中文

English

主题

Learn Harness Engineering ​

这是一门项目制课程：系统学习如何通过环境、状态、验证与控制机制，让 Codex 和 Claude Code 更可靠地工作。

本课程仍在持续建设中，内容后续可能会调整。

英文入口见：English Home

课程概览 ​

Harness engineering 指的是：围绕模型搭建一整套工作环境，让它干活更靠谱。这不只是写提示词，还包括：

  • 代码放哪、怎么组织
  • 什么能干、什么干不了
  • 任务做到哪了、下次怎么接上
  • 做完怎么验证对不对
  • 出了问题怎么排查
  • 哪些规矩必须遵守
  • 怎么保持干净、不留烂摊子

这门课是强实践导向的。我们不会只停留在“概念解释”，而是会让 Codex 或 Claude Code 在同一个不断演化的 Electron 应用上反复工作，并比较弱 harness 与强 harness 的差异。

课程真正关心的问题是：

  • 哪些 harness 设计会提升任务完成率？
  • 哪些设计会减少返工和错误完成？
  • 哪些机制能让长时任务更稳定地持续推进？
  • 哪些结构能让系统在多轮 agent 运行后仍然可维护？

核心观点 ​

以后让模型干活，人只需要定好规则和边界。这就是 harness。

为什么这个重要： 模型很强，但不代表它能自动靠谱地完成真实工程任务。它需要一套明确的规则来约束自己的行为范围，需要清晰的交接机制来维持长时任务的连续性，需要验证手段来确认自己做对了。

我们不是在尝试“让模型本身更聪明”，而是在研究：怎么给模型搭建一个靠谱的工作环境，让同一个模型做出更可靠的工作。

课程大纲 ​

讲义 ​

讲义正文目前仍以英文为主，中文先提供导览和说明。

项目 ​

项目正文目前仍以英文为主，中文先提供导览和学习路径。

资料库 ​

快速开始 ​

不必先把所有 lecture 读完。如果你想先上手，可以直接去资料库参考这些文件，然后按自己的项目改一版。

中文版本：

英文版本：

推荐最小起步组合：

  • AGENTS.md 或 CLAUDE.md
  • feature_list.json
  • claude-progress.md
  • init.sh

先把这四样放进你的项目里，再开始让 agent 真正干活，效果会比只写一段大 prompt 稳定得多。

建议学习节奏 ​

这门课适合按 6 个单元推进：

  • 单元 1：Lecture 01-02 + Project 01
  • 单元 2：Lecture 03-04 + Project 02
  • 单元 3：Lecture 05-06 + Project 03
  • 单元 4：Lecture 07-08 + Project 04
  • 单元 5：Lecture 09-10 + Project 05
  • 单元 6：Lecture 11-12 + Project 06

如果你想慢一点，也可以把每个单元当成一周来学。

适合谁 ​

这门课适合：

  • 已经在使用 coding agent、希望提升稳定性和质量的工程师
  • 想系统理解 harness 设计的研究者或构建者
  • 需要理解“环境设计如何影响 agent 表现”的技术负责人

这门课不适合：

  • 只想要一个零代码 AI 入门的人
  • 只关心 prompt，而不打算做真实实现的人
  • 不准备让 agent 在真实仓库里工作的学习者

环境要求 ​

这是一门真正需要动手跑 coding agent 的课程。

你至少需要具备一个这类工具：

  • Claude Code
  • Codex
  • 其他支持文件编辑、命令执行、多步任务的 IDE / CLI coding agent

课程默认你可以：

  • 打开本地仓库
  • 允许 agent 编辑文件
  • 允许 agent 运行命令
  • 检查输出并重复执行任务

如果你没有这类工具，仍然可以阅读课程内容，但无法按预期完成课程 project。

核心参考资料 ​

主参考：

辅助参考：

本地预览 ​

本仓库使用 VitePress 作为文档查看器。

sh
npm install
npm run docs:dev

然后在浏览器里打开 VitePress 输出的本地地址即可。