Gitのコミット差分をレビューする、GitHub風のローカルWebビューアを起動するCLIツール。コメントはAI向けプロンプトとしてコピーできます。
oil-oil/oil-diff
Gitの変更を、ファイルごとのdiff一覧ではなく、業務上の目的ごとにまとめた1画面のHTMLレビュー画面に変換するエージェント向けSkill。
- スター
- 88
- フォーク
- 7
- 未解決の Issue
- 0
- 最終コミット
- 7 日前
これは何?
oil-diffは、AIコーディングエージェント向けのSkillです。未コミットの変更、コミット範囲、ブランチ間の比較を読み取り、Git diffを具体的な変更3〜7件にまとめます。.oil-diff/index.htmlに単一のHTMLレポートを生成するため、アルファベット順のファイル一覧をスクロールしなくても、どの業務領域に何のための変更があり、どのファイルが重要なのかを確認できます。
レポートの各セクションでは、説明とビジュアルを組み合わせます。UIに変更がある場合は変更前後のスクリーンショットを、ロジックやルールに変更がある場合はルーティング、フロー、フィールド変更の図を生成して表示します。各変更の下には、追加・削除行数とともにレビューの中心となるファイルを掲載し、参照資料、設定、ドキュメントなどの補助的な編集はカードの下部にまとめます。折りたたみ可能なファイルツリーと右側のドロワーでは、任意のファイルの変更前後のコードを確認できます。
生成物は<repo>/.oil-diff/に保存され、gitで無視されるため、プロジェクトのファイルやgit statusには影響しません。最終的なHTMLは、オフラインで動作する自己完結型ファイルです。必要なのはシステムにインストールされたgitとPython 3.10以降の標準ライブラリだけで、APIキーは不要です。macOS、Windows、Linuxで動作します。
主な機能
- 01diffをファイル一覧ではなく、業務レベルの変更3〜7件にまとめる。
- 02ブラウザーで直接開ける、オフライン対応の単一HTMLレポートを生成する。
- 03各変更について、変更前後のスクリーンショットまたは自動生成した図を表示する。
- 04レビューの中心となるファイルと補助的な編集を分け、行数も表示する。
- 05折りたたみ可能なファイルツリーと、変更前後のコードを表示するサイドドロワーを備える。
- 06リポジトリを変更せず、gitで無視されるフォルダーに出力を保存する。
ユースケース
- マージの前後に、変更内容をチームに共有する。
- 大規模なブランチで、まず変更された領域の概要を把握してからレビューする。
- AIコーディングエージェントが作業ツリーに加えた変更を把握する。
- リポジトリにアクセスできない同僚に、自己完結型のHTML変更サマリーを共有する。
クイックスタート
- 1
npx で Skill をインストールする
npx skills add oil-oil/oil-diff - 2
Agent に現在の変更内容のレポートを生成するよう依頼する
使う前に知っておきたいこと
- システムに git がインストールされており、Python 3.10 以降が必要です。
- これは Agent Skill です。利用するには、Skills を読み込める AI agent が必要です。
収録されている特集
トピック
よくある質問
- oil-diff とは?
- Gitの変更を、ファイルごとのdiff一覧ではなく、業務上の目的ごとにまとめた1画面のHTMLレビュー画面に変換するエージェント向けSkill。 oil-diffは、AIコーディングエージェント向けのSkillです。未コミットの変更、コミット範囲、ブランチ間の比較を読み取り、Git diffを具体的な変更3〜7件にまとめます。.oil-diff/index.htmlに単一のHTMLレポートを生成するため、アルファベット順のファイル一覧をスクロールしなくても、どの業務領域に何のための変更があり、どのファイルが重要なのかを確認できます。
- oil-diff は無料で使えますか?ライセンスは?
- oil-diff は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
- oil-diff は今もメンテナンスされていますか?
- 活発にメンテナンス中。oil-diff の最終コミットは 2026年10月31日 です。
- oil-diff は何に使えますか?
- マージの前後に、変更内容をチームに共有する。 大規模なブランチで、まず変更された領域の概要を把握してからレビューする。 AIコーディングエージェントが作業ツリーに加えた変更を把握する。 リポジトリにアクセスできない同僚に、自己完結型のHTML変更サマリーを共有する。
- oil-diff のインストール方法は?
- npx で Skill をインストールする: npx skills add oil-oil/oil-diff Agent に現在の変更内容のレポートを生成するよう依頼する
- oil-diff はどこで入手できますか?
- ソースコードとインストール手順は GitHub にあります:https://github.com/oil-oil/oil-diff
概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。
関連プロジェクト
git、diff、grep、blameの出力をシンタックスハイライト付きで表示するページャー。gitのデフォルトページャーと置き換えて使えます。
行単位ではなく構文木でファイルを比較し、整形やコードの移動も正確に表示するコマンドラインdiffツール。
Git、Jujutsu、Sapling、GitHub PR、raw fileのコード変更を、エージェントのインラインメモとともにレビューできる対話型ターミナルdiffビューア。
GitHub風に差分を左右に並べ、シンタックスハイライト付きで表示するターミナル用Gitページャー。
Rust製のコンテンツに応じたdiffツール。tree-sitterでコードを構造的に比較するほか、画像、フォント、アーカイブ、PDFも比較します。