项目2026-11-20 · 智涌AI

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

oil-ui 项目头图:左侧大字「oil-ui 界面设计 Skill」与钩子「先定首屏给谁看,再让 Agent 写界面」,三张数据卡为 3,572 GitHub 星、5,336 次 skills.sh 安装、最新版本 v0.34.2;右侧终端显示 npx skills add 安装命令、三个方向对比页、桌面与手机截图自查、边框过多提示和独立评审流程,底部提示用 OIL_NO_UPDATE_CHECK=1 关闭版本检查

让编程 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 后面写出来的页面才不会千篇一律。

装之前看这几条

适合谁,不适合谁

适合经常让 Agent 从零做落地页、产品页、后台或小游戏界面,又不想每次都拿到同一张模板脸的人,特别是能接受先挑方向再实现的节奏。只改文案、调间距的日常维护用不上它。想要一套更偏审查和检测规则的设计 Skill,可以看站内写过的 Impeccable;想给已有网站整体改版,可以参考 TasteSkill 的改版记录。

最后

想试的话,在一个空目录里装上它,让 Agent「做三个不同方向放进对比页」,挑中一个再让它往下实现,看截图自查报出来的问题是不是你平时也会改的那些。

关注公众号「智涌AI速递」

每天的 AI 快讯、实用教程和 AI项目实测,也会同步发到微信公众号。在微信里搜索「智涌AI速递」就能关注;不用微信的话,可以用 RSS 订阅本站。