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

科学上网

科学上网

关于科学上网,只要在互联网公司,一般来说,问问研发同学,就都知道如何翻墙了。我们讲点进阶的知识。 * 美国手机号 * 海外银行卡 * 干净的 IP 如果你有更好的科学上网的方案,欢迎补充:https://github.com/kekeboomboom/haoel.github.io,这个项目来源于陈浩老师,让我们一起来继续维护这个项目。 美国手机号 Ultra mobile 我最近用 Ultra Mobile 这个手机卡,目前接受验证码都是挺快的,很稳定。但是这个卡的风控很严,你需要用干净的 IP 访问他们的网站或者 app 才能登录,否则很容易就各种奇怪的报错,或者登录失败等等。还有一点很烦人的是,最近他总是给我发 voicemail,说我国际漫游没有积分了,但是我买的这个 PayGO 的计划中是本来就没有国际漫游的,然后我登录他的 APP 和官网之后,也看不到国际漫游的充值选项,真的是让人恼火。

By Keboom007
《程序员软技能》—书

《程序员软技能》—书

这是一本关于程序员自我营销的书籍,有关程序员职业发展过程中遇到的一切。比如编程语言、开发工具、技术发展、职场发展、职场软技能等等,总之你能在工作中遇到的一切主题,都可以展示出来,都可以通过自媒体的方式展示出来。 好像互联网相关的从业人员,更容易利用自媒体进行自我营销呢?比如除了程序员,我们也能看到很多产品经理相关的网站、UI 设计相关的网站。近年来由于知识付费习惯的养成,很多金融领域的博主、高校政治哲学教授等,也在做自媒体内容。 自媒体社交 自媒体是百利而无一害的事情,我提倡大家都应该去做,去产出好的内容,让良币驱逐劣币。 自媒体应该是一种新型的社交方式,在没有互联网的年代,要积累个人声望,要通过各种实际的聚会、交往,慢慢积攒声望。 现在呢,我们可以足不出户,就可以发布自己的言论,自己的内容,可以影响他人,获得自己的粉丝。这是一种新型的、威力巨大新型社交方式。 再次提倡,每个人都应该去展现自己,如果你不展露自己,别人怎么了解你呢?别人可以快速的了解我们,我们可以快速的构建信任,我们可以找到更多志同道合的人,我们可以认识更多有趣的人,多好的一条解放之路呢? 作者的网站

By Keboom007
Prompt skill

Prompt skill

A post that introduce cursor prompt Cursor 内部提示词窥探 | Superlinear Academy课程里提到可以用自定义模型来看提示词,写了篇文章详细记录一下 Cursor 的 agent 模式本质上就是 VSCode(引入对话的交互) + 大模型(Claude 3.7 Sonnet 等) + tools use(读文件、写文件、搜索文件) + 提示词。 这篇文章利用 Cursor 的自定义模型来查看一下每次对话时 Cursor 自动填充的提示词。 环境准备 ollama 安装 https://ollama.com/,一个可以方便的本地运行开源大语言模型的软件。 安装完成之后在命…Superlinear Academy 这是社区里面的一篇文章,他直接本地部署了一个模型,让 cursor 调用本地模型,查看

By Keboom007
行知合一

行知合一

行知合一(新的理解方式) 或许其他人也经历我这个阶段,感觉上看的书也不少了,当然是那种通识知识,就是说基本上我再去看书,很多道理上的东西,我基本上都是没有新概念了。 那些大道理、通用的、共性的东西,每个人都在说,因此很多书都在讲一样东西,让人看了很无趣了。我说的是少了获得新知的兴奋,这让人无趣。很多道理我也都听到过了,我觉得在接着去看书,我不那么开心了,因为我认为不那么有趣了,当然我说的是通用知识。 有些书,比如金刚经,更多的是让人处于一种能量场,比如我在看金刚经,我本身就会被金刚经影响,我的内心就会更平静,思绪更宁静。还有很多小说,比如我在读《四世同堂》时,同学说我为何那么失落。比如我在读《老人与海》,我就特喜欢刀子般的北风吹在脸上,好似自己在抗争什么,感觉自己就像那个死死攥紧渔线、将手掌勒出深痕的老人。 在上面的视频中,提到的,知行合一,最开始灶爷的看法是,提高认知,由认知来指导行动,因此他认为应该先看很多书,然后再去行动。 这种看法也大概是很多人的看法吧,总觉得应该先提高认知,然后才能去行动。

By Keboom007