📑

要求図の「包含」と「導出」をきちんと区別しよう! ― 要求定義で思考の階段を一段ずつ登るために

に公開1件

※ この記事はnote.comの自作コンテンツの転載です。

要求図の「包含」と「導出」をきちんと区別しよう! ― 要求定義で思考の階段を一段ずつ登るために

開発ドキュメントをレビューする場で要求図を目にしたときに、ある種の「こうじゃない感」を覚えることがあります。その正体を探っていくと、多くの要求図が単なる「機能の箇条書き」や、実装を前提とした内部構造の書き直しになっていることに気づきます。

もっとも大きな問題は、SysMLにおける 「包含(Containment)」と「導出(Derivation)」の使い分けが混同されている点にあります。

1. 標準がエンジニアに委ねたもの

SysML v1.6までは、仕様書の付録(Annex E)に「機能要求(«functionalRequirement»)」や「性能要求(«performanceRequirement»)」といった具体的な種別(ステレオタイプ)が例示されていました。

しかし、SysML v1.7ではこれらは「非推奨」となり、規範的な定義は単一の «requirement» のみに集約されました。これは、特定のドメインに縛られない汎用性を追求した結果といえます。しかし、標準から消えたからといって、分類が不要になったわけではありません。むしろ、自分たちのドメインに最適な「語彙」を自分たちで定義する責任が、エンジニアに委ねられたのだと考えた方がよいでしょう。

2. 思考を支える独自のステレオタイプ

本稿では、要求の階層を整理するために以下のステレオタイプを独自に導入します。

  • «feature»:顧客価値やシステムの「特徴」を表します。実装に依存しない、抽象度の高い「価値」の単位です。

  • «definition»:要求の根底にある「判定基準」を固定します。曖昧な言葉を、客観的に判断可能な状態へと変換するアンカーの役割を果たします。

ここで、「定義なら用語集(グロッサリー)に書けば十分ではないか?」という疑問があるかもしれません。しかし、用語集に書き加えることと、要求図に取り上げることには、明確な意図の違いがあります。

  • 用語集(名詞の定義):「障害物」や「自車」など、モノ(名詞)を定義した「辞書」です。

  • 要求図の «definition»(動作の判定基準):「回避する」といった動作(動詞)が、どのような状態をもって「成功」とみなされるのかを定義する、論理の「土台」です。


3. 要求図を描く前に:思考の「棚卸し」と「仕分け」

いきなり図を書き始めると、どうしても「書きやすいところ」から手が動いてしまいます。まずは、脈絡なく出された箇条書きの要求を仕分けすることから始めてみましょう。

車の自動ブレーキによる衝突回避を題材にしてみます。私は車載開発を専門にしているわけではないので、現実とは乖離しているかもしれませんが、わかりやすい説明のためとして、ご容赦ください。

■ ステップ1:生の「要求の断片」を並べる

  • 衝突・追突を回避できること。

  • 前方障害物に対して減速できること。

  • 回避とは「自車進行方向における相対速度が 0km/h になること」を指す。

  • 相対速度 80km/h までは対応する必要がある。

  • 必要に応じて停止できること。

  • ドライバーに警告できること。

  • 後続車に通知し、二次被害を防ぐこと。

  • 路面状態の変化や障害物の移動も考慮すること。

  • 人間のとっさの行動(ハンドル操作など)と、システムによる安全動作の矛盾に対応できること。

■ ステップ2:構造の整理(アウトライン)

分類に基づき、関係性を整理します。

【価値の階層:包含関係で整理するもの】 「言い換え」や「構成要素」の列挙であり、価値の解像度を上げる作業です。

  • F0:衝突・追突回避(メインの価値)

    • D0:回避の判定基準(相対速度 Vrel​=0)

    • F1:前方減速

    • F2:緊急停止

    • F3:ドライバー警告

    • F4:後続車通知

【論理の階層:導出関係で繋ぐもの】 上位の目的を果たすために、エンジニアリングとして導き出した「具体的な要求」です。

  • Q1[性能要求]:相対速度 80km/h 対応(F0 から導出)

  • Q2[環境条件]:路面状態の変化に対応(F1, F2 から導出)

  • Q3[調停要求]:人間と制御の矛盾への対応方針(F1, F2 から導出)


4. 要求図における「論理の階段」

整理した関係性を 要求図 で表現します。ここで重要なのは、 「包含(+)」と「導出(矢印)」を明確に使い分ける ことです。

5. 実践における注意点

「包含」は整理の棚、「導出」は思考の跡

包含関係(AND 集合)を使って良いのは、すでに構成が決まったあとの整理のときだけです。要求を深掘りしている最中は、常に「なぜこの具体的な要求が必要か」という論理の階段を一歩ずつ登るように、導出の矢印(«deriveReqt»)で思考を繋がなければなりません。

答えを急がない「矛盾への対応」

「人間の操作とシステムの自動制御が矛盾したとき」の要求(Q3)は、非常に高度な設計判断を要します。安易に「人間優先」といった結論を急いではいけません。 大切なのは、具体的な実現方法に走る前に、「矛盾が発生しうることを認識し、どのような優先順位や調停ロジックで解決すべきか」を、独立した「要求」として定義し尽くすことです。

ソフトウェア構造をあえて描かない

「この図では内部の機能構成が分からない」という批判を受けるかもしれません。しかし、それは要求図が正しく開発上の役割を果たしている証拠でもあります。 要求図の役割は「何(What)を成し遂げたいか」の論理を示すことであり、「どう作るか(How)」を示すことではないからです。内部構造に逃げず、純粋な論理に向き合うことで、はじめて技術基盤が変わっても揺るがない「要求の核心」を掴むことができます。

混ぜるな危険:«satisfy» の誘惑

要求図の中に、それを満たすブロック(設計要素)との関係(«satisfy»)を描き込みたくなるかもしれません。しかし、同じ図の中に「物理的な構成」が登場した瞬間に、私たちの意識は論理から構造へと引きずり戻されてしまいます。 要求図は「設計の正当性」を問う場所であり、設計の結果を清書する場所ではありません。この図を登りきった先に、ようやく設計との出会いがあるのです。

この「設計の正当性」をどう表現するのかについては、いずれ別の記事で議論したいと考えています。


まとめ:モデルが見せる「エンジニアの意思」

技術レビューの場において、私たちが見たいのは綺麗に整列したツリーではありません。

「なぜ、その機能が必要だと言い切れるのか」 「その数値は、どの価値から導き出されたのか」

包含関係で「整理」された棚の奥にある、「導出」という名の考え抜いた論理の連鎖を、私たちは探しています。 要求図は単なるドキュメントではありません。あなたが要件を分析する過程で、いかに誠実に思考の階段を登ってきたかを証明する、唯一の地図なのです。


主要参考文献・リファレンス

  • OMG Systems Modeling Language (OMG SysML™) v1.7 https://www.omg.org/spec/SysML/1.7/ (Version 2.0もリリースされているが、現在最も一般的な仕様。Requirement Diagram については Section 16 を参照)

  • OMG Systems Modeling Language (OMG SysML™) v1.6 https://www.omg.org/spec/SysML/1.6/ (Annex E: Non-normative Extensions にて過去の要求種別の例示を確認可能)


Discussion

kuboakikuboaki

要求図、書いてもらうの難しいですよねー。