Holarch

指南 · 需求

如何撰寫良好的系統需求:範例與檢查清單

收聽本指南 26 分鐘

良好的需求說明系統必須做到或具備的一件事,用兩位工程師會以相同方式理解的文字,並附上可由測試或分析檢查的數值。本指南說明需要與需求的差別、需求陳述的組成、ISO/IEC/IEEE 29148 與 INCOSE Guide to Writing Requirements 中的品質特性、附改寫前後範例的檢查清單、驗證與允收準則、TBD 與 TBR 值,以及需求類型,全部以同一份 CubeSat 規格示範。

本頁內容
  1. 需求的措辭為何重要
  2. 利害關係人需要與需求
  3. 需求的結構
    1. 陳述
    2. 屬性
  4. 良好需求的品質特性
  5. 檢查清單:附改寫前後範例的規則
  6. 與需求一起撰寫驗證方法與允收準則
  7. 處理 TBD 與 TBR 值
  8. 需求類型
  9. 實作範例:審查 EO-1 規格
    1. 小型發現
    2. 三項改寫
  10. 常見錯誤
  11. 在 Holarch 中試試看
  12. 下載檢查清單
  13. 關於撰寫需求的問題
    1. Shall、must 還是 will?
    2. 一個系統應該有多少項需求?
    3. 使用者故事是需求嗎?
    4. 工具能檢查需求品質嗎?
  14. 下一步

需求的措辭為何重要

需求是提出系統要求的人與建造系統的人之間的契約。下游的每個人都會閱讀它:設計者依它決定元件尺寸,測試工程師依它撰寫通過準則,變更委員會依它衡量變更,客戶則依它驗收系統。他們讀的是同一句話,而作者通常不在場。如果一句話可以有兩種讀法,就一定會有人這樣讀,而差異會在很晚才浮現:在一項依沒有人同意過的準則「通過」的測試中,或在驗收時,客戶原本指的是另一回事。

措辭不佳也會破壞模型的其餘部分。沒有數值的需求無法分配給元件,因為沒有人能說出元件是否滿足它。它無法驗證,因此會在 可追溯性 與 驗證矩陣 中顯示為涵蓋缺口。而當它變更時,沒有人能判斷相關聯的設計是否仍然成立。把需求寫好是專案中成本最低的品質工作:一開始在一句話上花一小時,能在最後省下一整輪測試。

本指南使用一個貫穿全文的範例:EO-1,一顆以四個光譜波段拍攝農地影像的虛構 6U CubeSat。其規格 SRS-001 EO-1 System Requirements Specification 有 32 項需求,大多數寫得穩妥,其中三項則刻意寫得不好。它與 端到端 MBSE 範例專案 是同一個模型。這裡引用的利害關係人需要 N1 到 N3,就是 可追溯性指南 加入模型的那些需要。

利害關係人需要與需求

撰寫需求要從更早一步開始,也就是需要。利害關係人需要是使用者、操作者、客戶或主管機關以他們自己的用語表達的期望。需求則是系統據以設計與驗證的工程陳述。ISO/IEC/IEEE 15288 將兩者放在不同的技術流程中:利害關係人需要與需求定義(6.4.2)以及系統需求定義(6.4.3)。INCOSE Needs and Requirements Manual 也做了相同的區分,並將需要視為獨立的項目,而不是需求的粗略草稿。

EO-1 範例檢查方式
需要(N2 Twice-Weekly Revisit)Farm customers need fresh imagery of their fields at least twice a week in the growing season.確認:客戶是否能從交付的系統得到他們所需要的?
需求(1.6 Revisit Time)The mission shall revisit each target region within 72 hours.驗證:系統是否透過測試、分析、檢查或展示而符合陳述?

兩者的差別在於檢查方式。需求是被驗證的:依陳述量測系統。需要是被確認的:由某人確認系統在其預期用途中,做到了利害關係人想要的事。如果需求偏離了重點,系統可能通過每一項驗證卻仍無法通過確認;驗證與確認指南 說明這個落差。就撰寫而言,實際的結論很簡單:先寫需要,再寫一旦達成就能滿足該需要的需求,並將每項需求關聯回它所回應的需要。

