高質(zhì)量軟件需求文檔的生成之道

井濤

摘要 需求是軟件開發(fā)的基礎(chǔ)，其載體是需求文檔，文檔質(zhì)量的高低就決定了軟件的質(zhì)量高低和生存周期的長(zhǎng)短，因此任何單位都會(huì)下大力氣提升軟件需求文檔質(zhì)量。

【關(guān)鍵詞】需求開發(fā) 需求分析 需求評(píng)審

軟件開發(fā)過程中，需求開發(fā)和分析是最早開始的工作，需求文檔是整個(gè)軟件開發(fā)的依據(jù)和基礎(chǔ)，其質(zhì)量高低決定了軟件的成敗。眾所周知，越到開發(fā)的后期，為糾正或彌補(bǔ)需求錯(cuò)誤所付出的代價(jià)就越大，且會(huì)呈幾何級(jí)數(shù)增長(zhǎng)。據(jù)相關(guān)研究表明，在信息傳遞過程中，如果沒有采取措施，信息衰減的最大值能達(dá)到60%。即使是面對(duì)面交流，需求分析人員也難以100%理解客戶的真是意圖，有數(shù)據(jù)甚至顯示，經(jīng)過多層溝通后，軟件開發(fā)人員僅能獲得用戶真實(shí)意圖的8.4%。因此將用戶的需求固化在軟件需求文檔，并提高需求文檔的質(zhì)量是每個(gè)單位特別關(guān)注的重點(diǎn)。

1 需求文檔的產(chǎn)生過程

軟件開發(fā)一般需要經(jīng)歷需求分析階段、設(shè)計(jì)階段、編碼階段、測(cè)試階段、驗(yàn)收交付階段五個(gè)階段，后續(xù)還有維護(hù)階段，而需求分析階段產(chǎn)生的需求文檔，是后續(xù)幾個(gè)階段的依據(jù)和必備條件。需求文檔是需求分析階段的工作產(chǎn)品，是需求開發(fā)和分析的結(jié)果，是用戶和開發(fā)人員之間交流的橋梁，也是設(shè)計(jì)和編碼的基礎(chǔ)，又是測(cè)試和驗(yàn)收的依據(jù)。需求文檔需精確地闡述一個(gè)軟件必須提供的功能、性能、設(shè)計(jì)和實(shí)現(xiàn)的限制條件，并盡可能完整地描述軟件預(yù)期的外部行為和用戶可視化行為，還需包括設(shè)計(jì)、構(gòu)造、測(cè)試或工程管理的細(xì)節(jié)。一般需經(jīng)歷如下幾個(gè)過程：

1.1 需求開發(fā)過程

需求開發(fā)的主要目的是全面發(fā)掘用戶的需求，盡量避免后期的需求變動(dòng)，一般采用現(xiàn)場(chǎng)調(diào)研、調(diào)查問卷、樣機(jī)、樣例等方式，此時(shí)的需求都是從用戶的角度提出，盡量保證全面，不要求詳細(xì)、具體。一般采用任務(wù)書的書面形式確定開發(fā)任務(wù)，任務(wù)書是后續(xù)需求分析、軟件系統(tǒng)測(cè)試、軟件驗(yàn)收的重要依據(jù)。

1.2 需求分析過程

軟件需求分析就是解答軟件做什么的問題，本過程是需求文檔形成的主要過程，是在前述任務(wù)書確定了開發(fā)任務(wù)的基礎(chǔ)上，對(duì)用戶的需求進(jìn)行去粗取精、去偽存真、正確理解，然后把它用軟件工程開發(fā)語(yǔ)言（形式功能規(guī)約，即需求規(guī)格說明書）表達(dá)出來的過程。這個(gè)過程中需要明確每個(gè)功能的具體要求，例如，如何操作、如何展示結(jié)果、界面的樣式、要求、通信協(xié)議、接口、處理的數(shù)據(jù)、功能間的交互關(guān)系等等，最后一般是以軟件需求規(guī)格說明書的形式呈現(xiàn)全部分析結(jié)果。

1.3 需求評(píng)審過程

主要是從用戶的角度和軟件設(shè)計(jì)的角度，由用戶、軟件設(shè)計(jì)人員共同對(duì)需求規(guī)格說明和初步的用戶手冊(cè)進(jìn)行評(píng)審，以確保軟件需求的完整、準(zhǔn)確、清晰、具體，并使用戶和軟件設(shè)計(jì)人員對(duì)需求規(guī)格說明和初步的用戶手冊(cè)的理解達(dá)成一致。因此，任務(wù)書和需求規(guī)格說明形成后，均需進(jìn)行需求評(píng)審，評(píng)審文檔中的每一條需求是否符合用戶要求、是否有遺漏、是否模糊、前后是否一致、是否無歧義等，使開發(fā)方和用戶方的理解達(dá)成一致，并固定用戶需求。

2 需求文檔產(chǎn)生過程易忽視的問題

