如何編寫一個(gè)好的需求

1、如何編寫一個(gè)好的需求【各位讀友,本文僅供參考,望各位讀 者知悉,如假設(shè)喜歡或者需要本文,可點(diǎn) 擊下載下載本文,謝謝！】祝大家工作順利】如何編寫高質(zhì)量需求Karl E WiegerProcess Impact許多軟件需求說(shuō)明書(shū)寫得非常糟 糕.任何產(chǎn)品的質(zhì)量需要其原始材料的 質(zhì)量保證,糟糕的軟件需求說(shuō)明書(shū)不可 能產(chǎn)出優(yōu)秀的軟件.不幸的是,幾乎沒(méi) 有開(kāi)發(fā)人員受過(guò)與需求的抽象、分析、 文檔、質(zhì)檢有關(guān)的教育.而且,沒(méi)有非 常多的好需求可以借鑒學(xué)習(xí),局部原因 是很少有工程可以找到一個(gè)好的借鑒, 其他原因是公司不愿意將其產(chǎn)品說(shuō)明書(shū) 放在公共區(qū)域.這篇文章描述了高質(zhì)量需求表達(dá)和 說(shuō)明的幾個(gè)特性.我們將用這些觀

2、點(diǎn)檢 最新財(cái)經(jīng)經(jīng)濟(jì)資料感謝閱讀 1 精選財(cái)經(jīng)經(jīng)濟(jì)類資料 5 查一些有缺陷的需求,帶著痛楚重新編 寫.而且我會(huì)談一些如何編寫好的需求 的提示.你也許想通過(guò)這些質(zhì)量標(biāo)準(zhǔn)評(píng) 估你的工程需求.對(duì)于修訂,也許遲了, 但你會(huì)學(xué)到一些有用的東西,并幫助你 的小組在下次編寫出更好的需求.不要期望能夠編寫出一份能表達(dá)需 求應(yīng)具備的所有特性的 SRS.無(wú)論你怎 么細(xì)化、分析、評(píng)論和優(yōu)化需求,都不 可能到達(dá)完美.但是,如果你牢記這些 特性,你就會(huì)編寫出更好的需求,生產(chǎn) 出更好的產(chǎn)品.一、高質(zhì)量需求說(shuō)明書(shū)的特性我們?nèi)绾螐囊恍┯袉?wèn)題的需求中分 辨出好的軟件需求？判斷每個(gè)需求是否 具備應(yīng)有的特性的一種方式是由持有不 同觀

3、點(diǎn)的工程資金治理人所作的正規(guī)檢 查.另一種有力的方法是在編寫代碼前 依據(jù)需求編寫測(cè)試?yán)?測(cè)試?yán)幽軌?明確顯現(xiàn)在需求中描述的產(chǎn)品行為,能 夠顯現(xiàn)缺陷、冗余和模糊之處.？正確：最新財(cái)經(jīng)經(jīng)濟(jì)資料感謝閱讀每個(gè)需求必須精確描述要交付的功 能.正確性依據(jù)于需求的來(lái)源,如真實(shí) 的客戶或高級(jí)別的系統(tǒng)需求說(shuō)明書(shū).一 個(gè)軟件需求與其對(duì)應(yīng)的系統(tǒng)需求說(shuō)明書(shū) 相抵觸是不正確的.只有用戶的代表能夠決定用戶需求 的正確性,這就是為什么在檢查需求時(shí), 要包括他們或他們的代理的關(guān)鍵所在. 不包括用戶的需求檢查就會(huì)導(dǎo)致開(kāi)發(fā)人 員的：這是沒(méi)意義的,這可能是他們的意思等眾所周知 的猜測(cè).？可行性：在的水平、有限的系統(tǒng)及其環(huán) 境中

