Skip to content
HARNESS ENGINEERING —— 学习档案 · 中文
人类掌舵，智能体执行
一座从概念理解到独立实践的 Harness Engineering 深度学习档案。工程师不再逐行写代码——设计约束、明确意图、构建反馈回路，让智能体可靠地交付。
§ 01一句话理解
THE PARADIGM SHIFT传统工程人类写代码→机器执行代码
HARNESS ENG.人类设计约束→智能体写代码→机器执行代码
核心转变：工程师的产出，从「代码」变成了「约束系统」——AGENTS.md、架构规则、自定义 linter、反馈回路。
§ 02六大核心概念
SIX CORE CONCEPTS像档案卡一样编号归档——每一张都指向仓库里一篇可追溯的概念笔记。
01REPO = RECORD仓库即记录系统不在仓库里的东西，对智能体不存在。决策、规范、计划一律以版本化工件入库。concepts/01→02MAP, NOT MANUAL地图而非手册AGENTS.md 是目录页，不是百科全书。渐进式披露，从小入口点指向更深的文档。concepts/00→03MECHANICAL机械化执行文档会腐烂，lint 规则不会。自定义 linter 与结构测试，是不变量的守护者。concepts/02→04AGENT READABLE智能体可读性优先为智能体的推理优化。选「无聊」的稳定技术，让应用可按 worktree 隔离启动。concepts/04→05THROUGHPUT吞吐量改变合并理念纠错成本低、等待成本高。PR 生命周期很短，偶发失败靠续跑重跑解决。concepts/05→06ENTROPY & GC熵管理 = 垃圾回收技术债是高息贷款。把「黄金规则」编码进仓库，后台任务定期扫描并修复偏差。concepts/03→
§ 03档案总目
BUILD-TIME · 自动清点导航与下面每一个数字，都在构建时由脚本从仓库文件系统清点生成，再由 C1–C14 一致性检查守护，不随文档腐烂而漂移。这不是营销数据，是一座档案馆的总目。
§ 04仓库即 harness · 自我指涉
THE ARCHIVE RUNS ON WHAT IT RECORDS这个仓库，开始策展自己了。
HUMAN GATE人类闸门「收不收进来」始终是一道人类闸门。人类掌舵，决定什么值得进入档案。
MECHANICAL RAIL机械护栏C1–C14 一致性检查守着计数与保真，不让任何数字悄悄腐烂。
FEEDBACK LOOP反馈回路外部调研的评审，由智能体沿一条固化成 skill 的流水线自动完成。
于是约束本身成了产品——正是「约束即产品」讲的东西，只不过这一次，实验的对象是仓库自己。