高質(zhì)量的需求文檔

《不是人人都可以做產(chǎn)品經(jīng)理》---什么是高質(zhì)量的需求文檔1目錄一、前言...2二、什么是需求？...2三、撰寫(xiě)需求文檔的目的是什么?.3四、什么是需求文檔？...3五、什么是高質(zhì)量的需求文檔（PRD）????4正確...4無(wú)歧義（無(wú)二義性）4完備...5一致...5具有優(yōu)先級(jí)...66. 可驗(yàn)證...67. 可修改...68. 可追蹤...7六、 參考文獻(xiàn)...7一、 前言本文基于fanny騰訊入職測(cè)試實(shí)習(xí)第三天的當(dāng)天感想與個(gè)人原有感悟。目的：更好的理解需求文檔的目的，了解高質(zhì)量的需求文檔如何撰寫(xiě)。本文針對(duì)互聯(lián)網(wǎng)尤其web領(lǐng)域的產(chǎn)品文檔、不針對(duì)游戲等領(lǐng)域。有錯(cuò)誤請(qǐng)各位及時(shí)指出！謝謝！文中有任何錯(cuò)誤，或者您有任何疑問(wèn)和建議，歡迎當(dāng)面一起討論。不吝賜教！為了拉高行業(yè)準(zhǔn)入門(mén)檻，提升行業(yè)薪資。故叫《不是人人都可以做產(chǎn)品經(jīng)理》。。本人blog:產(chǎn)品經(jīng)理新視線二、 什么是需求？其實(shí)我們沒(méi)有必要去思考什么叫做需求，因?yàn)檫@個(gè)議題太大了，無(wú)從談起。針對(duì)互聯(lián)網(wǎng)行業(yè)，我們所說(shuō)的“需求”特指“產(chǎn)品需求”。那么什么是產(chǎn)品需求？站在公司的立場(chǎng)上，需求是為了滿足領(lǐng)導(dǎo)分配的KPI,為了達(dá)到特定的經(jīng)濟(jì)效益，由產(chǎn)品經(jīng)理制定的一些列的產(chǎn)品描述。那么互聯(lián)網(wǎng)產(chǎn)品都滿足了哪些需求？如果按照產(chǎn)品來(lái)劃分，那么騰訊1300多產(chǎn)品各自滿足了不同的需求。從現(xiàn)有理論角度，根據(jù)馬洛斯的需求層次理論：我覺(jué)得互聯(lián)網(wǎng)產(chǎn)品滿足了人類(lèi)的精神性價(jià)值需求。傳統(tǒng)行業(yè)產(chǎn)品是滿足了人類(lèi)的物質(zhì)性價(jià)值需求。精神需求是否被滿足是依據(jù)用戶預(yù)期來(lái)界定的。這個(gè)是動(dòng)態(tài)平衡的過(guò)程，也就是說(shuō)互聯(lián)網(wǎng)產(chǎn)品的研發(fā)的道路是無(wú)止境的！而互聯(lián)網(wǎng)中的電子商務(wù)卻很復(fù)雜，從幾千年前就存在的傳統(tǒng)行業(yè)演變成了現(xiàn)在線上環(huán)節(jié)為主導(dǎo)的行業(yè)，電子商務(wù)傾向于滿足人類(lèi)物質(zhì)性的需求，這也是電子商務(wù)區(qū)別于一般互聯(lián)網(wǎng)的因素之一。本人更傾向于把電子商務(wù)從互聯(lián)網(wǎng)行業(yè)里面剝離出來(lái)看。。扯遠(yuǎn)了。。從更高的抽象層次來(lái)講：從人類(lèi)進(jìn)化角度，弱弱的-，-，我傾向于把人類(lèi)的需求單純的分為：-生存需求-繁衍需求。。。。扯遠(yuǎn)了下篇文章再展開(kāi)吧。。三、 撰寫(xiě)需求文檔的目的是什么?了解了需求文檔的目的才能更好的撰寫(xiě)需求文檔，才能有張有弛的去控制需求分析的粒度。我覺(jué)得其目的是:準(zhǔn)確的描述需求，使得產(chǎn)品最終形態(tài)與預(yù)期吻合。要達(dá)到這個(gè)目標(biāo)，需求文檔對(duì)需求的描述必須具備以下特征1.正確2.無(wú)歧義3.完備4.一致5.具有優(yōu)先級(jí)6.可驗(yàn)證（易于測(cè)試）7.可修改8.可追蹤這樣一看，編寫(xiě)高質(zhì)量的需求文檔是一件很難的事情。別著急，本文下文講詳細(xì)對(duì)每一個(gè)特征進(jìn)行解釋。四、 什么是需求文檔？ 業(yè)內(nèi)對(duì)于需求文檔有很多種理解形式：PRD、SRS。。。。一般騰訊所指的需求文檔都是PRD(productrequirementsdocument),MRD則更偏市場(chǎng)，SRS則更偏技術(shù)實(shí)現(xiàn)(含有數(shù)據(jù)流、時(shí)序圖等)。有時(shí)候也稱(chēng)需求文檔為“需求規(guī)格說(shuō)明書(shū)”，其實(shí)“需求規(guī)格說(shuō)明書(shū)”是傳統(tǒng)軟件行業(yè)里面用的叫法，如果需要寫(xiě)得規(guī)范一點(diǎn)，那么就需要按照國(guó)家標(biāo)準(zhǔn)的GB，ISO,IEEE的規(guī)范來(lái)撰寫(xiě)“需求規(guī)格說(shuō)明書(shū)”，但是那樣的文檔是十分重型的。在小步快跑，快速迭代的騰訊模式下，輕量的產(chǎn)品需求文檔更加符合騰訊。當(dāng)然這也不是絕對(duì)的。一般大型的項(xiàng)目還是需要有詳細(xì)，規(guī)范的，較重型的文檔來(lái)支撐的。需求文檔里面主要寫(xiě)什么?我覺(jué)得需求文檔里面主要的內(nèi)容是對(duì)需求的描述，通過(guò)用例去描述。而在騰訊并不是所有人都知道用例是什么，一般來(lái)說(shuō)都用“功能”、或者“特性”來(lái)代替描述用例。傳統(tǒng)軟件行業(yè)過(guò)來(lái)的人一般都知道吧。。。就是說(shuō)騰訊內(nèi)部對(duì)于“用例”，“功能”，“特性”并沒(méi)有形成一個(gè)統(tǒng)一的認(rèn)知。每個(gè)人的認(rèn)知不統(tǒng)一，這是一個(gè)比較大的問(wèn)題，我覺(jué)得必須不斷的加強(qiáng)這方面的規(guī)范。我覺(jué)得用例其實(shí)是UML建模中用例分析環(huán)節(jié)中的輸出物。UML建模是現(xiàn)代軟件產(chǎn)業(yè)常用的較敏捷的方法。適合產(chǎn)品生命周期較短的項(xiàng)目來(lái)使用。其實(shí)騰訊是蠻受用的。至于UML那一套體系是否適合騰訊，還需要實(shí)踐去論證。

