変更差分を読むために環境を整備しよう

生成AI時代、コードはもちろんそれ以上に自然言語の設計ドキュメントの変更差分を読む場面が増えてきました。
意思決定を次々進めるために、人間が早く正確に変更差分を読めるような環境の一例を紹介します。

1. 変更差分を読むために環境を整備しよう 2026-11-13 AIオレオレ環境お披露目会 北嶋 悠斗(pipepasta) / フリュー株式会社 © FURYU Corporation. 1
2. 自己紹介 北嶋 悠斗 ソフトウェアエンジニア@フリュー株式会社 プリントシール機の連動サービス「ピクトリンク」の開発を担当 2026年度からイネイブリングチーム(商品開発チームの技術支援) GitHub: pipepasta Twitter(新X): @pipepasta_ © FURYU Corporation. 2
3. 今の環境ざっくり © FURYU Corporation. 3
4. 今の環境ざっくり Ghostty quick terminal ( cmd+shift+b ) OSCにより完了通知・進捗バーがエージェントと統合 Claude Code zsh starship (プロンプトカスタマイズ) sheldon (zshプラグイン管理) fzf + fzf-tab (ファジーファインダー) zoxide ( cd コマンドの拡張) mise (ツールバージョン管理) ... © FURYU Corporation. 使っているツール一覧 (https://do-gu.niwa.dev/@pipepasta) 4
5. 今回注目したいところ 「変更差分」 - TODO: あとで書き直す + FIXME: なぜかコメントアウトすると動く © FURYU Corporation. 5
6. なぜ変更差分？ → 読み書きのウェイトや対象、スタイルが変わったから 以前 書くのは自分 差分を読むのは他人のPRくらい 自分の変更差分は低コスト(知ってるから) 差分以外を読むことが多かった(いわゆるコ ードリーディング) © FURYU Corporation. 今 人間がコードを書くことは減った コードリーディングも減った 人間が変更差分を読む割合が増えた 生成AIが書いたコード差分 設計ドキュメント(自然言語)だけを読む場面 も増えてきた 6
7. ドキュメントの小さな差分→増えるワカメ - 外部APIの呼び出しに失敗した場合、リトライは必須とする。 + 外部APIの呼び出しに失敗した場合、リトライは任意とする。 変わったのは2文字だが設計としては全くの別の意味 ここから作られるコードの差異は何行、何ファイルにも増幅する どちらが正解かは決まっていない エージェントや lint では検知しにくい 人間が判断すること → 人間が速く正確に読める環境が必要 © FURYU Corporation. 7
8. delta: いつもの git diff をちょっと良くする © FURYU Corporation. 8
9. delta: いつもの git diff をちょっと良くする delta: 出力をシンタックスハイライト付きで見やすく表示するためのページャ ターミナルで完結 エージェントの隣のペインで読める git に組み込める git diff / git show / git log -p などがdelta表示に置き換わる いつもの感覚で使える stdoutがttyであれば使われる delta コマンド単体でも利用可能 → diff の代替にもなる © FURYU Corporation. 9
10. delta の設定例 gitの設定ファイルに記載する ~/.config/git/config side-by-side 変更前と変更後を左右に並べる [core] pager = delta [delta] side-by-side = true line-numbers = true navigate = true line-numbers 行番号を表示する navigate n [diff] algorithm = histogram colorMoved = default / N で次・前のファイルへ移動 diff.algorithm = histogram 差分の区切りを人間の感覚に近づける diff.colorMoved 移動しただけの行を別の色で表示 © FURYU Corporation. 10
11. 日本語のドキュメントを読むためにしていること デフォルト 設定後 日本語には空白がない → 読点の間がまるごと強調、または何も強調され ない 日本語は1文字ずつ、英数字は単語単位 → コードの見え方は変わらない 設定 word-diff-regex = [\\p{Han}\\p{Hiragana}\\p{Katakana}]|[A-Za-z0-9_]+ © FURYU Corporation. 11
12. 持ち帰ってもらえると嬉しいこと deltaを試してみる https://github.com/dandavison/delta 設定調整して差分を読みやすくする↓ [core] pager = delta [delta] side-by-side = true word-diff-regex = [\\p{Han}\\p{Hiragana}\\p{Katakana}]|[A-Za-z0-9_]+ # その他ユースケース、好みに合わせて (みなさんが普段何を使ってるかも是非教えてください！) © FURYU Corporation. 12