ガイド · 要求
良いシステム要求の書き方:例とチェックリスト
このガイドを聴く(英語音声) 26 min
良い要求は、システムがしなければならないこと、またはそうでなければならないことを一つ、二人のエンジニアが同じように読める言葉で、テストや解析で確認できる値とともに述べます。このガイドでは、ニーズと要求の違い、要求文の構成要素、ISO/IEC/IEEE 29148 と INCOSE Guide to Writing Requirements の品質特性、修正前と修正後の例を含むチェックリスト、検証と受け入れ基準、TBD と TBR の値、要求の種類を扱い、すべてを一つの CubeSat の仕様書で実践します。
このページの内容
要求の言葉遣いが重要な理由
要求は、システムを依頼する人々とそれを作る人々の間の契約です。下流のすべての人がそれを読みます。設計者はそれに照らしてコンポーネントの寸法を決め、テストエンジニアはそこから合格基準を書き、変更委員会はそれに照らして変更を検討し、顧客はそれに基づいてシステムを受け入れます。全員が同じ文を、たいていは作成者のいないところで読みます。文が二通りに読めるなら、実際に二通りに読まれ、その違いは遅くなってから表面化します。誰も合意していない基準に対して「合格」したテストの場面や、顧客が別のことを意図していた受け入れの場面です。
言葉遣いが悪いと、モデルのほかの部分も壊れます。値のない要求は、コンポーネントがそれを満たすかどうか誰も言えないため、コンポーネントに割り当てられません。検証できないため、トレーサビリティと検証マトリックスにカバレッジのギャップとして現れます。そして変更されたとき、リンクされた設計がまだ成り立つかどうか誰にもわかりません。要求をうまく書くことは、プロジェクトで最も安い品質作業です。最初に一つの文にかける 1 時間が、最後のテストキャンペーンを一つ節約します。
このガイドでは、一つの例を通して使います。四つのスペクトルバンドで農地を撮影する架空の 6U CubeSat、EO-1 です。その仕様書 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.(農業の顧客は、生育期に少なくとも週 2 回、自分の圃場の新しい画像を必要としている。) | 妥当性確認:顧客は納入されたシステムから必要なものを得ているか? |
| 要求(1.6 Revisit Time) | The mission shall revisit each target region within 72 hours.(ミッションは、各ターゲット領域を 72 時間以内に再訪すること。) | 検証:システムは、テスト、解析、検査、実証によって記述を満たしているか? |
違いは、それぞれの確認方法に表れます。要求は検証されます。システムを記述に照らして測定します。ニーズは妥当性確認されます。システムが意図された使用の中で、ステークホルダーが望んだことを行うことを誰かが確認します。要求が要点を外していれば、システムはすべての検証に合格しても、妥当性確認に失敗することがあります。そのギャップは検証と妥当性確認のガイドで扱っています。書く作業にとっての実際的な帰結は単純です。まずニーズを書き、満たされればそのニーズを満たすことになる要求を書き、各要求をそれが応えるニーズにリンクします。
変換が一対一になることはまれです。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」 |
| Action | 主語が行うこと、またはそうであること。能動態の動詞で | 「enter」 |
| 目的語 | 動作の対象 | 「safe mode」 |
| 性能または制約 | 単位と限界の方向を伴う測定可能な値 | 「within 10 seconds」 |
まとめると「The C&DH shall enter safe mode within 10 seconds of undervoltage detection.」(C&DH は、低電圧の検出から 10 秒以内にセーフモードに入ること。)となります。順序は変えてもかまいません(「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…」)は、要求ではなく前提条件として正しく書かれています。これはそれに依存する要求のための文脈であり、モデルはスコア付けも検証もされない記述として保存しています。
属性
以下は、PDR 後に 28 W から 30 W に変更された後の、EO-1 モデルに記録されている 3.1 Orbit Average Power です。
| 属性 | 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.(太陽電池アレイは、寿命末期に軌道平均で 30 W 以上の電力を発生すること。) | 義務そのもの |
| 根拠 | Orbit-average load grew to 26 W after PDR; 30 W keeps 15% margin.(PDR 後に軌道平均負荷が 26 W に増加。30 W で 15% のマージンを維持。) | 後の読み手が、作成者なしに変更を判断できるようにする |
| 出典と親 | Derived (systems analysis)。1.5 Daily Collection Volume から派生 | 後方トレーサビリティ:要求が存在する理由 |
| 検証方法とレベル | テスト、サブシステムレベル | 証明する計画。書く時点で決める |
| 成功基準 | 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 は 1 日あたり 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.」重要なほかの復帰手順には、それぞれ独自の要求を立てる。 |
| 義務を表す言葉遣い | 拘束力のある要求には、「should」「will」「may」ではなく「shall」を使っているか? | 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)」 | 括弧のない要求文。理由は根拠に記載 |
| どのようにではなく、何を | 下位のレベルが選ぶべき解決策を押し付けるのではなく、ニーズを述べているか? | 「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:方法はテスト。TC-06 はピーク電力 ≥ 72 W を期待している | 電力予算を通じて導いた合格基準:軌道平均 30 W にはピークで約 80.6 W(次のセクションを参照) |
| 上方へのトレーサビリティ | ニーズ、親、出典の要求にリンクされているか? | 上流へのリンクがない 3.1 | 1.5 Daily Collection Volume から派生した 3.1 |
| 一意 | ほかの要求が別の言葉で同じことを述べていないか? | 熱のセクションの下にある 2 つ目の「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 となり、現在の 30 W はおろか、元の 28 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 の印を付ける。
数値に何らかの根拠があるなら、裸の TBD より推定値付きの TBR を選びます。設計者は推定値に合わせて作業でき、後で値が動けばそれは変更となり、トレーサビリティがそれを追います。各未決事項には三つのものが必要です。そうでなければ管理されていません。
- 担当者:それを解決する人。
- 期限またはマイルストーン:通常は、それに依存する設計上の決定より前。
- 解決計画:値を決める解析、テスト、決定。
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」は、少なくとも六つのルールに違反しています。「shall」ではなく「should」、「and」でつながれた二つの義務、値のない「quickly」、逃げ道となる表現「as appropriate」、文末のピリオドの欠落、検証の欠落です。書き直しでは、顧客にとって重要な一つの結果を残し、それに値を与えます。
The spacecraft shall resume imaging within 6 hours of a safe mode entry.(宇宙機は、セーフモードに入ってから 6 時間以内に撮像を再開すること。)
根拠には、6 時間がどこから来たかを書くべきです(N1 は当日の作物ストレスのアラートを求めており、6.2 はダウンリンクから配信まで 6 時間を許容しています)。Sun 指向の再捕捉や原因の報告など、復帰の手順がそれ自体で重要なら、それぞれを独自の要求にします。方法:フラットサットでの故障注入によるテスト。成功基準:注入した各セーフモード移行で、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 以上に保つこと。)
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.(オペレーターインターフェースは、訓練を受けたオペレーターが 5 分以内に地上局とのコンタクトを予約できるようにすること。)
作業と時間は例示です。実際のセットでは、重要な少数の作業(コンタクトの予約、ターゲットリストのアップロード、最新のヘルステレメトリーの確認)を、それぞれ時間とエラーの上限とともに挙げ、訓練を修了したオペレーターによる実証で測定します。
よくある間違い
| 間違い | 何がまずいか | より良い方法 |
|---|---|---|
| 設計上の解決策を要求として書く | トレードを行う前に設計が固定され、誰も決めないうちに、より良い選択肢が除外される。 | ニーズを述べ(「充電中のセルを 0 °C 以上に保つ」)、ヒーターは下位のレベルに選ばせる。 |
| ステークホルダーの言葉をそのまま要求に写す | 「週 2 回の新しい画像」はニーズであり、書かれたままでは検証できない。 | ニーズは残し、それを満たす値と条件を伴う要求を書く(1.6 within 72 hours)。 |
| 一つの段落に複数の要求 | 一つの識別子が複数の義務を担い、それらが一つのステータス、一つのテスト、一つの運命を共有する。 | 一つの項目に一つの要求、一つの要求文に一つの「shall」。 |
| 条件のない値 | 寿命初期の「30 W」と寿命末期の「30 W」は別の設計になる。 | モード、寿命の段階、環境、平均の取り方を明記する。 |
| 根拠がない | 後の変更を誰も判断できず、理由がなくなった後も長く要求が残る。 | 値の背後にある理由と数値を書く。 |
| 要求から導かれていないテストのしきい値 | 要求が満たされていないのにテストが合格する(軌道平均 28 W に対してピーク 72 W の TC-06)。 | 成功基準を計算によって要求文から導き、それを記録する。 |
| テキストに打ち込まれて忘れられた TBD | 未決の値に担当者も期限もなく、そのままベースラインに入る。 | 各 TBD と TBR を、担当者、期限、解決計画とともに追跡する。 |
| 過剰な要求(ゴールドプレーティング) | 誰も求めていない要求が設計とテストの労力を消費する。 | 最上位の各要求がニーズまたは出典にトレースされていることを確認する。 |
| 自動チェックへの過度な依存 | 語のチェックで問題がないことが、要求が正しいことと取り違えられる。 | 機械的なルールにはツールを使い、正確性、実現可能性、必要性は人が判断する。 |
Holarch で試す
LML プロジェクトでは、各要求はクラス Requirement のエンティティで、上で説明した属性(Rationale、Status、Priority、Criticality、Owner、Source、Verification Method、Verification Level、Success Criteria と 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 のニーズと要求:ドキュメント、品質チェック、ベースライン、トレーサビリティを一つのモデルで。