4、每個(gè)需求必須是可實(shí)現(xiàn)的.為了避 免需求的不可行性,在需求分析階段應(yīng) 該有一個(gè)開(kāi)發(fā)人員參與,在抽象階段應(yīng) 該有市場(chǎng)人員參與.這個(gè)開(kāi)發(fā)人員應(yīng)能 檢查在技術(shù)上什么能做什么不能做,哪 些需要需要額外的付出或者和其他的權(quán) 衡.？必要性： 最新財(cái)經(jīng)經(jīng)濟(jì)資料 感謝閱讀每個(gè)需求應(yīng)載明什么是客戶確實(shí)需 要的,什么要順應(yīng)于外部的需求,接口 或標(biāo)準(zhǔn).每個(gè)需求源于你認(rèn)可、具有權(quán) 說(shuō)明需求的原始資料,這是考慮必需的 另外情形.跟蹤每個(gè)需求回溯到出處, 如用例,系統(tǒng)需求,規(guī)章,或來(lái)自其他 用戶的意見(jiàn).如果你不能標(biāo)識(shí)出處,可 能需求只是個(gè)鍍金的例子,沒(méi)有真正的 必須.？?jī)?yōu)先權(quán)：為了說(shuō)明在一個(gè)詳細(xì)的產(chǎn)品版本中 應(yīng)包含哪些要點(diǎn)

5、,需要為每個(gè)需求,特 征,或用例分配實(shí)現(xiàn)的優(yōu)先權(quán).客戶或 其代理都應(yīng)有強(qiáng)烈的責(zé)任建立優(yōu)先權(quán). 如果所有的需求都被視為同等重要,那 么由于在開(kāi)發(fā)中,預(yù)算削減,方案超時(shí) 或組員的離開(kāi)導(dǎo)致新的需求時(shí),工程經(jīng)理將不能起到作用.優(yōu)先權(quán)的作用是提 供給客戶的價(jià)值,實(shí)現(xiàn)的相關(guān)費(fèi)用,實(shí) 現(xiàn)相關(guān)聯(lián)的有關(guān)技術(shù)風(fēng)險(xiǎn).我是用3種級(jí)別的優(yōu)先權(quán)：高優(yōu)先 權(quán)說(shuō)明需求必須表達(dá)在下一個(gè)產(chǎn)品版本 最新財(cái)經(jīng)經(jīng)濟(jì)資料 感謝閱讀 精選財(cái)經(jīng)經(jīng)濟(jì)類資料中,中優(yōu)先權(quán)說(shuō)明需求是必須的,但是 如果需要可以推遲到晚一些的產(chǎn)品版本 中,低優(yōu)先權(quán)說(shuō)明有它很好,但我們必 須熟悉到如果沒(méi)有充足的時(shí)間或資源, 它可以被放棄掉.？明確：需求表達(dá)的讀者應(yīng)只能從

6、其得到唯 一的解釋說(shuō)明,同樣,一個(gè)需求的多個(gè) 讀者也應(yīng)達(dá)成共識(shí).自然語(yǔ)言極易導(dǎo)致 模糊.要預(yù)防使用一些對(duì)于 SRS作者很 清楚但對(duì)于讀者不清楚的主觀詞匯,如: 用戶友好性,容易,簡(jiǎn)單,快速,有效, 幾個(gè),藝術(shù)級(jí),改善的,最大,最小等 等.每寫一個(gè)需要都應(yīng)簡(jiǎn)潔,簡(jiǎn)單,直 觀的采用用戶熟知的語(yǔ)言,不要采用計(jì) 算機(jī)術(shù)語(yǔ).檢查需求模糊的有效方式包 括需求說(shuō)明書(shū)的正規(guī)檢查,根據(jù)需求寫 測(cè)試,建立用戶的假想來(lái)說(shuō)明產(chǎn)品某個(gè) 特定局部預(yù)期的特性.？可證實(shí)：看你是否能夠做出測(cè)試方案或其他 驗(yàn)證方式,如檢查和實(shí)證,來(lái)決定在產(chǎn) 最新財(cái)經(jīng)經(jīng)濟(jì)資料 感謝閱讀 精選財(cái)經(jīng)經(jīng)濟(jì)類資料品中每個(gè)需求是否正確的實(shí)現(xiàn).如果需 求是不

7、可驗(yàn)證的,決定需求是不是正確 的實(shí)現(xiàn)就成了判斷的事.需求之間不一 致,不可行,不明確也能導(dǎo)致不可證實(shí). 任何需求如果說(shuō)產(chǎn)品將要支持什么也是 不可證實(shí)的.？完整：不應(yīng)該遺漏要求和必需的信息.完 整性也是一個(gè)需求應(yīng)具備的.發(fā)現(xiàn)缺少 的信息很難,由于根本不存在.在 SRS 中將需求以分層目錄方式組織,將幫助 評(píng)審人員理解功能性描述的結(jié)構(gòu),使他 們很容易指出遺失的東西.在需求抽象時(shí),相對(duì)于系統(tǒng)功能, 你過(guò)多的注意用戶的業(yè)務(wù),將導(dǎo)致在需 求的全局觀和引進(jìn)不是真正必需的需求 上顯得缺乏.在需求抽象上,應(yīng)用用例 方法會(huì)發(fā)揮很好的作用.能夠從不同角 度觀察需求的圖形分析模型也可以檢查 出不完整性.如果你知道已

