用途:ultrapolish-web 是一套通用界面打磨标准与操作流程,适用于任意风格的项目,包括编辑式单色、密集数据工具、娱乐型消费应用等,目标是在项目自有视觉风格内,让已有界面显得经过考量、连续且鲜活。它不是视觉风格本身,而是工艺标准与流程。
主要能力:包含通用性护栏、工作流、输出格式与十条法则。工作流强调先阅读项目自有规则(如 DESIGN.md、AGENTS.md、CLAUDE.md 设计章节、globals.css、tailwind.config、@theme、token 文件、motion.ts、components 目录等),并检索 --radius、--ease、cubic-bezier、transition、box-shadow、font-family、@media (prefers- 等,建立录入表后再提修改建议。要求不得引入项目本没有的字体、配色、圆角语言或动效个性;项目自身 token 优先于默认值;不一致本身才是发现点。
模式与输出:支持 build、quick audit、full audit 三种模式,需在输出首行注明模式。审计按可访问性与状态、布局与层级、文案、排版、颜色与表面、动效与连续、控件与表单与浮层、感知性能的顺序推进。输出按根因分组,含严重度(HIGH/MEDIUM/LOW)、位置、其他出现处、问题与应改成什么、对用户的影响,并附“考虑后否决”表和验证方式。严重度判定:HIGH 为阻塞任务、误导、隐藏内容、丢失数据或键盘与读屏不可用;MEDIUM 损害理解、效率或一致性;LOW 为孤立的细节打磨,仅全量模式包含。系统性问题提升一档。结论用 Ship、Needs changes、Block 三者之一。
十条法则:同一数据同一曲线;出场快于入场;日触发 100 次不要动画;opacity 不用弹簧、transform 可用;进度显示在结果出现处;每个状态同等对待;绝不产生布局位移;禁用控件需说明原因、破坏性操作需点名对象;每视图一个强调色;人人可达(真实 button 或 a、可见 focus-visible 环、最小 24px 目标、触控 44px、可被读屏读出名称)。
必要用法:资料未提供安装命令或代码调用方式,暂未提供具体命令行用法。资料建议渲染屏幕、截图,并以十分之一速度回放动效后再写发现;未实际看到的只能标记为猜测。
适用场景:对任何 Web 应用或网站进行构建期打磨、快速审计或全面审计。限制:数值为无既定值项目时的默认值,项目自身一致使用的 token 优先;未提供具体技术栈版本限制;缺失事实包括安装方式、定价、平台支持与效果保证,资料均未提供。