見出し画像

2.1.5項 設計書・仕様書

更新 Z 
小中高生に、エンジニアの魅力を伝えたい「エンジニアの教科書」2.1.5項。

あなたが何かを作るとき、「こういうものを作りたい!」というイメージだけでは、他の人には伝わりません。そのため、言葉で
 ・「どんな動作をするのか」
 ・「どんな形になるのか」
などを記述する必要があります。これが 「設計書」や「仕様書」 です。
上手な設計書は、変化することを前提で記載してあります。



1. 設計書とは?

設計書とは「これから作るもの の 動作や仕組み を、言語や数字 で記述したもの」 です。
設計図(部品図・回路図など)を描く 上流のエンジニア が作成します。
設計書には多くの種類がありますが、V字開発モデル では、以下のように分類されます。

製品設計書:(全体の仕様・要求を定義)
ユニット設計書:(各機能ブロックごとの仕様)
ソフトウェア設計書:(プログラムの構成・動作ルール)
評価設計書:(どのようにテストするかの手順)

「神が世界を作るとき、まずロゴス(言葉)があった」と言われるように、
製品を作るにも まず「言語での記述」 が必要です。
これを トポロジー(ものごとの構造や、つながりを示す考え方)と表現することもあります。


2. 仕様書の重要性

最近では、AI(ChatGPT など)がプログラムを自動生成してくれるため、仕様書の質 がますます重要になっています。

 ✔ あいまいな仕様書 → AIが正しく理解できず、プログラムが間違う
 ✔ 明確な仕様書 → AIが適切なコードを書き、バグも少なく、時間短縮

例えば、仕様書に 「条件分岐が3つ」「繰り返し回数は10回」 などの具体的な指示が書かれていれば、AIは正確なプログラムを生成しやすくなります。

つまり、「上手な仕様書を書くスキル」は、それだけで仕事になる レベルで重要 なのです。


3.【やる気Upポイント】

リーダーになったとき、明確な設計書を作れる人は、尊敬される!
 チームメンバーにとって 分かりやすい設計書を作れる人 は、信頼され、頼られる存在になります。

「だいたいこんな感じ」で済ませない!
 設計書を書くときは、
「この設計書で、メンバーは どのような行動 を起こすか?」
  を考えることが大切です。
 チームの動きを想像しながら書くと、自然と 良い設計書 になります。

AI時代でも「人間のしたいこと」は人間が考えます。
 設計書を書く仕事は、だから無くなることはありません。
 自分のやりたい事を、言葉にする訓練をしましょう。


4. 参考図書/Webサイト

「アプリ開発における仕様書の概要と種類とは?要求書を書くときのポイントを解説」 株式会社 Hybrid Technologies Co., Ltd.
 → 仕様書のV字モデルは、一般的。
  ソフトウェアの仕様書として、文章は記載されていますが。
  機械・電気の設計も、流れとしては同じです。

上記サイトより、引用。 この図は、よく見かけるフローです。


「基本設計とは?書き方や成果物一覧、詳細設計との違いから役立つツールまで紹介」  株式会社Jitera
 → 全体的な流れがわかる、よいサイトだと思います。

上記サイトより、引用。 この図のように、上流 から 下流 を考えて、仕様書は記載します。


99_履歴

( 読者様にお願い: 誤記・間違い・改善点など、指摘ください。)

改定日   記号 変更点
2025/10/27 Z  初版

いいなと思ったら応援しよう!