轉換很少是一對一的。N2 成為 1.6 Revisit Time,接著再分解為 1.6.1 Ground Track Repeat(3 天)與 1.6.2 Off-Nadir Imaging(25 度)。有些需求並不直接回應任何需要:3.1 Orbit Average Power 衍生自 1.5 Daily Collection Volume,因為成像負載決定了太陽能板必須提供的功率。沒有客戶要求 30 W,但沒有它,客戶確實要求的成像就無法實現。

需求的結構

需求不只是一句話。這句話承載義務;而它周圍的一組屬性承載理由、證明它的計畫以及記錄管理。兩者都是撰寫需求的一部分。

陳述

多數良好的需求陳述都符合同一種模式。ISO/IEC/IEEE 29148(5.2.4)將其描述為主詞、動作、受詞以及對動作的約束,前面可加上選用的條件;INCOSE Guide to Writing Requirements 建議相同的順序,並為每種需求採用議定的範本。

組成說明內容EO-1 4.3 Fault Detection
條件(選用)需求在何時、在哪個模式或狀態下適用「…of undervoltage detection」(觸發事件)
主詞必須遵循的系統或元素,名稱要精確「The C&DH」
情態動詞義務的強度「shall」
動作主詞做什麼或是什麼,以主動動詞表示「enter」
受詞動作作用的對象「safe mode」
效能或約束可量測的數值,附單位與限制方向「within 10 seconds」

合起來就是:「The C&DH shall enter safe mode within 10 seconds of undervoltage detection.」順序可以調整(「When undervoltage is detected, the C&DH shall…」將條件放在前面,如許多團隊使用的 EARS 範本),但每個組成都應該存在,或是刻意省略。

有三個字承載了大部分的分量。Shall 表示具約束力的需求;will 陳述關於系統外部事物的事實或意圖;should 陳述不予驗證的目標。無論專案採用哪種慣例,都在規格中定義一次並始終遵守。EO-1 1.1 Reference Orbit(「The mission assumes a 500 km sun-synchronous orbit…」)正確地寫成假設,而不是需求:它是依賴它的需求的背景,模型將它儲存為不評分也不驗證的陳述。

屬性

以下是 EO-1 模型中記錄的 3.1 Orbit Average Power,即 PDR 後從 28 W 改為 30 W 之後的狀態:

屬性3.1 Orbit Average Power存在的原因
識別碼與名稱3.1 Orbit Average Power供關聯、審查與變更請求使用的穩定代號
陳述The solar arrays shall generate at least 30 W orbit-average power at end of life.義務本身
理由Orbit-average load grew to 26 W after PDR; 30 W keeps 15% margin.讓日後的讀者不必找作者也能判斷變更
來源與父項Derived (systems analysis);derived from 1.5 Daily Collection Volume向後追溯:需求存在的原因
驗證方法與層級Test,子系統層級證明它的計畫,在撰寫時決定
成功準則End-of-life orbit-average power predicted from measured peak power.什麼結果算是達成
擁有者、優先順序、關鍵程度Power Engineer;High;High由誰負責,以及它有多重要
狀態審查中(原為已核准;其文字在核准後變更)它在同意流程中的位置
TBD/TBR無數值是否仍未確定

ISO/IEC/IEEE 29148(5.2.8)列出這類屬性,INCOSE 指南又增加了更多;專案應挑選它實際會維護的屬性。理由是最常被略過、日後也最常被想念的屬性。沒有「26 W 負載、15% 裕度」,下一個看到 3.1 的人無法判斷 30 W 是硬性物理限制、客戶數字還是裕度選擇,因此也無法判斷負載變更對它的意義。

良好需求的品質特性

了解寫作規則所保護的對象,就更容易運用它們。ISO/IEC/IEEE 29148(5.2.5)列出單項需求的九項特性,INCOSE Guide to Writing Requirements 以相同的九項作為其 C1 到 C9,每一項都附有簡短定義與支援它的規則。下表將每一項寫成審查者可以提出的問題。

