需求分析師如何撰寫需求規(guī)格說明書?
本文將分享一般的需求說明書該如何撰寫,有哪些格式,需要注意什么等方面,力求使需求說明書看起來規(guī)范、專業(yè)。enjoy~
需求分析師的一個主要工作就是寫需求說明書。
國內(nèi)對于需求說明書的格式并沒有一套標準規(guī)范,每家公司有每家公司自己的需求說明書格式,在我從事的三家公司,我寫過三種格式不同的需求說明書,這樣造成的一個后果就是因為沒有一套標準格式的需求說明書,假如去其他公司的話,又得拋棄原有的書寫格式,重新習慣其他公司的需求說明書格式。
這樣,對于一個有經(jīng)驗的需求分析師而言,在書寫需求說明書這塊,他就會和新人沒有什么差別,無優(yōu)勢可言。
只有不斷的總結(jié),才能進步。
本文將分享一般的需求說明書該如何撰寫,有哪些格式,需要注意什么等方面,力求使需求說明書看起來規(guī)范、專業(yè)。
一、文檔結(jié)構(gòu)
1. 首頁
先說需求說明書的首頁,首頁展示本公司的基本信息、需求說明書的標題,如XX產(chǎn)品需求規(guī)格說明書,和文檔編號、編寫人、模塊名稱、部門、保密等級、日期、版權(quán)說明等。
2. 修訂頁
修訂頁的作用是記錄需求說明書版本的變更,在跟客戶溝通需求的時候,需求可能會變更,每一次修訂,都需記錄下來,作為留痕。
修訂頁展示的內(nèi)容包括編號、章節(jié)名稱、修訂內(nèi)容簡述、修訂日期、修訂前版本號、修訂后版本號、修訂人、批準人。
3. 目錄
目錄即是需求說明書正文的內(nèi)容,包含了引言、項目概述、業(yè)務(wù)需求、附錄。
(1)引言:展示編寫目的、范圍、定義和參考資料。
- 編寫目的:說明編寫這份軟件需求說明書的目的,指出預(yù)期的讀者范圍。
- 范圍:待開發(fā)的軟件系統(tǒng)的名稱;說明軟件將干什么,如果需要的話,還要說明軟件產(chǎn)品不干什么;描述所說明的軟件的應(yīng)用,盡可能精確地描述所有相關(guān)的利益、目的、以及最終目標。
- 定義:列出本文件中用到的專門術(shù)語的定義和縮寫詞的原詞組。
(2)項目描述:如果是項目需求,簡要描述一下項目的概況,如項目的背景,項目的周期等等。
- 產(chǎn)品描述:敘述該項軟件開發(fā)的意圖、應(yīng)用目標、作用范圍以及其他應(yīng)向讀者說明的有關(guān)該軟件開發(fā)的背景材料。如果開發(fā)的系統(tǒng)與其他系統(tǒng)有對接,則還應(yīng)該本系統(tǒng)與其他系統(tǒng)之間的關(guān)系,用方框圖表示。
- 產(chǎn)品功能:系統(tǒng)包含的模塊,并簡要描述下各模塊的功能。描述產(chǎn)品功能模塊的作用是將系統(tǒng)的范圍定義清楚,一共有多少個模塊,以便甲乙兩方明確本次項目的邊界。
(3)業(yè)務(wù)需求:用戶提出的需求
- 功能介紹:描述功能要達到的目標、所彩的方法和技術(shù),還應(yīng)清楚說明功能意圖的由來和背景。
- 流程圖:如果涉及到流程,除了文字以外,還需附上流程圖
- 數(shù)據(jù)項描述:展示字段、字段類型(文本、日期、數(shù)值、枚舉值等)、數(shù)據(jù)來源、備注,開發(fā)看到數(shù)據(jù)項描述能定義數(shù)據(jù)庫表中的字段。
- 界面展示:原型圖輸出,用原型圖方式呈現(xiàn)文字描述的功能,每張原型圖下面可以備注功能的路徑,以便開發(fā)明白該原型圖在哪個模塊的哪個菜單。
(4)附錄:對一個實際的需求規(guī)格說明來說,若有必要應(yīng)該編寫附錄。
附錄包括有助于理解需求說明的背景信息、用戶歷史、背景、經(jīng)歷和操作特點、原始需求、需求調(diào)研記錄等等。需要注意的是當包括附錄時,需求說明必須明確地說明附錄只作為參考,不作為正式的需求。
因為有時候一些原始需求,在需求溝通過程或者其他原因,可能會不做,原始的需求和正式要開發(fā)的需求不一定是相同的,所以要用文字說明附錄不作為正式開發(fā)的需求,也不作為驗收的標準。
最后,如果需求說明書需要用戶簽名,還需在后面寫上用戶公司名稱、日期,以及本公司名稱和日期。
以上是文檔結(jié)構(gòu)部分,為了使一份需求說明書看起來專業(yè),還需注意細節(jié)部分。
二、文檔細節(jié)
- 頁眉頁腳: 頁眉注明是XX公司的需求說明書;頁腳要編寫頁碼,如第幾頁,但是首頁不要頁眉頁腳。
- 字體字號:正文的字體建議用宋體,字號用5號。需求說明書不要出現(xiàn)3種字體。
- 行距:1.5倍行距
需求說明書可以向開發(fā)和用戶展現(xiàn)需求分析師的實力,專業(yè)的需求說明書能體現(xiàn)需求分析師的專業(yè)水平,可以說需求說明書是需求分析師的一件“外衣”,專業(yè)的需求分析師寫出的需求不僅是用戶開發(fā)能看懂,而且整篇文檔的結(jié)構(gòu)完整,細節(jié)也相當注意。
作者:Vi-Vi-Fu,微博@風將信至,杭州某金融軟件公司需求分析師,負責過證券公司信用風險管理項目的需求分析。
本文由 @Vi-Vi-Fu 原創(chuàng)發(fā)布于人人都是產(chǎn)品經(jīng)理。未經(jīng)許可,禁止轉(zhuǎn)載。
題圖來自StockSnap.io,基于 CC0 協(xié)議
用戶畫像
平時產(chǎn)品寫需求規(guī)格說明書好像不是太多吧,一般就需求文檔。我還沒寫過規(guī)格說明
需求調(diào)研報告、需求分析說明書、產(chǎn)品需求說明書、需求規(guī)格說明書;這幾個有什么區(qū)別,受眾對象,側(cè)重點
我已經(jīng)懵逼了,大神求指導
我也想知道
我也想知道
這篇文章寫的是給客戶看的需求說明書吧????不怎么會寫,怎么練?
這個是需求分析報告還是需求說明書??
需求規(guī)格說明書要寫風險嗎
有的需要,說明下約束條件
不知道大佬有沒有模板啊,可以套著寫給開發(fā)看,我現(xiàn)在應(yīng)公司要求寫需求卡片,總感覺格式架構(gòu)太差
每個公司的模板都不一樣,建議最好不要套著用,會水土不服
文檔的架構(gòu)上產(chǎn)品功能和業(yè)務(wù)分析這兩個模塊的順序感覺怪怪的,產(chǎn)品功能應(yīng)該是分析后得出的系統(tǒng)有哪些功能模塊,不應(yīng)該是先分析業(yè)務(wù)流程然后再得出有哪些模塊
寫法上是總體概述-詳細描述,就像新聞,倒金字塔寫法
要是能配上案例就更完美了
涉及到客戶公司的信息,就不方便公開了
問個問題 ba不懂技術(shù)實現(xiàn)方案的 ,需求規(guī)格說明書中是否需要詳細列明技術(shù)方案??
需求說明書分為給客戶的需求說明書和給開發(fā)的,如果懂技術(shù)的話,在給開發(fā)的說明書可以寫下。
需求文檔格式大同小異。
看你寫的是給誰看的,給客戶看的,和給開發(fā)看的差別還是挺大的
開發(fā)轉(zhuǎn)產(chǎn)品,沒有相關(guān)經(jīng)驗,簡歷怎么寫?大佬求教,wx:hyw123456520
開發(fā)轉(zhuǎn)產(chǎn)品很有優(yōu)勢,產(chǎn)品挺注重邏輯思維能力的,可以突出這塊
嗯嗯,好的,謝謝
然而兢兢業(yè)業(yè)自認為寫的很完美的需求規(guī)格說明書后作為產(chǎn)出介質(zhì)交給開發(fā)人員,開發(fā)人員根本不認真看,遇到需求問題會直接問產(chǎn)品經(jīng)理XXX的需求是什么意思,這個為什么這樣做。然而因為是同事關(guān)系,又不能直接懟回去說你自己去好好看看需求規(guī)格說明書!然而只能認認真真為開發(fā)講解。。。。。 要說需求規(guī)格說明書存在的意義就是當產(chǎn)品經(jīng)理換人或者對需求規(guī)定不是很清楚的時候,就需要根據(jù)需求規(guī)格說明書來進行工作,畢竟需求規(guī)格說明書是幾個經(jīng)理進行需求評審后產(chǎn)出的。
別人看不看是別人的事情,你寫的好不好是自己的事情,況且需求說明書不止給開發(fā)看,也要給客戶看的。
說出心聲吶吶
不過還有一個好處,就是當開發(fā)做出來的東西跟你的需求有差異,并且賴賬說是你的鍋的時候可以甩過去打臉 ??