実装とコードレビューでは何を見て、なぜ時間をかけるのか
- 項目番号
- 2-4
- 棚
- 仕事の流れ
- 確かめた日
- 2026年10月11日
- 根拠
- 資料1
お金の意味
実装は、請負なら「完成」に向けた作業、準委任なら工数として報告する作業そのものです。書き方の質は、納品後に直す費用(保守の費用)を左右します。
コードレビューは、不具合を作った直後に見つける手段です。後のテストや本番で見つかるより、直す範囲が小さくてすみます。
実装はコーディング規約と設計に沿ってプログラムを書く工程で、コードレビューは他の人の目で不具合と読みにくさを早めに見つける工程です。
要点
- 実装は、詳細設計をプログラムにする工程です。コーディング規約(名前の付け方・書き方の決まり)に沿って書きます。
- コードレビューでは、正しく動くかに加えて、読みやすさ・直しやすさ・セキュリティ・テストのしやすさを見ます。
- 研究の集計では、レビューで見つかる不具合は全体の3〜9割と幅があり、中央値は6割ほどと報告されています(2001年の論文)。
- 変更の影響を小さな部分に閉じ込める設計は、後で見つかった不具合を直す費用を下げる、と同じ論文は述べています。
実装で守ること
- 設計に合っているか: 詳細設計と違う作り方をしたら、設計書も直すか、理由を残します
- 規約に沿っているか: 名前・書式・エラーの扱い・ログの出し方を、チームの規約にそろえます
- 単体テストを書く: 自分の書いた部品が意図どおり動くかを、繰り返し確かめられる形で残します
- 秘密を書かない: パスワードや鍵をソースコードに書かない、という決まりはセキュリティの基本です(「開発者が最初に守るセキュリティの決まり」の項目)
コードレビューで見ること
| 観点 | 見る点の例 |
|---|---|
| 正しさ | 境界の値・空のとき・エラーのとき・同時に動いたときに正しいか |
| 読みやすさ | 名前で意図が分かるか、1つの関数が多くのことをしていないか |
| 直しやすさ | 変更が1か所ですむ構造か、同じ処理が何か所にもないか |
| セキュリティ | 入力の検証、権限の確認、秘密の扱い |
| テスト | 変更に対応するテストがあるか |
レビューは人を評価する場ではなく、コードを良くする場です。指摘は「なぜそうした方がよいか」を添え、受ける側は理由を確かめてから直します。
レビューで見つかる割合
Boehm と Basili は2001年の論文「Software Defect Reduction Top 10 List」で、多くの研究をまとめると、同僚によるレビュー(peer review)が見つける不具合は31〜93%、中央値は約60%だと書いています。また、良い設計の作法は、修正を小さくまとまった部品の中に閉じ込めるので、後で直す費用の増え方を大きく抑えられる、とも述べています。
ただし、この数字は2001年の時点の研究の集計で、対象のシステムや開発のしかたは今と違います。著者自身も、リストはさらなる研究で見直されうると書いています。自分のチームの値は、自分たちのレビューの記録から確かめるのが確実です。
お金とのつながり
- 請負の場合: 完成までにかかった作業は、見積もりを超えても原則として受注者の負担です。レビューで早く見つけるほど、手戻りの作業が減ります
- 準委任の場合: レビューの時間も作業として工数に入ります。何にどれだけ時間を使ったかを記録しておくと、報告と次の見積もりに使えます
- 保守の場合: 読みやすく直しやすいコードは、納品後の改修の工数を小さくします。保守を同じ会社が続けて受けるなら、その費用の見積もりにも響きます
根拠
出典
- 論文IEEE Computer, Vol. 34, No. 1, pp. 135-137(Boehm, B. and Basili, V. R.)(2001)「Software Defect Reduction Top 10 List」
出典:Boehm, B. and Basili, V. R. "Software Defect Reduction Top 10 List", IEEE Computer, 34(1), 2001利用規約:論文(著作権は出版社・著者)。数値と短い句の引用のみ。2026年10月11日に確認。https://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.
doi.org/10.1109/2.962984