7.3 KiB
7.3 KiB
name, description, metadata
| name | description | metadata | ||
|---|---|---|---|---|
| ui-review | 对 lpt-fe 的新页面或大范围 UI 改动做独立视觉评审:起本地服务、按关键状态截图取证、派无上下文的评审者按固定评分锚点打分并输出「问题 / 提升 / 保留」,主 agent 按清单修完再核对一轮。当用户新增页面、重构页面结构、改版视觉语言、或说“页面难看/重新设计一下/评审下这个界面”时使用。触发词:评审界面、UI 评审、页面难看、重新设计、视觉评审、设计走查、新页面、改版。 |
|
前端界面独立评审
针对 lpt-fe 的新页面或大范围 UI 改动(整页重构、视觉语言变更、新增信息区块)走一遍:取证 → 独立评审 → 修正 → 复核。
小改动、局部低风险调整不走本技能,按 roles/ui-review-checklist.md 自检即可。
本技能只在 lpt-fe 仓库内使用,规则依据为 roles/design-principles.md 与 roles/design-system.md——评审时把后者作为「现状规范」交给评审者,不让它凭空想象理想风格。
工作区约定
| 用途 | 路径 |
|---|---|
| 本技能 | lpt-fe/skills/ui-review/ |
| 设计原则(禁用清单) | lpt-fe/roles/design-principles.md |
| 设计系统(现状规范) | lpt-fe/roles/design-system.md |
| 交付自检清单 | lpt-fe/roles/ui-review-checklist.md |
| 证据存放 | 本次任务的工作目录(截图不进仓库) |
Step 1 确认范围
| 项 | 说明 |
|---|---|
| 改动类型 | 全新页面 / 整页重构 / 视觉语言变更 / 局部新增区块 |
| 涉及页面与路由 | 具体路径(如 /review),以及它的当前状态 |
| 不可动的东西 | 品牌色、字体、Element Plus 组件库、既有导航结构 |
| 用户最常做的事 | 决定「一屏一个主角」是谁 |
| 验收重点 | 这次最想让用户看到什么变化 |
缺一项就问,不要猜。存量页面润色时,不探索新风格,只对齐 roles/design-system.md 的现状规范。
Step 2 取证
- 起服务:
npm run dev(端口 5158,代理到 lpt-be:5157)。 - 覆盖关键状态截图,不要只截默认态:
- 默认/有数据的常态
- 空状态
- 加载中
- 错误态
- 窄屏(375px)
- 用
agent_browser截图并落盘到本次任务目录;确认artifactVerification全部 verified 再用于评审。 - 后端不可用或需要登录才能到达的页面:把不可达的页面显式标为「未验证」,不要用静态推断代替画面。
- 缩一张 480px 宽的缩略图,自己先做一次三秒测试(见 Step 4 第 0 条),明显不合格的先改再送评审。
Step 3 派独立评审者
- 用
subagent派一个没有历史上下文的子代理;一次只派一个,不要多个评审者。 - 交给它的材料只有:截图 + 任务与约束 +
roles/design-system.md的现状规范 + 下面的提示词模板。 - 不给代码、不给制作过程、不给你的实现说明——评审只看画面,避免被实现细节带偏。
- 没有可派子代理的环境时,按同一模板自查,并在交付说明里写明「未独立评审」。
评审提示词模板
你是这次界面改动的独立视觉评审者,没有参与制作。只根据我给的截图、任务描述和现状设计规范评审。
任务:[这次改动要解决什么、给谁用、主任务是什么]
约束:[不可动的品牌色/字体/组件库/导航结构;目标视口]
现状规范:[roles/design-system.md 的全文]
截图:[文件路径与每个文件对应的状态、视口]
评审要求(按顺序做,看不清就写明"未验证",不要猜):
0. 三秒测试:把首屏缩到 480px 宽看三秒,写出两句:它像哪一类产品;第一眼看到的是什么,这个东西换到别的产品上是否同样成立。
1. 品类与标杆:指出这属于什么品类,该品类的优秀产品首屏怎么做;现有画面哪里违背了品类共识,是有意为之还是套了默认模板。
2. 默认做法检查:逐条对照 design-principles.md 的禁用清单,指出画面上仍在的项。
3. 状态检查:空 / 稀疏 / 密集 / 加载 / 错误五态是否都有合理呈现;错误态能否恢复。
4. 层级与减法:哪块在抢注意力、哪块该更安静;点名可直接删掉的文字、面板与装饰。
5. 可访问性与可读性:对比度、焦点可见性、触达尺寸、长内容与数字排版;在 100% 与 200% 缩放下看关键区域。
输出格式(先问题,后提升):
- 问题:只写会阻断任务、读不清、或明显是默认模板的,按影响从大到小,最多 5 条。每条写「位置 + 观察到的现象 + 影响 + 修完应该达到什么结果」。
- 提升:精致度 / 设计感 / 动效三项都要表态,最多 5 条,某项确实没有差距就写"没有"和依据。
- 保留:一两处修改时不能磨掉的做法。
- 打分:[新页面或改版才打分,存量润色不打分,只列客观修正建议]
打分锚点(拿不准取低一档):
10 挑不出可观察缺陷,至少一处是品类里没见过的好做法
9 主流程、异常状态、细节都成立,提升只剩小处
8 方向鲜明、主流程走得通、没有阻断或数据丢失;若干中等问题
7 方向成立,但有一处会让用户丢数据/走错/卡住,或首屏仍是明显默认模板
5-6 能看出方向,但骨架是默认模板,或主流程多处卡住
1-4 主任务走不通,或画面有重叠、裁切、看不清这类基本错误
不要修改任何文件,不要替我定构图,只给诊断与目标。
Step 4 按结果修正
- 问题按评审给出的顺序修,从影响最大的开始。
- 首条是「重做:……」时(分数落在 6 分及以下、骨架仍是默认模板),回到
roles/design-principles.md的「页面信息架构」重排结构,不要在被否定的骨架上做局部修补。 - 只做减法与结构修正,不靠加功能、加数据量来换真实感;要求新增任何元素时,同一条里写明为它腾位置删掉什么。
- 修完按
roles/ui-review-checklist.md自检一遍。
Step 5 复核
- 重新截图(与 Step 2 相同的状态与视口),再派一次评审者,逐条核对上一轮清单:修掉了几条、有没有引入新问题。
- 最多两轮。第二轮仍有 6 分及以下的问题,停下来找用户确认方向,不要继续自己改。
- 风格开始漂移、意见反复时,保留最合适的版本并说明取舍。
Step 6 交付说明
回复里必须包含:
- 什么改动、为什么这么改(对应哪条设计原则);
- 做了哪些动效;
- 评审轮次与结果:打分制写每轮分数,不打分制写问题如何处理;未独立评审要写明;
- 删掉了哪些文字与装饰;
- 未完成与非界面问题(环境、接口)各一行,不排查。
禁止事项
- 跳过取证(不截图)就派评审,或拿静态推断当画面证据。
- 把代码给评审者,或让评审者看制作过程。
- 把截图、评审记录提交进仓库。
- 存量页面润色时另起一套风格、更换品牌色或字体。
- 在被判定「重做」的骨架上继续做局部修饰。