给 AI 一份可验收的规格
验收标准是每次生成前的「刹车」。规格质量决定代码质量。
规格质量决定代码质量
AI 生成代码，质量的下限由模型决定，上限由你给的规格决定。如果规格是含糊的「帮我做个下单功能」，你得到的往往是「看起来对、实则有一堆边角没处理」的代码。所以正确的姿势是：在生成之前，先写清需求与可测的验收标准。
什么是「可验收」
一份可验收的规格，至少要能回答这些问题：
- 输入：接受什么？格式、范围、类型
- 输出：返回什么？结构、成功与失败的形态
- 边界：空值、0、超大值、并发、重复提交
- 错误行为：什么情况报错？报什么错？是否吞异常？
- 验收标准：怎样算「做完了」？有没有可执行的测试？
把这些写清楚，模型就能自检「对不对」，而不是靠猜你的意图。能自检，比写得长重要得多。
从「一次性 PRD」到「实时输入」
传统工程里，需求、验收标准是项目前置阶段的一次性产物，写完就进入开发。Agent 时代它们变了性质：
- 变成每一轮对话的实时输入
- 意图一旦写错，会污染后续所有生成
- 反馈粒度从「阶段」变成「即时」
- 多了一层「传达验证」——验证模型是否真的理解你
所以规格不只是「文档」，它是每次生成前的刹车。
让 AI 辅助 AI
- 让 AI 根据你的规格列出边界清单、生成测试建议
- 再让另一层校验（人、CI、测试）去核对 AI 的产物
- 形成「规格 → 生成 → 验证 → 修正」的闭环
可落地
- 用「AI 任务规格」模板写契约：背景 / 任务 / 约束 / 输出格式
- 用「AI 代码评审清单」逐项核对：契约 / 边界 / 安全 / 集成 / 性能 / 测试
- 规格与评审清单本身也是规约，随会话长期复用
一句话：规格质量决定代码质量，验收标准是每次生成前的刹车。 把精力花在「把成功定义清楚」上，AI 才能把实现做好。