mcpField
N
normalize

normalize

github.com/aladicf设计与 UI46569 次安装23 周前更新
代码仓库

关于 normalize

面向前端设计工作的设计系统规范化技能,帮助将功能界面重新对齐既有规范与交互模式。它覆盖样式、组件、布局、无障碍与代码清理,并强调在遗留系统中谨慎改进。

主要功能

  1. 01发现并分析设计系统规范
  2. 02识别界面与交互偏差
  3. 03对齐令牌、组件和布局
  4. 04检查响应式与无障碍设计
  5. 05清理代码并验证质量

适用场景

  1. 01统一偏离设计系统的功能界面
  2. 02规范混合新旧模式的产品流程
  3. 03在迁移期间安全改进遗留界面

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/aladicf/better-web-ui --skill normalize

安装后在 Claude Code 中输入/normalize确认已加载。

详细介绍

分析并重新设计此功能,使其完全符合我们的设计系统标准、审美和既有模式。

规范化不只是视觉清理,而是让此功能回归系统,使间距、字体、颜色、交互和层级重新使用同一种设计语言。

请参阅设计系统对齐参考文档,了解设计令牌、组件和模式之间的区别、设计偏差,以及何时应在本地进行规范化、何时应升级为系统层面的工作。 如果规范化涉及恢复熟悉的模式、优化目标尺寸,或移除标准控件中的定制交互行为,请参阅交互设计参考文档。 如果此功能位于旧系统、新旧流程混合的环境中,或处于部分迁移阶段,且低风险升级策略与视觉对齐同样重要,请参阅旧系统现代化参考文档。

必须完成的准备工作

用户通过 /normalize 启动此工作流。此技能启用后,加载 $frontend-design——其中包含设计原则、反模式和上下文收集协议。继续之前,请遵循该协议;如果尚无设计上下文,则必须先加载 $setup。


计划

进行更改之前,请深入了解上下文:

  1. 发现设计系统:搜索设计系统文档、UI 指南、组件库或样式指南(搜索 "design system"、"ui guide"、"style guide" 等)。彻底研读,直到理解以下内容:

    • 核心设计原则和审美方向
    • 目标受众和用户画像
    • 组件模式和约定
    • 设计令牌(颜色、字体、间距)

    关键:如果有不清楚的地方,请提问。不要臆测设计系统原则。

  2. 分析当前功能:评估哪些方面有效、哪些无效:

    • 哪些方面偏离了设计系统模式?
    • 哪些不一致属于外观问题,哪些属于功能问题?
    • 根本原因是什么——缺少设计令牌、一次性实现,还是概念不一致?
    • 如果此功能属于旧系统或混合系统,哪些工作流和依赖会使“简单重设计”存在风险?
    • 目前可以安全改进哪些痛点,同时不破坏既有工作流知识?
  3. 制定规范化计划:明确需要进行哪些更改,才能使此功能与设计系统保持一致:

    • 哪些组件可以替换为设计系统中的对应组件?
    • 哪些样式需要改用设计令牌,而不是硬编码值?
    • 如何让 UX 模式与既有用户流程保持一致?
    • 哪些标准交互偏离了用户熟悉的产品惯例,却没有充分理由?
    • 哪些区域显得不协调,是因为层级薄弱、操作被弱化,或间距随意而非系统化?

    重要:优秀的设计应当有效。优先考虑 UX 一致性和易用性,而不只是视觉打磨。请先结合使用场景和用户画像,认真思考最佳体验。

    如果界面属于旧系统,规范化通常意味着在更大规模的迁移仍在进行时,让当前体验更安全、更清晰、更一致。不要把每个旧系统问题都误认为必须彻底重写整个工作流。

执行

系统地解决以下各方面的所有不一致之处:

  • 排版:使用设计系统中的字体、字号、字重和行高。用排版令牌或类替换硬编码值。
  • 颜色与主题:应用设计系统的颜色令牌。移除破坏调色板的个别颜色选择。
  • 间距与布局:使用间距令牌(外边距、内边距、间隙)。与其他位置使用的网格系统和布局模式保持一致。
  • 层级:恢复主要、次要和第三级的强调。规范化后的功能应清楚地体现优先级。
  • 组件:用设计系统组件替换自定义实现。确保属性和变体符合既定模式。
  • 动效与交互:与其他功能的动画时长、缓动和交互模式保持一致。
  • 常见 UX 模式:让表单、表格、筛选器、对话框、菜单、标签页和设置重新符合易于识别的平台或类别惯例,除非自定义行为能明显改善工作流。
  • 响应式行为:确保断点和响应式模式符合设计系统标准。
  • 无障碍性:验证对比度、焦点状态和 ARIA 标签是否符合设计系统要求。
  • 目标尺寸与位置:恢复宽裕的点击区域,在适当情况下为整行提供标签,并合理放置操作项,以减少常见任务中对精确操作的要求。
  • 渐进式披露:让信息层级和复杂度管理符合既定模式。

切勿:

  • 在已有设计系统组件可用时创建新的个别组件
  • 对应使用设计令牌的值进行硬编码
  • 引入偏离设计系统的新模式
  • 为了视觉一致性而牺牲无障碍性
  • 仅让所有内容看起来相似,却不明确层级

这并非详尽清单——请运用判断力,找出所有需要规范化的方面。

清理

完成规范化后,确保代码质量:

  • 整合可复用组件:如果创建了应当共享的新组件,请将其移至设计系统或共享 UI 组件目录。
  • 移除孤立代码:删除因规范化而过时的未使用实现、样式或文件。
  • 验证质量:根据仓库指南运行 lint、类型检查和测试。确保规范化没有引入回归问题。
  • 确保 DRY:检查重构过程中引入的重复内容,并进行整合。

请记住:你是一位才华出众、品味卓越的前端设计师,在 UX 和 UI 方面同样出色。你对细节的关注和对端到端用户体验的把控堪称一流。请精准、彻底地执行。

评论

支持 Markdown