AIツール

AIの変更を小さく確認する方法|Windowsで差分を読む練習

AIに「この部分だけ直して」と頼んだら、関係のない数字や設定まで変わっていた。完成後にまとめて読むほど、こうした変更を見つけにくくなります。

今回は、変更の途中で、前後の違いを小さく確認する練習です。自作の短いPython例と公開できる架空の文章を使いました。ClaudeなどのAI製品のレビュー精度を測った記事ではありません。有料サービスやAIモデルを呼ばずに試せる範囲を扱います。

先に結論:差分は「変わった場所」を読むためのもの

差分とは、変更前と変更後の違いです。今回の例では、消えた行に -、加わった行に + を付けて表示します。どこが変わったかは分かりますが、その変更が正しいか、依頼に合うかは別に判断します。

実際の開発なら、設定値、送信先、削除する範囲、権限、費用に関わる部分を重点的に読みます。依頼と違う変更があれば、次の実行や公開に進まず、理由を確認して直します。今回は仕事のソースやログを使っていません。

きっかけは、Anthropicのコードレビュー運用記事です。原典は2026年10月15日公開、10月18日に本文を確認しました。レビューを最後だけに置かず途中にも入れる着眼点を、初心者向けの独自練習にしています。同社の製品導入手順や効果の再現ではありません。

図解:小さく直し、前後を比べる

変更前を残し、小さく変更して差分を読む。マイナスは変更前、プラスは変更後。正誤は人が判断する

まず、変更前の内容を残します。次に変更範囲を小さく区切り、前後を比較します。読んだ後にも変更が入ったら、以前の確認を使い回さず、最新の差分を読み直してください。

「差分が少ないから安全」とは限りません。短い否定語の削除だけでも、処理の意味が反対になることがあります。差分を読む作業に加えて、変更に合った動作確認と戻し方を用意します。

Windowsで試す:公開ダミーから差分を作る

準備するもの

今回はWindowsとPython 3.12.14で確認しました。Pythonが既に使える環境向けです。追加パッケージやGitは使いません。Pythonが入っていない場合は、ここで止めて環境を確認してください。macOS・Linuxでは今回試していません。

新しい練習用フォルダを開き、次のコードを review_demo.py という名前でUTF-8保存します。メモ帳で保存するときは、末尾が .py.txt にならないよう確認します。実案件のファイルや顧客情報は入れません。

短い例を保存して実行する

from pathlib import Path
from difflib import unified_diff

def write_diff(folder):
    before = (folder / "before.txt").read_text(encoding="utf-8")
    after = (folder / "after.txt").read_text(encoding="utf-8")
    result = "".join(unified_diff(
        before.splitlines(keepends=True),
        after.splitlines(keepends=True),
        fromfile="before.txt", tofile="after.txt"))
    (folder / "changes.diff").write_text(result, encoding="utf-8")
    return result

if __name__ == "__main__":
    folder = Path("review-practice")
    folder.mkdir(exist_ok=False)
    (folder / "before.txt").write_text(
        "公開ダミーです。\n保存期間は3日です。\n外部には送信しません。\n", encoding="utf-8")
    (folder / "after.txt").write_text(
        "公開ダミーです。\n保存期間は30日です。\n外部には送信します。\n", encoding="utf-8")
    print(write_diff(folder))

同じフォルダでターミナルを開き、次を実行します。-X utf8 は表示の文字コードをUTF-8に揃える指定です。-B はPythonのバイトコードキャッシュを作らない指定です。

python -B -X utf8 review_demo.py

review-practice フォルダに、変更前の before.txt、変更後の after.txt、差分の changes.diff ができます。この例は数字と否定をわざと変えています。文章中の保存期間や送信の説明は、実際のツール仕様ではありません。

表示された差分を読む

--- before.txt
+++ after.txt
@@ -1,3 +1,3 @@
 公開ダミーです。
-保存期間は3日です。
-外部には送信しません。
+保存期間は30日です。
+外部には送信します。

先頭の --- と +++ は比較するファイル名です。@@ の行は変更位置の目印。その下の本文に付く - が変更前、+ が変更後です。色だけに頼らず、記号と文章を一緒に読みます。

今回は「保存期間は3日です。」が「保存期間は30日です。」へ、「外部には送信しません。」が「外部には送信します。」へ変わっています。依頼していない変更なら、ここで止めます。この練習ではAIの出力をそのまま実行せず、見つけるべき変更を自分で用意しています。

実機で確認できたこと

この例は差分を表示するだけです。正しい・間違いの自動判定は行いません。内容を読んで判断する工程を省かないでください。

