Files

123 lines
7.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
name: ui-review
description: 对 lpt-fe 的新页面或大范围 UI 改动做独立视觉评审:起本地服务、按关键状态截图取证、派无上下文的评审者按固定评分锚点打分并输出「问题 / 提升 / 保留」,主 agent 按清单修完再核对一轮。当用户新增页面、重构页面结构、改版视觉语言、或说“页面难看/重新设计一下/评审下这个界面”时使用。触发词:评审界面、UI 评审、页面难看、重新设计、视觉评审、设计走查、新页面、改版。
metadata:
short-description: 前端新页面与大改动的独立视觉评审
---
# 前端界面独立评审
针对 `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 取证
1. 起服务:`npm run dev`(端口 5158,代理到 lpt-be:5157)。
2. 覆盖关键状态截图,不要只截默认态:
- 默认/有数据的常态
- 空状态
- 加载中
- 错误态
- 窄屏(375px)
3. 用 `agent_browser` 截图并落盘到本次任务目录;确认 `artifactVerification` 全部 verified 再用于评审。
4. 后端不可用或需要登录才能到达的页面:把不可达的页面显式标为「未验证」,不要用静态推断代替画面。
5. 缩一张 480px 宽的缩略图,自己先做一次三秒测试(见 Step 4 第 0 条),明显不合格的先改再送评审。
## Step 3 派独立评审者
- 用 `subagent` 派一个**没有历史上下文**的子代理;一次只派一个,不要多个评审者。
- 交给它的材料只有:**截图 + 任务与约束 + `roles/design-system.md` 的现状规范 + 下面的提示词模板**。
- **不给**代码、不给制作过程、不给你的实现说明——评审只看画面,避免被实现细节带偏。
- 没有可派子代理的环境时,按同一模板自查,并在交付说明里写明「未独立评审」。
### 评审提示词模板
```text
你是这次界面改动的独立视觉评审者,没有参与制作。只根据我给的截图、任务描述和现状设计规范评审。
任务:[这次改动要解决什么、给谁用、主任务是什么]
约束:[不可动的品牌色/字体/组件库/导航结构;目标视口]
现状规范:[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 交付说明
回复里必须包含:
1. 什么改动、为什么这么改(对应哪条设计原则);
2. 做了哪些动效;
3. 评审轮次与结果:打分制写每轮分数,不打分制写问题如何处理;未独立评审要写明;
4. 删掉了哪些文字与装饰;
5. 未完成与非界面问题(环境、接口)各一行,不排查。
## 禁止事项
- 跳过取证(不截图)就派评审,或拿静态推断当画面证据。
- 把代码给评审者,或让评审者看制作过程。
- 把截图、评审记录提交进仓库。
- 存量页面润色时另起一套风格、更换品牌色或字体。
- 在被判定「重做」的骨架上继续做局部修饰。