代码是廉价的。规格说明才是资产。

代码正在变成一种廉价的产物。真正的价值现在存在于规格说明(specification)之中。

我花在手动编写实现计划上的时间减少了,而花在设计上的时间增加了。AI 让这一切成为可能。它并没有取代工程判断,而是改变了你使用判断的时机。

我让 AI 起草规格说明和代码。我的工作现在是定义意图并识别约束条件。编写过程本身是价值最低的部分。

我的规格说明不是给阅读维基的人看的,而是给下一个 AI 会话准备的。它们必须能够让 AI 在无需新解释的情况下继续工作。

有效的规格说明专注于:

它们是为了被执行而构建的,而不仅仅是为了被阅读。受众是下一个贡献者,无论是人类还是 AI 智能体。

现代工程是一个约束管理问题。如果你能清晰地捕捉约束,AI 就能很好地处理它们。我的工作流遵循以下环节: 意图 → AI 规格说明 → 人工评审 → AI 实现计划 → 人工评审 → AI 代码生成 → 测试

我提供目标、需求和边界。AI 起草规格说明。我进行评审。AI 起草计划。我进行评审。只有在那之后,我们才会生成代码。

我写得更少了,但我评审得更仔细了。这才是工程价值所在。

一个好的规格说明定义的是“什么必须为真”,而不是“如何使其为真”。例如,一个重构规格说明应该声明:

最重要的任务是识别“承重约束”(load-bearing constraints)。这些是关键规则,例如:

如果你遗漏了这些,系统就会崩溃。

AI 会话是暂时的。它们来来去去。价值来自于共享记忆:

这种记忆可以防止文档漂移(documentation drift)。当你的 README、代码和 ADR 描述的内容不一致时,信任就会瓦解。你必须使它们与现实保持一致。

仓库应反映以下结构:

AI 可以生成代码。但它无法可靠地判断哪些约束对你的业务至关重要。那是你的责任。

构建可执行的知识。让每个项目都从共享记忆开始,而不是从一张白纸开始。

来源:https://dev.to/daniel_wu_cac679a2760ba0a/the-code-is-cheap-artifact-now-the-spec-is-the-asset-3b02

可选学习社区:https://t.me/GyaanSetuAi