產(chǎn)品需求文檔（PRD）重點(diǎn)描述一個(gè)被提議的新產(chǎn)品或者現(xiàn)有產(chǎn)品的改進(jìn)需求。與MRD側(cè)重于從市場(chǎng)需要角度看需求的不同，PRD側(cè)重于從產(chǎn)品本身角度看待需求。通常在特點(diǎn)和功能需求上更深入細(xì)節(jié)，并也可能包括屏幕截圖和用戶界面流程。在那些MRD不包括具體需求和用例的機(jī)構(gòu)中，PRD就包含這些具體內(nèi)容OPRD通常是由產(chǎn)品經(jīng)理撰寫(xiě)的OPRD通常是一份連續(xù)的1030頁(yè)Word文檔。在我看來(lái)需求文檔就是用例的集合。從表現(xiàn)形式來(lái)講需求文檔就是：一個(gè)用例列表+各個(gè)用例的詳細(xì)描述。用例的定義是：在不展現(xiàn)一個(gè)系統(tǒng)或子系統(tǒng)內(nèi)部結(jié)構(gòu)的情況下，對(duì)系統(tǒng)或子系統(tǒng)的某個(gè)連貫的功能單元的定義和描述[2]o一般用例主要包含以下條目：用例簡(jiǎn)述、用例優(yōu)先級(jí)、用例圖、執(zhí)行者、前置條件、后置條件、交互稿及其描述、主流程、分支流（異常流）、業(yè)務(wù)約束。五、什么是高質(zhì)量的需求文檔五、什么是高質(zhì)量的需求文檔（PRD）?總的來(lái)講高質(zhì)量的需求文檔就是能最有效的達(dá)到需求文檔撰寫(xiě)目的的文檔（太虛了。O）o即能夠有效協(xié)助產(chǎn)品干系人（視覺(jué)、交互、頁(yè)面、開(kāi)發(fā)、測(cè)試）完成與預(yù)期吻合的產(chǎn)品。上文中提到，需求文檔對(duì)需求的描述必須具備以下特征1. 正確2. 無(wú)歧義3.完備4.一致5.具有優(yōu)先級(jí)6.可驗(yàn)證（易于測(cè)試）7.可修改8.可追蹤而產(chǎn)品新人需要著重關(guān)注其中的：1、2、51.正確當(dāng)且僅當(dāng)PRD中的每一項(xiàng)需求都是產(chǎn)品應(yīng)滿足的需求，PRD才是正確的。不存在確保PRD正確性的工具或規(guī)程。宜把PRD與任何適用的上層規(guī)格說(shuō)明（如,立項(xiàng)文檔、項(xiàng)目計(jì)劃書(shū)、MRD）、其他項(xiàng)目文件和其他適用的標(biāo)準(zhǔn)進(jìn)行對(duì)比，以確保其相互一致。作為一種選擇，產(chǎn)品經(jīng)理可以確定PRD是否正確地反映了實(shí)際需要。可追蹤性使相應(yīng)的規(guī)程更加便利并減少缺陷。2. 無(wú)歧義（無(wú)二義性）我覺(jué)得需求描述的這個(gè)特性是產(chǎn)品經(jīng)理新人最需要注意的需求通常使用自然語(yǔ)言（如，漢語(yǔ)）來(lái)編寫(xiě)。但自然語(yǔ)言固有的不明確性，尤其是漢語(yǔ)這樣的每個(gè)詞有很多意思的語(yǔ)言。使用自然語(yǔ)言編制的PRD宜由獨(dú)立的一方進(jìn)行評(píng)審，以識(shí)別語(yǔ)言的含糊用法并予以糾正。這樣可以讓開(kāi)發(fā)減少疑惑，讓測(cè)試寫(xiě)的測(cè)試用例更加正確。為了消除歧義，其實(shí)可以使用需求文檔專(zhuān)用的語(yǔ)言的編寫(xiě)，但是這樣成本太大了。那么什么叫做無(wú)歧義？當(dāng)且僅當(dāng)PRD中的每一項(xiàng)需求都只有一種解釋?zhuān)琍RD才是無(wú)歧義的。這要求最終產(chǎn)品的每個(gè)特征至少使用唯一的術(shù)語(yǔ)來(lái)描述。當(dāng)在特定背景中使用的某個(gè)術(shù)語(yǔ)存在多種含義時(shí)，宜將該術(shù)語(yǔ)包含在術(shù)語(yǔ)表中，以便更加具體說(shuō)明其含義。正如在GB/T8566中描述的那樣，SRS是軟件生存周期中需求過(guò)程的一個(gè)重要部分，并被應(yīng)用于設(shè)計(jì)、實(shí)現(xiàn)、項(xiàng)目監(jiān)控、驗(yàn)證和確認(rèn)，以及培訓(xùn)活動(dòng)中。對(duì)于編制人員和使用人員。其中的SRS其實(shí)可以換成PRD,軟件可以換成產(chǎn)品，即:PRD是產(chǎn)品生存周期中需求過(guò)程的一個(gè)重要部分，并被應(yīng)用于設(shè)計(jì)、實(shí)現(xiàn)、項(xiàng)目監(jiān)控、驗(yàn)證和確認(rèn)，以及培訓(xùn)活動(dòng)中。對(duì)于各種產(chǎn)品相關(guān)人員。PRD宜是無(wú)歧義的。但是，產(chǎn)品干系人通常并不具備相同的背景，因而對(duì)產(chǎn)品需求的描述不會(huì)傾向相同的形式。尤其現(xiàn)在騰訊校園招聘的產(chǎn)品經(jīng)理幾乎很少有相同專(zhuān)業(yè)的。每個(gè)人可能有各自的描述風(fēng)格，這樣會(huì)降低團(tuán)隊(duì)效率。所以產(chǎn)品新人必須對(duì)需求描述的二義性有深刻的理解和感知。這也是為什么我覺(jué)得：需求描述的這個(gè)特性是產(chǎn)品經(jīng)理新人最需要注意的。3.完備3.當(dāng)且僅當(dāng)PRD包含以下要素，PRD才是完備的:a） 所有重要的需求，不論是否與功能、性能、設(shè)計(jì)約束、屬性或者外部接口有關(guān)。尤其是由系統(tǒng)條件所施加的任何外部需求都應(yīng)當(dāng)?shù)玫酱_認(rèn)和處理。b） 產(chǎn)品響應(yīng)的定義，以說(shuō)明產(chǎn)品對(duì)所有可實(shí)現(xiàn)的輸入數(shù)據(jù)類(lèi)型的響應(yīng)。應(yīng)當(dāng)注意，對(duì)于有效和無(wú)效輸入數(shù)值兩種情況，規(guī)定產(chǎn)品響應(yīng)是重要的。c） PRD中所有圖標(biāo)的全部標(biāo)記和索引，以及所有術(shù)語(yǔ)和度量單位的定義。任何含有“待定”詞語(yǔ)的PRD是不完備的。但是有時(shí)使用“待定”是不可避免的，若萬(wàn)一使用“待定”時(shí)應(yīng)做如下說(shuō)明：a）對(duì)導(dǎo)致使用“待定”的情形進(jìn)行描述（為什么答案未知），以便問(wèn)題能得到解決；b）描述為排除“待定”應(yīng)采取的措施、由誰(shuí)負(fù)責(zé)排除以及何時(shí)必須排除。4. 一致這里的一致是指內(nèi)部一致性。如果PRD與某些更高層的文檔（如，概要設(shè)計(jì)文檔）不一致，那么它是不正確的。但是這個(gè)不是一致性所涉及的，這個(gè)是外部不一致。當(dāng)且僅當(dāng)在PRD中描述的任何單個(gè)需求的子集之間相互不矛盾，PRD才是內(nèi)部一致的。PRD中可能存在下述三種類(lèi)型的矛盾顯示世界對(duì)象的規(guī)定特征可能相互矛盾。如：1)報(bào)告輸出的格式在一個(gè)需求中是表格形式，而在另一個(gè)需求中是文本形式；2)一個(gè)需求指出所有的燈是綠色，而另一個(gè)需求規(guī)定所有的燈是藍(lán)色。在兩個(gè)規(guī)定的行為之間可能存在邏輯上的或時(shí)間上沖突。如：1)一個(gè)需求規(guī)定程序?qū)?duì)兩個(gè)輸入相加，另一個(gè)需求則規(guī)定程序?qū)?duì)這兩個(gè)輸入相乘；2)一個(gè)需求指出“A”必須總是在“B”之后，而同時(shí)另一個(gè)需求中要求“A和B”同時(shí)發(fā)生?？赡軆蓚€(gè)或更多的需求描述現(xiàn)實(shí)世界的相同對(duì)象，但使用不同的術(shù)語(yǔ)。如，在一個(gè)需求中程序?qū)τ脩糨斎氲恼?qǐng)求成為“提示符”，在另一個(gè)需求中稱(chēng)為“提示”。使用標(biāo)準(zhǔn)術(shù)語(yǔ)和定義可以改善一致性。5.具有優(yōu)先級(jí)如果PRD中每條需求(用例)賦有標(biāo)明其優(yōu)先級(jí)的標(biāo)示，那么該P(yáng)RD便按照優(yōu)先級(jí)進(jìn)行分級(jí)。通常，與產(chǎn)品有關(guān)的所有需求并不具有相同的重要優(yōu)先級(jí)性。某些需求可能是基本的(即核心需求，最能驅(qū)動(dòng)利益增長(zhǎng)的需求，最能達(dá)到特定KPI的需求)而其他的可能是所期望的需求，可有可無(wú)。PRD中的每個(gè)需求宜予以標(biāo)識(shí)，以使需求在這方面的差異清晰和明確。另一種需求分級(jí)的方式是區(qū)別如下基本的、有條件的和可選的需求類(lèi)別：基本的——除非表示同意并滿足了這類(lèi)需求，否則產(chǎn)品將不被接受；有條件的——表示這類(lèi)續(xù)期會(huì)增強(qiáng)軟件產(chǎn)品，但是，如果缺少這類(lèi)需求，也不會(huì)導(dǎo)致軟件產(chǎn)品被拒收；可選的——表示該類(lèi)功能需求可有可無(wú)，這賦予開(kāi)發(fā)一定開(kāi)發(fā)彈性。6.可驗(yàn)證6.當(dāng)且僅當(dāng)PRD中的每個(gè)需求是可驗(yàn)證的，PRD才是可驗(yàn)證的。當(dāng)且僅當(dāng)存在某個(gè)有限的成本、有效的過(guò)程，人或機(jī)器依照該過(guò)程能夠檢查軟件產(chǎn)品滿足某個(gè)需求，該需求才是可驗(yàn)證的。一般說(shuō)來(lái)，任何有歧義的需求都是不可驗(yàn)證的。所以一般保證了“無(wú)歧義”就可以保證可驗(yàn)證，即關(guān)注“無(wú)歧義”是最重要的。不可驗(yàn)證的需求包含諸如“工作良好”、“好的人機(jī)界面”和“通常應(yīng)該發(fā)生”之類(lèi)的陳述。因?yàn)椴豢赡芏x“良好”、“好的”和“通?！?，因此，這些需求不可能驗(yàn)證。陳述“程序應(yīng)絕對(duì)不進(jìn)入無(wú)限循環(huán)”是不可驗(yàn)證的，因?yàn)槔碚撋显撎匦允遣豢蓽y(cè)試的。可驗(yàn)證陳述示例：程序輸出應(yīng)在時(shí)間開(kāi)始20s內(nèi)達(dá)到60%,在30s內(nèi)達(dá)到100%。這樣的陳述是可驗(yàn)證的，因?yàn)樗褂昧司唧w的術(shù)語(yǔ)和可測(cè)量的數(shù)值。需求描述一定要定量。如果不能設(shè)計(jì)出一種方法，以確定產(chǎn)品是否滿足某個(gè)具體的需求，那么該需求宜被刪除或被修改。7. 可修改當(dāng)且僅當(dāng)PRD的結(jié)構(gòu)和形式能夠?qū)θ魏涡枨筮M(jìn)行容易、全面和一致的修改,同時(shí)保持該結(jié)構(gòu)和形式，PRD才是可修改的。一般地，可修改要求PRD：具有連貫、方便使用的結(jié)構(gòu)，包含目次、索引及清晰的相互引用；沒(méi)有冗余(即，相同的需求在PRD不應(yīng)當(dāng)出現(xiàn)在多處)；c） 分別地表述每個(gè)需求，而不與其他需求相混淆。盡管冗余本事不是缺陷，但它容易導(dǎo)致錯(cuò)誤。盡管冗余偶爾可以有助于PRD的可讀性，但當(dāng)對(duì)存在冗余的文件更新時(shí)，可能會(huì)引起問(wèn)題。例如，可能對(duì)出現(xiàn)多處的某個(gè)需求僅在一處做了修改，那么使得PRD內(nèi)容不一致。當(dāng)需要冗余是,PRD宜包括一個(gè)清晰的交叉索引表，已增加其可修改性。8.可追蹤如果PRD每個(gè)需求的來(lái)源是清楚的，并在將來(lái)編制或增強(qiáng)文檔的過(guò)程中便于每個(gè)需求的索引，那么該P(yáng)RD是可追蹤的。推薦以下兩種類(lèi)型的可追蹤性：a） 逆向可追蹤性（即，到以前的開(kāi)發(fā)階段）。這依賴于每個(gè)需求清晰地指向其在早期文件的來(lái)源；b） 正向可追蹤性（即，到由PRD產(chǎn)生的所有文件）。這依賴于PRD中每個(gè)需求具有唯一的名稱(chēng)或索引號(hào)。當(dāng)軟件產(chǎn)品進(jìn)入運(yùn)行和維護(hù)階段時(shí)，PRD的正向可追蹤性尤為重要。隨著代碼好設(shè)計(jì)文檔的修改，最要緊的是能夠確定這些修改可能影響的全部的需求集合?？勺粉櫺院檬沟眯枨笞兏尤菀?。六、 參考文獻(xiàn)1】 計(jì)算機(jī)軟件需求規(guī)格說(shuō)明規(guī)范GB-T_9385-20082】 /view/706238.