特性要問的問題EO-1 範例
Necessary(必要)如果刪除它,是否會失去利害關係人需要的東西?它是否並非重複?3.1 是必要的:沒有它,就沒有任何項目依成像負載決定太陽能板的尺寸。
Appropriate(適當)它是否寫在正確的層級,而沒有鎖定應由下一層做的設計選擇?3.1 為太陽能板設定功率水準,而不是電池類型或面板數量。
Unambiguous(明確)它是否只能有一種讀法?6.4「user friendly」不符合:兩位審查者對是否達成會有不同意見。
Complete(完整)它是否說明了所需的一切,沒有缺少條件或數值?3.5「warm enough (TBD)」不符合:缺少數值。
Singular(單一)它是否只陳述一項義務?2.5 不符合:它以「and」連接,同時要求復原與恢復成像。
Feasible(可行)它能否在已知的技術、成本與時程限制內達成?30 W 的 3.1 有疑問:依目前設計,太陽能板約提供 28 W 軌道平均。
Verifiable(可驗證)能否以測試、分析、檢查或展示證明它已達成?2.5「quickly」不符合;「within 6 hours」則符合。
Correct(正確)它是否以正確的數值陳述其來源的真正需要?1.2 的 4.5 m 地面取樣距離正確表達了 N3 田區層級地圖的需要,且留有裕度。
Conforming(符合規範)它是否遵循專案議定的範本與詞彙?每項 EO-1 需求都使用「shall」、指名的主詞與 SI 單位。

需求集合有其自身的特性,任何單一陳述都無法呈現。ISO/IEC/IEEE 29148(5.2.6)將集合的特性列為完整、一致、整體可行、易於理解以及可確認;INCOSE 指南另增加 C15 正確,並將集合特性編為 C10 到 C15。

  • 完整:集合涵蓋了需要。EO-1 說明了欠壓時會發生什麼(4.3),但它唯一的安全模式復原需求是 2.5,而依目前寫法無法驗證,因此復原實際上並未規定。
  • 一致:沒有兩項需求互相衝突,且術語與單位用法一致。1.5 要求每天 3.2 GB 的影像資料,5.4 則要求地面收到 3 GB;兩者之所以一致,只因為 5.4 的理由寫著「after compression」。沒有這個理由,它們看起來就像衝突。
  • 可行:需求能夠同時達成。每項電源需求單獨看可能都可行,但 30 W 軌道平均、太陽能板面積與質量預算加在一起可能就不可行。
  • 易於理解:讀者能看出系統被期望做什麼,以及需求之間如何相關,這除了取決於措辭,也同樣取決於結構、編號與可追溯性。
  • 可確認:能證明集合會產生一個滿足需要的系統,這就是每項頂層需求都要關聯回某項需要的原因。

檢查清單:附改寫前後範例的規則

這些特性要透過具體的寫作規則才能派上用場。INCOSE Guide to Writing Requirements 為規則編號(R1、R2 等);NASA Systems Engineering Handbook(附錄 C)則有一份方向相同但較短的檢查清單。下表彙整了實務上能抓出多數問題的規則,每條都附有一個 EO-1 規格的範例。「改寫前」是示範專案中的現有文字;「改寫後」是改寫版本。標示為示意的數值只呈現寫法,不是 EO-1 分析的結果。

