Appearance
用 Impeccable 检查一个页面,再修最重要的问题
你的表单能提交,但手机上按钮挤出屏幕,错误提示不明显,键盘也找不到当前焦点。这类问题适合先列清单、再逐项修改,而不是一句“帮我变高级”后让 Agent 重做整个网站。
Impeccable 是第三方设计技能。本文以已有表单页为例,说明怎样给它可检查的任务;你需要准备自己的可运行项目。
1. 先选一个页面和一个目标
只选一个页面,例如项目里的报名表。开始前记下页面地址、相关源码和当前启动命令;保存 Git 提交或目录副本。
这次交付三样东西:带位置与复现步骤的问题清单、对应的代码差异、修改前后相同步骤的检查结果。品牌重做、后端改造和新增动效不属于本次任务。
2. 按上游方式安装到项目
在项目根目录的系统终端运行上游提供的安装器:
bash
npx impeccable install按提示选择 Codex 与项目级安装,检查它将写入哪些文件,再重新加载 Codex。该工具会安装项目 hook;按上游说明在 /hooks 中检查定义与信任请求,不把技能文件存在当作所有功能已可用。
安装方式与版本变化以 Impeccable README 为准。不要将整个仓库随意复制进某个 skills 目录,再假设就完成了安装。
3. 告诉它哪些设计已经确定
在 Codex 对话中运行:
text
/impeccable init初始化会收集产品背景。提供真实受众、页面用途,以及必须保留的设计约定;已有 PRODUCT.md 或 DESIGN.md 时先读取,不让初始化覆盖团队共识。
本练习无需另写 TOML 或 JSON。让项目按照原来的启动命令运行,并在浏览器中确认目标页面可访问。没有浏览器工具时,可以提供自己的截图协助分析,但鼠标、键盘和响应式行为仍需人工实查。
4. 先审计,再指定修复范围
先把下面任务中的方括号替换成真实地址与文件:
text
请用 Impeccable 的 audit 检查 [页面地址],关联源码为 [文件路径]。
只输出问题清单,暂不改代码。
重点检查手机宽度下的溢出、键盘焦点、表单错误提示。
每项写清:位置、复现步骤、实际现象、对用户的影响、建议改法。
看不到的状态请说明,不要根据截图推断按钮或提交逻辑已经通过。命令形式也可以写成 /impeccable audit 加目标。检查清单后,只选择最重要的一到三项,继续说:
text
请只修清单中的 [编号]。保留原品牌、字段、提交逻辑和接口。
修改前解释涉及哪些文件;完成后运行项目现有检查,并展示 diff。
用与审计时相同的视口、输入和操作复查,报告仍未解决的项。需要移动端适配、细节收尾或异常状态补齐时,上游分别提供 adapt、polish、harden。根据实际问题选用,不必把所有命令依次跑一遍。
5. 用行为判断修改是否有效
保持同一个页面和测试输入,检查以下结果:
- 缩到手机宽度,主要操作仍能找到,整页没有不必要的横向滚动。
- 只用 Tab 与 Enter 完成操作,能看清当前焦点。
- 空提交、正常提交、错误返回分别检查,提示与真实状态一致。
- diff 没有夹带接口变更、业务规则修改或整套品牌替换。
构建通过只说明代码能构建。截图可以对比外观,不能单独证明无障碍、交互或性能合格。动画时长、圆角和间距应服从项目设计,不统一锁死成某个数字。
若 Codex 找不到命令,先检查安装目标、重启状态与上游版本;若只交付评分没有位置,让它补充实际问题依据;若改动超出范围,先停止继续精修,逐项决定保留哪些修改。
6. 保存下一次能复用的结果
把已确认的问题整理为“页面—操作—预期—实际—修改—复查”的短记录。下一次改页面时用同一组检查,避免只积累一份审美形容词清单。