需求文檔的產(chǎn)生的三個(gè)過程，理論上可以保證需求文檔的質(zhì)量，實(shí)際實(shí)施時(shí)會(huì)有較多的原因?qū)е驴刂剖?，甚至?xí)?dǎo)致需求與用戶的要求南轅北轍，造成這種情況的主要原因存

2.1 需求不是來自直接用戶

例如，征集需求時(shí)只收集了訂購(gòu)方的意見，未能面對(duì)真正的使用用戶，導(dǎo)致訂購(gòu)方的需求不能代表最終用戶的需求;而對(duì)那些無特定用戶的軟件，則采取閉門造需求等。

2.2 需求分析人員技能不足

分析需求時(shí)未能真正了解到用戶的具體要求，例如，用戶要求保密功能，需求人員對(duì)保密缺乏相關(guān)知識(shí)，使得只設(shè)計(jì)了密碼登陸的功能，未能提出更多的需求分析問題征集到用戶的不同角色權(quán)限不同、數(shù)據(jù)保密、密碼長(zhǎng)度、強(qiáng)度等要求全面的保密需求。

3 提高需求文檔質(zhì)量的措施

為解決上述需求過程中發(fā)生的問題，需要加強(qiáng)質(zhì)量控制，不僅對(duì)最終產(chǎn)品控制質(zhì)量，更加需要從過程中進(jìn)行控制質(zhì)量，主要的控制點(diǎn)：

3.1 需求開發(fā)過程是否合理

（1）是否制定了需求開發(fā)計(jì)劃，計(jì)劃的合理性經(jīng)過評(píng)審;

（2）需求開發(fā)的執(zhí)行人是否有相應(yīng)的技能;

（3）選擇的調(diào)查對(duì)象是否能代表最終用戶的意見;

（4）是否采用了規(guī)定的方法、流程、模板、表格等;

（5）是否未經(jīng)調(diào)查直接編制需求文檔。

3.2 需求分析過程是否合理

（1）是否制定了需求分析計(jì)劃，計(jì)劃的合理性經(jīng)過評(píng)審;

（2）需求分析人員是否具備相應(yīng)技能;

（3）是否采用了規(guī)定的或者合適的需求分析方法;

（4）是否采用了規(guī)定的模板、表格;

（5）是否針對(duì)軟件的行業(yè)特性制定了相應(yīng)的分析措施。

4 需求文檔質(zhì)量的制度和資源保障

需求文檔的質(zhì)量，除了具備過程質(zhì)量控制、工作產(chǎn)品質(zhì)量控制的技術(shù)條件，更需要健全的制度、充足的資源保障，需考慮建立以下制度：

4.1 建立合理的制度

需求文檔的質(zhì)量一般在軟件研發(fā)的后期才能體現(xiàn)，需求形成過程的所有檢查都要以制度的形式固化，并對(duì)需求開發(fā)、分析、評(píng)審等過程規(guī)定具體、可行的方法;

4.2 制定需求指南

從需求的獲取方法、分析方法、表述方法等方面制定適合本單位的詳細(xì)的指南，比如，盡量采用圖、表、原型;構(gòu)建業(yè)務(wù)場(chǎng)景;建立術(shù)語(yǔ)表，由于需求采用自然語(yǔ)言的特性，同一詞語(yǔ)，在不同語(yǔ)境下的意思會(huì)完全不同，因此術(shù)語(yǔ)表，不止是對(duì)業(yè)務(wù)領(lǐng)域內(nèi)特有的專用術(shù)語(yǔ)，對(duì)一些平常可見的、通用的術(shù)語(yǔ)，同樣要定義，避免歧義。如“系統(tǒng)”一詞，有時(shí)是軟件本身，有時(shí)有指軟、硬件結(jié)合體、有時(shí)又是指多個(gè)組件的結(jié)合體。

5 高質(zhì)量需求文檔具備的特征

好的需求文檔應(yīng)具備如下特征：

5.1 完整、正確性

每一項(xiàng)需求的功能都描述清楚、準(zhǔn)確、無沖突，使后續(xù)開發(fā)、測(cè)試人員獲得所有必要信息。

5.2 可行性

每一項(xiàng)需求都必須能在己知能力和約束條件內(nèi)實(shí)現(xiàn)，對(duì)于技術(shù)上無法實(shí)現(xiàn)，或者成本上無法負(fù)擔(dān)的需求，則不可行。

6 結(jié)束語(yǔ)

高質(zhì)量的需求文檔是軟件研發(fā)成功的基礎(chǔ)，在實(shí)踐過程中，需持續(xù)進(jìn)行經(jīng)驗(yàn)總結(jié)和改進(jìn)并以模板、指南、制度的形式固化，是一個(gè)不斷改進(jìn)的長(zhǎng)期過程。

參考文獻(xiàn)

[1]覃征，軟件項(xiàng)目管理[M].北京：清華大學(xué)出版社，2009.

[2]張海潘.軟件工程導(dǎo)論[M].北京：清華大學(xué)出版社，2005.

[3]（澳）麥斯阿塞克，需求分析與系統(tǒng)設(shè)計(jì)[M].北京：機(jī)械工業(yè)出版社，2009-09.