如何寫一份讓開發(fā)工程師【淚流滿面】的PRD產(chǎn)品需求文檔？

時(shí)間：2023-11-30 04:24:01 | 來源：網(wǎng)站運(yùn)營

時(shí)間：2023-11-30 04:24:01 來源：網(wǎng)站運(yùn)營

如何寫一份讓開發(fā)工程師【淚流滿面】的PRD產(chǎn)品需求文檔？：我們都知道一份完整的PRD，面向閱讀人群有：設(shè)計(jì)師、市場(chǎng)、運(yùn)營、測(cè)試、研發(fā)、領(lǐng)導(dǎo)…那在實(shí)際工作中，真的會(huì)有這么多角色來看你的PRD嗎？

其實(shí)，因?yàn)榛ヂ?lián)網(wǎng)快速迭代的原因（我曾經(jīng)負(fù)責(zé)的產(chǎn)品每周發(fā)版），一方面閱讀落到做這件事的研發(fā)頭上，一方面PM也沒有充裕的時(shí)間去思考和完善PRD中那些為了某些非核心閱讀人員看的內(nèi)容。

所以，我這里說的主要是：如何寫一份看上去清晰，研發(fā)容易理解的PRD。

那么研發(fā)在看一份PRD的時(shí)候到底關(guān)注什么？經(jīng)過這幾年我與不同崗位、不同層級(jí)的研發(fā)同學(xué)深入溝通和交流，總結(jié)為以下幾點(diǎn)：

1、為什么做這個(gè)？
團(tuán)隊(duì)中少數(shù)研發(fā)會(huì)很關(guān)心這個(gè)問題，他們不愿意盲目去寫代碼。
2、業(yè)務(wù)關(guān)系是什么樣的？
這個(gè)功能涉及到的整體業(yè)務(wù)流程和系統(tǒng)架構(gòu)是什么。
3、頁面長什么樣子？
頁面很大部分決定前端的工作量，大部分后臺(tái)同學(xué)也習(xí)慣于通過前端頁面去評(píng)估。
4、數(shù)據(jù)從哪里來？
從后臺(tái)來？從其它事業(yè)部來？還是從合作的第三方API拿？亦或是人工上傳？

當(dāng)然，研發(fā)同學(xué)肯定關(guān)注的問題不只以上4點(diǎn)，但一開始這4點(diǎn)說清楚了，基本上這個(gè)文檔就很容易讀下去了。

曾經(jīng)一位研發(fā)總監(jiān)給我一個(gè)建議： PRD先畫一個(gè)整體流程圖，不要一上來就說具體功能，不然很容易就產(chǎn)生“這個(gè)功能好復(fù)雜好難”的潛在心理暗示。 我深表贊同！

那么接下來，就實(shí)際說一下，滿足以上條件的PRD到底怎么落地去寫。

一、需求背景

解釋一下為什么做這個(gè)需求？我們遇到的問題或現(xiàn)狀是什么樣的，我們做這個(gè)需求是為了解決什么具體問題的。 盡量用大白話描述，不用太書面化。

這么幾年工作下來，大概感覺是研發(fā)團(tuán)隊(duì)中其實(shí)不到50%的人在意這個(gè)需求背景，一大部分研發(fā)還是習(xí)慣于直接看功能描述，看怎么做，偏向于單純的寫代碼。

二、產(chǎn)品目標(biāo)

1、功能目標(biāo)

描述一下這個(gè)需求具體要實(shí)現(xiàn)什么功能，這里的描述類似于一句話給別人介紹你這個(gè)產(chǎn)品。

2、數(shù)據(jù)目標(biāo)

現(xiàn)在這個(gè)時(shí)代下，不關(guān)注數(shù)據(jù)的產(chǎn)品迭代行為都是耍流氓。你可以不完全依靠數(shù)據(jù)去做決策，但是必須知道你做的產(chǎn)品，核心衡量數(shù)據(jù)指標(biāo)是什么吧？即所謂的OMTM（one metric that matters）。

建議這個(gè)指標(biāo)不要超過3個(gè)，聚焦在核心路徑上 ，甚至最好是只有1個(gè)。

三、系統(tǒng)架構(gòu)&流程

這部分我認(rèn)為主要是用來向研發(fā)同學(xué)傳遞以下2點(diǎn)內(nèi)容：

1、功能的邏輯流程

基本等同于從用戶使用角度的用例流程。

2、各個(gè)端之間的交互

前端、后臺(tái)、算法等是怎么交互的。像機(jī)器人產(chǎn)品就更復(fù)雜了，大范圍劃分要涉及到客戶端、機(jī)器人前端、機(jī)器人后端、服務(wù)器、語義平臺(tái)、云平臺(tái)等等。而某些機(jī)器人端功能更是要講核心板和算法板也劃分開。

建議是用泳道圖的形式來表現(xiàn)這部分內(nèi)容。

四、頁面 & 功能結(jié)構(gòu)

說白了就是功能的概覽圖，但是很多時(shí)候我們會(huì)面臨：這個(gè)概覽圖是按照頁面緯度還是功能緯度去劃分。

我的建議是，根據(jù)這個(gè)需求的實(shí)際表現(xiàn)情況， 如果涉及到超過5個(gè)以上大大小小的頁面了，那么建議從頁面緯度來劃分功能概覽 ；如果是主頁面就涉及到2、3個(gè)，那么從功能以及功能分支維度劃分可能更好一點(diǎn)。

五、最小化功能描述

這部分你就要開始詳細(xì)的描述一個(gè)功能點(diǎn)了。我一般會(huì)從以下幾方面來描述一個(gè)功能點(diǎn)。

