@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)
- 我们实测
- 部分实测
- 成本 / 耗时
- Skill MIT 免费;只需本机 Python 与 git。跑 Agent 归纳文案时消耗你已有的 Claude / Codex 额度,不另收 API。
要解决的事
在 Agent 大批量改代码后,向自己、同事或非技术负责人讲清「这轮到底改了哪几块业务、为什么改、核心该看哪几个文件」,而不是按字母顺序翻 Diff。
步骤
- 环境:Python 3.10+、系统 `git`;可用 Claude Code / Codex 等能装 Skill 的 Agent。
- 安装:`npx skills add oil-oil/oil-diff`,或对 Agent 说「请安装 https://github.com/oil-oil/oil-diff」。
- 在对话里指定范围,例如:「用 oil-diff 把当前分支最近的改动做成汇报页」「整理还没提交的修改」「对比 main..HEAD」。
- Skill 会跑 `scripts/collect_diff.py` 写出 `.oil-diff/assets/diff-data.json`,再按业务写 `report-spec.json`(3~7 件事,每件事带 overview、要点、核心文件)。
- 无真实运行截图时用内置矢量积木(routing / flow / schema 等);有实测截图才允许 `screenshots`,lint 会用哈希拦住从仓库别处抄来的图。
- 再跑 `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 做了跨平台静态检查。
同类用例
- 文档每页配演示视频,界面一改就报红视频创作ScreenplayClaude Code工具免费;需 Claude 等 agent 额度◐ 部分实测海外
- 让 AI 写后端时默认防并发、越权和改表事故编程开发backendskillsClaude CodePostgreSQL免费;每次任务多花约一倍额度◐ 部分实测海外
- 一个下午让 AI 做出能在浏览器里玩的 3D 动作游戏编程开发Claude CodeTripo即梦技能免费;需 Claude 额度,素材工具另计◐ 部分实测国内
- 长期让 AI 写同一个项目,仓库也不乱编程开发ClaudeCodexoil-delegate需 Claude 和 Codex 订阅◐ 部分实测国内
- 边用一个网页产品,边让 AI 写出它的工作原理调研搜索REAClaude CodeChrome工具免费;需 Claude 或 Codex◐ 部分实测海外