規則要問的問題改寫前(EO-1)改寫後
每項陳述一項義務是否恰好只有一個「shall」,沒有以「and」、「or」、「and/or」連接兩項要求?2.5:「The spacecraft should recover from safe mode quickly and resume imaging as appropriate」「The spacecraft shall resume imaging within 6 hours of a safe mode entry.」其他重要的復原步驟各自成為獨立的需求。
強制性措辭具約束力的需求是否使用「shall」,而不是「should」、「will」或「may」?2.5:「should recover」「shall resume」
附單位的可量測數值每個效能用語是否都有數字與單位?2.5:「quickly」「within 6 hours of a safe mode entry」
說明限制方向是否清楚表明數值是下限還是上限?1.6.2:「image targets up to 25 degrees off nadir」「image targets at off-nadir angles from 0 to 25 degrees」(是能力範圍,而不是指向的上限)
沒有免責條款是否有任何部分留給供應商自行判斷(「as appropriate」、「if possible」、「where practical」)?2.5:「as appropriate」已移除;改為陳述重要的條件
沒有模糊或主觀的用語兩位審查者是否可能對是否達成有不同意見(「user friendly」、「easy」、「adequate」、「enough」)?6.4:「The operator interface shall be user friendly and/or easy to use.」「The operator interface shall let a trained operator book a ground station contact in no more than 5 minutes.」(示意;每項重要工作各一項需求)
明確的名詞,不用代名詞每個「it」、「its」或「this」是否都只有一個可能的指涉對象?1.6.1:「The reference orbit shall repeat its ground track every 3 days.」「The reference orbit shall repeat the ground track every 3 days.」這裡的代名詞無害,但在較長的句子中,它是最先產生歧義的地方。
說明條件是否說明數值何時適用:生命週期階段、模式、環境?「The solar arrays shall generate 30 W.」「…at least 30 W orbit-average power at end of life.」
已確定的數值,或受追蹤的 TBD每個未確定的數值是否都有負責人與到期日加以追蹤,而不只是寫在文字中?3.5:「The thermal design shall keep the battery warm enough (TBD).」「The thermal design shall keep the battery cell temperature at or above 0 °C while charging.」(示意;在熱分析訂出數值之前,TBD 屬性會指定 Thermal Engineer 與到期日)
陳述中不放理由或附註目的片語(「so that」、「in order to」)與括號附註是否已移到理由中?3.5:「(TBD)」陳述不含括號;理由放在 Rationale 中
說明做什麼,而不是怎麼做它是否陳述需要,而不是強加應由下一層選擇的解決方案?「The thermal design shall keep the battery warm by means of a 2 W film heater.」(示意)上述 3.5 的改寫:溫度限制,加熱器則留給熱設計決定
正面且可達成在意指可量測限制時,是否避免使用「not」、「never」、「always」、「100%」?「The C&DH shall never lose a stored command.」(示意)「The C&DH shall execute each stored command within 1 second of the scheduled time.」(4.2 的現有寫法)
記錄理由是否說明了選擇該數值的原因?沒有理由的 3.1理由:「Orbit-average load grew to 26 W after PDR; 30 W keeps 15% margin.」
驗證方法與準則是否已選定方法,並從陳述推導出通過準則?3.1:方法 Test;TC-06 預期峰值功率 ≥ 72 W經由功率預算推導的通過準則:30 W 軌道平均約需 80.6 W 峰值(見下一節)
可向上追溯是否關聯到需要、父項或來源需求?沒有上游關聯的 3.13.1 derived from 1.5 Daily Collection Volume
唯一是否有其他需求以不同說法陳述同一件事?熱控章節下的第二條「The battery shall store 77 Wh」(示意)一項需求 3.2 Battery Capacity,在需要處引用

檢查清單是審查者的工具,而不是寫作範本。對照整份清單把每項需求讀一遍,而不是一次只找一條規則,並將發現連同其違反的規則一起記錄,讓作者知道要改什麼。規則也會有誤判。字詞清單檢查會把 1.6.1 中的「every」標示為全稱限定詞,但「every 3 days」是週期,並不是對所有情況的主張;由審查者判斷。

與需求一起撰寫驗證方法與允收準則

可驗證性在撰寫需求的當下最容易檢查:如果作者說不出要如何證明它已達成,它就還沒寫完。每項需求都要記錄兩件事。

  • 驗證方法:測試、分析、檢查或展示,以及執行驗證的組裝層級(元件、子系統、系統)。EO-1 四種都有:3.1 以測試驗證、1.5 Daily Collection Volume 以分析驗證、3.4 Bus Regulation 以檢查驗證,6.1 Contact Scheduling 則以展示驗證。RVTM 指南 說明如何在其中選擇。
  • 成功準則(允收準則):算作達成的可觀察結果,其陳述方式要能據以撰寫測試或分析。以 3.2 Battery Capacity 為例:「Measured capacity of at least 77 Wh at C/2 and 20 °C.」以 6.2 Image Delivery 為例:「Products on the portal within 6 h for 95% of passes in rehearsal.」

