主题
第 5 章 规格驱动开发 · 先写清楚,再让 AI 动手
第一册第 13 章教你把一次需求提清楚,这一章把它升级成制度,规格(Spec)先于代码,而且规格是一份正式的、进仓库的文件。
为什么值得升级?AI 把写代码的成本打到了接近零,瓶颈整个移动了,现在最贵的是返工,方向错了的实现,写得再快都是浪费。而返工的根源几乎总是同一个,开工时没人把"做成什么样才算成"写清楚。规格驱动的算盘很简单,审一页规格,永远比审四十个文件的差异便宜。把争论前置到纸面上,代码只是规格的执行。
一份够用的规格,五个部分。背景,为什么做这件事,现状是什么。目标,做成什么样。非目标,明确写出不做什么,这是新概念,也是防止 AI(和你自己)范围蔓延的最有效一栏。约束与红线,技术选择,不许碰的东西。验收标准,一张可判定的清单,每一条都必须能明确回答"过了没有"。验收标准是规格的灵魂,写不出验收标准的目标,只能算愿望。
这套东西你已经见过实物。books.stickmancharles.com 的改版,就是先写了一份任务书,背景,目标,分阶段,红线,验收清单,再交给 AI 分阶段执行,每阶段先给计划再动手。那份文件就是规格驱动开发的标本,效果你亲眼看过,AI 没有跑偏的空间,"偏"的定义提前写死了。
和搭档配合的姿势,规格由你主笔,这活是判断,不是打字。但可以让 AI 当第一读者,"读这份规格,列出所有歧义和你会自作主张的地方",它找歧义的能力一流。规格定稿后进仓库,走 PR(第二册第 7 章),从此实现和验收都对着同一份文件说话。
关键领悟
AI 时代的分工,想清楚是人的活,写出来是规格的活,实现是 AI 的活,验收对着验收标准来。四件事串成一条线,返工就没了藏身之处。
试一试
下一个中型任务(预计半天以上的),强制自己先写一页规格,五部分齐全,尤其是"非目标"和"验收标准"。做完对照,返工次数和以前比,差多少。