How to write PRD

How to write PRD

我有这个问题不是说为了人类写 PRD,而是为 AI 写 PRD。我想写一种 PRD,这个里面我们规定 AI 需要做的,边界权限等,然后我们坐等 AI 去根据文档去实现所有功能。而不是我们像个监工一样,总是时不时要看看 AI 写的对不对。

What is PRD

看了几篇文章,好像每个人理解的都不一样,主要区别是 scope。

比如我原本的理解,几乎就是一个设计文档。我有一个 feature,我需要如何修改 UI 界面,我需要增加怎样的功能,详细的列出来。但是网上对于 PRD 有不同层面的理解。

一种 PRD 文档,就是已经有了一个产品了,我们只需要加一个新功能,那么内容大致如下:

  1. overview,需求背景,stakeholder,大概要如何解决问题,要添加怎样的功能。都是梗概性,力求简洁。
  2. use case 或者说 用户画像,就是解决了那些用户的怎样的问题。用户的使用案例是什么
  3. 可以说一些功能设计了,比如 ux,ui 设计,需要在哪里加怎样的功能等等。然后可以把设计师的设计文档链接贴上,把工程师的设计文档链接贴上
  4. 需求排期,比如大概什么时候做,多长时间做完等等
  5. 上线检测,看看上线这个功能后,又怎样的变化。有何反馈
  6. 风险点,我看到有的文档还会说一些风险点。比如法律、用户使用习惯、程序开发影响点可能导致的 bug 等等。

一种 PRD 涵盖的范围很大,是一个全新的产品,看起来有点像商业企划书了。还会讲 vison

  1. 整个产品的背景,我们发现了怎样的用户需求,我们希望开发一个怎样的产品。
  2. vison,这个领域有多少用户量。商业逻辑是什么,产品变现逻辑是什么
  3. 产品交互图,大致的一个交互图。
  4. 产品具体的 feature,然后由于是一个新产品,因此需求很多,还需要排优先级
  5. 希望达到的里程碑事件

上面描述了 PRD 大致在写什么,还有很多文章通过 PRD 延伸出 PM 应该做什么,什么是好的 PM,好的 PRD 应该是怎样的。比如 PRD 应该是一个信息交流的平台,PM 使用 PRD 来传达自己的想法,让信息透明。

  1. 让各方能够知道需求的由来,理解了来由之后,才能有默契的高效的合作。
  2. 信任。知道 PM 不是拍拍脑袋瓜随便想出来的,需求是有背景的。

还有一些讨论,在于什么是正确的需求。

AI 能够理解理念么?

比如我们想说什么是一个好的 PM?什么是一个好的 PRD?什么是一个好的组织?这些问题更像是一个理念,这些理念当然可以写到纸面上,但是这些理念的权衡,AI 真的能够理解么?AI 真的能够权衡理念观念么?

或许我们对 AI 太苛刻了?毕竟人类也无法权衡理念。

如何更好的执行

下面是 figma 的一个 PRD 样例

https://www.figma.com/resource-library/product-requirements-document/?utm_source=chatgpt.com#_4-contextualize-strategic-goals

https://coda.io/@yuhki/figmas-approach-to-product-requirement-docs/prd-name-of-project-1

figma 给出的 PRD 普遍都具体些,都是针对某个小需求来做的。很适合我们作为 PRD,只有足够具体的明确的需求,AI 才能够执行好。当然对于人类可能也是这样,但是人类的隐含的 context 太多,因此人类可以在语言信息不完整的情况下,也能意会。AI 很像一个知识极其丰富、学习能力极强的、单纯的、木纳的小孩子。

今天我用 PRD 完成了前端的工作

我首先写了 RPD 文档,但实际上那个文档很短,基本上就是介绍前端需要做什么,后端需要做什么,就这些。我感觉那都不能称为一个文档了,因为他太细碎了,我把每个她需要改的文件地址都告诉他了,然后接口需要改什么字段也都告诉她了。我觉得我只是把 cursor 对话框里面的 prompt 放到一个文件里面了。

前端代码生成还不错,但是仍然有不少错误。

  1. ui 设计,我把 ui 设计图放到文档中了,AI 写出的按钮放错了位置。可能是他的图像识别有一点问题?我不太清楚图像识别出的信息是什么,各个组件的位置关系?
  2. 第二个就是代码逻辑,当然那个可能也不算错误吧,可能是另一种实现方法。这个是我的文档中的缺失。如果我能明确写出来,那么他可能直接就能搞定。