在陳述旁邊寫下準則,能抓出一類否則要到最後才會發現的錯誤。EO-1 的 3.1 由 TC-06 Solar Array Power Test 驗證,它在太陽模擬器上量測峰值功率,達 72 W 以上即通過。但需求針對的是軌道平均功率,而模型以日照比例(0.62)與功率路徑效率(0.6)將兩者互相換算。72 W 峰值換算為 72 × 0.62 × 0.6 = 26.8 W 軌道平均,低於原本的 28 W,更不用說目前的 30 W。測試門檻並不是從需求推導而來的。TC-06 實測 75.1 W 並「通過」,但 75.1 W 換算為 27.9 W,兩個數值都達不到。如果準則是依陳述撰寫的,它應該是約 30 / (0.62 × 0.6) = 80.6 W 峰值,而不足之處在第一次測試時就會顯現。變更影響分析指南 沿著從 28 W 改為 30 W 的變更追蹤同一項發現。

這個教訓可以推而廣之:通過準則應能以他人可檢查的算式追溯到需求的數值,而這個算式應寫在理由或驗證計畫中,而不是留在工程師的記憶裡。

處理 TBD 與 TBR 值

在專案初期,有些數值還不知道。省略需求會隱藏缺口;捏造數字則會隱藏不確定性。常見的做法是以佔位符撰寫需求,並將佔位符作為未結事項追蹤。

  • TBD(to be determined,待定):尚無數值。「The thermal design shall keep the battery cell temperature at or above TBD °C while charging.」
  • TBR(to be reviewed,待審查,有時寫作「to be resolved」,待解決):目前的最佳值,尚未確認。「…within 60 seconds」,其中 60 標示為 TBR。

只要數字有任何依據,就優先使用附估計值的 TBR,而不是單純的 TBD:設計者可以依估計值工作,而之後變動的數值屬於變更,會由可追溯性追蹤。每個未結事項都需要三樣東西,否則就沒有被管理:

  1. 負責人:將其結案的人。
  2. 到期日或里程碑:通常在依賴它的設計決策之前。
  3. 結案計畫:將訂出數值的分析、測試或決策。

EO-1 規格有三個未結事項。3.5 Battery Thermal Control 是一個由 Thermal Engineer 負責的 TBD,已經逾期。2.4 Target Slew(「through 30 degrees within 60 seconds」)是由 ADCS Lead 負責的 TBR,5.3 Downlink Link Margin(「at least 3 dB link margin at 10 degrees elevation」)則是由 Comms Lead 負責的 TBR;兩者都帶有工作值,供設計在分析完成前使用。

在每個里程碑清點未結事項,並預期數量會下降。含有許多未結 TBD 的需求基準線只是名義上的基準線。NASA Systems Engineering Handbook 中的審查準則要求,從系統需求審查起,未結的 TBD 與 TBR 事項都要經過識別,並附有結案計畫與時程。追蹤應放在屬性或登錄表中,而不只是寫在文字裡:句子中打上的「TBD」沒有負責人也沒有日期,也沒有任何東西會提醒人去結案。

需求類型

將需求分類有助於審查者提出正確的問題,也有助於集合保持完整。以下是常見的類別;ISO/IEC/IEEE 29148 與 INCOSE 指南描述了類似的集合,許多專案也會加入自己的類別。

類型陳述內容EO-1 範例注意事項
功能系統必須做什麼4.3 Fault Detection:「The C&DH shall enter safe mode within 10 seconds of undervoltage detection.」沒有附帶效能的功能;多數功能需求也需要說明「做得多好」,此處為「within 10 seconds」
效能功能做得多好:數量、速率、精度、時間2.1 Pointing Accuracy:「The ADCS shall point the payload boresight within 0.1 degrees of the commanded target.」缺少條件(哪個模式、哪個生命週期階段)以及缺少限制方向
介面與另一個系統或元素之間跨越邊界的內容及其特性5.2 UHF Command Uplink:「The UHF transceiver shall receive ground commands at 9.6 kbps.」完整定義位於介面控制文件中。重述 ICD 而不是引用它的需求,使兩者逐漸不一致
約束由外部強加於設計或系統建造方式的限制4.4 Downlink Encryption:「The C&DH shall encrypt each downlink frame with 256-bit keys.」其理由:客戶合約要求影像在傳輸中加密,因此這項需求來自專案外部,而不是來自專案內部的權衡。在沒有任何外部強加的情況下,把設計選擇寫成約束
環境、可靠度、安全必須承受的條件與必須達到的可靠性1.7 Mission Lifetime:「The spacecraft shall operate in orbit for at least 730 days.」未註明所宣稱的機率或信心水準的數值

