【プログラミング習得】インプット-アウトプット法（詳細版・プログラム仕様のまとめ方）

今回もエンジニア向けのスキルアップ方法について書いていきます。

プログラミングの習得は、エンジニアにとって大きな課題で、前回の記事でも効果的なトレーニング方法としてインプット-アウトプット法を紹介しました。

インプット-アウトプット法の概要は以下の手順でした。

見本のソースコードを見つける
ソースからプログラム仕様とコーディング技能をノートなどにまとめていく
仕様と技能を見て、実際にコーディングする
自分がコーディングしたものと見本のソースの相違点をチェックしながら、スキルアップする

今回はその詳細版で、プログラム仕様のまとめ方について詳しく解説していきたいと思います。

今回も以下の方向けになっています。

これからエンジニアを目指す方
すでにエンジニアで新しい技術を身につけたい方
主体的な勉強方法を取り入れたい方、部下などに紹介したい方

見本からプログラム仕様を書き起こすメリット
プログラム仕様を書き起こす方法
リンク

見本からプログラム仕様を書き起こすメリット

仕様を書き出すのは”リバースエンジニアリング”とも言われ、システムの実態の把握のため仕様書を起こす事が保守開発の現場ではよく行われています。

そして今回行う見本ソースコードからのリバースエンジニアリングには、以下のようなメリットがあります。

プログラムを解読する訓練になる
仕様書（詳細設計）を書く訓練にもなる
仕様書からプログラムを書く訓練にもなる

このように一石二鳥どころか一石三鳥なので、一見手間がかかるように見えて効果が大きいです。

概要版でも触れましたが、自分の頭で考えてプログラミングする為、スキルの定着に効果的な方法です

プログラム仕様を書き起こす方法

以下では、仕様を書き起こす方法について主に２つ説明します。

ソフトウェア設計のテクニックを使う

ソフトウェア設計の分野では、設計手法がいくつか提供されています。

そのため、色々ある設計手法の中から、適切なものを選んで仕様書を書くようになります。

つまりこの作業で、ソフトウェア設計手法を習得する訓練にもなるということです。

そこで、以下ではソフトウェア設計の中でも、プログラム開発に直接関わる詳細設計の分野からいくつか手法を紹介していきます。

モジュール分割法

プログラムソースから仕様を起こすため、基本はモジュール単位で仕様を書いていくようになります。

そこで代表的として、モジュール分割法を紹介します。*1)

モジュール分割法に、STS分割法・ワー二エ法・ジャクソン法などいろいろありますが、詳細は下記リンクを参考ください。

ここでは、例としてSTS分割法を元にした仕様の記載例です。

STS分割の仕様の例：
● プログラムへの入力関連の情報
→ 入力方法：手入力・固定値・別モジュールからの引数などで記載
→ 入力内容：上記方法で何が入力されるか（具体的な変数やオブジェクトなど）

● 処理内容
→ 入力データの加工内容
→ 途中での別モジュールとの連携
→ ループや分岐などの処理

● 出力内容
→出力方法：テーブルや画面、帳票など
→出力のイメージ図を記載

STS分割法はソフトウェアの処理を、「入力」「処理」「出力」という枠組みで仕様整理していきます。

必要に応じて図で示しても良いでしょう。

もしプログラムが「入力」「処理」「出力」の形式で整理できるものなら、STS分割法は適切になります。