关于 normalize
面向前端设计工作的设计系统规范化技能,帮助将功能界面重新对齐既有规范与交互模式。它覆盖样式、组件、布局、无障碍与代码清理,并强调在遗留系统中谨慎改进。
主要功能
- 01发现并分析设计系统规范
- 02识别界面与交互偏差
- 03对齐令牌、组件和布局
- 04检查响应式与无障碍设计
- 05清理代码并验证质量
适用场景
- 01统一偏离设计系统的功能界面
- 02规范混合新旧模式的产品流程
- 03在迁移期间安全改进遗留界面
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ aladicf/ better-web-ui --skill normalize安装后在 Claude Code 中输入/normalize确认已加载。
详细介绍
分析并重新设计此功能,使其完全符合我们的设计系统标准、审美和既有模式。
规范化不只是视觉清理,而是让此功能回归系统,使间距、字体、颜色、交互和层级重新使用同一种设计语言。
请参阅设计系统对齐参考文档,了解设计令牌、组件和模式之间的区别、设计偏差,以及何时应在本地进行规范化、何时应升级为系统层面的工作。 如果规范化涉及恢复熟悉的模式、优化目标尺寸,或移除标准控件中的定制交互行为,请参阅交互设计参考文档。 如果此功能位于旧系统、新旧流程混合的环境中,或处于部分迁移阶段,且低风险升级策略与视觉对齐同样重要,请参阅旧系统现代化参考文档。
必须完成的准备工作
用户通过 /normalize 启动此工作流。此技能启用后,加载 $frontend-design——其中包含设计原则、反模式和上下文收集协议。继续之前,请遵循该协议;如果尚无设计上下文,则必须先加载 $setup。
计划
进行更改之前,请深入了解上下文:
-
发现设计系统:搜索设计系统文档、UI 指南、组件库或样式指南(搜索 "design system"、"ui guide"、"style guide" 等)。彻底研读,直到理解以下内容:
- 核心设计原则和审美方向
- 目标受众和用户画像
- 组件模式和约定
- 设计令牌(颜色、字体、间距)
关键:如果有不清楚的地方,请提问。不要臆测设计系统原则。
-
分析当前功能:评估哪些方面有效、哪些无效:
- 哪些方面偏离了设计系统模式?
- 哪些不一致属于外观问题,哪些属于功能问题?
- 根本原因是什么——缺少设计令牌、一次性实现,还是概念不一致?
- 如果此功能属于旧系统或混合系统,哪些工作流和依赖会使“简单重设计”存在风险?
- 目前可以安全改进哪些痛点,同时不破坏既有工作流知识?
-
制定规范化计划:明确需要进行哪些更改,才能使此功能与设计系统保持一致:
- 哪些组件可以替换为设计系统中的对应组件?
- 哪些样式需要改用设计令牌,而不是硬编码值?
- 如何让 UX 模式与既有用户流程保持一致?
- 哪些标准交互偏离了用户熟悉的产品惯例,却没有充分理由?
- 哪些区域显得不协调,是因为层级薄弱、操作被弱化,或间距随意而非系统化?
重要:优秀的设计应当有效。优先考虑 UX 一致性和易用性,而不只是视觉打磨。请先结合使用场景和用户画像,认真思考最佳体验。
如果界面属于旧系统,规范化通常意味着在更大规模的迁移仍在进行时,让当前体验更安全、更清晰、更一致。不要把每个旧系统问题都误认为必须彻底重写整个工作流。
执行
系统地解决以下各方面的所有不一致之处:
- 排版:使用设计系统中的字体、字号、字重和行高。用排版令牌或类替换硬编码值。
- 颜色与主题:应用设计系统的颜色令牌。移除破坏调色板的个别颜色选择。
- 间距与布局:使用间距令牌(外边距、内边距、间隙)。与其他位置使用的网格系统和布局模式保持一致。
- 层级:恢复主要、次要和第三级的强调。规范化后的功能应清楚地体现优先级。
- 组件:用设计系统组件替换自定义实现。确保属性和变体符合既定模式。
- 动效与交互:与其他功能的动画时长、缓动和交互模式保持一致。
- 常见 UX 模式:让表单、表格、筛选器、对话框、菜单、标签页和设置重新符合易于识别的平台或类别惯例,除非自定义行为能明显改善工作流。
- 响应式行为:确保断点和响应式模式符合设计系统标准。
- 无障碍性:验证对比度、焦点状态和 ARIA 标签是否符合设计系统要求。
- 目标尺寸与位置:恢复宽裕的点击区域,在适当情况下为整行提供标签,并合理放置操作项,以减少常见任务中对精确操作的要求。
- 渐进式披露:让信息层级和复杂度管理符合既定模式。
切勿:
- 在已有设计系统组件可用时创建新的个别组件
- 对应使用设计令牌的值进行硬编码
- 引入偏离设计系统的新模式
- 为了视觉一致性而牺牲无障碍性
- 仅让所有内容看起来相似,却不明确层级
这并非详尽清单——请运用判断力,找出所有需要规范化的方面。
清理
完成规范化后,确保代码质量:
- 整合可复用组件:如果创建了应当共享的新组件,请将其移至设计系统或共享 UI 组件目录。
- 移除孤立代码:删除因规范化而过时的未使用实现、样式或文件。
- 验证质量:根据仓库指南运行 lint、类型检查和测试。确保规范化没有引入回归问题。
- 确保 DRY:检查重构过程中引入的重复内容,并进行整合。
请记住:你是一位才华出众、品味卓越的前端设计师,在 UX 和 UI 方面同样出色。你对细节的关注和对端到端用户体验的把控堪称一流。请精准、彻底地执行。