8、缺少一些信息,使用 TBD標(biāo)準(zhǔn)標(biāo)志可以突出這些缺陷,當(dāng)你 最新財(cái)經(jīng)經(jīng)濟(jì)資料 感謝閱讀 6 11 在構(gòu)建產(chǎn)品的相關(guān)局部時(shí),就可以從一 個(gè)給定的需求集中解決所有的缺陷.？ 一致性：一致性需求就是不要于其他的軟件 需求或局級(jí)別的系統(tǒng)需求發(fā)生沖突.需 求中的不一致必須在開(kāi)發(fā)開(kāi)始前得到解 決.只有經(jīng)過(guò)調(diào)研才能確定哪些是正確 的.修改需求時(shí)一定要謹(jǐn)慎,如果只審 定修改的局部,沒(méi)有審定于修改相關(guān)的 局部,就可能導(dǎo)致不一致性.？可修改性：當(dāng)每個(gè)需求的要求修改了或維護(hù)其 歷史更改時(shí),你必須能夠?qū)彾?SRS.也 就是說(shuō)每個(gè)需求必須相對(duì)于其他需求有 其單獨(dú)的標(biāo)示和分開(kāi)的說(shuō)明,便于清楚 的查閱.通過(guò)良好的組織可以使需

9、求易 于修改,如：將相關(guān)的需求分組,建立 目錄表,索引,以及前后參考.？可追蹤：你應(yīng)能將一個(gè)軟件與其原始材料相 對(duì)應(yīng),如高級(jí)系統(tǒng)需求,用例,用戶的 提議等.也能夠?qū)④浖枨笈c設(shè)計(jì)元素, 最新財(cái)經(jīng)經(jīng)濟(jì)資料 感謝閱讀源代碼,用于構(gòu)造實(shí)現(xiàn)和驗(yàn)證需求的測(cè) 試相對(duì)應(yīng).可追蹤的需求應(yīng)該具有獨(dú)立 標(biāo)示,細(xì)密和結(jié)構(gòu)化的編寫,不應(yīng)過(guò)大, 不應(yīng)是表達(dá)性的文字和公告式的列表.二、需求質(zhì)量的評(píng)審這些有關(guān)需求質(zhì)量的特性的描述在 理論上都是非常好的,但一個(gè)好的需求 到底是個(gè)什么樣子的呢？為了表達(dá)得更 切合實(shí)際,我們做個(gè)小練習(xí).下面有幾 個(gè)從實(shí)際的工程選出的需求,依據(jù)上面 的質(zhì)量標(biāo)準(zhǔn),評(píng)估每個(gè)需求,看看有什 么問(wèn)題,然后用

10、更好的方式重寫.我將 對(duì)每個(gè)例子都提出自己的分析和改進(jìn)的 建議.也歡迎你提出不同的見(jiàn)解.我所 占優(yōu)的只是我知道每個(gè)需求的出處.因 為你我都不是真正的客戶,我們只能猜 測(cè)每個(gè)需求的意圖.例1.產(chǎn)品應(yīng)在不少于每60秒的正 常周期內(nèi)提供狀態(tài)信息這個(gè)需求是不完整的：狀態(tài)信息是 什么,如何顯示給用戶.這個(gè)需求有幾 處模糊.我們?cè)谡務(wù)摦a(chǎn)品的哪局部？狀 最新財(cái)經(jīng)經(jīng)濟(jì)資料 感謝閱讀 8 精選財(cái)經(jīng)經(jīng)濟(jì)類資料態(tài)信息間隔真的假定為不少于 60秒？, 甚者每10年顯示一條新的狀態(tài)信息也可 以？也許它的意圖是消息間隔不應(yīng)超過(guò) 60秒,那么1毫秒是不是太短？ 每這 個(gè)詞導(dǎo)致了不確定性.問(wèn)題的后果,就 是需求的不可證實(shí).彌

