oil-ui 是什么:让 Agent 先定设计方向再写界面

让编程 Agent 写界面,最常见的结果是一眼就能认出来的「AI 模板脸」:大横幅、渐变按钮、三列卡片,换个产品也长一样。oil-ui 是一个开源的 UI 设计 Skill,它要求 Agent 动手前先想清楚产品是什么、首屏给谁看,写完再打开真实浏览器截图自查。这篇按官方 README、SKILL.md 和最近三个发布页(截至 2026-11-20 的 v0.34.2),讲它做什么、怎么装、装之前要知道的几件事。
它是什么
oil-ui 是给编程 Agent 用的界面与 UI/UX 设计 Skill,负责「长什么样」的判断:方向、字体、配色、留白、首屏内容和动效。纯业务逻辑、接口开发、改文案这类改法已经明确的小修改,SKILL.md 写明它不接。
| 仓库 | github.com/oil-oil/oil-ui |
|---|---|
| 作者 | oil-oil |
| 许可证 | MIT |
| 热度 | GitHub 3,572 星、202 fork(GitHub API);skills.sh 累计安装 5,336 次(均为 2026-11-20 北京时间) |
| 组成 / 要求 | Markdown 指令 + Python、Node.js 辅助脚本;对比页生成器要 Python 3.10+,截图脚本要 Node.js 22+ 和本机 Chrome/Chromium/Edge |
| 最新版本 | v0.34.2(2026-11-20 12:52 北京时间) |
解决什么问题
Agent 写界面的毛病大多出在动手之前:没想过产品属于哪一类、用户来这一页要干什么,就直接套默认样式。oil-ui 在这一步定了几条规矩:
| 常见毛病 | oil-ui 的规矩 |
|---|---|
| 工具类页面首屏放一大段口号,真正要用的搜索、筛选被挤到下面 | 浏览、购物、办事的页面,首屏先放内容和操作;只有要说服人的页面才做开场编排 |
| 「高级感」「简洁」停留在形容词 | 先按题材、受众和品牌语气定调,再落到具体的字体、留白和颜色比例 |
| 让它出 3 个方案,结果只是换了个主色 | 任意两个方案在布局、字体、配色、主视觉里最多共享一项,看着像就重做布局 |
| 只看代码就说做完了 | 打开桌面和手机视口看真实截图,派一个没看过构建过程的评审,最后再做一轮减法 |
v0.34.0 加了「轻路径」:动手前先写六行(用户与任务、主角与主动作、基线与偏离、方向、字体色彩与主视觉、动效与状态),然后实现、截图自查、评审一轮、交付。官方说新建落地页要读的说明从约 125KB 降到了 26–35KB。
怎么用
1. 安装。用 Vercel 的 npx skills 一条命令装好,装完不用配置:
npx skills add oil-oil/oil-ui
用 DeepSeek Harness 的,装官方插件 dsh plugin --profile web add github:oil-oil/dsh-oil-ui。
2. 直接用自然语言提需求。README 给的说法可以照搬:
用 oil-ui 给这个课程预约产品探索几个设计方向,做出能预览的页面
做三个字体、配色、构图都不同的设计,放进一个对比页让我选
按项目现有的设计规范打磨这一页
评审这个首页,说清改什么、怎么改,先别动文件
照这张截图还原页面,再补一个手机版布局
3. 在对比页里挑方向。候选可以是 HTML 文件、图片或正在跑的本地开发服务器,当前版本排第一当基线。页面上能切桌面和手机视口、方向键翻看,点「Select」后把复制出的提示词贴回 Agent 继续做。
4. 找产物。中间方案、截图和素材缓存放在项目里的 .oil-ui 目录,最终代码和正式素材直接写进项目。
动手前先定下首屏给谁看、用什么字体和颜色,Agent 后面写出来的页面才不会千篇一律。
装之前看这几条
- 会定期查新版本。每次使用最多每 10 分钟检查一次,只读取
ui.oiloil.org上的公开版本列表,不上传项目内容;默认只提醒,不自动替换。缓存在~/.local/state/oil/,关闭用OIL_NO_UPDATE_CHECK=1。 - 出设计稿可能花钱。宿主 Agent 自带生图工具时用宿主的;否则可以走 Oil 积分,SKILL.md 规定要先问你,无人值守又没授权时直接写代码,不消耗积分。
- 开源版和 Pro 分工不同。改造现有项目、合并冲突的
DESIGN.md、表单弹窗等可用性细节在 Pro 里(一次性 14.99 美元)。开源版碰到这类任务,会先说明该用哪种做法,不会勉强去做。两个版本同时装会抢同一类请求。 - 截图要本机浏览器。没装 Chrome/Chromium/Edge 时,截图自查这一步做不了,Agent 也要有看图能力,视觉验收才有意义。
适合谁,不适合谁
适合经常让 Agent 从零做落地页、产品页、后台或小游戏界面,又不想每次都拿到同一张模板脸的人,特别是能接受先挑方向再实现的节奏。只改文案、调间距的日常维护用不上它。想要一套更偏审查和检测规则的设计 Skill,可以看站内写过的 Impeccable;想给已有网站整体改版,可以参考 TasteSkill 的改版记录。
最后
想试的话,在一个空目录里装上它,让 Agent「做三个不同方向放进对比页」,挑中一个再让它往下实现,看截图自查报出来的问题是不是你平时也会改的那些。