1、 功能簡(jiǎn)介 ： 一句話說明這個(gè)功能要完成什么操作；
2、 原型圖 ： 如果有設(shè)計(jì)稿就直接放設(shè)計(jì)稿截圖部分；
3、 入口： 主要入口在哪里？同時(shí)要多想一下用戶還可能從哪些地方進(jìn)來，比如APP可能有PUSH消息直達(dá)；
4、 前繼條件： 進(jìn)入此功能需要滿足什么條件嗎？有什么必須帶入的參數(shù)嗎？等等此類說明；
5、 頁面或功能包含元素： 事無巨細(xì)的列出這個(gè)頁面或功能由哪些元素構(gòu)成；
6、 每個(gè)元素的屬性和作用： 純文本元素還是文字鏈？是否可被點(diǎn)擊；
7、 整個(gè)頁面和功能的交互規(guī)則： 點(diǎn)擊某個(gè)元素會(huì)觸發(fā)什么操作等描述；
8、 數(shù)據(jù)內(nèi)容從哪里來： 從后臺(tái)調(diào)取還是前端寫死？前端寫死的話此處要附上文案。

對(duì)一個(gè)功能如果以上8點(diǎn)描述清楚了，我相信基本就可交付開發(fā)了。

當(dāng)然，在這幾年實(shí)際迭代中，我發(fā)現(xiàn) 在PRD交付后，項(xiàng)目后期或者測(cè)試期間，最容易被問到的問題就是：沒數(shù)據(jù)了怎么辦？數(shù)據(jù)太多了怎么顯示？

此類問題，每次寫都嫌棄麻煩，但是不寫的話測(cè)試同學(xué)可是會(huì)給你提BUG的，況且還會(huì)影響產(chǎn)品功能和項(xiàng)目進(jìn)度。 建議勤快點(diǎn)，此類問題提取出來作為公共規(guī)則，在公司內(nèi)部建立公用文檔，每次需要的時(shí)候直接超鏈在PRD中即可。

以上希望對(duì)一些同學(xué)有幫助，如有其它寫作PRD的實(shí)戰(zhàn)經(jīng)驗(yàn)，歡迎交流。

以上內(nèi)容轉(zhuǎn)載自公眾號(hào)PM無漏法，作者是小七，希望能夠給你帶來收獲。

接下來我們來討論一下：

如何撰寫產(chǎn)品文檔？

產(chǎn)品經(jīng)理該如何高效輕松地撰寫產(chǎn)品文檔？摹客近期重磅推出的產(chǎn)品文檔在線撰寫功能，為產(chǎn)品經(jīng)理帶來了全新的產(chǎn)品文檔寫作解決方案。

摹客是一個(gè)產(chǎn)品協(xié)作設(shè)計(jì)平臺(tái)。從產(chǎn)品、設(shè)計(jì)、到開發(fā)，研發(fā)流程的每一個(gè)環(huán)節(jié)都可以匯聚到一個(gè)平臺(tái)，形成一個(gè)完整閉環(huán)。摹客將產(chǎn)品文檔在線撰寫無縫接入其柔性工作流，打造了一款自帶協(xié)作基因的產(chǎn)品文檔寫作神器，不僅可以幫助產(chǎn)品經(jīng)理高效寫作產(chǎn)品文檔，還能讓產(chǎn)品經(jīng)理充分深入到產(chǎn)品開發(fā)流程中來，極大地降低溝通成本，提升團(tuán)隊(duì)效率。

在線寫作模式

產(chǎn)品文檔沒有標(biāo)準(zhǔn)化的模板，因此，產(chǎn)品文檔寫作的自由度和流暢度很大程度上決定了文檔的效率。對(duì)此，摹客提供了全新的寫作模式：

• 富文本在線編輯，產(chǎn)品經(jīng)理可以像使用Word一樣編輯文案，并通過云存儲(chǔ)來實(shí)時(shí)查看和修改；
• 產(chǎn)品文檔中可插入線框原型或高保真設(shè)計(jì)稿，深度引用；設(shè)計(jì)稿在iDoc中有任何更新，文檔中也會(huì)自動(dòng)同步更新。

此外，產(chǎn)品經(jīng)理還可以直接上傳已編寫好的產(chǎn)品文檔，摹客會(huì)自動(dòng)解析目錄，并生成文檔樹，方便查閱。

和設(shè)計(jì)稿完美結(jié)合

產(chǎn)品經(jīng)理在寫作產(chǎn)品文檔時(shí)可插入設(shè)計(jì)稿，團(tuán)隊(duì)成員在設(shè)計(jì)稿上進(jìn)行評(píng)論時(shí)也可以引用產(chǎn)品文檔進(jìn)行說明，可以精確至引用文檔的某一部分，創(chuàng)建引用點(diǎn)，并標(biāo)記該內(nèi)容為高亮狀態(tài)，方便查閱。這樣，文檔、原型圖、設(shè)計(jì)稿就能無縫銜接，相互引用，無論是需求評(píng)審，還是開發(fā)時(shí)查閱，統(tǒng)統(tǒng)都能搞定。

多人在線協(xié)作、審閱

文檔編寫完成后，通過鏈接分享給團(tuán)隊(duì)成員，成員可對(duì)文檔進(jìn)行實(shí)時(shí)審閱，通過打點(diǎn)評(píng)論來標(biāo)記內(nèi)容，無需頻繁開會(huì)。

我們有準(zhǔn)備一份教程，歡迎去看看哦：添加產(chǎn)品文檔

偷偷告訴你，摹客的產(chǎn)品經(jīng)理們也一直在使用摹客管理產(chǎn)品文檔，幾位PM都覺得寫作效率明顯提升了，和設(shè)計(jì)師、開發(fā)工程師的交流也更加順暢了。

助力產(chǎn)品高效研發(fā)！點(diǎn)擊下方鏈接開始使用：