oil-ui
Design, improve, and review interfaces for websites, apps, dashboards, and components: explore directions, generate side-by-side comparisons, and refine visual hierarchy against real screenshots. Delivers a comparison page, design notes, a comp, or a working interface when asked. Design judgment only. Hand off to oil-ui-pro when that skill is installed.
Install
npx skills add https://github.com/oil-oil/oil-ui --skill oil-ui视觉评审派发协议 (主 Agent 专用)
主 Agent 用这份文件派发独立评审。打分标准和检查规则在 评审手册 [blocked] 里,由评审者读;主 Agent 不读,只按下面的清单交接。调用方已指定领域标准时,把它和任务模式一并交接;冲突的检查项按领域覆盖,是否打分与是否只读仍由任务决定。
1. 什么时候该派发?触发什么模式?
当你完成了一个关键页面、设计方案或改动后,按以下清单触发对应的评审子 Agent:
模板里的路径换成本 Skill 目录下的绝对路径:子 Agent 的工作目录不是本目录。派发时在模板末尾统一加:先看代表画面的整体构图、文字可读性和主操作是否可见,再按对应标准评审;现有证据足以判断时不追加取证,不要求全语言、全页面、全状态截图。
2. 派发前,主 Agent 要准备的“交接清单”
调用宿主提供的隔离执行能力时,必须提供以下物料:
- 必给:按 工具 [blocked] 的默认范围选出的当前版本截图及按需取得的动效证据(注明设备视口)、用户原始任务、设计边界和约束;有方向卡时,再给北极星那一句。方向卡里其他需要评审知道的硬性约束,例如品牌要求每屏出现字标,摘成一句写进约束,不交整张方向卡。
- 如果有:现有项目的色彩规范、组件约束(存量老项目必须给);方向卡的选色记录,即“色彩”一栏里颜色来自这个产品的什么那一句;项目里有
DESIGN.md或同类设计文档时,存量润色评审整份给出并以它为标准,新界面与改版评审只把其中的品牌资产和“不要做”摘进约束。 - 不给:源代码、为自己的做法辩护的说明、之前评审打过的分数(评分要独立)。
证据必须属于当前版本,且能被评审者访问;这一轮没有改到的状态和动效,可以沿用上一轮的证据文件,交接时注明哪些是沿用的。长页提供能看清整体节奏的整页图;文字或关键细节无法判断时,只补对应局部,细节图不能替代整体构图。
动效不用逐项备证据:交已有序列图,或给评审能直接操作的页面地址;录屏只按 工具 [blocked] 的条件取用,不为每个状态补录。只有现有证据无法支持结论时,才让它补看对应操作,不重走已经能判断的流程。 没有隔离、能看图的执行者时,主 Agent 仍不读手册,结合实际截图按所属领域入口自查,交付时写明“未独立评审”;没有实际画面时不打视觉分。
3. 主 Agent 如何处理子 Agent 的反馈
子 Agent 返回报告后,按以下原则修改:
- 第一条是“重做”:回到方向卡,重定被点名区块的骨架或主视觉,不逐条修补。
- 按清单顺序改:问题清单从影响最大的一条往下改;“保留”那一行记进设计说明,改的时候对照,别把它修平。
- 落到具体调整:把子 Agent 的高层要求(如“太挤”“层级不清”)落成间距、字号和阴影的实际调整。子 Agent 提议更改用户锁定的品牌色或大框架时,写一句理由后不采纳。
- 防止死循环:如果双方审美意见陷入僵持、来回横跳且无可见收益,保留你认为最佳的版本并停止循环。