别再把 Prd写成 Word 了

AI 时代的 Prd，应该是一份执行契约。

你有没有遇到过——

花半小时写完 PRD，丢给 Cursor。

AI 写出来的代码，和你想要的完全两回事。

你回头看 PRD，明明写了”做一个登录功能”。

但 AI 不知道要不要手机号登录、密码什么规则、要不要微信 OAuth、错误提示中文还是英文。

它猜了一堆，全猜错了。

这不是 AI 的问题。

是你的 PRD 的问题。

PRD 的三次进化

2025 到 2026 年，AI 开发圈对 PRD 的理解，经历了三个阶段。

第一代。写给人看。像论文一样，”本章节描述了某某系统的某某模块”。

第二代。写给 AI 看。本质上是个长 prompt，”帮我做一个登录功能”。

第三代。可执行。机器可解析、可验证、可追踪。Agent 自己读、自己做、自己验。

大部分人还在第二代。

但真正在卷的那批人，已经在做第三代了。

三个值得看的模板标准

我翻了 GitHub 上最热的几个 AI 开发工具包。

找到三个有代表性的。

一、BHIL Toolkit

最工业化。

整个开发流程是一条链：

PRD 定义 WhatSPEC 定义 HowADR 记录 WhyTASK 拆成 Steps然后 CODE、REVIEW、DEPLOY

每一环都用 YAML 元数据追溯。

PRD 里用户故事用 EARS 格式。SPEC 里有 API 契约的 JSON Schema。TASK 里标了每个文件是 create 还是 modify 还是 don’t-touch。

最狠的是 AI-native 专项：验收标准不是”功能正常”，而是”事实性得分大于等于 0.85，在 100 次运行中”。

二、Vibe Coding PRD Template

最轻量。

就一个 Markdown 规则文件。核心方法论：先追问，再写 PRD。

它默认 PRD 的读者是一个 junior developer。每一条需求都必须显式、无歧义，不依赖”大家都知道”的常识。

写完拆成 task list，AI 逐个执行，你说 yes 它才做下一个。

适合非技术 PM 快速启动。

三、Nexus Harness

最工程化。

不是模板，是一整条研发管道。PRD 生成由 Python 状态机驱动。

写完走三重质量门禁：

第一关，机械质检。脚本自动扫描。

第二关，自动修复。发现问题自己修。

第三关，语义审查。子 Agent 逐条审核。

PRD 不通过第三关，绝不进入下一步。

三个放在一起看

   BHIL           Vibe Coding     Nexus Harness

受众   应用开发者      非技术 PM        工程团队追溯   YAML 全链路    无               JSON 状态机质量   审批清单        无               三重门禁 + 子 AgentAI级   概率化验收      无               偏传统工程难度   中高            极低             最高

可执行 PRD 的十二个要素

一个能直接喂给 AI Agent 的 PRD，应该包含：

一、YAML Frontmatter机器可读的 id、status、sprint、parent。

二、Problem Statement一句话。只说问题，不说方案。

三、Target Users谁在用，在什么场景下用。

四、Solution Overview 与边界要做什么，同时明确不做什么。

五、User StoriesINVEST 原则。每一条带验收标准。

六、Functional RequirementsP0、P1、P2 分级。不是所有需求同等重要。

七、Non-Functional Requirements性能、安全、可用性。带数字，不带形容词。

八、Edge Cases边界情况。出错了怎么办。

九、Success Metrics基线、目标、时限。可测量，不可争论。

十、Out of Scope明确不做。防止范围蔓延。

十一、Dependencies and Risks依赖谁、怕什么。

十二、Release Plan功能开关、灰度、回滚。

进阶：Agent-Optimized Story

PRD Engine 提出了一种新格式：

每条 User Story 不仅描述功能，还告诉 AI：

files_to_touch: [src/db/schema.ts]commands_to_run: [tsc –noEmit, npm test]done_when: All verify commands pass

AI 知道自己要改哪些文件。

AI 知道用什么命令验证。

AI 可以自己判断是否完成。

这已经不是需求文档了。这是执行契约。

最后

第一代 PRD，写给人看。

第二代 PRD，写给 AI 看。

第三代 PRD，AI 自己读、自己做、自己验。

你的 PRD 还在第几代？

龙虾书童专注 AI 工程化实践每周一条让你少踩坑的方法论。

捎带手基于这些方法论，写了一个正向和逆向都可以的技能生产prd。https://github.com/xcxseric-ux/prd.git