指南 · 需求
如何撰寫良好的系統需求:範例與檢查清單
收聽本指南 26 分鐘
良好的需求說明系統必須做到或具備的一件事,用兩位工程師會以相同方式理解的文字,並附上可由測試或分析檢查的數值。本指南說明需要與需求的差別、需求陳述的組成、ISO/IEC/IEEE 29148 與 INCOSE Guide to Writing Requirements 中的品質特性、附改寫前後範例的檢查清單、驗證與允收準則、TBD 與 TBR 值,以及需求類型,全部以同一份 CubeSat 規格示範。
本頁內容
需求的措辭為何重要
需求是提出系統要求的人與建造系統的人之間的契約。下游的每個人都會閱讀它:設計者依它決定元件尺寸,測試工程師依它撰寫通過準則,變更委員會依它衡量變更,客戶則依它驗收系統。他們讀的是同一句話,而作者通常不在場。如果一句話可以有兩種讀法,就一定會有人這樣讀,而差異會在很晚才浮現:在一項依沒有人同意過的準則「通過」的測試中,或在驗收時,客戶原本指的是另一回事。
措辭不佳也會破壞模型的其餘部分。沒有數值的需求無法分配給元件,因為沒有人能說出元件是否滿足它。它無法驗證,因此會在 可追溯性 與 驗證矩陣 中顯示為涵蓋缺口。而當它變更時,沒有人能判斷相關聯的設計是否仍然成立。把需求寫好是專案中成本最低的品質工作:一開始在一句話上花一小時,能在最後省下一整輪測試。
本指南使用一個貫穿全文的範例: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.1 | 3.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:設計者可以依估計值工作,而之後變動的數值屬於變更,會由可追溯性追蹤。每個未結事項都需要三樣東西,否則就沒有被管理:
- 負責人:將其結案的人。
- 到期日或里程碑:通常在依賴它的設計決策之前。
- 結案計畫:將訂出數值的分析、測試或決策。
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 欄位。
- 以 管理專案 → 專案檔案 ▾ → 新增示範專案 → CubeSat(引導式系統工程) 建立示範專案。其規格包含本指南中使用的三項較弱需求以及未結的 TBD/TBR 事項。
- 開啟 需要與需求 → 品質,在範圍清單中選擇文件,然後按一下 檢查品質。每項需求都依九項特性評分,建議會列出字詞清單或模式能檢查的 INCOSE 指南規則編號。Correct 與 Feasible 需要審查者:按一下標記以記錄決定。
- 依上文改寫 2.5,然後再次執行檢查。連接詞、免責條款與模糊用語的發現事項都會消失。
- 開啟 需要與需求 → TBD/TBR,查看附負責人與到期日的未結事項,並在某一項的數值確定後按 關閉。
- 若要針對規則無法判定的特性取得第二意見,請使用 ✦ AI ▾ → AI 需求檢查;每項判定與改寫都會先顯示供審查,之後才會變更任何內容。
完整參考請見 需求品質 與 TBD/TBR 登錄表 文件。
下載檢查清單
附 EO-1 改寫前後範例的需求品質檢查清單(CSV) 包含檢查清單規則及其審查問題與範例,可用於審查,或作為專案自訂寫作規則的起點。可追溯性指南 也提供同一個檔案。
關於撰寫需求的問題
Shall、must 還是 will?
只要規格有定義並始終遵守,任何慣例都可行。最普遍的慣例是以「shall」表示具約束力的需求,以「will」表示關於系統外部事物的事實與意圖,以「should」表示不予驗證的目標。有些政府寫作指南基於淺白語言的理由偏好「must」。真正的問題是在同一份規格中混用它們。
一個系統應該有多少項需求?
沒有正確的數字。小型太空載具可能有數十項系統需求,其下再有數百項;大型計畫則有數千項。更有用的問題是:每項需求是否都追溯到某項需要或父項,以及每項需要之下是否都有需求。
使用者故事是需求嗎?
使用者故事以使用者的用語記錄一項需要及其目的。它扮演利害關係人需要的角色,其允收準則則接近驗證準則。對於以硬體與軟體一同建造、整合與驗證的系統而言,故事仍需轉換為可分配與測試的需求。
工具能檢查需求品質嗎?
工具能可靠地檢查機械性規則:情態動詞、連接詞、模糊字詞、免責條款、代名詞、缺少的關聯。它無法知道 30 W 是否為正確的數值,或太陽能板能否提供它。在審查前以自動檢查清除機械性發現,讓審查者把時間花在正確性與可行性上。
下一步
- 需求可追溯性與變更影響:將這些需求關聯到需要、設計與測試,並追蹤變更。
- 功能分析:將需求轉換為功能並加以分配。
- 需求驗證矩陣:為每項需求規劃驗證方法並記錄結果。
- Holarch 中的需要與需求:在同一個模型中處理文件、品質檢查、基準線與可追溯性。