上流工程とAI駆動開発 1207上流工程とAI駆動開発

レビューの6観点と読み方

一覧に戻る

レビューの6観点は見るところと読み方がそれぞれ違うので、読む人は観点ごとに設計書をたどる向きを変える。96秒の動画で、効果音と画面の字幕だけで進みます。

用語 例外系 = Exception cases、非機能 = Non-functional

字幕の全文

  1. 同じ設計書を、1人は「要件漏れ」、もう1人は「矛盾」の観点で読むとします
  2. このとき2人は、同じ資料の同じ場所から読み始めるでしょうか
  3. まず要件漏れを探す人は、設計書より先に要件一覧を開きます
  4. そして要件一覧を上から1件ずつ読み、設計書の中でその要件を探すのです
  5. 反対に矛盾を探す人は、設計書の1つの項目を全部のシートで横に追います
  6. 同じ項目の扱いがシートごとに違っていれば、そこが矛盾の指摘になります
  7. このように、観点が変わると、設計書をたどる向きも変わるのです
  8. 3つ目の曖昧表現では、読む人で解釈が変わる言葉を探します
  9. 見つけた言葉は、数や条件に置き換えられるかを試しましょう
  10. 4つ目は、0件や上限超え、失敗、期間の境目のような場合を見る観点です
  11. 正常な1件の流れから外れるこうした場合を、例外系と呼びます
  12. 例外系では、正常な流れを先に決め、そこから外れる場合を並べましょう
  13. 5つ目は、権限、性能、監査、運用を見る観点で、非機能と呼びます
  14. 非機能では、誰が、何秒で、何を残すかが書いてあるかを探しましょう
  15. 6つ目の項目定義・形式では、型と桁と必須、IDの付け方を見ます
  16. シートごとに並べて見比べると、そろっていない書き方が見つかるのです
  17. ところが、1回の読みで6つを同時に追うと、読み方が混ざってしまいます
  18. 上から読む向きと横に追う向きを、同時には進められないからです
  19. 設計書を開く前に観点を1つ決め、その読み方で最後まで読みましょう