功能需求與效能需求的界線,常常劃在同一句話之內:許多需求陳述一個功能及其效能,如 4.3 所示。只要這句話仍只包含一項義務,就沒有問題。介面控制文件指南 更深入地說明介面需求,功能分析指南 則說明功能需求背後的功能。

實作範例:審查 EO-1 規格

依檢查清單審查 SRS-001,可將 32 項需求分為三組。多數通過。少數有小型發現,各值得寫一句話。三項需要改寫。

對同一份規格的自動檢查與人工審查結果一致:32 項需求中有 29 項評為良好,三項較弱的需要修改。2.5 的發現事項依名稱與編號列出每一條被違反的規則,這正是作者修正時所需要的。檢查也會標示它無法判定的部分:對 3.1 而言,由於文字在上次審查後變更,正確性與可行性需等待審查者判斷。

小型發現

  • 1.6.2 Off-Nadir Imaging,「up to 25 degrees off nadir」:「up to」讀起來像上限,但其意圖是太空載具在 0 到 25 度之間任何角度都必須具備的能力。錯誤的解讀會讓只能在天底成像的設計也符合要求。
  • 1.6.1 Ground Track Repeat,「its ground track」:代名詞只有一個可能的指涉對象,因此這是輕微的發現。同一句中的「every」則是全稱限定詞規則的誤判。
  • 1.5 Daily Collection Volume 有方法(分析)與成功準則(「Simulated daily volume of at least 3.2 GB over a 30-day plan」),但尚未關聯任何分析。措辭沒有問題;驗證尚未完成。
  • 3.1 Orbit Average Power 寫得很好,但其文字在核准後變更,因此正確性與可行性需要審查者再次判斷。可行性才是真正的問題:依目前設計,太陽能板約提供 28 W 軌道平均。

三項改寫

2.5 Safe Mode Recovery。「The spacecraft should recover from safe mode quickly and resume imaging as appropriate」至少違反六條規則:用「should」而非「shall」、以「and」連接兩項義務、「quickly」沒有數值、免責條款「as appropriate」、沒有結尾句點,以及沒有驗證。改寫保留對客戶重要的那一個結果,並為其賦予數值:

The spacecraft shall resume imaging within 6 hours of a safe mode entry.

理由應說明 6 小時從何而來(N1 要求當日的作物逆境警示,而 6.2 允許從下傳到交付有 6 小時)。如果復原的各步驟本身就很重要,例如重新取得太陽指向或回報原因,每一步都應成為獨立的需求。方法:測試,在 flatsat 上進行故障注入;成功準則:在每次注入的安全模式進入後,成像都在 6 小時內恢復。

3.5 Battery Thermal Control。「The thermal design shall keep the battery warm enough (TBD).」含有模糊用語、文字中的 TBD 以及括號。修正方式是將義務、未確定的數值與理由分開:

The thermal design shall keep the battery cell temperature at or above 0 °C while charging.

0 °C 僅為示意:鋰離子電池芯通常不在冰點以下充電,但真正的限制來自電池芯規格書與熱分析。在該分析訂出數值之前,此數值是由 Thermal Engineer 負責的 TBR,到期日在熱設計審查之前。改寫也揭露了原文所隱藏的缺口:沒有關於放電溫度範圍的需求,這需要另外撰寫一項陳述。

6.4 Operator Interface。「The operator interface shall be user friendly and/or easy to use.」含有兩個主觀用語與一個「and/or」。可用性是可以規定的,但只能透過可觀察的工作:

The operator interface shall let a trained operator book a ground station contact in no more than 5 minutes.

這裡的工作與時間僅為示意。實際的集合會列出少數幾項重要工作(預約通聯、上傳目標清單、讀取最新的健康遙測),每項都附有時間與錯誤限制,並在由完成訓練的操作者參與的展示中量測。

常見錯誤

