一言でいうと

仕様書とは、ソフトウェアやシステムがどのように動くべきかを決めた「設計図」のようなドキュメント(文書)です。

もう少し詳しく

仕様書は、プログラマーやエンジニアが「何を作るのか」「どう動くのか」を細かく書いた説明書だと考えてください。

たとえば、新しい家を建てるときは設計図が必要ですよね。設計図がなければ、どんな間取りにするのか、どこに窓を付けるのか誰もわかりません。ソフトウェアも同じで、仕様書がないと開発者が何を作ればいいのかわかりません。

仕様書には以下のようなことが書かれています。

  • ユーザーがどのボタンを押したら何が起こるのか
  • データはどのように保存されるのか
  • エラーが起きたときはどう表示するのか
  • システムの速度はどのくらい必要か

よく使われる場面

ソフトウェアが完成した後、バグ(不具合)が見つかったときに「これは仕様書通りなのか、それともバグなのか」を判断するために仕様書を確認します。また、新しいメンバーがチームに加わるときも、仕様書を読んで「このシステムはどう動くのか」を理解するために使われます。

関連する言葉

  • 要件定義書:仕様書より前に、「何が必要か」を決めるドキュメント
  • テスト仕様書:システムが正しく動くかを確認する方法を書いた書類
  • API仕様書:異なるソフトウェア同士が通信する際のルール書