11、補(bǔ)缺陷,重寫需求的一種方法：“1狀態(tài)信息1.1后臺(tái)任務(wù)治理器因該以誤差上 下不超過(guò)10秒的60秒間隔,在用戶界 面的指定位置顯示狀態(tài)信息1.2如果后臺(tái)進(jìn)程處理正常,那么應(yīng) 該顯示任務(wù)已完成的百分?jǐn)?shù)/比1.3任務(wù)完成時(shí),應(yīng)顯示相關(guān)的信息 1.4后臺(tái)任務(wù)出錯(cuò)應(yīng)該顯示錯(cuò)誤信為了分別測(cè)試和追蹤,我將其分成 了多個(gè)需求.如果將幾個(gè)需求串接在一 節(jié)中,在構(gòu)造和測(cè)試時(shí)就很容易漏掉一 個(gè).例2.產(chǎn)品應(yīng)瞬間在顯示和隱藏不 可打印字符間切換 最新財(cái)經(jīng)經(jīng)濟(jì)資料感謝閱讀計(jì)算機(jī)在瞬間不能做任何事,所以 這個(gè)需求不切實(shí)可行.它的不完整性表 現(xiàn)在沒(méi)有聲明觸發(fā)狀態(tài)切換的條件.軟 件要在某些條件下更改自己？或者用戶 為了模仿更

12、改要做一些動(dòng)作？而且,在 文檔中改變顯示的范圍是多大：選中的 文本,整個(gè)的文檔,或其他的？這也是 個(gè)模糊的問(wèn)題.不可打印字符合隱藏字 符一樣嗎？或者是一些屬性標(biāo)志或一些 限制字符？問(wèn)題的后果,就是需求的不 可證實(shí).象這樣編寫需求也許更好一些：用 戶能夠在一個(gè)由特定觸發(fā)條件激活處于 編輯的文檔中在顯示和隱藏所有 HTML 標(biāo)記間切換.現(xiàn)在就很清楚,不可打印 字符是HTML標(biāo)記.由于沒(méi)有定義觸發(fā) 條件,需求對(duì)設(shè)計(jì)沒(méi)有約束力.只有設(shè) 計(jì)人員選定了觸發(fā)條件后,你才能編寫 測(cè)試驗(yàn)證觸發(fā)的正確操作.例3 “HTM吩析器可以產(chǎn)生HTML 標(biāo)記錯(cuò)誤報(bào)告,幫助HTML入門者快速 解決錯(cuò)誤.最新財(cái)經(jīng)經(jīng)濟(jì)資料感謝閱

13、讀13精選財(cái)經(jīng)經(jīng)濟(jì)類資料單詞快速使其模糊,沒(méi)有加進(jìn)錯(cuò) 誤報(bào)告的定義也是其部完整.我不知道, 你怎么驗(yàn)證這個(gè)需求.找一個(gè)自稱為 HTML的入門者,看看能不能根據(jù)錯(cuò)誤 報(bào)告快速解決錯(cuò)誤？試試這個(gè)：“ HTML分析器可以產(chǎn)生 一個(gè)錯(cuò)誤報(bào)告,錯(cuò)誤報(bào)告包含有在被分 析文件中出錯(cuò)的HTML文本和行號(hào)以及 錯(cuò)誤的描述.如果沒(méi)有錯(cuò)誤,就不會(huì)產(chǎn) 生錯(cuò)誤報(bào)告.現(xiàn)在我們知道了,什么會(huì) 被加到出錯(cuò)報(bào)告中,但是出錯(cuò)報(bào)告是個(gè) 什么樣子,那么留由設(shè)計(jì)人員決定.我們 還指定了一個(gè)例外：如果沒(méi)有發(fā)現(xiàn)錯(cuò)誤, 不產(chǎn)生錯(cuò)誤報(bào)告.例4如果可能,主管號(hào)應(yīng)通過(guò)聯(lián) 機(jī)校驗(yàn),而不是通過(guò)主全體主管號(hào)列 表校驗(yàn)".真到絕望,什么是 如果