錯誤出了什麼問題較好的做法
把設計解決方案寫成需求在進行權衡之前就固定了設計,而更好的選項在沒有任何人決定的情況下就被排除了。陳述需要(「充電時將電池芯維持在 0 °C 以上」),讓下一層選擇加熱器。
將利害關係人的用語直接抄進需求「每週兩次的最新影像」是需要;依其寫法無法驗證。保留需要,並撰寫一項附數值與條件、能滿足它的需求(1.6 within 72 hours)。
一段文字中包含多項需求一個識別碼承載多項義務,而它們共用一個狀態、一項測試與同一個命運。每個項目一項需求,每項陳述一個「shall」。
沒有條件的數值壽命初期的「30 W」與壽命末期的「30 W」是不同的設計。說明模式、生命週期階段、環境與平均方式。
沒有理由沒有人能判斷之後的變更,而需求在其原因消失很久之後仍然存在。寫下數值背後的原因與數字。
測試門檻並非從需求推導測試通過了,需求卻沒有達成(TC-06 以 72 W 峰值對應 28 W 軌道平均)。以算式從陳述推導成功準則,並加以記錄。
TBD 打進文字中就被遺忘未確定的數值沒有負責人或日期,就這樣進入基準線。為每個 TBD 與 TBR 指定負責人、到期日與結案計畫並加以追蹤。
過度設計沒有人要求的需求耗費了設計與測試的心力。檢查每項頂層需求都追溯到某項需要或來源。
過度依賴自動檢查字詞檢查沒有問題,就被當成需求正確。以工具處理機械性規則;由人判斷正確、可行與必要。

在 Holarch 中試試看

在 LML 專案中,每項需求都是類別 Requirement 的一個實體,具有上述屬性:理由、狀態、優先順序、關鍵程度、擁有者、來源、驗證方法、驗證等級、成功準則,以及 TBD/TBR 欄位。

  1. 以 管理專案 → 專案檔案 ▾ → 新增示範專案 → CubeSat(引導式系統工程) 建立示範專案。其規格包含本指南中使用的三項較弱需求以及未結的 TBD/TBR 事項。
  2. 開啟 需要與需求 → 品質,在範圍清單中選擇文件,然後按一下 檢查品質。每項需求都依九項特性評分,建議會列出字詞清單或模式能檢查的 INCOSE 指南規則編號。Correct 與 Feasible 需要審查者:按一下標記以記錄決定。
  3. 依上文改寫 2.5,然後再次執行檢查。連接詞、免責條款與模糊用語的發現事項都會消失。
  4. 開啟 需要與需求 → TBD/TBR,查看附負責人與到期日的未結事項,並在某一項的數值確定後按 關閉。
  5. 若要針對規則無法判定的特性取得第二意見,請使用 ✦ AI ▾ → AI 需求檢查;每項判定與改寫都會先顯示供審查,之後才會變更任何內容。

完整參考請見 需求品質 與 TBD/TBR 登錄表 文件。

下載檢查清單

附 EO-1 改寫前後範例的需求品質檢查清單(CSV) 包含檢查清單規則及其審查問題與範例,可用於審查,或作為專案自訂寫作規則的起點。可追溯性指南 也提供同一個檔案。

關於撰寫需求的問題

Shall、must 還是 will?

只要規格有定義並始終遵守,任何慣例都可行。最普遍的慣例是以「shall」表示具約束力的需求,以「will」表示關於系統外部事物的事實與意圖,以「should」表示不予驗證的目標。有些政府寫作指南基於淺白語言的理由偏好「must」。真正的問題是在同一份規格中混用它們。

一個系統應該有多少項需求?

沒有正確的數字。小型太空載具可能有數十項系統需求,其下再有數百項;大型計畫則有數千項。更有用的問題是:每項需求是否都追溯到某項需要或父項,以及每項需要之下是否都有需求。

使用者故事是需求嗎?

使用者故事以使用者的用語記錄一項需要及其目的。它扮演利害關係人需要的角色,其允收準則則接近驗證準則。對於以硬體與軟體一同建造、整合與驗證的系統而言,故事仍需轉換為可分配與測試的需求。

工具能檢查需求品質嗎?

工具能可靠地檢查機械性規則:情態動詞、連接詞、模糊字詞、免責條款、代名詞、缺少的關聯。它無法知道 30 W 是否為正確的數值,或太陽能板能否提供它。在審查前以自動檢查清除機械性發現,讓審查者把時間花在正確性與可行性上。

下一步