docs: 补充设计原则、设计系统与界面自检规则
This commit is contained in:
@@ -0,0 +1,122 @@
|
||||
---
|
||||
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. 未完成与非界面问题(环境、接口)各一行,不排查。
|
||||
|
||||
## 禁止事项
|
||||
|
||||
- 跳过取证(不截图)就派评审,或拿静态推断当画面证据。
|
||||
- 把代码给评审者,或让评审者看制作过程。
|
||||
- 把截图、评审记录提交进仓库。
|
||||
- 存量页面润色时另起一套风格、更换品牌色或字体。
|
||||
- 在被判定「重做」的骨架上继续做局部修饰。
|
||||
Reference in New Issue
Block a user