让 AI 少猜代码,先补齐结构约束
文章指出,数据库关系、接口载荷和权限规则若只写成笼统需求,编码 Agent 就会自行补全,造成跨文件不一致。相比继续加长提示词,更应明确这些关键约束并要求 Agent 遵循。
AI 深度解读
AI 编程助手把数据库字段写成两套、前后端对不上接口,未必是提示词不够详细。作者的核心判断是:规格没有提前决定关键事实,模型就会替团队做决定,而且不同文件里的决定可能互相打架。解决办法是先固定数据结构、接口契约和权限规则,再交给 Agent 实现。
这个思路对用 Cursor、Claude Code 或 Windsurf 开发完整功能的人很有用。不过,标题里的「零幻觉」说得偏满:原文提出了一套减少猜测的规格组织方法,没有提供消除错误的实测证据。
一句需求,为什么会长出两套实现
作者举的例子很常见:「用户属于工作区,用户只能看到自己工作区的数据。」
产品层面,这句话容易理解;工程层面,至少还欠四组决定:
- 建立
workspaces和workspace_members表,成员关系里保存用户 ID。 - 每张业务数据表都带有
workspace_id外键。 - 每张表配置行级安全策略(Row Level Security,RLS),例如检查当前行的
workspace_id是否出现在当前用户的成员关系记录中。 - API 请求中的工作区 ID 必须放在约定的位置,并在查询执行前完成校验。
这些细节决定了系统如何运行。只给自然语言需求,Agent 就得自行选择表名、关联方式、请求结构和权限实现。今天写数据库时选了一套,明天写 API 时又可能选另一套,两边单看都合理,接起来却不成立。
关键事实没有定下来,提示词写得再顺,也不能保证实现一致。
作者把这类问题称为幻觉,强调它来自规格留下的空白。这个解释适合分析跨文件不一致,但并没有覆盖模型出错的全部原因。
四份文件分别锁住哪些决定
作者开发的 Web Dev Mehedi 会把一个想法生成四份文件,声称耗时不到 60 秒。它们分别负责产品、界面、技术约束和执行流程。
PRODUCT_REQUIREMENTS.md 写清范围、用户旅程、边界情况,以及 GIVEN/WHEN/THEN 验收条件。它要回答的不只是「做什么」,还包括满足什么条件才算完成。
UI_UX_SPECIFICATION.md 规定设计令牌(design tokens)、字体、页面状态和无障碍规则。对前端来说,最实用的是提前定义空状态、加载状态和错误状态,否则 Agent 容易在各个页面临时发挥,同一种失败出现不同交互。
TECHNICAL_ARCHITECTURE.md 同时放 PostgreSQL DDL、Supabase RLS 策略,以及带类型的 REST、Server Actions API 契约和 Zod 校验。作者特意把数据库结构和接口契约放在一起:字段或请求形状发生偏移时,更容易在同一处发现。
AI_AGENT_IMPLEMENTATION.md 则规定分阶段实现流程,并要求 Cursor、Claude Code 或 Windsurf 遵守前三份文件:使用指定表名和 payload,不绕过 RLS,发现冲突时报告,而不是默默挑一个答案。
其中,报告冲突这条尤其有价值。比如产品规格允许跨工作区查看数据,RLS 却只允许当前工作区访问,Agent 应当把矛盾交回团队处理。自行选边,可能把规格问题藏成实现缺陷。
这套方案的重点也不在文件数量,而在约束能否落到实现上。Schema 可以让不匹配的查询报错,Zod 可以校验输入;只有文字写着「必须一致」,约束仍然需要靠执行和检查才能成立。
我的判断
我赞同作者把注意力从「怎么问模型」转向「哪些工程决定还没做」。尤其是数据库、API 和权限,它们彼此牵连,适合提前明确。
作者给出的自检问题也值得保留:两位合格工程师只看这份规格,能否得到相同的表结构和 payload?如果不能,就说明还有重要决策依赖口头理解。
但「没有东西可编造」和「零幻觉」都超出了原文证据。规格完整,Agent 仍可能误读规则、漏掉校验或错误实现权限。Schema 能约束结构,也不保证业务规则正确。四份文件之间同样可能产生矛盾,还需要有人维护。
原文没有给出错误率、返工次数,也没有比较「四份文件」「单份完整文档」和「从现有代码提取契约」的效果,因此它目前是一套工程经验,不能据此认定四文件方案更优。对已有项目,数据库迁移、类型定义和现有校验代码也应成为约束来源,否则再写一套文档,反而可能增加不同步的地方。
另外,文章带有明确的产品推广:注册赠送 50 credits,无需银行卡,价格从 ৳99/month 起,支持 bKash/Nagad,也提供 GitHub 免费模板。不到 60 秒描述的是生成速度;生成结果是否完整、能否直接用于项目,原文没有给出验证。
能拿来做什么
- 给 AI 编程助手安排跨前后端功能前,先写清表名、外键、请求和响应结构,以及权限检查位置,再用作者的「两位工程师」问题检查歧义。
- 做前端页面时,把空状态、加载状态和错误状态一起交付给 Agent,并说明各状态的触发条件,减少页面之间的随意实现。
- 在 Node、REST 或 Server Actions 开发中,把类型和 Zod 校验对照数据结构一起审查;payload 通过结构校验,也仍需检查访问权限。
- 在 Agent 执行规则里明确要求:规格冲突时指出具体文件和条目,等待决策;实现完成后,再检查关键权限与接口行为是否符合约定。