驾驭工程:给 AI 套上缰绳#
一本关于 驾驭工程 的长篇中文技术书 —— 一种刻意塑造 AI 编码智能体所处环境的实践,好让它们生产出来的软件是可验证、可观测、可理解的。
作者 |
Walter Fan |
许可证 |
CC-BY-NC-SA-4.0(正文)· Apache-2.0(代码样例) |
状态 |
草稿 —— 骨架就位,章节正在撰写中 |
源码 |
本书怎么读#
本书循一条六段式的论证弧线 —— 为什么 → 是什么 → 怎么做 → 例子 → 结语 → 参考。大多数读者应当把第一、第二部分顺着读下去,然后进第三部分挑自己最需要的那一份方法论,再从第四部分挑一两份贴近自身技术栈的案例研究。第五部分短小、偏行动;第六部分是参考。
本书最前头还有一份 Part 0 · Presentation(公开分享),它面向的是另一类读者:任何人若在一次会议前只剩六十分钟,又需要把整本书当成一场 talk 讲出去 —— 那就从这一 Part 开始。它把全书压成一份一小时的讲稿,外加一份分钟级的 speaker outline 与一份每页一张 slide 的大纲。只想读论证的读者可以跳过 Part 0;需要把这套论证 再次传递 给同事的读者,应当从这里起步。
每一份有实质内容的章(第 02 至第 16 章)都在正文下方遵循同一副双节骨架:## 研究脉络 把论证钉在可引用的先前工作之上,## 动手环节 则至少交付一件可跑起来的制品。这些章节是刻意把理论与实践配对的。
Part 0 · 公开分享
第一部分 · 为什么
第二部分 · 是什么
- 什么是 Harness Engineering?
- 插章:Agent Memory 系统的结构
- 插章:AI Agent 与编程工具的结构
- 插章:Fowler 的 Harness 词汇 —— 两条正交轴与一份 Java 最小示例
- 06.1 LangChain 公式:Agent = Model + Harness
- 06.2 第一条轴:Feedforward × Feedback
- 06.3 第二条轴:Computational × Inferential
- 06.4 两条轴一起看:一张 2 × 2
- 06.5 三类 Harness:Maintainability、Architecture Fitness、Behaviour
- 06.6 Harnessability:不是所有代码库都一样好"拴"
- 06.7 一张最小可用 Harness 清单
- 06.8 一个 Java Web 项目的最小 harness
- 06.9 一条调试法:问 harness 链路
- 研究脉络
- 动手环节
第四部分 · 例子
- 案例研究:OpenHarness
- 案例研究:Superpowers
- 案例研究:lazy-scrum-team —— 用工作流编码出来的马具
- 案例研究:通过《马书》看 Claude Code
- 案例研究:Codex —— 把代理式编码变成一套可审计的工作面
- 案例研究:OpenSpec —— 把意图变成可合并的工程制品
- 15.1 —— 一眼看清这具马具
- 15.2 —— 三个最承重的实现选择
- 15.3 —— OpenSpec 的六个精华模式
- 15.4 —— 十二格亮点图
- 15.5 —— Artifact Graph:OpenSpec 的骨架
- 15.6 —— Delta Specs:为 brownfield 而生的规格格式
- 15.7 —— 跨 Agent 分发:最容易被低估的一层
- 15.8 —— Workspace Beta:从 repo-local 到 coordination surface
- 15.9 —— OpenSpec vs Superpowers:工件马具与技能马具
- 15.10 —— 风险与盲区
- HarnessCard
- 研究脉络
- 动手环节
第五部分 · 结语