「差分ツールで変更箇所は出たが、何を確認すればよいか分からない」
「修正箇所は正しいのに、関連する表の更新漏れを見逃した」
設計書の差分確認は、赤く表示された箇所を読むだけの作業ではありません。変更要求に必要な差分がすべて入り、意図しない差分がなく、関連箇所が取り残されていないことを確認する作業です。
WordやExcelでは、書式、列幅、改ページ、自動更新による差分が大量に出ることがあります。本当に確認すべき内容変更が埋もれないよう、差分を分類する必要があります。
長く保守されるシステムでは、一つの定義が本文、表、図、別冊資料に重複していることもあります。変更箇所の前後と横並びを確認しなければ、資料内の矛盾が残ります。
この記事では、差分ツールの結果を使いながら、変更漏れと意図しない変更を見抜く手順を解説します。
差分は「必要・不要・不足」の3種類に分ける
表示された差分が変更要求に必要なものか、書式など不要なものかを確認します。さらに、表示されていないが本来変更すべき関連箇所、つまり不足差分を探します。
差分ツールは変更された場所を示しますが、変更されるべきなのに変わっていない場所までは教えてくれません。
| 分類 | 意味 | 確認例 |
|---|---|---|
| 必要差分 | 要求どおりの変更 | 条件・項目・メッセージの更新 |
| 不要差分 | 意図しない内容・書式変更 | 列幅、フォント、改ページ |
| 不足差分 | 本来更新すべき未変更箇所 | 関連表、図、別章、別資料 |
| 判断保留 | 要件や正が不明な差分 | 実装との不一致、曖昧な定義 |
差分レビューを行う4ステップ
1．比較対象の版と変更一覧を固定する
比較する旧版・新版の版数、更新日、承認状態を確認します。途中版同士を比較すると、関係のない差分が混ざります。
課題票や変更一覧を用意し、今回入るべき変更を先に把握します。差分を見る前に期待値を持つことが大切です。
2．差分を必要・不要・判断保留へ分類する
差分ツールの結果を上から確認し、変更一覧と対応付けます。書式差分が多い場合は、内容差分と分けて処理します。
意図が分からない差分を推測で承認せず、変更者へ理由を確認します。
- 変更要求に対応しているか
- 変更前後の意味が明確か
- 書式だけの変更ではないか
- 削除した情報が別の場所へ移ったか
- 変更理由や課題番号が追えるか
3．前後関係と横並びから不足差分を探す
変更行の前後にある条件、例外、注記を確認します。同じ項目やコードを文書内検索し、別章、一覧、図、サンプルに古い定義が残っていないか確認します。
正常系を変えた場合は異常系、登録を変えた場合は照会・取消、オンラインを変えた場合はバッチなど、対になる処理も見ます。
変更：ステータス02の名称を「処理済」から「送信待ち」へ変更 横並び確認： ・コード定義一覧 ・画面表示 ・APIレスポンス仕様 ・バッチ抽出条件 ・運用手順 ・テスト期待結果
4．要件・実装・テストとの整合を確認する
設計書内で整合していても、要件や実装、テスト仕様と違っていれば不十分です。変更要求の受入条件を満たし、実装可能・テスト可能な記述かを確認します。
レビュー指摘の反映後は、差分をもう一度確認します。指摘修正によって新しい差分や戻し漏れが生じることがあります。
差分確認記録のテンプレート
差分ごとの判断と根拠を残すと、再レビューと承認が速くなります。
【比較対象】 旧版： 新版： 変更要求・課題番号： 【差分一覧】 No.／章・ページ／差分概要／分類／根拠／指摘／対応結果 分類：必要／不要／不足／判断保留 【横並び確認】 同一項目の記載箇所： 対になる処理： 関連資料： 【最終確認】 要件整合： 実装整合： テスト整合： 残課題：
レビュー記録では、単に「OK」とせず、変更一覧との対応や確認した関連箇所を残すと、承認根拠になります。
よくある失敗と改善方法
| 失敗 | 起こる問題 | 改善方法 |
|---|---|---|
| 差分表示だけを見る | 未変更の更新漏れを検出できない | 文書検索と影響一覧で不足差分を探す |
| 書式差分を放置する | 内容差分が埋もれ、レビュー負荷が上がる | 内容変更と書式変更を分ける |
| 指摘反映後に再比較しない | 修正による新たな誤りを見逃す | 最終版でもう一度差分確認する |
若手SE向けチェックリスト
- 旧版・新版・承認状態を確認した
- 変更一覧と差分を対応付けた
- 必要・不要・判断保留へ分類した
- 同一項目を文書内・関連資料で検索した
- 正常系と異常系など対になる処理を確認した
- 要件・実装・テストとの整合を確認した
- 指摘反映後の最終差分を確認した
まとめ：差分確認では、変わった場所と変わるべき場所を見る
差分ツールは、変更箇所を見つけるための便利な道具です。しかし、レビューで本当に必要なのは、変更要求との一致と、関連箇所の更新漏れを確認することです。
必要差分、不要差分、不足差分を意識すると、単なる誤字チェックから一段深いレビューになります。
- 比較版と変更一覧を先に固定する
- 差分を必要・不要・不足へ分類する
- 前後・横並び・関連資料で更新漏れを探す
コメント