Skip to main content

oil-diff 将 Git 改动做成可视化 HTML 汇报页。

把指定的 Git 范围或未提交修改整理成独立 HTML 汇报页,按业务归纳几件事,并配上图示和可对照的代码抽屉。

来源信息

仓库
oil-oil/oil-diff
最近来源活动
2026年10月31日 15:53
检测到的 SKILL.md 语言
中文
星标
50
Forks
3

用途

适合你希望用可视化 HTML 页说明某一 Git 范围、某次提交或未提交修改改了什么,并按业务归纳成几件事,让没有写这些代码的同事也能读懂时使用。它不用于直接改代码、提交、常规缺陷审查,或制作通用幻灯片。

必要前提

提供目标仓库,以及要说明的比较范围或未提交修改。也可以提供本次改动真实的前后截图。不必事先准备 HTML 页面、3 到 7 件业务事项大纲,或 .oil-diff 数据。文档要求系统 git 和 Python 3.10 或更新版本;不需要 API 密钥。这些工具本次未安装或运行。

操作说明

原帖以第一人称介绍 oil-diff 并链接仓库;长文实体里的短链与短帖短链不同,但都指向同一 GitHub 仓库;帖内视频未观看。说明要汇报的范围或未提交修改即可。文档流程会把确定性 Git 数据采到 .oil-diff/,把文件归纳成 3 到 7 件业务事项,制作图示或仅使用核验过的截图,渲染单文件 index.html,并在 git 状态保持不变的前提下校验到 PASS。文档中的命令本次未执行。

限制

不要执行 git add、commit、checkout、reset 或 stash,也不要修改已跟踪文件;输出只写在未跟踪的 .oil-diff/ 下,并用仅含星号的 gitignore 隔离。截图必须是实机截取、用户为本次改动提供,或就在本次 diff 中的文件;不得把其他图片当作实测图拷入。原帖关于很快改动几十个文件、以及不写代码的负责人也能一眼看懂的说法,不是保证。帖内视频未观看。脚本未执行。MIT 要求保留声明且无保证。GitHub 登录名 oil-oil 与 X 账号 I_am_oil_oil 不同,已提交公开映射,但未自动认定身份。

安装方式

默认使用会先检查来源的 Prompt;你也可以切换为直接命令,或下载本地副本。

检查来源文件

决定是否安装前,请先阅读 SKILL.md,以及 SkillsMP 当前展示的配套文件。

正在显示 SKILL.md

SKILL.md
来源说明 · 只读预览
nameoil-diff
description将 Git 改动、提交范围或工作区修改生成直观易读的可视化 HTML 改动汇报页(含业务模块速览、前后对比图示、具体例子、单行改动文件树与右侧原文对照抽屉)。用户要求解释一轮代码或文档改了什么、把 git diff 做成汇报页或可视化演示页、向老板或团队展示仓库改动时使用。不用于执行代码修改、Git 提交、常规 Code Review 缺陷审计或制作通用幻灯片。