Repolode
提交项目
oil-oil

oil-oil/oil-diff

把 Git 改动按业务目的整理成一屏可看懂的 HTML 汇报页的 Agent Skill。

在 GitHub 查看
Star
91
Fork
7
未关闭 Issue
0
最近提交
7天前

这是什么？

oil-diff 是一个面向 AI 编程 Agent 的 Skill，可读取工作区未提交的修改、某次提交的范围或两个分支之间的差异，并把 Git Diff 归纳为 3 到 7 件具体改动。它会生成单个 HTML 汇报页（.oil-diff/index.html），让审阅者不必逐个翻看按字母排序的文件列表，就能看清改了哪些业务、为什么改、哪些文件最关键。

每一章节的说明都配有图示：界面改动时可放入前后截图并拖动对比，逻辑或规则改动时则生成分流、流程或字段增删的对比图。每项改动下列出核心文件及增删行数，引用、配置、文档等外围修改则折叠在卡片底部。页面右侧有可收起的文件树，点击文件可滑出修改前后的代码对照。

生成的内容保存在仓库的 <repo>/.oil-diff/ 目录中并自动被 Git 忽略，不改动项目原有文件，也不影响 git status。最终生成的 HTML 是离线可用的单文件，只依赖系统 git 和 Python 3.10+ 标准库，无需 API Key，支持 macOS、Windows 和 Linux。

核心功能

  • 01将改动归纳为 3 到 7 件业务级别的具体事项，而非罗列文件。
  • 02生成单个可离线打开的 HTML 汇报页，双击即可在浏览器查看。
  • 03每项改动可配前后截图，或自动生成分流、流程、字段变化等图示。
  • 04区分需要重点审阅的核心文件与外围同步修改，并标明增删行数。
  • 05提供可收起的文件树，以及展示修改前后代码的侧边抽屉。
  • 06输出保存在被 Git 忽略的目录中，不修改仓库原有文件。

适用场景

  • 合并代码前向团队汇报一轮改动的范围与目的。
  • 在审阅大型分支时，先通过总览了解涉及哪些业务区域。
  • 快速弄清 AI 编程 Agent 刚刚在工作区里改了什么。
  • 把独立的 HTML 改动汇报发给没有仓库权限的同事查看。

快速上手

  1. 1

    用 npx 安装该 Skill

    npx skills add oil-oil/oil-diff
  2. 2

    让 Agent 为当前改动生成汇报页

使用前须知

  • 需要系统已安装 git，并且 Python 版本为 3.10 或以上。
  • 它是一个 Agent Skill，因此需要能够加载 Skill 的 AI Agent 才能使用。

收录于专题

AI 代码审查工具AI 编程助手与编码 AgentAI Agent 技能包图表、示意图与动画可视化工具

标签

#git#diff#code-review#agent-skill#html-report#visualization#developer-tools

常见问题

oil-diff 是什么？
把 Git 改动按业务目的整理成一屏可看懂的 HTML 汇报页的 Agent Skill。 oil-diff 是一个面向 AI 编程 Agent 的 Skill，可读取工作区未提交的修改、某次提交的范围或两个分支之间的差异，并把 Git Diff 归纳为 3 到 7 件具体改动。它会生成单个 HTML 汇报页（.oil-diff/index.html），让审阅者不必逐个翻看按字母排序的文件列表，就能看清改了哪些业务、为什么改、哪些文件最关键。
oil-diff 可以免费使用吗？用的什么许可证？
oil-diff 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
oil-diff 还在维护吗？
活跃维护中。oil-diff 最近一次提交是在 2026年10月31日。
oil-diff 适合用来做什么？
合并代码前向团队汇报一轮改动的范围与目的。 在审阅大型分支时，先通过总览了解涉及哪些业务区域。 快速弄清 AI 编程 Agent 刚刚在工作区里改了什么。 把独立的 HTML 改动汇报发给没有仓库权限的同事查看。
oil-diff 怎么安装和运行？
用 npx 安装该 Skill: npx skills add oil-oil/oil-diff 让 Agent 为当前改动生成汇报页
在哪里获取 oil-diff？
源代码和安装说明在 GitHub 上：https://github.com/oil-oil/oil-diff

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目