SEの仕事の全体像お金・契約・工程・法律・キャリア

トップ › 2 仕事の流れ › 2-4

実装とコードレビューでは何を見て、なぜ時間をかけるのか

項目番号
2-4
棚
仕事の流れ
確かめた日
2026年10月11日
根拠
資料1

お金の意味

実装は、請負なら「完成」に向けた作業、準委任なら工数として報告する作業そのものです。書き方の質は、納品後に直す費用(保守の費用)を左右します。

コードレビューは、不具合を作った直後に見つける手段です。後のテストや本番で見つかるより、直す範囲が小さくてすみます。

実装はコーディング規約と設計に沿ってプログラムを書く工程で、コードレビューは他の人の目で不具合と読みにくさを早めに見つける工程です。

要点

  1. 実装は、詳細設計をプログラムにする工程です。コーディング規約(名前の付け方・書き方の決まり)に沿って書きます。
  2. コードレビューでは、正しく動くかに加えて、読みやすさ・直しやすさ・セキュリティ・テストのしやすさを見ます。
  3. 研究の集計では、レビューで見つかる不具合は全体の3〜9割と幅があり、中央値は6割ほどと報告されています(2001年の論文)。
  4. 変更の影響を小さな部分に閉じ込める設計は、後で見つかった不具合を直す費用を下げる、と同じ論文は述べています。

実装で守ること

  • 設計に合っているか: 詳細設計と違う作り方をしたら、設計書も直すか、理由を残します
  • 規約に沿っているか: 名前・書式・エラーの扱い・ログの出し方を、チームの規約にそろえます
  • 単体テストを書く: 自分の書いた部品が意図どおり動くかを、繰り返し確かめられる形で残します
  • 秘密を書かない: パスワードや鍵をソースコードに書かない、という決まりはセキュリティの基本です(「開発者が最初に守るセキュリティの決まり」の項目)

コードレビューで見ること

観点見る点の例
正しさ境界の値・空のとき・エラーのとき・同時に動いたときに正しいか
読みやすさ名前で意図が分かるか、1つの関数が多くのことをしていないか
直しやすさ変更が1か所ですむ構造か、同じ処理が何か所にもないか
セキュリティ入力の検証、権限の確認、秘密の扱い
テスト変更に対応するテストがあるか

レビューは人を評価する場ではなく、コードを良くする場です。指摘は「なぜそうした方がよいか」を添え、受ける側は理由を確かめてから直します。

レビューで見つかる割合

Boehm と Basili は2001年の論文「Software Defect Reduction Top 10 List」で、多くの研究をまとめると、同僚によるレビュー(peer review)が見つける不具合は31〜93%、中央値は約60%だと書いています。また、良い設計の作法は、修正を小さくまとまった部品の中に閉じ込めるので、後で直す費用の増え方を大きく抑えられる、とも述べています。

ただし、この数字は2001年の時点の研究の集計で、対象のシステムや開発のしかたは今と違います。著者自身も、リストはさらなる研究で見直されうると書いています。自分のチームの値は、自分たちのレビューの記録から確かめるのが確実です。

お金とのつながり

  • 請負の場合: 完成までにかかった作業は、見積もりを超えても原則として受注者の負担です。レビューで早く見つけるほど、手戻りの作業が減ります
  • 準委任の場合: レビューの時間も作業として工数に入ります。何にどれだけ時間を使ったかを記録しておくと、報告と次の見積もりに使えます
  • 保守の場合: 読みやすく直しやすいコードは、納品後の改修の工数を小さくします。保守を同じ会社が続けて受けるなら、その費用の見積もりにも響きます

根拠

出典

  1. 論文IEEE Computer, Vol. 34, No. 1, pp. 135-137(Boehm, B. and Basili, V. R.)(2001)「Software Defect Reduction Top 10 List」

    Numerous studies confirm that peer review provides an effective technique that catches from 31 to 93 percent of the defects, with a median of around 60 percent.

    出典:Boehm, B. and Basili, V. R. "Software Defect Reduction Top 10 List", IEEE Computer, 34(1), 2001利用規約:論文(著作権は出版社・著者)。数値と短い句の引用のみ。2026年10月11日に確認。https://doi.org/10.1109/2.962984