Deft
Ask AI

Search

Search skills, authors and topics

oil-oil / oil-ui

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:

你做了什么改动子 Agent 的提示词 (Prompt) 模板
探索了新界面,或推翻现状重新设计(重塑)请读取 references/reviewer-manual.md,按照【全新界面与改版评审】标准,评审这些截图,并给出 1-10 的打分。
给已有界面评审:在已有界面上整理、升级、润色或扩展请读取 references/reviewer-manual.md,按照【存量已有界面润色评审】标准,对比提供的现状规范,指出偏离点。不打分。
小改动、单处间距或颜色微调无需派发子 Agent,主 Agent 结合上下文自行核对即可。

模板里的路径换成本 Skill 目录下的绝对路径:子 Agent 的工作目录不是本目录。派发时在模板末尾统一加:先看代表画面的整体构图、文字可读性和主操作是否可见,再按对应标准评审;现有证据足以判断时不追加取证,不要求全语言、全页面、全状态截图。

2. 派发前,主 Agent 要准备的“交接清单”

调用宿主提供的隔离执行能力时,必须提供以下物料:

  • 必给:按 工具 [blocked] 的默认范围选出的当前版本截图及按需取得的动效证据(注明设备视口)、用户原始任务、设计边界和约束;有方向卡时,再给北极星那一句。方向卡里其他需要评审知道的硬性约束,例如品牌要求每屏出现字标,摘成一句写进约束,不交整张方向卡。
  • 如果有:现有项目的色彩规范、组件约束(存量老项目必须给);方向卡的选色记录,即“色彩”一栏里颜色来自这个产品的什么那一句;项目里有 DESIGN.md 或同类设计文档时,存量润色评审整份给出并以它为标准,新界面与改版评审只把其中的品牌资产和“不要做”摘进约束。
  • 不给:源代码、为自己的做法辩护的说明、之前评审打过的分数(评分要独立)。

证据必须属于当前版本,且能被评审者访问;这一轮没有改到的状态和动效,可以沿用上一轮的证据文件,交接时注明哪些是沿用的。长页提供能看清整体节奏的整页图;文字或关键细节无法判断时,只补对应局部,细节图不能替代整体构图。

动效不用逐项备证据:交已有序列图,或给评审能直接操作的页面地址;录屏只按 工具 [blocked] 的条件取用,不为每个状态补录。只有现有证据无法支持结论时,才让它补看对应操作,不重走已经能判断的流程。 没有隔离、能看图的执行者时,主 Agent 仍不读手册,结合实际截图按所属领域入口自查,交付时写明“未独立评审”;没有实际画面时不打视觉分。

3. 主 Agent 如何处理子 Agent 的反馈

子 Agent 返回报告后,按以下原则修改:

  • 第一条是“重做”:回到方向卡,重定被点名区块的骨架或主视觉,不逐条修补。
  • 按清单顺序改:问题清单从影响最大的一条往下改;“保留”那一行记进设计说明,改的时候对照,别把它修平。
  • 落到具体调整:把子 Agent 的高层要求(如“太挤”“层级不清”)落成间距、字号和阴影的实际调整。子 Agent 提议更改用户锁定的品牌色或大框架时,写一句理由后不采纳。
  • 防止死循环:如果双方审美意见陷入僵持、来回横跳且无可见收益,保留你认为最佳的版本并停止循环。