代码是廉价的。规格说明才是资产。
代码正在变成一种廉价的产物。真正的价值现在存在于规格说明(specification)之中。
我花在手动编写实现计划上的时间减少了,而花在设计上的时间增加了。AI 让这一切成为可能。它并没有取代工程判断,而是改变了你使用判断的时机。
我让 AI 起草规格说明和代码。我的工作现在是定义意图并识别约束条件。编写过程本身是价值最低的部分。
我的规格说明不是给阅读维基的人看的,而是给下一个 AI 会话准备的。它们必须能够让 AI 在无需新解释的情况下继续工作。
有效的规格说明专注于:
- 需求
- 约束
- 验收标准
- 验证步骤
它们是为了被执行而构建的,而不仅仅是为了被阅读。受众是下一个贡献者,无论是人类还是 AI 智能体。
现代工程是一个约束管理问题。如果你能清晰地捕捉约束,AI 就能很好地处理它们。我的工作流遵循以下环节: 意图 → AI 规格说明 → 人工评审 → AI 实现计划 → 人工评审 → AI 代码生成 → 测试
我提供目标、需求和边界。AI 起草规格说明。我进行评审。AI 起草计划。我进行评审。只有在那之后,我们才会生成代码。
我写得更少了,但我评审得更仔细了。这才是工程价值所在。
一个好的规格说明定义的是“什么必须为真”,而不是“如何使其为真”。例如,一个重构规格说明应该声明:
- 应用层中的任何类都不得引用 DAO 实现。
- 验收标准:在搜索过程中,违反分层原则的操作应返回零匹配项。
最重要的任务是识别“承重约束”(load-bearing constraints)。这些是关键规则,例如:
- 数据库初始化策略
- 部署模型
- 集成边界
如果你遗漏了这些,系统就会崩溃。
AI 会话是暂时的。它们来来去去。价值来自于共享记忆:
- 规格说明
- 实现计划
- 架构决策记录 (ADRs)
- 规范
这种记忆可以防止文档漂移(documentation drift)。当你的 README、代码和 ADR 描述的内容不一致时,信任就会瓦解。你必须使它们与现实保持一致。
仓库应反映以下结构:
- CLAUDE.md:工作流与评审关卡。
- status.md:所有规范与计划的动态索引。
- specs/:“是什么”与“为什么”。
- plan/:“怎么做”。
- rules/:类级别的编码规范。
- docs/adr/:重大决策的不可变记录。
AI 可以生成代码。但它无法可靠地判断哪些约束对你的业务至关重要。那是你的责任。
构建可执行的知识。让每个项目都从共享记忆开始,而不是从一张白纸开始。
来源:https://dev.to/daniel_wu_cac679a2760ba0a/the-code-is-cheap-artifact-now-the-spec-is-the-asset-3b02
可选学习社区:https://t.me/GyaanSetuAi