14、可能：如 果技術(shù)上可行？如果主全體主管號(hào)列 表可以聯(lián)機(jī)獲得？要預(yù)防象 應(yīng)該的這 類不確切的詞.客戶是需要這個(gè)功能性 還是不需要.我曾看過(guò)一些需求說(shuō)明書(shū), 最新財(cái)經(jīng)經(jīng)濟(jì)資料 感謝閱讀11采用諸如：應(yīng),將,應(yīng)該/將要等一些詞 描述優(yōu)先級(jí)的細(xì)微差異.但我更喜歡用 應(yīng)清楚的說(shuō)明需求的意圖,指明優(yōu)先 級(jí).這是修改后的：系統(tǒng)應(yīng)校驗(yàn)輸入的 主管號(hào)而不通過(guò)聯(lián)機(jī)的主全體主官號(hào) 碼列表.如果在列表中沒(méi)有發(fā)現(xiàn)主管號(hào) 碼,將會(huì)顯示一條錯(cuò)誤信息,也不接受 指令.在理解各個(gè)已完成的糟糕需求上, 開(kāi)發(fā)人員將會(huì)遇到的難題是：開(kāi)發(fā)人員 與客戶將會(huì)在審核需求,未達(dá)成共識(shí)前 發(fā)生劇烈的爭(zhēng)論.詳細(xì)檢查大的需求文 檔不是一件輕松的事情

15、.我清楚有人做 過(guò),而且他們花在檢查上的每一分鐘都 是值得的.相對(duì)于開(kāi)發(fā)階段和用戶的抱 怨 ,在這個(gè)階段修補(bǔ)缺陷是廉價(jià)的,編寫質(zhì)量需求的方針編寫優(yōu)秀的需求是沒(méi)有公式化的方 法的.這需要大量的經(jīng)驗(yàn),要從你在過(guò) 去的文檔中發(fā)現(xiàn)的問(wèn)題學(xué)習(xí).請(qǐng)?jiān)诮M織 軟件需求文檔時(shí),嚴(yán)格遵從這些方針.？句子和段落要短.采用主動(dòng)語(yǔ)氣. 最新財(cái)經(jīng)經(jīng)濟(jì)資料 感謝閱讀使用正確的語(yǔ)法,拼寫,標(biāo)點(diǎn).使用術(shù) 語(yǔ),要保持一致性,并在術(shù)語(yǔ)表或數(shù)據(jù)字典 中定義它們？要看需求是否被有效的定義,可 以以開(kāi)發(fā)人員的觀點(diǎn)看看.在內(nèi)心將 當(dāng) 你們做完了找我這句加到文檔尾部,看看能 不能是你緊張起來(lái).換句話說(shuō),你是否 需要SRS的編寫者的額外解釋幫

16、助開(kāi)發(fā) 人員很好的理解需求,以便于設(shè)計(jì)和實(shí) 現(xiàn)？如果是的話,在繼續(xù)工作前,需求還 需要細(xì)化.？需求編寫者還要努力正確地把握 細(xì)化程度.要預(yù)防包含多個(gè)需求的長(zhǎng)的 表達(dá)段落.有幫助的提示是編寫?yīng)毩⒌目蓽y(cè)試 的需求.如果你認(rèn)為一小局部測(cè)試可以 驗(yàn)證一個(gè)需求的正確,那么它已經(jīng)正確 的細(xì)化了.如果你預(yù)想到多種不同類的 測(cè)試,幾個(gè)需求可能已擠到了一起,需 最新財(cái)經(jīng)經(jīng)濟(jì)資料 感謝閱讀 13 精選財(cái)經(jīng)經(jīng)濟(jì)類資料要拆分開(kāi).？密切關(guān)注多個(gè)需求合成了單個(gè)需 求.一個(gè)需求中的連接詞 和 /或°建議 幾個(gè)需求合并.不要在一個(gè)需求中使用 和域您.？通篇文檔細(xì)節(jié)上要保持一致.我 曾看見(jiàn)過(guò)多個(gè)需求說(shuō)明書(shū)前后不一致.如：對(duì)于紅色合法的顏色代碼應(yīng)是 R'及對(duì) 于綠色合法的顏色代碼應(yīng)是 G'就有可以 以分散的需求別離開(kāi),而產(chǎn)品應(yīng)能對(duì)來(lái) 自語(yǔ)音編輯指示做出反響應(yīng)作為一個(gè) 子系統(tǒng),不應(yīng)作為單個(gè)的功能性需求.？預(yù)防在SRS中過(guò)多的申述需求. 在多處包含相同的需求可以使