仕様書の品質を均一化するためにテンプレートを利用する現場は多いと思うが,正しく運用できているだろうか。ちょっとした心がけの違いで,過剰品質の原因となったり,型にはまりすぎた平板な仕様書を生みだしたりする。「テンプレートの利用に伴う弊害」をテーマに取り上げ,よく起こる2タイプの事例を通して,予防するための心得とは何かを考えてみたい。 仕様書を作成する際,記述する情報の質と量が重要であることは言うまでもないが,その記述レベルは人によってばらつきやすい。特にシステムの規模が大きければ,仕様書の作成にかかわる人の数が増え,生み出される仕様書の質と量のばらつきも大きくなってくる。 このような問題を避けるため,書式や記述レベルを均一化する目的で仕様書の「テンプレート(ひな型)集」や「ガイドライン」を用意したり,プロジェクトの実情に合わせた「記述サンプル」を作って配布したりする開発現場は多いだろう。仕様
![意図が伝わる設計書作成の心得【第5回】](https://cdn-ak-scissors.b.st-hatena.com/image/square/bed39b5962a5d552c95b6d796db8f55e72d32943/height=288;version=1;width=512/https%3A%2F%2Fxtech.nikkei.com%2Fimages%2Fn%2Fxtech%2F2020%2Fogp_nikkeixtech_hexagon.jpg%3F20220512)