iT邦幫忙

2024 iThome 鐵人賽

DAY 6
0
Modern Web

從零開始:全端新手的困境與成長系列 第 6

Day6 如何撰寫產品需求規格書:從需求拆分到細節展現

  • 分享至 

  • xImage
  •  

產品需求規格書 PRD (Product Requirements Document) 是每個開發專案中不可或缺的文件,它能夠清楚地告訴工程師和設計師需要做什麼,如何實現功能,並確保項目從開始到結束都保持一致。也就是說,產品需求規格書是一份詳細的藍圖,讓工程師一看就知道要做哪些事情,它都應該涵蓋所有開發過程中的關鍵要素。

https://ithelp.ithome.com.tw/upload/images/20240914/20168326irUgmPjNHF.png

文章大綱:

  1. 撰寫產品需求規格書時的挑戰
  2. 如何用 AI 幫我初步完成產品需求規格書
  3. 分功能逐步詳細撰寫完成
  4. 持之以恆,別怕麻煩

1. 撰寫產品需求規格書時的挑戰

● 規模太大,容易失去重點

一開始撰寫產品需求規格書時,經常會遇到的問題是東西太多了,到底要怎麼寫,內容涵蓋了太多細節而難以掌握,我要先寫功能嗎?還是寫寫 API?或是規劃一下資料庫。這時候的最佳做法是將產品需求規格書拆分成更小的部分,逐步進行。

● 逐步拆解,一步一步來

為了避免規格書過於龐雜,可以先從用戶故事開始,再進一步介紹專案概述和技術規格。接下來,把 Wireframe、功能細節介紹、API 路徑、資料庫,這樣能讓工程師和設計師更直觀地了解每個頁面的結構和功能。

2. 如何用 AI 幫我初步完成產品需求規格書

1. 使用 AI 生成初步產品需求規格書

如果之前從未撰寫過產品需求規格書,可以利用 AI 工具來生成產品需求規格書的大致方向。AI 可以幫助你整理出規格書的大框架,然後你再進一步細化每個部分。這樣可以避免從頭開始時感到困難,同時也能節省時間。

Prompt:請你當一位專業的產品經歷,讓後幫我規畫一份產品需求規格書 PRD 的大綱,主題是毛小孩購物網站,名稱叫毛毛購物,大綱像是專案介紹、技術規格等等
https://ithelp.ithome.com.tw/upload/images/20240914/20168326dZH7cH8txN.png

3. 分功能逐步詳細撰寫完成

有了大綱之後,我們就可以逐步完成產品需求規格書,也可以依照自己的需求修改內容。產品需求規格書的重點就是,每個頁面的功能描述應該詳細且具體。例如,當描述某個頁面的操作時,除了基本功能外,還要放上所有可能的操作流程和任何可能的狀況。

重點就是,讓工程師一看就知道要做哪些事情,那讓我們來一起完成吧!

1. 此 Side Project 的基本介紹

在撰寫產品需求規格書時 (下面用 PRD 代稱),用戶故事專案介紹技術規格是開頭的關鍵部分,讓我們簡單介紹如何撰寫這三個部分。

1. 用戶故事

用戶故事主要描述使用者如何與你的系統互動。它應該簡潔明了,並清楚說明用戶為何需要這個產品,以及它如何解決用戶的需求。你可以從用戶的角度出發,具體描述他們的行為和目標。

2. 專案介紹

專案介紹是概述專案的背景與目標。這部分應該描述專案的目的、它的主要功能模組,以及專案的整體結構。將前後台的劃分與功能點簡單列出,讓讀者對專案有基本的認識。

3. 技術規格

技術規格應描述專案中所使用的技術棧和框架,並簡要說明每個技術在專案中的角色。這部分應該清晰列出前端和後端的技術選擇及資料庫的使用,讓開發者對專案的技術基礎有明確的了解。

https://ithelp.ithome.com.tw/upload/images/20240914/20168326fz1cwkJX4A.png

這樣的介紹能夠幫助讀者迅速了解專案的基本背景和技術基礎,為後續的詳細需求規格做鋪墊。

2. 細部功能撰寫

PRD 的核心是需求規格,所以要詳細列出所有操作上的可能性。例如,哪些按鈕會觸發什麼動作,哪裡需要數據輸入,要做哪些檢查,盡可能想到的都要詳細寫出來。

但是好多東西要寫,要如何拆解步驟呢?我們可以先區分成前後台,然後依每個頁面去區分撰寫。
https://ithelp.ithome.com.tw/upload/images/20240914/20168326xdFhe27tQm.png

我們也可以將重複的功能拉出為通用功能,此方式可以讓 PRD 更為簡潔。
https://ithelp.ithome.com.tw/upload/images/20240914/20168326pHA3WHlHax.png

3. API 規格

接下來,介紹 API 規格。在這一部分,你應該列出所有 API 路徑,並說明每個 API 的功能、請求方法、參數和回應數據格式。這部分應該提供具體的範例,方便工程師進行開發。
https://ithelp.ithome.com.tw/upload/images/20240914/20168326XmfnOjCGPn.png

如果可以,我們也可以將 Response 的結果寫下,更方便後面我們撰寫 API 。
https://ithelp.ithome.com.tw/upload/images/20240914/20168326BKsF8lo6DN.png

關於 API 我們可以再做得更仔細,就是在剛剛功能的撰寫的部份加上 API 路徑,這樣我們就知道在哪裡要使用到哪些 API 。
https://ithelp.ithome.com.tw/upload/images/20240914/20168326GkgGnOiD7V.png

4. 資料庫設計

資料庫設計部分是產品需求規格書中不可缺少的一環。這裡應該列出所有資料表的結構、欄位名稱和資料類型,並說明它們之間的關聯。提供資料庫設計圖,讓開發者能夠清楚地理解資料的流動和存儲方式。
https://ithelp.ithome.com.tw/upload/images/20240914/201683266x96QqUB9P.png

6. 時程安排

最後,為了確保專案的順利進行,應該加入一份時程安排。這樣可以讓我們更掌握此專案的開發時程,並且如果有多人一起協作,更能知道他人的狀況。
https://ithelp.ithome.com.tw/upload/images/20240914/20168326BUeWpTdyMl.png

4. 持之以恆,別怕麻煩

雖然撰寫產品需求規格書(PRD)可能看起來比之前的內容更加複雜、更加麻煩,但這個過程對後續的正式開發是非常重要的。PRD 能夠幫助你在開發過程中避免不必要的混亂,而且確保每個功能的細節都被清楚地定義,在開發之前就能更好的知道未來可能會遇到的狀況。

此外,撰寫 PRD 也能幫助你更深入的知道 Side Project 的全貌,幫助你思考系統的運作方式以及各個功能之間的關係。慢慢地一步步拆解需求,也是一種對工程時思維變化的幫助。

雖然寫 PRD 需要投入較多的時間和心力,但它所帶來的好處是很大的,讓你的專案更具順暢,也更容易達到預期目標。

繼續加油,每一步的完成,你離成功的專案就越來越近!


上一篇
Day5 從 Wireframe 到 UI Flow 再進一步用心智圖 GitMind 完善功能規劃
下一篇
Day 7 搭建開發環境:開發者的成長第一步
系列文
從零開始:全端新手的困境與成長19
圖片
  直播研討會
圖片
{{ item.channelVendor }} {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言