oil-diff (oil-oil/oil-diff)部分实测🇨🇳 中文

@I_am_oil_oil 开源的 oil-diff 把 AI 改动的几十个文件(Git Diff)整理成 3~7 件业务事项的 HTML 汇报页,不写代码的人也能看懂

oil(@I_am_oil_oil,GitHub oil-oil)新开源 oil-diff(MIT,0.1.0):给 Claude Code / Codex 等 Agent 用的 Skill。Agent 十几分钟改三四十个文件时,直接翻 Git Diff 抓不住重点,让模型从零写 HTML 报告又容易堆满废话。oil-diff 用采集脚本抽出改动,再按业务归纳成 3~7 件事,生成单文件 `.oil-diff/index.html`:Bento 看板、前后对比图示、🎯核心必看 / 📎外围同步、右侧代码抽屉。产物写在未跟踪的 `.oil-diff/`(内置 `*` gitignore),不改仓库状态。我们克隆 commit 8f4b40c,`python3 -m unittest` 跑作者测试 5/5 通过(覆盖采集→渲染→lint、中文路径与二进制、拦截仓库里抄来的假截图、空话词检查);没有在真实业务仓库上让 Agent 出完整汇报页。

访问官网 oil-diff (oil-oil/oil-diff) ↗
定价
免费
地区
海外
出自哪里
中文社区
上架日期
2026 年 11 月 2 日
实测日期
2026 年 11 月 2 日
用的版本
oil-oil/oil-diff commit 8f4b40c (SKILL 0.1.0)
分类
编程开发效率办公
原作者
oil @I_am_oil_oil ↗
我们实测
部分实测
成本 / 耗时
Skill MIT 免费;只需本机 Python 与 git。跑 Agent 归纳文案时消耗你已有的 Claude / Codex 额度,不另收 API。
来源
X @I_am_oil_oil ↗GitHub oil-oil/oil-diff ↗

要解决的事

在 Agent 大批量改代码后,向自己、同事或非技术负责人讲清「这轮到底改了哪几块业务、为什么改、核心该看哪几个文件」,而不是按字母顺序翻 Diff。

步骤

  1. 环境:Python 3.10+、系统 `git`;可用 Claude Code / Codex 等能装 Skill 的 Agent。
  2. 安装:`npx skills add oil-oil/oil-diff`,或对 Agent 说「请安装 https://github.com/oil-oil/oil-diff」。
  3. 在对话里指定范围,例如:「用 oil-diff 把当前分支最近的改动做成汇报页」「整理还没提交的修改」「对比 main..HEAD」。
  4. Skill 会跑 `scripts/collect_diff.py` 写出 `.oil-diff/assets/diff-data.json`,再按业务写 `report-spec.json`(3~7 件事,每件事带 overview、要点、核心文件)。
  5. 无真实运行截图时用内置矢量积木(routing / flow / schema 等);有实测截图才允许 `screenshots`,lint 会用哈希拦住从仓库别处抄来的图。
  6. 再跑 `render_report.py` 生成 `.oil-diff/index.html`,最后 `lint_report.py` 做结构与安全边界检查;用浏览器打开单文件页即可分享。

提示词

用 oil-diff 把当前还没提交的修改做成 HTML 汇报页:按业务归纳成几件事,没有实测截图就用内置矢量图,不要改仓库里已跟踪的文件。

原文怎么说

@I_am_oil_oil:AI 改三四十个文件时,Git Diff 太散、让模型从零写 HTML 又容易堆文字;oil-diff 把汇报标准定成「给不写这块代码的老板看也能一眼看懂」——按业务归纳几件事,配路由分流/控件前后对比等图示,点「核心必看」从右侧抽屉看 Diff;内置采集脚本、配图规范和页面模板,结构稳定。产物在 `.oil-diff/`,对 Git 隐形。

我们实测

在 Linux 盒子上克隆 oil-oil/oil-diff commit 8f4b40c(SKILL metadata 0.1.0),对 `scripts/*.py` 做 AST 语法检查全部通过;运行 `python3 -m unittest tests.test_oil_diff -v`。没有安装 Claude Code / Codex,也没有在真实产品仓库上生成对外汇报页。

我们亲自试下来:5 项测试约 1.2 秒全部通过,覆盖:临时仓库里中文文件名与二进制、完整 collect→render→lint 管道、lint 拦截从仓库非改动区抄来的假截图与缺少 captureSource、结构化 diagram 与纯文字 diagram 的 lint、空话词检查。说明作者声称的防伪与结构约束有自动化测试支撑,但不等于端到端 Agent 汇报已被我们验收。

怎么用上

作者中文帖与中文 README;GitHub MIT 公开。国内可直接克隆;配合 Claude Code / Codex 时需自备可用接入。

适合谁

常用编程 Agent 大批量改代码、需要向产品/老板或自己快速通览改动的开发者;也适合合并前自查「这轮到底动了哪几块业务」。

踩坑提示

  • 它不做 Code Review 找缺陷,也不执行提交;只解释「改了什么」。
  • 业务归因文案仍靠模型:脚本保证采集与渲染结构,但章节划得好不好取决于 Agent 是否读完 SKILL 与 references。
  • 作者建议主对话启动子 Agent 跑完整个流程,避免巨大 `diff-data.json` 撑爆上下文。
  • 我们实测:作者单元测试 5/5 通过;在干净仓库上 `collect_diff` 对无改动范围会写出 0 条文件记录——没有改动就没有汇报内容。
  • 0.1.0 早期版本,作者称 macOS 实机验证过,Windows/Linux 做了跨平台静态检查。

同类用例