后端的问题,逻辑方面,我就自己写了。我觉得自己写可能比 AI 更快点。关键的是我很难描述我要做的东西。我说的难,是指我需要花很多口舌,去描述我的需求是什么,每个字段应该如何设计,每个字段意义,业务逻辑是什么。如果我真的把这些都描述清楚,我认为还不如我直接编码呢。

能否让 AI 自己设计代码?

我们总是把需求设计好了,字段设计好了,ui 设计好了,然后才告诉 AI 怎么做。

我们是否能直接把需求告诉 AI,让他扫描代码库,让他自己出方案,我们评估方案,最终确定方案后,AI 自己生成 PRD 文档,自己去执行,调试呢?

Read more

乱世华尔街

乱世华尔街

作者用小说体的风格描述了他在 08 年左右的华尔街见闻,作者幽默风趣,文史积累丰厚。 经济不是数学模型,经济是贪婪与恐惧 如果经济如经济学家、数学家所建立的模型一样发展,那么将永远不会发生经济危机。经济学家预测地震与飓风同时发生的概率微乎其微,两者根本没有任何关联。但是在人类世界,“经济地震”却会多米诺骨牌般的引发“经济飓风”、“经济海啸”、“经济沙尘暴”…… 前台,后台 到了华尔街之后我才发现,虽然“身在赌场”,可我的工作与“押宝下注”毫不沾边。我所在的部门属于“后台”(back office),与直接负责融资交易的“前台”(front office)完全不是一回事,待遇也差别很大。形象地说:前台负责战斗,后台负责保障支援,虽然陈老总说过:“淮海战役的胜利是人民群众用小车推出来的”,可立功受奖的都是解放军战士。中央军委的新年嘉奖令上写得明白:解放军指战员,每人慰问一斤猪肉,五包香烟;支前群众,每人一包香烟。投资银行发放年终奖金,也照此办理。

By Keboom007
臣服实验

臣服实验

别毁掉自己的生活 突然想到公司门下的两个商店超市 他们之间的差别就挺大的,一个是雇佣制度的 711,员工就是来打工的,很像机器人,没人味。一家是自己盘的店面,自己开超市的,自己就是个体户,看状态就非常放松,会嬉笑打闹。 我们可以说 711 的制度,那种冰冷的制度,让员工也变成冰冷的机器。可是生活终究是自己的,如此度日,终究是伤害了自己的生活。大家都讨厌上班,可如果总是充满怨气的工作,充满怨气的与人打交道,一天中大部分时间都在怨气中度过,这不是一种好的生活。就当是为了自己的生活,都应该笑着玩,玩游戏就是“啸”着玩嘛! 平静 作者这个臣服实验,感觉有种平静,这种平静,如果你用来干任何事情,或许都会比别人做的好 如果你比别人做得好,那么你凭什么不能得到很多人的青睐呢 不管是哪家哲学,都是叫人平静的。平静中,人有佛性?神性? 超脱 感觉作者就是很超脱的那种性格的人。做事情不太会有很强的目的性。就是单纯随心而动。随遇而安的那种人。 比如胖东来,

By ke wang

playwright

对于开发者来说最实用的 MCP,claude code 可以自动调用 playwright 开启浏览器,抓取 console、network,帮助我们 fix bug 或者开发代码。我平时遇到的原型图比较少,所以如果你有界面的设计图,还可以让 playwright 截图,自己去调整 UI。 以下是一些常见用法: 爬取文档 某些文档我们需要登录才能打开,直接让 AI 进行 websearch 抓不到页面,那么这时使用 playwright 就是很好的选择。还有一种更彻底的: https://github.com/hangwin/mcp-chrome 这个项目可以直接 copy 当前浏览器的 cookie,直接“免登录”了。 Help dev 修复 bug,可以直接让

By ke wang
claude code practice

claude code practice

工具只是作为工具,关键在于使用者的思维方式。如果你把他当做一个只会写写增减某个字段的基础工作者,那么他就只是一个基础工作者。但如果你把他当成一个能够进行市场调研、需求分析、代码设计、代码执行、检验效果等等的各种角色的话,那么他就是会这些角色。 很简单的,如果还是把 AI 当做一种文章总结工具,那么他也就是总结工具了。但是如果你在思考他作为某个人类角色,他应该做什么时,那么他其实就是你的“伙伴”了。这一点我在创建 claude code 的 subagent 时慢慢有所体会。 怎么用 我是用的拼车,Claude code Max 20X,六人车,每个人 398 软妹币 插件 插件最大的好处就是很方便引用代码块,而且我觉得能够引用代码块这件事很重要,你引用的代码块越精准,AI 才能更好的理解你要做什么。 cursor 上 claude code 插件在 cursor 上是旧版本,需要从

By Keboom007