
- 登入
- 註冊

系統開發需求規格書(也稱系統需求書或需求規格書)的目的,不是讓非工程背景的主管先決定資料庫或程式語言,而是把營運問題、使用角色、流程、規則、資料、權限、例外與驗收條件整理成共同語言。文件夠清楚,團隊才能估算範圍,找出風險,並討論取捨。
第一版不必追求厚重格式。比起列出幾十個畫面,更重要的是說清楚誰在什麼情況做什麼,系統依哪些規則回應,以及什麼結果可以被測試。本文提供九個整理區塊(目標與基準、角色、現況流程、功能與規則、資料、權限、整合、例外與限制、驗收)、一頁填寫樣本與審閱方法。
以下為假設服務公司需求,不是 SHOPLINE 或任何 API 的實際欄位。把規則寫到可測試程度,第三方不確定能力另立驗證項。
| 規格欄位 | 本例填寫 | 對回驗收 |
|---|---|---|
| 角色與觸發 | 服務人員確認報價後建立待付款訂單 | 未授權人員不能操作 |
| 輸入與主檔 | 客戶識別、報價編號、幣別與金額;訂單系統為主檔 | 必填、格式、金額與身分均一致 |
| 業務規則 | 同報價重複送出不得建立重複應收 | 測試 PAY-T02:重複操作結果可查 |
| 輸出 | 唯一訂單與對應收款入口 | 測試 PAY-T01:付款可對回訂單 |
| 例外 | 錯金額、身分不符或通知重送,停止自動交付 | 測試 PAY-T03~05,交人工核對 |
| 責任與證據 | 業務確認規則;開發留記錄;驗收人執行 | 每條需求關聯案例、結果與缺陷負責人 |
第一版還要寫成功與失敗狀態、可看資料的角色及變化來源。需求、測試與交付物互相追溯,才方便估價和驗收;不把「有付款按鈕」當完整需求。規格結構參考ISO 29148 公開書目的需求工程範圍,本文樣本是教學整理,不聲稱已取得或符合完整標準。
需求若包含線上收款,記得把金流申請列為外部依賴:是否核准與可用的付款方式由支付服務商審核決定,規格書只能寫「待核准後確認」,不能先當成已具備的功能。申請資料與流程可先看《金流申請完整指南》。若只需要收款連結或 QR Code,可先用立即付建立商店,再評估是否還需要客製系統。
好的第一版需求文件,應讓不在會議現場的人也能理解四件事:為什麼要做,誰會使用,正常與例外流程怎麼走,以及做到什麼程度才算完成。技術方案可以在這些條件明確後,由合適團隊提出。
需求規格書是一份持續更新的決策紀錄,用來描述系統必須支援的功能、品質、資料、介面與限制。第一版不一定是正式的 SRS(Software Requirements Specification,軟體需求規格書),但至少要讓團隊看見關鍵流程、必要規則、高風險假設與待確認項目。
ISO/IEC/IEEE 29148:2018 標準資訊(2026 年 8 月查核:現行已發布版仍為 2018 版,ISO 已標示進入修訂程序)提供需求工程與規格的正式脈絡,但中小型專案不必照搬完整標準格式。可以先取其精神:需求應明確且一致,並且可追溯,也能被驗證。
這五種文件的差別在主要讀者與要回答的問題,不是寫得越多越好。先確認目前卡在哪個決策,再決定要寫哪一種。
| 文件 | 主要讀者 | 回答的問題 | 適用時機 |
|---|---|---|---|
| 問題陳述 | 決策者、流程負責人 | 為什麼要做,現況影響是什麼 | 專案最前期 |
| PRD | 產品、設計與開發團隊 | 產品要解決什麼,範圍與優先順序是什麼 | 產品規劃與迭代 |
| SRS | 分析、開發、測試與驗收角色 | 系統應具備哪些可驗證需求與限制 | 需要較正式規格時 |
| RFP | 採購與候選供應商 | 要採購什麼,如何提案與評選 | 對外徵求方案前 |
| User Story | 產品與迭代團隊 | 特定角色為何需要某能力 | 拆分工作與對話 |
文件可以互相引用,不必選一種包辦全部。問題陳述先固定商業目標,PRD 管理產品方向,SRS 深入可驗證需求,RFP 讓供應商回答同一範圍,User Story 則協助小批次討論。
一份能用來估價與驗收的需求規格書,至少要涵蓋九個區塊:目標與基準、角色、現況流程、功能與規則、資料、權限、整合、例外與限制、驗收。下表列出每個區塊要回答的問題,以及怎樣才算寫完。
| 區塊 | 要回答的問題 | 完成判定 |
|---|---|---|
| 目標與基準 | 改善什麼,目前數字或現況是什麼 | 能比較導入前後 |
| 角色 | 誰使用,誰決定,誰管理,誰驗收 | 每個責任有具體角色 |
| 現況流程 | 正常、例外與人工補救如何發生 | 能畫出起點、終點與交接 |
| 功能與規則 | 什麼條件觸發什麼結果 | 不是只列畫面名稱 |
| 資料 | 來源、欄位、品質、主檔與更新方式 | 關鍵資料有擁有人 |
| 權限 | 誰能查看,誰能建立,誰能修改,誰能核准,誰能匯出 | 敏感操作可被追蹤 |
| 整合 | 與哪些系統交換哪些資料 | 介面、錯誤與版本責任清楚 |
| 例外與限制 | 失敗、重複、逾時與邊界如何處理 | 高頻例外有負責人 |
| 驗收 | 用什麼情境與資料判斷完成 | 條件可測試,不用主觀形容詞 |
九個區塊不是九份獨立文件。小型專案可放在同一份需求表中,大型專案再拆成流程圖、資料字典、權限矩陣、介面規格與測試案例。需求裡若要讓 AI 讀取資料或代為執行動作,還要另外寫明可用的工具權限、資料來源與交回人工的條件,寫法見《AI 系統整合完整指南》。
功能需求應包含觸發條件、使用角色、輸入、規則、輸出、例外與權限。只寫「建立報表功能」太模糊;要補上誰能選什麼期間,資料從哪裡來,並補上更新頻率、欄位定義、匯出格式與資料不足時的處理。
驗收案例怎麼寫成另一個人也能重現的格式,可接著看《系統開發驗收清單》的案例填寫表與缺陷分級。
非功能需求描述系統如何運作,例如效能、可用性、安全、可維護性、備份、稽核與相容性。它們不一定出現在某個按鈕上,卻會決定系統能不能穩定進入營運。
不要直接複製「系統需具高安全性」這類句子。應依風險定義登入、權限、敏感資料、紀錄、備份與回復的具體情境。NIST SSDF可協助思考安全如何進入需求與開發流程,但實際控制仍需專案與法遵專業判斷。
下表用四個常見的模糊寫法示範怎麼改寫。內容是假設的示例,秒數、頻率與保存期間這類數值要由專案依風險與成本議定,不能直接沿用。
| 模糊寫法 | 改寫成可驗收的條件(假設示例) | 驗收時看什麼 |
|---|---|---|
| 系統要快 | 在議定的資料量與同時使用人數下,訂單查詢要在議定的秒數內顯示結果 | 用接近正式環境的資料實測,並記錄數值 |
| 系統要安全 | 未登入不能進入後臺;一般人員看不到其他部門的客戶資料;匯出與權限變更會留下操作者與時間 | 用不同角色的帳號逐項操作,再核對操作紀錄 |
| 資料不能遺失 | 寫明備份頻率、保存期間與負責人,以及回復需要多久 | 實際做一次回復演練,確認資料可用 |
| 系統要穩定 | 外部服務失敗時顯示看得懂的訊息,保留未完成的資料,並通知負責人 | 模擬外部服務中斷,確認沒有重複建立或遺失資料 |
需求文件可以分七步產出:先訪談並畫出現況流程,確認目標與範圍,再依九區塊整理,用原型與驗收案例核對理解,最後審閱成基線並記錄每次變更。
基線不是禁止改需求,而是讓每次改動有比較起點。想理解需求之後的設計、開發、測試與上線,可接著閱讀《系統開發流程完整指南》。基線版本怎麼對應到報價的工作項目與假設,見《系統開發費用怎麼算》。
下列六種寫法會讓需求規格書看起來完整,卻無法用來估價、開發或驗收。
若問題與跨部門優先順序仍沒有共識,可先透過言回提出顧問需求;若需求已明確,則可搭配《系統開發公司評選指南》進入詢價。
需求文件應有能辨識的版本,讓企業與開發團隊知道目前依哪一版估價與驗收。下面是編輯建議的追溯方式,不是特定標準要求的固定格式。每個需求給一個穩定編號,再連到對應驗收案例;發生變更時保留原因與核定結果。
| 需求編號 | 規則與例外 | 驗收案例 | 變更決定 |
|---|---|---|---|
| PAY-01 | 建立待付款訂單,重送不重複建立 | AT-01 正常建立,AT-02 重複送出 | 維持範圍,由流程負責人確認 |
| PAY-02 | 收到付款通知後更新狀態 | AT-03 正常通知,AT-04 重複或延遲通知 | 新增範圍,先確認費用與排程 |
以上 PAY-02 是假設的變更示例,並非指定支付服務商的規格。先問清楚誰發出事件,哪個系統保存付款狀態,以及通知失敗時由誰查核;沒有官方規格與測試結果前,不把「可接金流」視為已完成驗收。事件通知的責任可以參考Webhook 串接與失敗處理指南。
每次確認變更時,一起更新需求版本、受影響流程、驗收案例、費用與排程,並寫明確認人。若只有聊天訊息同意加功能,文件與測試卻仍用舊版,驗收時便難以判斷差異是缺陷還是追加需求。完整測試範圍接著依系統開發驗收清單核對。
完成第一版需求後,可用《系統開發流程完整指南》確認每階段輸出,再以《系統開發公司怎麼選》比較供應團隊;涉及外部平臺時,再讀《API 串接完整指南》。即站力可依專案需求討論需求整理與系統開發,實際文件、範圍與交付方式逐案確認。已經有第一版需求時,可以到立即諮詢頁提出。
可以先整理問題、角色、流程、資料、規則與驗收。技術設計可由專業團隊提出,但營運責任人仍要確認需求是否符合實際工作。
不一定。文件名稱依專案規模與團隊作法決定。重點是產品目標、系統需求與驗收資訊沒有缺口,也沒有互相矛盾。
至少要能界定問題、主要流程、角色、資料、整合、必要範圍與驗收。其餘不確定可列為探索階段,不能假裝已固定。
不是。文件提供比較基準,讓團隊知道變更原因、影響、費用與時程。沒有基線,變更反而更難被辨識與管理。
應共同制定。開發團隊協助轉成可測試條件,企業的流程負責人與驗收人則確認情境符合營運需求。
不能保證,但能降低不必要的假設。整合、資料品質、技術驗證與決策速度仍可能影響範圍、估價與排程。