Repolode
oil-oil

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. 1

    npx で Skill をインストールする

    npx skills add oil-oil/oil-diff
  2. 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 の数値は毎日更新されます。

関連プロジェクト