上流工程とAI駆動開発 1207上流工程とAI駆動開発
レビューの6観点と読み方
レビューの6観点は見るところと読み方がそれぞれ違うので、読む人は観点ごとに設計書をたどる向きを変える。96秒の動画で、効果音と画面の字幕だけで進みます。
用語 例外系 = Exception cases、非機能 = Non-functional
字幕の全文
- 同じ設計書を、1人は「要件漏れ」、もう1人は「矛盾」の観点で読むとします
- このとき2人は、同じ資料の同じ場所から読み始めるでしょうか
- まず要件漏れを探す人は、設計書より先に要件一覧を開きます
- そして要件一覧を上から1件ずつ読み、設計書の中でその要件を探すのです
- 反対に矛盾を探す人は、設計書の1つの項目を全部のシートで横に追います
- 同じ項目の扱いがシートごとに違っていれば、そこが矛盾の指摘になります
- このように、観点が変わると、設計書をたどる向きも変わるのです
- 3つ目の曖昧表現では、読む人で解釈が変わる言葉を探します
- 見つけた言葉は、数や条件に置き換えられるかを試しましょう
- 4つ目は、0件や上限超え、失敗、期間の境目のような場合を見る観点です
- 正常な1件の流れから外れるこうした場合を、例外系と呼びます
- 例外系では、正常な流れを先に決め、そこから外れる場合を並べましょう
- 5つ目は、権限、性能、監査、運用を見る観点で、非機能と呼びます
- 非機能では、誰が、何秒で、何を残すかが書いてあるかを探しましょう
- 6つ目の項目定義・形式では、型と桁と必須、IDの付け方を見ます
- シートごとに並べて見比べると、そろっていない書き方が見つかるのです
- ところが、1回の読みで6つを同時に追うと、読み方が混ざってしまいます
- 上から読む向きと横に追う向きを、同時には進められないからです
- 設計書を開く前に観点を1つ決め、その読み方で最後まで読みましょう