基础篇
进阶篇
高频篇
精选篇
手写篇
面经篇
AI 篇
原理篇
每日一题
小程序题库
  • 知识卡片碎片时间过考点
  • 场景篇按分类整理的大前端场景考点
  • 历年面经按年份追踪真实考点
  • 算法题库NEW在线编码即时判题
  • 专项自测100 题快速查漏
  • 前端基础
    • HTTP从报文一路讲到 HTTPS
    • 浏览器渲染、事件循环、进程
    • 计算机基础Linux、网络、操作系统
  • 进阶专项
    • 设计模式23 种模式怎么用
    • 前端系统进阶学习大型项目工程化
    • 前端综合文章长期沉淀的实践文
  • 工程与工具
    • Node学习指南从环境搭建到服务端
    • NPM工作流script、依赖与发布
    • Docker容器化部署上手
    • Canvas图形与动画实战
  • 路线与导图
    • 思维导图知识点全景图
    • 学习路线按图索骥不跑偏
  • 动态
    • 公众号动态公众号历史文章
    • 博客动态站长的技术博客
    • 开发者导航常用工具与文档站
    • AI 热点每日 AI 资讯与动向
AI 工作台
旧版
AIHT
内容
精选全部 AI 动态热点榜AI 日报收藏
分类
模型行业编程产品技术观点开源
更多
Agent 接入
返回首页开发者导航
AIHT
精选 / 资讯详情
8.0
热点
AI SCORE
编程提效2026-11-16 12:51

给编程代理写规格,先锁定数据与接口

dev.to · AI#Claude Code#Cursor#需求规格
Editor brief · 编辑速览

文章建议为 Cursor、Claude Code 准备包含需求、数据库结构、API 契约和规则文件的规格,减少跨会话实现漂移。具体做法包括给需求编号并附验收检查,写明外键、约束及行级安全策略。

文章思维导图
Knowledge map
拖拽缩放
AI deep read

AI 深度解读

把需求交给 Cursor 或 Claude Code,第一天生成的页面能跑,第二天接着改,字段名、接口返回值和权限判断却开始各走各的。作者把这类偏移归因于规格留白:开发者没有提前决定的事,Agent 就会自行补齐,而且每次补的未必一样。

这篇 2026 指南建议,把交给 Agent 的材料补成四部分:需求、数据库结构、接口契约、规则文件。它值得借鉴的是如何减少猜测;至于效果有多大,原文没有给出实测对照,文末还包含自家生成工具的推广,需要分开看。

为什么只有功能需求,Agent 还是会越写越偏

作者归纳了三种失败模式。

第一种是编造数据结构。规格没有表名、列名和关联关系,Agent 就在实现过程中临时设计,后续会话又可能生成另一套。

第二种是接口形状漂移。同一个接口,在不同文件里返回不同字段,调用方只能不断补兼容逻辑。

第三种是安全规则遗失。行级安全(Row Level Security,RLS)、租户检查和权限限制,没有被固定成明确约束,跨会话修改时就可能消失。

这些问题有一个共同点:代码依赖的决定,没有进入项目材料。

需求写清功能,结构和契约写清边界,规则文件约束执行方式。

作者认为,应该在写代码之前把这些决定记录下来。不过,原文把普通 PRD 概括为只有需求,略显绝对。很多团队已经把数据库设计、接口文档和权限方案放在其他文档里,真正要检查的是 Agent 能否读到它们,以及它们是否一致。

四部分规格,怎样写到可以验收

需求首先要可检查。作者建议用 FR-1、FR-2… 编号,每条都配一个可观察的验收条件,例如「创建商品 X,库存为 20,列表显示库存 20」。这种描述让 Agent 有明确的完成标准,比「库存管理体验良好」更容易验证。

数据库部分要给出真实表名、外键和约束。使用 Supabase/PostgreSQL 时,RLS 策略也应放进同一份文档,并明确要求使用既定名称,不能自行新增字段。

接口部分覆盖每个 endpoint 或 Server Action:请求方法、路径、允许调用的人、用 Zod 定义的准确请求结构、成功返回结构,以及错误情况。作者还要求写明:契约与代码冲突时,以契约为准。

最后是放入 .cursor/rules 或 CLAUDE.md 的执行规则。下面这段约束了 Agent 遇到空白、冲突和验收要求时该怎么做:

1. Build only what the PRD requires. If a requirement is unclear, stop and ask — do not invent behaviour.
2. Use the schema's table and column names exactly. Never invent a column, table, or relationship.
3. Use the API contracts exactly. Never change a payload without updating the contract first.
4. Never bypass Row Level Security. Never use the service-role key in a user-facing endpoint.
5. After each requirement, run its acceptance check and report the result.
6. If the PRD, schema and contracts disagree, report the conflict instead of choosing silently.

尤其要看第 5 条:完成需求后必须执行验收并报告结果。否则,规则容易停留在「Agent 读过了」这一层。

作者用一个标为 2 分钟的虚构示例串起四部分。小店库存应用 ShopStock 的 FR-2 要求「记录销售后扣减库存,库存不能为负」;数据库用 check (stock >= 0) 约束,销售接口约定数量超过库存时返回 409,规则第 5 条再要求执行验收。

这个例子展示了同一条业务要求如何落实到不同层,但它是说明案例,不是生产验证。

我的判断

我认同这套方法对字段漂移和接口漂移的针对性。对于前端和全栈协作,提前固定请求与返回结构,通常比等页面、接口都生成完再统一名称更容易处理。

但有两个边界。

一是规则文件不能替代实际机制。写了「禁止绕过 RLS」,仍然要检查数据库策略和服务端权限;check (stock >= 0) 也没有交代并发销售时如何扣库存、如何稳定返回 409。原文没有展开这些实现细节。

二是文档数量不等于规格质量。作者称小应用四部分合计 2–4 页即可,也说已有 Notion/Docs PRD 的团队,补上结构和规则文件就能明显减少偏移。这些都是经验判断,没有对照数据。已有接口规范和迁移文件的团队,可以让 PRD 引用现有材料,避免多维护一份重复定义。

作者还称,手工整理需要一个晚上,Web Dev Mehedi 可从一段想法在 60 秒内生成四部分,并提供 50 个免费 credits。原文没有展示生成质量或一致性评测,速度不能证明规格正确。

能拿来做什么

  • 下次让 Cursor 或 Claude Code 开发功能前,给每条需求编号并补上验收条件,让「完成」有可检查的标准。
  • 在前端与 Node 接口协作中,先明确请求、成功返回和错误结构,再让 Agent 实现调用与处理逻辑。
  • 使用 Supabase/PostgreSQL 时,把表结构、约束和 RLS 策略一起交给 Agent,并检查实际实现是否遵守这些约束。
  • 给项目补一份规则文件,要求 Agent 报告文档冲突、先更新契约再改 payload,并逐条报告验收结果。
Original source

本文由 AI 通读原文后重新编写,观点部分为站内判断,细节以原文为准,来源 dev.to · AI,原文版权归原作者所有。

阅读原文
上一篇
混元发布低成本百万上下文模型
下一篇
部署大模型前,先算权重和 KV 缓存

资讯速览

dev.to · AI · 2026-11-16 12:51

AI 评分 8.0 / 10

相关标签

#Claude Code#Cursor#需求规格

继续阅读

  • Agent 审批恢复接口补上租户隔离
  • 混元发布低成本百万上下文模型
  • 部署大模型前,先算权重和 KV 缓存
  • Edge0 发布可下载的千亿参数编程模型
  • Codex 日志为何造成大量 SSD 写入