確認した操作 実測結果
例の実行、数字と否定の変更 ファイルを作成し、変更前後の行を表示
前後を同じ文章にする 差分は空になった
同じ入力で再処理・保存後に読戻し 同じ差分を確認
元ファイルを空にする 既に保存した差分は残った
差分だけを削除・元から再処理 元ファイルは残り、差分を作り直せた

関連する操作をまとめると上の結果です。内部の機能・保存確認は10項目が合格しました。日本語の意味理解、レビュー精度、作業時間の短縮は測っていません。差分機能の仕様はPython公式のdifflib資料も参照できます。

通信・保存・削除の注意点

「通信できなかった」の理由まで確かめた

内部検証では、起動・入力・処理・書出し・保存・再読込・削除の7段階で、通信の入口とDNS解決の呼出しを試しました。DNSは接続先の名前を調べる処理です。各段階で2回、合計14回の試行について、想定したPythonの呼出しが実際に拒否された記録を照合しています。範囲外の公開ダミーファイルの読取も拒否しました。

ただエラーが出たことだけでは合格にしていません。試行の名前、同じ処理内の記録、期待した拒否の種類と実際の結果を対応づけました。その制限下で、掲載コードの差分作成と保存も成功しています。想定した確認用試行以外に、この監査経路で通信試行は見つかりませんでした。

上の練習コードに、この通信制限が自動で付くわけではありません。内部検証で追加した制限です。また、確認したのはPythonの呼出しの入口であり、OS全体の通信や別アプリまで止めた証明ではありません。Pythonの監査フックは完全なサンドボックスではありません。

初回は検証結果の文字コードが合わず、結果を読めませんでした。その回を成功扱いせず、UTF-8を明示して再実行し、上記の証拠を取得しています。未知のエラーを「通信を止められた証拠」に置き換えないことが大切です。

差分にも、変更前後の本文が残る

before.txtとafter.txtからchanges.diffを作る。差分を削除しても元ファイルは残り、元を空にしても保存した差分は残る

changes.diff はファイル名だけの記録ではなく、変更前後の文章を含む平文ファイルです。元ファイルを消しても、保存した差分やターミナルの表示が自動で消えるわけではありません。差分だけを外部AIへ渡す場合も、秘密が含まれないか確認が必要です。

練習が終わったら処理の終了を確認し、自分で作った review-practice の中身を見てから、練習用のファイルを削除します。残したいものがある場合は削除対象から外してください。今回の内部検証では、専用のダミーフォルダを削除し、なくなったことと、外側の確認用ファイルが変わっていないことを確かめました。

記事、サンプルコード内の架空文章、確認記録、画像は別に残します。ごみ箱やバックアップ、復元できない消去、異常終了時の残存までは保証しません。「終了した」「差分を削除した」「元データも消した」を分けて記録してください。

ローカル検査と記事制作の送信は別

差分の練習は既存Pythonの標準機能だけで動かし、新規契約や課金APIを使いません。電力・保存容量・作業時間は必要です。記事のデザイン確認では公開可能な原稿と画像をClaude CLIへ、掲載時にはCMSへ送ります。これらはローカル検査とは別の外部送信です。

つまずきやすい点と、まだ確認していないこと

フォルダが既にあるエラー:この例は既存データを上書きしないよう、最初の作成時に止まります。別の空の練習場所で試すか、自分のダミーだけであることを確認して後片付けしてください。

pythonが見つからない:Pythonの実行環境を確認します。この手順のために、不明な配布サイトのソフトを入れる必要はありません。

差分が空:今回の例では前後が同じ文字列だと空になります。それでも、選んだファイルが正しいかを確認します。行末や文字コードの細かな違いは読込時に扱いが変わることがあり、この例をバイト単位の同一性確認には使いません。

確認範囲:小さな日本語の架空例だけです。巨大ファイル、改行のない入力、同時編集、悪意あるコードへの防御、サーバー側の保持、OS全体の遮断は未確認です。機密情報や実ログの投入は引き続き保留とします。

まとめ:差分を読んでから、次の作業へ進む

変更前を残し、小さく直し、前後の差分を読む。依頼していない変更があれば止め、修正後に再確認する。この順番を決めておくと、確認の対象がはっきりします。正しさは差分だけで決めず、動作確認や内容の確認も組み合わせてください。

よくある質問

Windowsにdiffコマンドがなくても試せますか?

この記事は既存Pythonのdifflibを使うため、diffコマンドやGitの導入は不要です。

AIへ差分だけ送れば、機密は守れますか?

差分にも本文や設定が入ります。秘密を含む差分を送ってよい根拠にはなりません。この記事では公開ダミーだけを使っています。

記事の公開前チェックと同じものですか?

この記事の短い例は、人が差分を読む練習用です。記事制作で使う数値・否定変更の停止処理や、通信拒否の証拠を照合する処理とは別です。

関連記事

-AIツール