1. 修改 CSS 前先记录问题
写下路由、视口宽度、必要时的设备像素比、发生裁切的内容,以及元素之间应有的关系。截图有帮助,但还要指出具体失败的文字或控件,让其他人能复现。
首次运行尽量只读。不要把移动端间距修复与重设计、文案改写或依赖升级混在一起;范围越小,原因和回滚越清楚。
- 写明发生问题的路由和视口。
- 指出裁切、溢出或不均匀元素。
- 用一句话描述预期结果。
- 保留起始截图或复现记录。
2. 一个问题对应一个 Skill
当界面缺少连贯视觉方向时,frontend-design 有价值,但它不是移动端回归测试。需要比较断点渲染并把可见问题追溯到源码时,web-design-reviewer 更合适。如果修复可能影响真实用户流程,或需要浏览器日志和可重复断言,再加入 webapp-testing。
选择能回答问题的最小角色。为一行溢出问题安装三个 Skill,只会增加需要审查的权限和产物,不会改善诊断。
3. 用三个代表性宽度复查
最小修改后,复查报告问题的手机宽度、一个较窄的中间宽度,以及原本正常的桌面宽度。重点看文字裁切、横向溢出、控件折叠、间距不一致和主要操作是否掉出可用区域。
保持条件一致:同一路由、同一内容、同一浏览器状态和同一句验收标准。如果一个宽度变好却破坏另一个宽度,应记录取舍,而不是直接判定通过。
- 原始移动端问题消失。
- 中间宽度没有横向滚动或文字裁切。
- 桌面端基线保持不变。
- 主要操作可以用键盘和指针完成。
4. 通过截图不代表什么
截图只展示一个渲染状态,不能证明屏幕阅读器语义、焦点顺序、所有状态的对比度、加载行为、性能或所有浏览器兼容性。没有实际检查,就不要在文章里做这些声明。
更强的页面级证据是前后对比、明确的变更边界和简短验收记录。对维护者来说,这比泛泛地说页面已经响应式更有用。