Holarch
コースのチャプター

トレーニング · トラック 2. 要求と検証 · チャプター 2.1(全 6 チャプター)

2.1 要求の記述と品質チェック 3:37

属性とともに要求を書き、品質チェックで弱い記述を見つけます。

Holarch 1.27 の画面です。

学習内容

  • 要求を、測定可能な値を含む 1 つのテスト可能な shall 文として書く
  • 仕様書のセクションの下に要求を追加する
  • 要求の優先度、検証方法、根拠、種類のラベルを設定する
  • ドキュメントで品質チェックを実行し、指摘された要求を修正する
  • 自分で要求をレビューした後、Correct と Feasible を設定する

Bike-Share Dock の仕様書に要求を書きます。良い要求の条件、セクションの下への要求の追加、優先度・検証方法・根拠の入力、ラベルの付与、要求の品質チェックの実行、弱い要求の修正、そしてレビュー担当者の判断の記録を扱います。

プロジェクトファイル

  • 開始時のプロジェクト (.holarch.json。プロジェクトを管理 → プロジェクトファイル ▾ → プロジェクトをインポート (.json)…)
  • 完成したプロジェクト (.holarch.json。プロジェクトを管理 → プロジェクトファイル ▾ → プロジェクトをインポート (.json)…)

動画は holarch.app から再生されます。プライバシーポリシーをご覧ください。

演習

CubeSat EO-1 デモプロジェクトを使って、Holarch で実際に操作します。

  1. EO-1 デモプロジェクトを開きます(または作成します:プロジェクトを管理 → プロジェクトファイル ▾ → 新しいデモプロジェクト → CubeSat(ガイド付きシステムズエンジニアリング))。
  2. ニーズと要求 → ドキュメント → EO-1 System Requirements Specification を開きます。セクション 5 Communications を選択して+ 子をクリックし、要求に Command Link Margin という名前を付けて、値を含む shall 文を書きます(たとえば、仰角 5 度で 6 dB 以上のマージン)。
  3. インスペクターで Priority を High、Verification Method を Analysis に設定し、根拠を入力してから、+ ラベルをクリックして Performance Requirement を選びます。
  4. ニーズと要求 → 品質を開き、スコープバーで Document: EO-1 System Requirements Specification を選んで品質をチェックをクリックします。2.5 Safe Mode Recovery の提案を読みます。
  5. 2.5 を 1 つの測定可能な文(何が復旧のきっかけになり、どれだけ速く、どのモードに戻るか)に書き直し、もう一度品質をチェックをクリックします。
  6. 書き直した内容を確認し、その行の Correct と Feasible の下にある ✘ をクリックして Yes にします。

2.5 Safe Mode Recovery のスコアが以前より高くなり、提案にあいまいな語が挙げられなくなり、Correct と Feasible に ✔ が表示されれば完了です。

確認問題

  1. and でつながれた要求は、両方の部分が良くてもスコアが低くなるのはなぜですか?
  2. 自動チェックが Correct と Feasible を決して設定できないのはなぜですか?
  3. quickly のような語が要求で問題になるのはなぜですか?
解答を表示
  1. and でつながれた要求は、両方の部分が良くてもスコアが低くなるのはなぜですか?

    1 つの中に 2 つの要求が含まれているからです。それらを別々に検証、トレース、変更できないため、チェックは単一性がないとして指摘します。

  2. 自動チェックが Correct と Feasible を決して設定できないのはなぜですか?

    要求が正しいニーズを述べているか、実現できるかの判断には、エンジニアリングの判断が必要です。人がレビューして、その 2 つの基準を設定します。

  3. quickly のような語が要求で問題になるのはなぜですか?

    測定できないため、どのテストでも要求が満たされたことを示せません。値と単位に置き換えます。

関連資料

トランスクリプト

トランスクリプトを表示 (ナレーションと画面の内容)

Introduction

Welcome to Requirements and Verification. This track follows requirements from the first draft to the proof that the system meets them, on the Bike-Share Dock from Getting Started.

This first chapter is about writing requirements well, and letting Holarch check them.

A good requirement

A good requirement states one thing the system shall do, in words that can only mean one thing, with a value someone can test. Vague words such as fast or user friendly cannot be tested, and two requirements joined by and cannot be checked separately.

On screen: Card: a good requirement.

Write requirements

Open the specification. Select section 5.1, Timing and Throughput, open the menu next to After, and choose Add Child. Name the requirement Pay at the Kiosk, and write its statement in the inspector.

On screen: SRS → 5.1 → Add Child → Pay at the Kiosk.

Add two more the same way: an environmental requirement under 7.1, and a usability requirement under 8.3. The usability one is written the way requirements often are on a first try.

On screen: 7.1 → Operate in Cold and Heat; 8.3 → Friendly Kiosk.

Attributes and labels

Each requirement also has attributes for planning. Select Pay at the Kiosk, and set its priority to High, its verification method to Test, and its rationale: why the value was chosen.

On screen: 5.1.1 → Priority, Verification Method, Rationale.

Give it a label too: click Label in the inspector, and choose Performance Requirement. Labels let you filter and report by kind.

On screen: + Label → Performance Requirement.

Quality check

Now check the wording. Open Needs and Requirements, then Quality, choose the specification, and click Check Quality. Each requirement is scored against nine qualities of a good requirement, with a tick or a cross for each.

On screen: Quality → Document: the SRS → Check Quality.

Friendly Kiosk scores low. The findings name the problems: user friendly and quick cannot be measured, and the and joins two requirements in one.

On screen: Findings for Friendly Kiosk.

Fix it. Go back to the document, select the requirement, and rewrite it as one measurable statement.

On screen: Back to the SRS → 8.3.1 → new description.

Check the quality again. The score rises. Two qualities, correct and feasible, always need a person: when you have reviewed a requirement, click their crosses to mark them yes.

On screen: Quality → Check Quality again → mark Correct and Feasible.

Recap

Let's recap. You learned what makes a requirement good, added requirements under sections, filled in their attributes and labels, ran the quality check, fixed a weak requirement, and recorded your own judgment.

Next, you trace the stakeholder needs to these requirements.